-
Notifications
You must be signed in to change notification settings - Fork 1
/
DW1000.h
145 lines (119 loc) · 10.6 KB
/
DW1000.h
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
//Register header based on work by Matthias Grob and Manuel Stalder - 2015.
// Identify which libraries to include.
#ifndef DW1000_h
#define DW1000_h
// Include general Arduino library.
#include "Arduino.h"
//#define MISO_PIN 11 //Pin 11 defined as DOUT for MOSI
//#define MOSI_PIN 12 //Pin 12 defined as DIN for MISO
//#define SCK_PIN 13 //Pin 13 defined as SCK
//#define CS_PIN 10 //Pin 10 defined as Chip Select
// register addresses
// Mnemonic Address Bytes Description
#define DW1000_DEV_ID 0x00 // 4 Device Identifier – includes device type and revision information
#define DW1000_EUI 0x01 // 8 Extended Unique Identifier
#define DW1000_PANADR 0x03 // 4 PAN Identifier and Short Address
#define DW1000_SYS_CFG 0x04 // 4 System Configuration bitmap
#define DW1000_SYS_TIME 0x06 // 5 System Time Counter (40-bit)
#define DW1000_TX_FCTRL 0x08 // 5 Transmit Frame Control
#define DW1000_TX_BUFFER 0x09 // 1024 Transmit Data Buffer
#define DW1000_DX_TIME 0x0A // 5 Delayed Send or Receive Time (40-bit)
#define DW1000_RX_FWTO 0x0C // 2 Receive Frame Wait Timeout Period
#define DW1000_SYS_CTRL 0x0D // 4 System Control Register
#define DW1000_SYS_MASK 0x0E // 4 System Event Mask Register
#define DW1000_SYS_STATUS 0x0F // 5 System Event Status Register
#define DW1000_RX_FINFO 0x10 // 4 RX Frame Information (in double buffer set)
#define DW1000_RX_BUFFER 0x11 // 1024 Receive Data Buffer (in double buffer set)
#define DW1000_RX_FQUAL 0x12 // 8 Rx Frame Quality information (in double buffer set)
#define DW1000_RX_TTCKI 0x13 // 4 Receiver Time Tracking Interval (in double buffer set)
#define DW1000_RX_TTCKO 0x14 // 5 Receiver Time Tracking Offset (in double buffer set)
#define DW1000_RX_TIME 0x15 // 14 Receive Message Time of Arrival (in double buffer set)
#define DW1000_TX_TIME 0x17 // 10 Transmit Message Time of Sending (in double buffer set)
#define DW1000_TX_ANTD 0x18 // 2 16-bit Delay from Transmit to Antenna
#define DW1000_SYS_STATE 0x19 // 5 System State information
#define DW1000_ACK_RESP_T 0x1A // 4 Acknowledgement Time and Response Time
#define DW1000_RX_SNIFF 0x1D // 4 Pulsed Preamble Reception Configuration
#define DW1000_TX_POWER 0x1E // 4 TX Power Control
#define DW1000_CHAN_CTRL 0x1F // 4 Channel Control
#define DW1000_USR_SFD 0x21 // 41 User-specified short/long TX/RX SFD sequences
#define DW1000_AGC_CTRL 0x23 // 32 Automatic Gain Control configuration
#define DW1000_EXT_SYNC 0x24 // 12 External synchronisation control.
#define DW1000_ACC_MEM 0x25 // 4064 Read access to accumulator data
#define DW1000_GPIO_CTRL 0x26 // 44 Peripheral register bus 1 access - GPIO control
#define DW1000_DRX_CONF 0x27 // 44 Digital Receiver configuration
#define DW1000_RF_CONF 0x28 // 58 Analog RF Configuration
#define DW1000_TX_CAL 0x2A // 52 Transmitter calibration block
#define DW1000_FS_CTRL 0x2B // 21 Frequency synthesiser control block
#define DW1000_AON 0x2C // 12 Always-On register set
#define DW1000_OTP_IF 0x2D // 18 One Time Programmable Memory Interface
#define DW1000_LDE_CTRL 0x2E // - Leading edge detection control block
#define DW1000_DIG_DIAG 0x2F // 41 Digital Diagnostics Interface
#define DW1000_PMSC 0x36 // 48 Power Management System Control Block
#define DW1000_WRITE_FLAG 0x80 // First Bit of the address has to be 1 to indicate we want to write
#define DW1000_SUBADDRESS_FLAG 0x40 // if we have a sub address second Bit has to be 1
#define DW1000_2_SUBADDRESS_FLAG 0x80 // if we have a long sub adress (more than 7 Bit) we set this Bit in the first part
class DW1000 {
public:
typedef void(*callbackRX)(void);
typedef void(*callbackTX)(void);
DW1000(int MOSI_pin, int MISO_pin, int SCLK_pin, int CS_pin, int IRQ_pin); // constructor, uses SPI class
void setCallbacks(void (*callbackRX)(void), void (*callbackTX)(void)); // setter for callback functions, automatically enables interrupt, if NULL is passed the coresponding interrupt gets disabled
//void setCallbacks(callbackRX, callbackTX);
template<typename T>
void setCallbacks(T* tptr, void (T::*mptrRX)(void), void (T::*mptrTX)(void)) { // overloaded setter to treat member function pointers of objects
callbackRX.attach(tptr, mptrRX); // possible client code: dw.setCallbacks(this, &A::callbackRX, &A::callbackTX);
callbackTX.attach(tptr, mptrTX); // concept seen in line 100 of http://developer.mbed.org/users/mbed_official/code/mbed/docs/4fc01daae5a5/InterruptIn_8h_source.html
setInterrupt(true,true);
}
// Device API
uint32_t getDeviceID(); // gets the Device ID which should be 0xDECA0130 (good for testing SPI!)
uint64_t getEUI(); // gets 64 bit Extended Unique Identifier according to IEEE standard
void setEUI(uint64_t EUI); // sets 64 bit Extended Unique Identifier according to IEEE standard
float getVoltage(); // gets the current chip voltage measurement form the A/D converter
uint64_t getStatus(); // get the 40 bit device status
uint64_t getRXTimestamp();
uint64_t getTXTimestamp();
void sendString(char* message); // to send String with arbitrary length
void receiveString(char* message); // to receive char string (length of the buffer must be 1021 to be safe)
void sendFrame(uint8_t* message, uint16_t length); // send a raw frame (length in bytes)
void sendDelayedFrame(uint8_t* message, uint16_t length, uint64_t TxTimestamp);
void startRX(); // start listening for frames
void stopTRX(); // disable tranceiver go back to idle mode
//private:
void loadLDE(); // load the leading edge detection algorithm to RAM, [IMPORTANT because receiving malfunction may occur] see User Manual LDELOAD on p22 & p158
void resetRX(); // soft reset only the tranciever part of DW1000
void resetAll(); // soft reset the entire DW1000 (some registers stay as they were see User Manual)
// Interrupt
//InterruptIn irq; // Pin used to handle Events from DW1000 by an Interrupthandler
void ISR(); // interrupt handling method (also calls according callback methods)
//typedef void(*GeneralFunction)(void);
//GeneralFunction callbackRX; // function pointer to callback which is called when successfull RX took place
// struct callbackRX_callback { //new
// callbackRX func;
// };
//
// struct callbackTX_callback { //new
// callbackTX func;
// };
// callbackRX func; //new
// callbackTX func; //new
//GeneralFunction callbackTX; // function pointer to callback which is called when successfull TX took place
void setInterrupt(bool RX, bool TX); // set Interrupt for received a good frame (CRC ok) or transmission done
uint16_t getFramelength(); // to get the framelength of the received frame from the PHY header
// SPI Inteface
//SPI spi; // SPI Bus
//DigitalOut cs; // Slave selector for SPI-Bus (here explicitly needed to start and end SPI transactions also usable to wake up DW1000)
uint8_t readRegister8(uint8_t reg, uint16_t subaddress); // expressive methods to read or write the number of bits written in the name
uint16_t readRegister16(uint8_t reg, uint16_t subaddress);
uint64_t readRegister40(uint8_t reg, uint16_t subaddress);
void writeRegister8(uint8_t reg, uint16_t subaddress, uint8_t buffer);
void writeRegister16(uint8_t reg, uint16_t subaddress, uint16_t buffer);
void writeRegister32(uint8_t reg, uint16_t subaddress, uint32_t buffer);
void writeRegister40(uint8_t reg, uint16_t subaddress, uint64_t buffer);
void readRegister(uint8_t reg, uint16_t subaddress, uint8_t *buffer, int length); // reads the selected part of a slave register into the buffer memory
void writeRegister(uint8_t reg, uint16_t subaddress, uint8_t *buffer, int length); // writes the buffer memory to the selected slave register
void setupTransaction(uint8_t reg, uint16_t subaddress, bool write); // sets up an SPI read or write transaction with correct register address and offset
void selectChip(); // selects the only slave for a transaction
void deselectChip(); // deselects the only slave after transaction
};
#endif