Forth-eV Wiki

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
{{pfw:banner.png}}
====== nRF24L01+ 2.4GHz transceiver ======

The [[https://www.sparkfun.com/datasheets/Components/SMD/nRF24L01Pluss_Preliminary_Product_Specification_v1_0.pdf|nRF24L01+]] is a cheap 2.4GHz transceiver module with a low level part of the communication layer already in hardware available. Features of the nRF24L01+ are, adjustable auto retransmit, RF ACK handshake, a 1 to 32 byte payload with variable length (Dynamic Payload), Fifo of 3 deep, 125 selectable frequencies, adjustable output power, CRC, etc.

**Bidirectional transmit & receive in action on the Egel kit** {{https://user-images.githubusercontent.com/11397265/154851672-ad18f3f9-d11a-442c-b3bd-ba4cf5b9e943.jpg|nRF24 bidirectional test}}


===== Software =====

  * [[en:pfw:spi_msp430_noforth_uscib_spi_msp_v100.f|USCIB SPI MSP v100.f]]**, SPI driver for MSP430G2553 (Github: [[https://raw.githubusercontent.com/project-forth-works/project-forth-works/main/Communication-Protocols/SPI/MSP430/noForth/USCIB%20SPI%20MSP%20v100.f|USCIB SPI MSP v100.f]]**)
  * [[en:pfw:wireless_nrf24l01_basic_24l01dn_g2553-01a.f|Basic 24L01dn G2553-01.f]],  Basic transceiver routines using 'Dynamic payloads' (Github: **[[https://github.com/project-forth-works/project-forth-works/blob/main/Communication-Protocols/Wireless-Communication/nRf24L01%2B/basic%2024L01dn%20G2553-01a.f|Basic 24L01dn G2553-01.f]]**)
  * [[en:pfw:wireless_nrf24l01_transmit_test.f|Transmit test.f]], Transmit command, receive & display data (Github: **[[https://github.com/project-forth-works/project-forth-works/blob/main/Communication-Protocols/Wireless-Communication/nRf24L01%2B/Transmit%20test.f|Transmit test.f]]**)\\
  * [[en:pfw:wireless_nrf24l01_receive_test.f|Receive test.f]], On command increase a counter and sent data back (Github: **[[https://github.com/project-forth-works/project-forth-works/blob/main/Communication-Protocols/Wireless-Communication/nRf24L01%2B/Receive%20test.f|Receive test.f]]**)\\
  * [[en:pfw:wireless_nrf24l01_rangechecker_g2553_usci.f|Range checker G2553 usci.f]], Tools to help testing the range & placement of the transceivers (Github: **[[https://github.com/project-forth-works/project-forth-works/blob/main/Communication-Protocols/Wireless-Communication/nRf24L01%2B/Range%20checker%20G2553%20usci.f|Range checker G2553 usci.f]]**)\\
  * [[en:pfw:wireless_nrf24l01_msp430|MSP430]], implementation(s) of a nRF24L01+ driver for MSP430 (Github: **[[https://github.com/project-forth-works/project-forth-works/blob/main/Communication-Protocols/Wireless-Communication/nRf24L01%2B/MSP430|MSP430]]**)\\
  * [[en:pfw:wireless_nrf24l01_gd32vf|GD32VF]], implementation(s) of a nRF24L01+ driver for GD32VF103 (Github: **[[https://github.com/project-forth-works/project-forth-works/blob/main/Communication-Protocols/Wireless-Communication/nRf24L01%2B/GD32VF|GD32VF]]**)

==== File load order for a test ====

  * SPI driver for your MPU on two boards
  * Adapted version of: **basic 24L01dn G2553-01a.f** file on two boards
  * One MPU board with: **Transmit test.f** [[#bidirectional-demo|See demo commands]]
  * And one MPU board with: **Receive test.f**

Load the **Range checker G2553 usci.f** on the boards when you want to check out busy channels or the placing of transceivers.\\
See [[#range&disturbance-test|here for a description]] of the words.

===== Basic nRF24L01+ commands =====

^Command           ^Stack         ^Function                                              ^
|''%%SPI-SETUP%%'' |( -- )        |Activate whole nRF24 SPI interface                    |
|''%%SETUP24L01%%''|( -- )        |Initialise nRF24l01                                   |
|''%%TRON%%''      |( -- )        |Tracer active                                         |
|''%%TROFF%%''     |( -- )        |Tracer inactive                                       |
|''%%>RF%%''       |( db rate -- )|Set transmit strength & bitrate                       |
|''%%>LENGTH%%''   |( +n -- )     |Set size of current payload                           |
|''%%>PAY%%''      |( b +n -- )   |Store byte b at location +n of the payload            |
|''%%PAY>%%''      |( +n -- b )   |Read byte b from location +n of the payload           |
|''%%IRQ?%%''      |( -- flag )   |Leave true when an nRF24 interrupt has gone off       |
|''%%RESPONSE?%%'' |( -- flag )   |Wait a bit, exit & leave true when an IRQ was received|
|''%%CE-HIGH%%''   |( -- )        |nRF24 to transmit modus                               |
|''%%CE-LOW%%''    |( -- )        |nRF24 to receive or standby modus                     |
|''%%XEMIT?%%''    |( c -- +n )   |Send byte c, +n are the transmit retries (max=10)     |
|''%%XEMIT%%''     |( c -- )      |Send byte c to addressed nRF24                        |
|''%%XKEY%%''      |( -- c )      |Receive byte c that is addressed to me                |
|''%%SET-DEST%%''  |( +n -- )     |Set address of destination nRF24 to +n                |

<html><a name="bidirectional-demo"></html><html></a></html>

==== Bidirectional demo commands ====

^Command          ^Stack    ^Function                                              ^
|''%%TRANSMIT1%%''|( +n -- )|Send a ''%%T%%'' every +n milliseconds, display answer|
|''%%TEST1%%''    |( -- )   |Send a ''%%T%%'' every 50 milliseconds, display answer|
|''%%RECEIVER%%'' |( -- )   |Receive command, incr. counter & send it back         |

<html><a name="range&disturbance-test"></html><html></a></html>

==== Range & disturbance test commands ====

^Command        ^Stack          ^Function                                                          ^
|''%%CHECK%%''  |( -- )         |Check all available frequency channels                            |
|''%%CARRIER%%''|( +n -- )      |Check only frequency channel +n                                   |
|''%%WAVE%%''   |( +n pwr -- )  |Send carrier on channel +n with strength pwr                      |
|''%%PULSE%%''  |( +n pwr p -- )|Send carrier on channel +n with strength pwr in p millisec. pulses|


----

==== Bidirectional transmit & receive test in action ====

{{https://user-images.githubusercontent.com/11397265/154994487-bffd043c-1e07-403d-8e72-6fbb5ada894f.mp4}}

A self constructing mesh network can be found [[https://github.com/project-forth-works/project-forth-works/blob/main/Communication-Protocols/Wireless-Communication/Mesh-network|here]].