DWM1001 FIRMWARE APPLICATION PROGRAMMING INTERFACE (API) GUIDE
◆DWM1001 module and the firmware The DWM1001 module is a radio transceiver module integrating the Nordic Semiconductor nRF52 MCU and Decawave’s DW1000 IC. The nRF52 MCU, which has Bluetooth v4.2 protocol stack implemented [1], is acting as the main processor of the DWM1001 module. The DW1000 IC part, which has the UWB physical layer defined in IEEE 802.15.4-2011 standard [2], is acting as the UWB radio module controlled by the nRF52 MCU.
Decawave provides a pre-built firmware library, the “Positioning and Networking stack” (PANS) library, in the DWM1001 module which runs on the nRF52 MCU. The firmware provides the Application Programming Interface(API) for users to use their own host devices to communicate with the DWM1001 module, namely the PANS API. The PANS API essentially is a set of functions providing a means to communicate with the nRF52 MCU to drive the module through the PANS library on application level without having to deal with the details of accessing the DW1000 IC part and other peripherals directly through its SPI/I2Cinterface register set. The detailed information of the firmware is introduced in the DWM1001 Firmware User Guide [3].
◆API and its guide
The PANS APIs are a set of functions. Each individual API function may be accessed through various communication interfaces providing flexibility to developers in using the DWM1001 module and integrating it into their systems. The API accesses mainly come in as two types:
◆External access API: via UART, SPI and BLE.
◆Integrated access API: via on-board user app (C code).
Among the above API interfaces:
◆The UART (Generic), the SPI and the on-board APIs are introduced in Sections 5.
◆The UART (Shell) APIs are introduced Section 6.
◆The BLE APIs are introduced in Section 7.
The detailed introduction to the flow with examples of how the API can be used is introduced in [3].
This document, “DWM1001API Guide”, specifies the PANS API functions themselves, providing descriptions of each of the API functions in detail in terms of its parameters, functionality and utility. Users can use the PANS API to configure each individual DWM1001 module. To setup a location system with multiple DWM1001 modules, users should refer to the DWM1001 System Guide [4].
|
|
Application note & Design Guide |
|
|
|
Please see the document for details |
|
|
|
|
|
|
|
English Chinese Chinese and English Japanese |
|
2021/06/05 |
|
Version2.2 |
|
|
|
2.2 MB |
- +1 Like
- Add to Favorites
Recommend
All reproduced articles on this site are for the purpose of conveying more information and clearly indicate the source. If media or individuals who do not want to be reproduced can contact us, which will be deleted.