Tom N / LidarSpi

This is a class which contains function to interface with the MLX75320

Dependents:   MLX75320_API

LidarSpi.h@12:d1767e2bd3a8, 2016-04-29 (annotated)

Committer:
TNU
Date:
Fri Apr 29 13:39:19 2016 +0000
Revision:
12:d1767e2bd3a8
Parent:
11:bd2dee9957a9
Child:
13:ccf4ab73c33d
General cleanup;

Who changed what in which revision?

UserRevisionLine numberNew contents of line
TNU 0:dfe498e03679 1 #ifndef LIDARSPI_H
TNU 0:dfe498e03679 2 #define LIDARSPI_H
TNU 0:dfe498e03679 3
TNU 0:dfe498e03679 4 #include "mbed.h"
TNU 0:dfe498e03679 5 #include "typeDef.h"
TNU 0:dfe498e03679 6 #include "FunctionPointer.h"
TNU 0:dfe498e03679 7
TNU 0:dfe498e03679 8
TNU 6:748062f3de21 9
TNU 0:dfe498e03679 10 class LidarSpi
TNU 0:dfe498e03679 11 {
TNU 0:dfe498e03679 12 public:
TNU 0:dfe498e03679 13
TNU 0:dfe498e03679 14 // Type used to read/write register values. Here, it is 16 bits
TNU 0:dfe498e03679 15 typedef uint16_t REGTYPE;
TNU 0:dfe498e03679 16 typedef unsigned char uchar;
TNU 0:dfe498e03679 17
TNU 0:dfe498e03679 18 static const uint16_t CRC_SZ = 2; // Bytes in SPI CRC field
TNU 0:dfe498e03679 19 static const uint16_t SHORT_SZ = 8; // Bytes in short SPI packet
TNU 0:dfe498e03679 20 static const uint16_t LONG_SZ = 300; // Bytes in long SPI packet
TNU 0:dfe498e03679 21 static const uint16_t HDR_SZ = 2; // Bytes in SPI header field
TNU 0:dfe498e03679 22
TNU 0:dfe498e03679 23 static const uint16_t MAXCH = 16; // Number of channels
TNU 0:dfe498e03679 24 static const uint16_t MAXSET = 2; // Number of acquisition sets
TNU 0:dfe498e03679 25 static const uint16_t MAXPTCNT = 64; // Max number of base points
TNU 0:dfe498e03679 26 static const uint16_t MAXECH = 64 ; // Max echo count
TNU 0:dfe498e03679 27 static const uint16_t MAXACCLOG = 10; // Max accumulation log2
TNU 0:dfe498e03679 28 static const uint16_t MAXOVRLOG = 3; // Max oversampling log2
TNU 0:dfe498e03679 29 static const uint16_t MAXLED = 16; // Max LED power
TNU 0:dfe498e03679 30 static const uint16_t MAXACC = 1<<MAXACCLOG;
TNU 0:dfe498e03679 31 static const uint16_t MAXOVR = 1<<MAXOVRLOG;
TNU 0:dfe498e03679 32 static const uint16_t MAXTRCLEN = 74*8*MAXCH*2; // Max length of a trace in bytes (samples * MAXOVR * MAXCH * 2bytes)
TNU 0:dfe498e03679 33 static const uint16_t BYTES_PER_ECH = 24; // Nb of bytes per echo
TNU 0:dfe498e03679 34 static const uint16_t START_DELAY =10;
TNU 0:dfe498e03679 35
TNU 0:dfe498e03679 36 // Used on header ADDR field to request all channels and as idx argument of GetTrace function
TNU 0:dfe498e03679 37 static const uint16_t ADDR_ALLCH= 0x1F;
TNU 0:dfe498e03679 38
TNU 0:dfe498e03679 39 struct Echo
TNU 0:dfe498e03679 40 {
TNU 0:dfe498e03679 41 uint32_t mDistance;
TNU 0:dfe498e03679 42 uint32_t mAmplitude;
TNU 0:dfe498e03679 43 uint32_t mBase;
TNU 0:dfe498e03679 44 uint16_t mMaxIndex;
TNU 0:dfe498e03679 45 uint8_t mChannelIndex;
TNU 0:dfe498e03679 46 uint8_t mValid;
TNU 0:dfe498e03679 47 uint32_t mAmplitudeLowScale;
TNU 0:dfe498e03679 48 uint32_t mSaturationWidth;
TNU 0:dfe498e03679 49 };
TNU 0:dfe498e03679 50
TNU 0:dfe498e03679 51 /// \enum eASICREG
TNU 0:dfe498e03679 52 /// \brief Lists all registers. Enum value is directly the register address.
TNU 0:dfe498e03679 53 /// Naming convention: REG_ + <name> + <L/H> + <#>
TNU 0:dfe498e03679 54 /// <name> = name of register
TNU 0:dfe498e03679 55 /// <L/H> = optional low or high register part
TNU 0:dfe498e03679 56 /// <#> = optional number, either for acquisition source 0/1 or index
TNU 0:dfe498e03679 57 typedef enum
TNU 0:dfe498e03679 58 {
TNU 0:dfe498e03679 59 REG_MEACL = 0x00,
TNU 0:dfe498e03679 60 REG_MEACH,
TNU 0:dfe498e03679 61 REG_CONTROL,
TNU 0:dfe498e03679 62 REG_ACQCTL0,
TNU 0:dfe498e03679 63 REG_ACQCTL1,
TNU 0:dfe498e03679 64 REG_PTCNT,
TNU 0:dfe498e03679 65 REG_SCANCTL,
TNU 0:dfe498e03679 66 REG_TRIGCTL,
TNU 0:dfe498e03679 67 REG_DELAY,
TNU 0:dfe498e03679 68 REG_TMPSET,
TNU 0:dfe498e03679 69 REG_TMPSHUT,
TNU 0:dfe498e03679 70 REG_TMPIC,
TNU 0:dfe498e03679 71 REG_TMPSRC,
TNU 0:dfe498e03679 72 REG_GAIN0,
TNU 0:dfe498e03679 73 REG_GAIN1,
TNU 0:dfe498e03679 74 REG_GAIN2,
TNU 0:dfe498e03679 75 REG_GAIN3,
TNU 0:dfe498e03679 76 REG_CHANNEL,
TNU 0:dfe498e03679 77 REG_PWMPERIOD0,
TNU 0:dfe498e03679 78 REG_PWMPERIOD1,
TNU 0:dfe498e03679 79 REG_PWMCOUNT,
TNU 0:dfe498e03679 80 REG_PWMWIDTH0,
TNU 0:dfe498e03679 81 REG_PWMWIDTH1 = REG_PWMWIDTH0 + 8,
TNU 0:dfe498e03679 82 REG_FILTER0 = REG_PWMWIDTH1 + 8,
TNU 0:dfe498e03679 83 REG_FILTER1 = REG_FILTER0 + 16,
TNU 0:dfe498e03679 84 REG_THRNEARL0 = REG_FILTER1 + 16,
TNU 0:dfe498e03679 85 REG_THRNEARH0,
TNU 0:dfe498e03679 86 REG_THRMEDL0,
TNU 0:dfe498e03679 87 REG_THRMEDH0,
TNU 0:dfe498e03679 88 REG_THRFARL0,
TNU 0:dfe498e03679 89 REG_THRFARH0,
TNU 0:dfe498e03679 90 REG_THRNEARL1,
TNU 0:dfe498e03679 91 REG_THRNEARH1,
TNU 0:dfe498e03679 92 REG_THRMEDL1,
TNU 0:dfe498e03679 93 REG_THRMEDH1,
TNU 0:dfe498e03679 94 REG_THRFARL1,
TNU 0:dfe498e03679 95 REG_THRFARH1,
TNU 0:dfe498e03679 96 REG_NOISE0,
TNU 0:dfe498e03679 97 REG_NOISE1,
TNU 0:dfe498e03679 98 REG_OFFSETL0,
TNU 0:dfe498e03679 99 REG_OFFSETH0 = REG_OFFSETL0 + 16,
TNU 0:dfe498e03679 100 REG_OFFSETL1 = REG_OFFSETH0 + 16,
TNU 0:dfe498e03679 101 REG_OFFSETH1 = REG_OFFSETL1 + 16,
TNU 0:dfe498e03679 102 REG_SCALEL0 = REG_OFFSETH1 + 16,
TNU 0:dfe498e03679 103 REG_SCALEH0,
TNU 0:dfe498e03679 104 REG_SCALEL1,
TNU 0:dfe498e03679 105 REG_SCALEH1,
TNU 0:dfe498e03679 106 REG_FACTORY,
TNU 0:dfe498e03679 107 REG_ASIL,
TNU 0:dfe498e03679 108 REG_OTP0,
TNU 0:dfe498e03679 109 REG_OTP1,
TNU 0:dfe498e03679 110 REG_OTP2,
TNU 0:dfe498e03679 111 REG_OTP3,
TNU 0:dfe498e03679 112 REG_OTP4,
TNU 0:dfe498e03679 113 REG_OTP5,
TNU 0:dfe498e03679 114 REG_OTP6,
TNU 0:dfe498e03679 115 REG_OTP7,
TNU 0:dfe498e03679 116 REG_SOFTVER,
TNU 0:dfe498e03679 117 REG_ASICVER,
TNU 0:dfe498e03679 118 REG_WATCHDOGL,
TNU 0:dfe498e03679 119 REG_WATCHDOGH,
TNU 0:dfe498e03679 120 // Wai: Changed from REG_MAX
TNU 0:dfe498e03679 121 REG_MAX = 0xFFFF // Number of registers
TNU 0:dfe498e03679 122 } eASICREG;
TNU 0:dfe498e03679 123
TNU 0:dfe498e03679 124 enum PackType
TNU 0:dfe498e03679 125 {
TNU 0:dfe498e03679 126 PACK_RREG = 0, ///< Read register request
TNU 0:dfe498e03679 127 PACK_WREG, ///< Write register request
TNU 0:dfe498e03679 128 PACK_RFIRM, ///< Read firmware request
TNU 0:dfe498e03679 129 PACK_WFIRM, ///< Write firmware request
TNU 0:dfe498e03679 130 PACK_STATUS_S, ///< Status short
TNU 0:dfe498e03679 131 PACK_STATUS_L, ///< Status long
TNU 0:dfe498e03679 132 PACK_RDATA_RESP_S, ///< Read data response short
TNU 0:dfe498e03679 133 PACK_RDATA_RESP_L, ///< Read data response long
TNU 0:dfe498e03679 134 PACK_WDATA_L, ///< Write data long
TNU 0:dfe498e03679 135 };
TNU 0:dfe498e03679 136
TNU 0:dfe498e03679 137 enum StatusType
TNU 0:dfe498e03679 138 {
TNU 0:dfe498e03679 139 STAT_OK = 0,
TNU 0:dfe498e03679 140 STAT_BUSY,
TNU 0:dfe498e03679 141 STAT_CRC,
TNU 0:dfe498e03679 142 STAT_INVALID_REQ,
TNU 0:dfe498e03679 143 STAT_SEQ_NB,
TNU 0:dfe498e03679 144 STAT_TIMEOUT,
TNU 0:dfe498e03679 145 };
TNU 0:dfe498e03679 146
TNU 0:dfe498e03679 147 enum FirmType
TNU 0:dfe498e03679 148 {
TNU 0:dfe498e03679 149 FW_OTP = 0,
TNU 0:dfe498e03679 150 FW_PROCESSED,
TNU 0:dfe498e03679 151 FW_RAW,
TNU 0:dfe498e03679 152 FW_PATCH,
TNU 0:dfe498e03679 153 FW_PRELOAD,
TNU 0:dfe498e03679 154 FW_TEST,
TNU 0:dfe498e03679 155 };
TNU 0:dfe498e03679 156
TNU 0:dfe498e03679 157
TNU 3:9ed1d493c235 158 LidarSpi(PinName mosi, PinName miso, PinName clk, PinName chipSelect, PinName dr, PinName rs, PinName tr, PinName smpl);
TNU 0:dfe498e03679 159 int SpiSetting(long freq, int mode, Serial* pc);
TNU 0:dfe498e03679 160 int TxPacket(uint8_t* rData, uint16_t *rSz, uint8_t *tData, uint16_t tSz);
TNU 0:dfe498e03679 161 int TxPacketWord(uint8_t* rData, uint16_t *rSz, uint8_t *tData, uint16_t tSz);
TNU 0:dfe498e03679 162 int TxPacket(uint8_t* rData, uint16_t *rSz, uint8_t *tData, uint16_t tSz, Serial* pc);
TNU 0:dfe498e03679 163 int TxPacketSlow(uint8_t* rData, uint16_t *rSz, uint8_t *tData, uint16_t tSz, uint16_t usDelay);
TNU 0:dfe498e03679 164 int BasicRead();
TNU 0:dfe498e03679 165 int BasicTransfer(uint8_t* rData, uint16_t rSz, uint8_t *wData, uint16_t wSz, const event_callback_t callback);
TNU 12:d1767e2bd3a8 166
TNU 0:dfe498e03679 167 int ReadReg ( uint32_t reg, uint32_t *val);
TNU 0:dfe498e03679 168 int ReadReg(uint32_t reg, uint32_t *val, Serial* pc);
TNU 0:dfe498e03679 169 int WriteReg ( uint32_t reg, uint32_t val);
TNU 0:dfe498e03679 170 int WriteRegSpeed ( uint32_t reg, uint32_t val, uint16_t usDelay);
TNU 0:dfe498e03679 171 int WriteReg ( uint32_t reg, uint32_t val, Serial* pc);
TNU 0:dfe498e03679 172 int WriteRegSpeed ( uint32_t reg, uint32_t val, uint16_t usDelay, Serial* pc);
TNU 0:dfe498e03679 173 //int GetRegNfo ( uint16_t reg, const RegInfo **nfo);
TNU 0:dfe498e03679 174 int GetEchoes ( Echo *ech, uint16_t maxN, uint16_t mode);
TNU 0:dfe498e03679 175 int GetEchoes ( Echo *ech, uint16_t maxN, uint16_t mode, Serial* pc);
TNU 0:dfe498e03679 176 int GetTrace ( uint16_t *buf, uint16_t maxN, uint16_t nSam, uint16_t idx, Serial* pc);
TNU 0:dfe498e03679 177 int GetTraceOne ( uint16_t *buf, uint16_t maxN, uint16_t nSam, uint16_t idx,int index , Serial* pc);
TNU 6:748062f3de21 178 int LoadPatch (const char *patch, Serial *pc);
TNU 7:c47612b25c77 179 int setTrace(void);
TNU 9:067f75510d67 180 int setEcho(void);
TNU 0:dfe498e03679 181 int PrintAllReg (uint16_t * regs, uint32_t * val, uint16_t size);
TNU 12:d1767e2bd3a8 182 int setLed(bool state);
TNU 0:dfe498e03679 183 void Trigger(int level);
TNU 0:dfe498e03679 184 //int SetConfig ( int configNum);
TNU 0:dfe498e03679 185 //int SetAcqCfg ( uint16_t set, uint16_t led, uint16_t accLog, uint16_t ovrLog);
TNU 0:dfe498e03679 186 //int Acquire ( uchar ab, uchar evGain, uchar evCh, uchar odGain, uchar odCh);
TNU 0:dfe498e03679 187 //int GetFrame ( uint16_t *buf, uint16_t maxN, uint16_t nSam, uint16_t nFrm);
TNU 0:dfe498e03679 188
TNU 0:dfe498e03679 189
TNU 0:dfe498e03679 190
TNU 0:dfe498e03679 191
TNU 0:dfe498e03679 192 private:
TNU 0:dfe498e03679 193 SPI device;
TNU 0:dfe498e03679 194 DigitalOut chipS;
TNU 0:dfe498e03679 195 DigitalIn dataReady;
TNU 11:bd2dee9957a9 196 DigitalOut resetPin;
TNU 4:534855b07d93 197 DigitalOut trigger;
TNU 3:9ed1d493c235 198 DigitalIn sampling;
TNU 0:dfe498e03679 199
TNU 6:748062f3de21 200 int parse_hex_line(char *theline, uint8_t bytes[], uint16_t *addr, uint16_t *num, uint16_t *code);
TNU 6:748062f3de21 201 int LoadPatchFragment(const char *patch, uint16_t *addrStart, uint16_t *startLine, uint16_t *nBytes, uint8_t *memory, Serial* pc);
TNU 0:dfe498e03679 202
TNU 0:dfe498e03679 203
TNU 0:dfe498e03679 204 };
TNU 0:dfe498e03679 205
TNU 0:dfe498e03679 206
TNU 0:dfe498e03679 207 #endif