Runs the RX calibration.
Needs to be done after startup, wake and after 20C temperature change
Needs to be run when chip is in IDLE_PLL state
Automatically run by initialize()

Due to an errata the check is a bit more complicated
Relies on system_status and chip_state being up to date

Copy received packet into the provided payload buffer, clear packet received flags

Parameters

payload	Region of memory the payload will be written to
payload_len	Contains the length of the received payload

Get the Clock offset multiplier for the received packet
Can be used to recover the clock drift compared to a packets sender
Unit is in parts per million (ppm)

Get the timestamp of the last arrived packet.
This timestamp already has various correction factors applied to it.
It is given in ~15.65 picoseconds per unit

Get the currently programmed RX antenna delay
Unit is approx 15.65ps

Get the IV to use for AES generation of the STS

Warning

Will only return the programmed IV, to get the incremented value use getCurrentCounter()

Get the currently programmed TX antenna delay
Unit is approx 15.65ps

Initialize the DW3000, make ready to receive/transmit
Call ideally after the IRQ Pin has gone high, signalling SPIRDY

Only load configuration independent stuff, everything else should be initialized when changing those parts

Simple implementation of read modify write using and and or masks
Use on registers that do not support native write register masked

Read a number of bytes from a register bank, useful for RX buffers and other large read transfers

Set the time between RX of a packet and the TX of the acknowledgement
Specified in number of preamble symbols, so time depends on the PRF

Set both the RX and TX antenna delay
Unit is approx 15.65ps

Enable auto acknowledgment
Will automatically respond to valid 802.5.14 Frames with the ACK request bit set
Only active when Frame filtering is enabled

Set the time spent listening for competing transmissions on CCA commands
Unit is in counts of PAC symbols

Enable a faster TX/RX turnaround.
The Frame will be set ready before computation of ToA data has finished and any ACKs will be sent.
Time of Arrival may not be ready when the frame is made available

Change Header format to non-standard to allow 1021 Byte payloads instead of default 125

Set interrupt bits
Set on which status events the IRQ Pin of the chip should be pulled high
Interrupt condition can be cleared by clearing the corresponding status bit using clearStatusBits()
Polarity of the line can be changed with setIRQPolarity()

Warning

Dw3110::SystemStatus::IRQS will be ignored since it does not correspond to an interrupt

Set the polarity of the interrupt line
Default is active high

Parameters

high	If true sets the line to active high

Set the preamble code used and looked for.

Warning

This implicitly sets the PRF as codes >8 use the 64MHz PRF instead of 16MHz

Set the number of preamble symbols sent with each transmission
Each symbol takes ~1µs to send

Warning

While further fine tuning of preamble length is possible it is currently unsupported by this driver

Set the timeout to wait on arriving packets after startReceive()
0 = No Timeout
Register resolution is ~1µs

Set the reference time value
Used as the reference in transmitDelayed() when using DelayTXMode::DelayWRTRef and DelayTXMode::DelayWRTRefAndReceive

Send the PHR at 6.8Mbps.
By default the PHR is always sent at 850kb/s

Set the IV to use for AES generation of the STS
Ignored if SDC is set in setSTSMode()

Set the Key to use for AES generation of the STS
Ignored if SDC is set in setSTSMode()

Set the length of the generated Secure timestamp

Parameters

len	Length in units of 8 chips (~1µs), minimum supported is 32 chips(e.g a value of 3)

Set the STS mode

Parameters

mode	Defines where to place the STS inside the packet
sdc	If true IV and Key are ignored and a deterministic code is used

Set the time between a transmission and the start of RX on any of the RX after TX commands
This can be used to delay turning on of the receiver after transmission to save on power.

Transmit a given package using the current configuration using a given transmission mode

Parameters

payload	Span to the desired payload
ranging	Decides whether or not to set the ranging bit in the header
fast	Decides if the data portion is sent at 850kbps or 6.8Mbps

Transmit a given package using the current configuration using a given delayed transmission mode

Parameters

payload	Span to the desired payload
ranging	Decides whether or not to set the ranging bit in the header
fast	Decides if the data portion is sent at 850kbps or 6.8Mbps
time	Either the transmission time or a delay in units of 4ns dependent on the DelayTXMode provided

Warning

This transmission mode does not respect the clear channel assessment

Transmit a given package using the current configuration and a specific command

Parameters

payload	Span to the desired payload
ranging	Decides whether or not to set the ranging bit in the header
fast	Decides if the data portion is sent at 850kbps or 6.8Mbps command

Write a number of bytes to a register bank, useful for TX buffers and other large write transfers