nanoFramework.Iot.Device.Nrf24l01 1.2.297

Prefix Reserved
There is a newer version of this package available.
See the version list below for details.
dotnet add package nanoFramework.Iot.Device.Nrf24l01 --version 1.2.297                
NuGet\Install-Package nanoFramework.Iot.Device.Nrf24l01 -Version 1.2.297                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="nanoFramework.Iot.Device.Nrf24l01" Version="1.2.297" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add nanoFramework.Iot.Device.Nrf24l01 --version 1.2.297                
#r "nuget: nanoFramework.Iot.Device.Nrf24l01, 1.2.297"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install nanoFramework.Iot.Device.Nrf24l01 as a Cake Addin
#addin nuget:?package=nanoFramework.Iot.Device.Nrf24l01&version=1.2.297

// Install nanoFramework.Iot.Device.Nrf24l01 as a Cake Tool
#tool nuget:?package=nanoFramework.Iot.Device.Nrf24l01&version=1.2.297                

nRF24L01 - Single Chip 2.4 GHz Transceiver

The nRF24L01 is a single chip radio transceiver for the world wide 2.4 - 2.5 GHz ISM band.

Documentation

  • The bindging datasheet can be found here

Board

Sensor picture

Note: the following diagram uses a Raspberry Pi. This can be achieved with any MCU having 2 available SPI.

Connection Diagram

Usage

Hardware Required

  • nRF24L01 × 2
  • Male/Female Jumper Wires

Connection for nRF1

  • VCC - 3.3V (Best)
  • GND - GND
  • MOSI - SPI0 MOSI (GPIO 10)
  • MISO - SPI0 MISO (GPIO 9)
  • SCK - SPI0 SCLK (GPIO 11)
  • CSN - SPI0 CS0 (GPIO 8)
  • CE - GPIO 23
  • IRQ - GPIO 24

Connection for nRF2

  • VCC - 3.3V (Best)
  • GND - GND
  • MOSI - SPI1 MOSI (GPIO 20)
  • MISO - SPI1 MISO (GPIO 19)
  • SCK - SPI1 SCLK (GPIO 21)
  • CSN - SPI1 CS0 (GPIO 16)
  • CE - GPIO 5
  • IRQ - GPIO 6

Code

Important: make sure you properly setup the SPI pins especially for ESP32 before creating the SpiDevice, make sure you install the nanoFramework.Hardware.ESP32 nuget:

//////////////////////////////////////////////////////////////////////
// when connecting to an ESP32 device, need to configure the SPI GPIOs
// used for the bus
Configuration.SetPinFunction(21, DeviceFunction.SPI1_MOSI);
Configuration.SetPinFunction(22, DeviceFunction.SPI1_MISO);
Configuration.SetPinFunction(23, DeviceFunction.SPI1_CLOCK);
// Make sure as well you are using the right chip select

For other devices like STM32, please make sure you're using the preset pins for the SPI bus you want to use. The chip select can as well be pre setup.


SpiConnectionSettings senderSettings = new SpiConnectionSettings(1, 42)
{
    ClockFrequency = Nrf24l01.SpiClockFrequency,
    Mode = Nrf24l01.SpiMode
};

SpiConnectionSettings receiverSettings = new SpiConnectionSettings(2, 44)
{
    ClockFrequency = Nrf24l01.SpiClockFrequency,
    Mode = Nrf24l01.SpiMode
};
var senderDevice = SpiDevice.Create(senderSettings);
var receiverDevice = SpiDevice.Create(receiverSettings);

// SPI Device, CE Pin, IRQ Pin, Receive Packet Size
using (Nrf24l01 sender = new Nrf24l01(senderDevice, 23, 24, 20))
{
    using (Nrf24l01 receiver = new Nrf24l01(receiverDevice, 5, 6, 20))
    {
        // Set sender send address, receiver pipe0 address (Optional)
        byte[] receiverAddress = Encoding.UTF8.GetBytes("NRF24");
        sender.Address = receiverAddress;
        receiver.Pipe0.Address = receiverAddress;

        // Binding DataReceived event
        receiver.DataReceived += Receiver_ReceivedData;

        // Loop
        while (true)
        {
            sender.Send(Encoding.UTF8.GetBytes("Hello! .NET Core IoT"));

            Thread.Sleep(2000);
        }
    }
}

private static void Receiver_ReceivedData(object sender, DataReceivedEventArgs e)
{
    var raw = e.Data;
    var msg = Encoding.UTF8.GetString(raw);

    Debug.Write("Received Raw Data: ");
    foreach (var item in raw)
    {
        Debug.Write($"{item} ");
    }
    Debug.WriteLine();

    Debug.WriteLine($"Message: {msg}");
    Debug.WriteLine();
}

Result

Sample result

Product Compatible and additional computed target framework versions.
.NET Framework net is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.2.631 76 8/28/2024
1.2.570 85 6/14/2024
1.2.560 87 5/29/2024
1.2.548 53 5/15/2024
1.2.436 236 11/10/2023
1.2.329 154 5/26/2023
1.2.313 133 5/12/2023
1.2.297 140 5/3/2023
1.2.203 308 12/28/2022
1.2.141 394 10/25/2022
1.2.122 406 10/12/2022
1.2.114 349 10/8/2022
1.2.95 430 9/22/2022
1.2.87 485 9/15/2022
1.2.73 398 9/8/2022
1.2.5 420 7/13/2022
1.1.141.41205 431 7/6/2022
1.1.113.2032 424 6/23/2022
1.1.58.10097 420 5/23/2022
1.1.27 418 4/26/2022
1.1.20 426 4/21/2022
1.1.1 434 4/14/2022
1.0.300 411 4/1/2022
1.0.277-preview.125 117 3/25/2022
1.0.277-preview.111 112 3/18/2022
1.0.277-preview.106 116 3/15/2022
1.0.277-preview.98 122 3/8/2022
1.0.277-preview.85 115 2/25/2022
1.0.277-preview.77 110 2/18/2022
1.0.277-preview.68 118 2/9/2022
1.0.277-preview.60 132 2/4/2022
1.0.277-preview.41 130 1/28/2022
1.0.277-preview.32 129 1/27/2022
1.0.277-preview.17 132 1/24/2022
1.0.277-preview.15 120 1/21/2022
1.0.277-preview.1 126 1/11/2022
1.0.259 278 12/9/2021
1.0.221 150 10/19/2021
1.0.219 165 10/19/2021
1.0.218 191 10/18/2021
1.0.155 159 8/31/2021
1.0.136 237 7/17/2021
1.0.135 159 7/16/2021
1.0.134 164 7/15/2021
1.0.133 194 7/14/2021
1.0.129 157 7/6/2021
1.0.125 190 7/5/2021
1.0.121 193 6/29/2021
1.0.119 223 6/28/2021
1.0.58 208 5/25/2021