nuttx/Documentation/platforms/arm/nrf52/boards/nrf52840-dk/index.rst
raiden00pl b3b543e093 arch/nrf52: add initial support for IEEE 802.15.4
Supported features:

- frame transmition
- frame reception and filtering
- immediate ACK (incoming and outgoing)
- promiscuous mode
- delayed transmision
- radio events trace
- setting pending bit for all incoming Data Request frames
- un-slotted CSMA-CA

Work in progres features (some logic is present, but they require more work):

- beacon transmision (periodic transmition works, but requires verification)
- slotted CSMA-CA
- GTS

Fetures not implemented:

- enhanced ACK (Enh-ACK)
- enhanced beacon
- low power mode
- advanced features from IEEE 802.15.4e (DSME, TSCH)

Added examples for boards:

- nrf52832-dk: mrf24j40_6lowpan
- nrf52832-dk: mrf24j40_mac
- nrf52840-dk: ieee802154_6lowpan
- nrf52840-dk: ieee802154_mac
- nrf52840-dongle: ieee802154_mac
- nrf9160-dk-nrf52: ieee802154_6lowpan
- nrf9160-dk-nrf52: ieee802154_mac
2024-02-18 07:40:41 -08:00

158 lines
3.0 KiB
ReStructuredText

===========
nRF52840-DK
===========
The `NRF52840-DK (PCA10056) <https://www.nordicsemi.com/Products/Development-hardware/nRF52840-DK>`_
is a development board for the nRF52840 SoC from Nordic.
Serial Console
==============
The PCA10056 default console is the UART0.
The PCA10056 does not have RS-232 drivers or serial connectors on board.
UART0 is connected to the virtual COM port:
======== =====
Signal PIN
======== =====
UART0-RX P0.08
UART0-TX P0.06
======== =====
LEDs and Buttons
================
LEDs
----
The PCA10056 has 4 user-controllable LEDs:
==== =======
LED MCU
==== =======
LED1 P0.13
LED2 P0.14
LED3 P0.15
LED4 P0.26
==== =======
A low output illuminates the LED.
Pushbuttons
-----------
======= =======
BUTTON MCU
======= =======
BUTTON1 P0.11
BUTTON2 P0.12
BUTTON3 P0.24
BUTTON4 P0.25
======= =======
Configurations
==============
Each configuration is maintained in a sub-directory and can be selected as
follow::
tools/configure.sh nrf52840-dk:<subdir>
Where <subdir> is one of the following:
adc
----
This configuration shows the use of the ADC peripheral.
buttons
-------
This configuration shows the use of the buttons subsystem.
cdcacm
-------
NuttShell configuration with support for CDC/ACM USB device driver.
composite
---------
NuttShell configuration with support for CDC/ACM with RNDIS composite driver.
highpri
-------
This application demonstrates high priority interrupt feature of the NuttX.
nsh
----
Basic NuttShell configuration (console enabled in UART0, exposed via J-Link VCOM connection,
at 115200 bps).
ostest_tickless
---------------
This is a NSH configuration that includes ``apps/testing/ostest`` as a builtin
and enable support for the tick-less OS.
pwm
---
This configuration shows the use of the PWM peripheral.
qspi
----
NuttShell configuration with enabled support for on-board MX25R QSPI memory.
rndis
-----
NuttShell configuration with support for RNDIS USB device driver.
sdc
---
Enables Nordic's SoftDevice controller and uses NuttX BLE stack for the host-layer.
The ``btsak`` application is included as a builtin.
sdc_nimble
----------
Enables Nordic's SoftDevice controller and uses nimBLE for the host-layer.
The ``nimble`` test application can be used to enable a simple GATT server.
sx127x
------
NuttShell configuration with support for sx127x chip.
timer
------
This configuration shows the use of the TIMER peripheral.
usbnsh
------
Basic NuttShell configuration (CDCACM console enabled in USB Port, at 115200 bps).
ieee802154_6lowpan
------------------
Cheat Sheet. Here is a concise summary of all all the steps needed to
run the UDP test (C=Coordinator; E=Endpoint)::
C: nsh> i8 wpan0 startpan cd:ab
C: nsh> i8 set saddr 0A:00
C: nsh> i8 set ep_saddr 0B:00
C: nsh> i8 acceptassoc
E: nsh> i8 wpan0 assoc
C: nsh> ifup wpan0
C: nsh> ifconfig <-- To get the <server-ip>
E: nsh> ifup wpan0
C: nsh> udpserver &
E: nsh> udpclient <server-ip> &