nrf24l01p.h
Go to the documentation of this file.
1 /*
2  * Copyright (C) 2014 Hamburg University of Applied Sciences
3  *
4  * This file is subject to the terms and conditions of the GNU Lesser General
5  * Public License v2.1. See the file LICENSE in the top level directory for more
6  * details.
7  */
8 
23 #ifndef NRF24L01P_H
24 #define NRF24L01P_H
25 
26 #ifdef __cplusplus
27 extern "C" {
28 #endif
29 
30 #include <stdint.h>
31 #include <stdio.h>
32 #include "periph/gpio.h"
33 #include "periph/spi.h"
34 
38 typedef struct {
40  gpio_t ce;
41  gpio_t cs;
42  gpio_t irq;
43  unsigned listener;
44 } nrf24l01p_t;
45 
49 typedef enum {
54 
55 
59 typedef enum {
64 
68 typedef enum {
74 
78 typedef enum {
86 
90 typedef enum {
94 
99 typedef enum {
117 
121 typedef enum {
124 
125 
136 int nrf24l01p_read_reg(const nrf24l01p_t *dev, char reg, char *answer);
137 
148 int nrf24l01p_write_reg(const nrf24l01p_t *dev, char reg, char write);
149 
165 int nrf24l01p_init(nrf24l01p_t *dev, spi_t spi, gpio_t ce, gpio_t csn, gpio_t irq);
166 
175 int nrf24l01p_on(const nrf24l01p_t *dev);
176 
185 int nrf24l01p_off(const nrf24l01p_t *dev);
186 
193 void nrf24l01p_transmit(const nrf24l01p_t *dev);
194 
205 int nrf24l01p_read_payload(const nrf24l01p_t *dev, char *answer, unsigned int size);
206 
214 void nrf24l01p_register(nrf24l01p_t *dev, unsigned int *pid);
215 
226 
236 
246 int nrf24l01p_unregister(nrf24l01p_t *dev, unsigned int pid);
247 
255 void nrf24l01p_get_id(const nrf24l01p_t *dev, unsigned int *pid);
256 
263 void nrf24l01p_start(const nrf24l01p_t *dev);
264 
271 void nrf24l01p_stop(const nrf24l01p_t *dev);
272 
283 int nrf24l01p_preload(const nrf24l01p_t *dev, char *data, unsigned int size);
284 
298 int nrf24l01p_set_channel(const nrf24l01p_t *dev, uint8_t chan);
299 
310 
326  nrf24l01p_rx_pipe_t pipe, uint8_t width);
327 
343 int nrf24l01p_set_tx_address(const nrf24l01p_t *dev, const uint8_t *saddr, unsigned int length);
344 
355 int nrf24l01p_set_tx_address_long(const nrf24l01p_t *dev, uint64_t saddr, unsigned int length);
356 
373 int nrf24l01p_set_rx_address(const nrf24l01p_t *dev, nrf24l01p_rx_pipe_t pipe, const uint8_t *saddr, unsigned int length);
374 
386 int nrf24l01p_set_rx_address_long(const nrf24l01p_t *dev, nrf24l01p_rx_pipe_t pipe, uint64_t saddr, unsigned int length);
387 
396 uint64_t nrf24l01p_get_tx_address_long(const nrf24l01p_t *dev);
397 
408 
422 
430 int nrf24l01p_get_status(const nrf24l01p_t *dev);
431 
444 int nrf24l01p_set_power(const nrf24l01p_t *dev, int pwr);
445 
453 int nrf24l01p_get_power(const nrf24l01p_t *dev);
454 
463 int nrf24l01p_set_txmode(const nrf24l01p_t *dev);
464 
473 int nrf24l01p_set_rxmode(const nrf24l01p_t *dev);
474 
484 
494 int nrf24l01p_reset_interrupts(const nrf24l01p_t *dev, char intrs);
495 
510 int nrf24l01p_mask_interrupt(const nrf24l01p_t *dev, char intr);
511 
526 int nrf24l01p_unmask_interrupt(const nrf24l01p_t *dev, char intr);
527 
538 
549 
557 int nrf24l01p_disable_crc(const nrf24l01p_t *dev);
558 
569 
586 int nrf24l01p_setup_auto_ack(const nrf24l01p_t *dev, nrf24l01p_rx_pipe_t pipe, nrf24l01p_retransmit_delay_t delay_retrans, char count_retrans);
587 
597 
606 int nrf24l01p_flush_tx_fifo(const nrf24l01p_t *dev);
607 
616 int nrf24l01p_flush_rx_fifo(const nrf24l01p_t *dev);
617 
624 void nrf24l01p_rx_cb(void *arg);
625 
626 #ifdef __cplusplus
627 }
628 #endif
629 
630 #endif /* NRF24L01P_H */
631 
nrf24l01p_retransmit_delay_t
nrf24l01p_retransmit_delay_t
Defines the automatic retransmission delay defined from end of transmission to start of next treansmi...
Definition: nrf24l01p.h:99
nrf24l01p_init
int nrf24l01p_init(nrf24l01p_t *dev, spi_t spi, gpio_t ce, gpio_t csn, gpio_t irq)
Initialize the nrf24l01+ transceiver.
nrf24l01p_stop
void nrf24l01p_stop(const nrf24l01p_t *dev)
Stop searching packets while in RX mode.
NRF24L01P_RETR_4000US
@ NRF24L01P_RETR_4000US
retransmit delay is 4000us
Definition: nrf24l01p.h:115
nrf24l01p_set_rxmode
int nrf24l01p_set_rxmode(const nrf24l01p_t *dev)
Set the nrf24l01+ into RX mode.
nrf24l01p_crc_t
nrf24l01p_crc_t
Defines the error detection encoding scheme for the nrf24l01p transceiver.
Definition: nrf24l01p.h:90
nrf24l01p_dr_t
nrf24l01p_dr_t
Defines the RF datarate.
Definition: nrf24l01p.h:59
nrf24l01p_start
void nrf24l01p_start(const nrf24l01p_t *dev)
Start searching packets while in RX mode.
nrf24l01p_get_tx_address_long
uint64_t nrf24l01p_get_tx_address_long(const nrf24l01p_t *dev)
Get the TX address for the nrf24l01+ transceiver (long int).
NRF24L01P_RETR_1500US
@ NRF24L01P_RETR_1500US
retransmit delay is 1500us
Definition: nrf24l01p.h:105
nrf24l01p_set_rx_address_long
int nrf24l01p_set_rx_address_long(const nrf24l01p_t *dev, nrf24l01p_rx_pipe_t pipe, uint64_t saddr, unsigned int length)
Set the RX address for the nrf24l01+ transceiver (long int).
nrf24l01p_set_channel
int nrf24l01p_set_channel(const nrf24l01p_t *dev, uint8_t chan)
Set the RF channel for the nrf24l01+ transceiver.
nrf24l01p_pwr_t
nrf24l01p_pwr_t
Defines the RF power level.
Definition: nrf24l01p.h:68
nrf24l01p_set_rx_address
int nrf24l01p_set_rx_address(const nrf24l01p_t *dev, nrf24l01p_rx_pipe_t pipe, const uint8_t *saddr, unsigned int length)
Set the RX address for the nrf24l01+ transceiver (byte array).
NRF24L01P_RETR_1750US
@ NRF24L01P_RETR_1750US
retransmit delay is 1750us
Definition: nrf24l01p.h:106
nrf24l01p_rx_event_t
nrf24l01p_rx_event_t
Defines states for the nrf24l01+ transceiver.
Definition: nrf24l01p.h:121
nrf24l01p_t::cs
gpio_t cs
GPIO pin to initialize as chip select.
Definition: nrf24l01p.h:41
spi.h
Low-level SPI peripheral driver interface definition.
NRF24L01P_RETR_2000US
@ NRF24L01P_RETR_2000US
retransmit delay is 2000us
Definition: nrf24l01p.h:107
nrf24l01p_unmask_interrupt
int nrf24l01p_unmask_interrupt(const nrf24l01p_t *dev, char intr)
Unmask one interrupt on the nrf24l01+ transceiver.
NRF24L01P_PWR_N18DBM
@ NRF24L01P_PWR_N18DBM
power is -18dBm
Definition: nrf24l01p.h:69
nrf24l01p_mask_interrupt
int nrf24l01p_mask_interrupt(const nrf24l01p_t *dev, char intr)
Mask one interrupt on the nrf24l01+ transceiver.
nrf24l01p_transmit
void nrf24l01p_transmit(const nrf24l01p_t *dev)
Transmit payload laying in TX FIFO of the nrf24l01+ transceiver.
NRF24L01P_DR_250KBS
@ NRF24L01P_DR_250KBS
datarate is 250 kbps
Definition: nrf24l01p.h:60
nrf24l01p_enable_pipe
int nrf24l01p_enable_pipe(const nrf24l01p_t *dev, nrf24l01p_rx_pipe_t pipe)
Enable RX datapipe on the nrf24l01+ transceiver.
nrf24l01p_set_tx_address
int nrf24l01p_set_tx_address(const nrf24l01p_t *dev, const uint8_t *saddr, unsigned int length)
Set the TX address for the nrf24l01+ transceiver (byte array).
NRF24L01P_RETR_3000US
@ NRF24L01P_RETR_3000US
retransmit delay is 3000us
Definition: nrf24l01p.h:111
NRF24L01P_RETR_1000US
@ NRF24L01P_RETR_1000US
retransmit delay is 1000us
Definition: nrf24l01p.h:103
nrf24l01p_get_power
int nrf24l01p_get_power(const nrf24l01p_t *dev)
Get the transmit power for the nrf24l01+ transceiver device.
nrf24l01p_read_payload
int nrf24l01p_read_payload(const nrf24l01p_t *dev, char *answer, unsigned int size)
Read payload from RX FIFO of the nrf24l01+ transceiver.
nrf24l01p_reset_interrupts
int nrf24l01p_reset_interrupts(const nrf24l01p_t *dev, char intrs)
Reset interrupts on the nrf24l01+ transceiver.
NRF24L01P_PIPE4
@ NRF24L01P_PIPE4
RX pipe 4.
Definition: nrf24l01p.h:83
nrf24l01p_setup_auto_ack
int nrf24l01p_setup_auto_ack(const nrf24l01p_t *dev, nrf24l01p_rx_pipe_t pipe, nrf24l01p_retransmit_delay_t delay_retrans, char count_retrans)
Setup and enable automatic ACK and retransmission on the nrf24l01+ transceiver.
NRF24L01P_AW_5BYTE
@ NRF24L01P_AW_5BYTE
address width is 5 Byte
Definition: nrf24l01p.h:52
NRF24L01P_RETR_2750US
@ NRF24L01P_RETR_2750US
retransmit delay is 2750us
Definition: nrf24l01p.h:110
NRF24L01P_PIPE2
@ NRF24L01P_PIPE2
RX pipe 2.
Definition: nrf24l01p.h:81
nrf24l01p_reset_all_interrupts
int nrf24l01p_reset_all_interrupts(const nrf24l01p_t *dev)
Reset all interrupts on the nrf24l01+ transceiver.
NRF24L01P_PIPE3
@ NRF24L01P_PIPE3
RX pipe 3.
Definition: nrf24l01p.h:82
nrf24l01p_enable_dynamic_ack
int nrf24l01p_enable_dynamic_ack(const nrf24l01p_t *dev)
Enable dynamic ack for the nrf24l01+ transceiver.
RCV_PKT_NRF24L01P
@ RCV_PKT_NRF24L01P
transceiver received data
Definition: nrf24l01p.h:122
NRF24L01P_RETR_1250US
@ NRF24L01P_RETR_1250US
retransmit delay is 1250us
Definition: nrf24l01p.h:104
nrf24l01p_flush_tx_fifo
int nrf24l01p_flush_tx_fifo(const nrf24l01p_t *dev)
Flush TX FIFO on the nrf24l01+ transceiver.
NRF24L01P_CRC_1BYTE
@ NRF24L01P_CRC_1BYTE
encoding scheme generates 1 Byte redundancy
Definition: nrf24l01p.h:91
NRF24L01P_RETR_3750US
@ NRF24L01P_RETR_3750US
retransmit delay is 3750us
Definition: nrf24l01p.h:114
nrf24l01p_off
int nrf24l01p_off(const nrf24l01p_t *dev)
Power off the nrf24l01+ transceiver.
nrf24l01p_flush_rx_fifo
int nrf24l01p_flush_rx_fifo(const nrf24l01p_t *dev)
Flush RX FIFO on the nrf24l01+ transceiver.
nrf24l01p_disable_crc
int nrf24l01p_disable_crc(const nrf24l01p_t *dev)
Disable CRC error detection on the nrf24l01+ transceiver.
NRF24L01P_AW_3BYTE
@ NRF24L01P_AW_3BYTE
address width is 3 Byte
Definition: nrf24l01p.h:50
NRF24L01P_RETR_2250US
@ NRF24L01P_RETR_2250US
retransmit delay is 2250us
Definition: nrf24l01p.h:108
NRF24L01P_RETR_500US
@ NRF24L01P_RETR_500US
retransmit delay is 500us
Definition: nrf24l01p.h:101
NRF24L01P_PIPE1
@ NRF24L01P_PIPE1
RX pipe 1.
Definition: nrf24l01p.h:80
NRF24L01P_PWR_0DBM
@ NRF24L01P_PWR_0DBM
power is 0dBm
Definition: nrf24l01p.h:72
nrf24l01p_rx_cb
void nrf24l01p_rx_cb(void *arg)
Callback that is called when interrupt occurs on interrupt pin from the nrf24l01+ transceiver.
nrf24l01p_get_status
int nrf24l01p_get_status(const nrf24l01p_t *dev)
Get the status (register) of the nrf24l01+ transceiver device.
nrf24l01p_rx_pipe_t
nrf24l01p_rx_pipe_t
Defines the datapipe on which the receiver searches for packets.
Definition: nrf24l01p.h:78
NRF24L01P_RETR_3500US
@ NRF24L01P_RETR_3500US
retransmit delay is 3500us
Definition: nrf24l01p.h:113
NRF24L01P_AW_4BYTE
@ NRF24L01P_AW_4BYTE
address width is 4 Byte
Definition: nrf24l01p.h:51
NRF24L01P_RETR_3250US
@ NRF24L01P_RETR_3250US
retransmit delay is 3250us
Definition: nrf24l01p.h:112
nrf24l01p_set_tx_address_long
int nrf24l01p_set_tx_address_long(const nrf24l01p_t *dev, uint64_t saddr, unsigned int length)
Set the TX address for the nrf24l01+ transceiver (long int).
NRF24L01P_CRC_2BYTE
@ NRF24L01P_CRC_2BYTE
encoding scheme generates 2 Bytes redundancy
Definition: nrf24l01p.h:92
NRF24L01P_RETR_750US
@ NRF24L01P_RETR_750US
retransmit delay is 750us
Definition: nrf24l01p.h:102
nrf24l01p_t
Structure that represents the hardware setup of the nrf24l01+ transceiver.
Definition: nrf24l01p.h:38
nrf24l01p_disable_pipe
int nrf24l01p_disable_pipe(const nrf24l01p_t *dev, nrf24l01p_rx_pipe_t pipe)
Disable RX datapipe on the nrf24l01+ transceiver.
nrf24l01p_get_rx_address_long
uint64_t nrf24l01p_get_rx_address_long(const nrf24l01p_t *dev, nrf24l01p_rx_pipe_t pipe)
Get the RX address for the nrf24l01+ transceiver (long int).
nrf24l01p_set_datarate
int nrf24l01p_set_datarate(const nrf24l01p_t *dev, nrf24l01p_dr_t dr)
Get the TX address for the nrf24l01+ transceiver (long int).
nrf24l01p_disable_all_auto_ack
int nrf24l01p_disable_all_auto_ack(const nrf24l01p_t *dev)
Disable automatic ACK on the nrf24l01+ transceiver.
NRF24L01P_PIPE5
@ NRF24L01P_PIPE5
RX pipe 5.
Definition: nrf24l01p.h:84
NRF24L01P_PWR_N12DBM
@ NRF24L01P_PWR_N12DBM
power is -12dBm
Definition: nrf24l01p.h:70
nrf24l01p_enable_crc
int nrf24l01p_enable_crc(const nrf24l01p_t *dev, nrf24l01p_crc_t crc)
Enable CRC error detection on the nrf24l01+ transceiver.
nrf24l01p_read_reg
int nrf24l01p_read_reg(const nrf24l01p_t *dev, char reg, char *answer)
Read one register of the nrf24l01+ transceiver.
nrf24l01p_aw_t
nrf24l01p_aw_t
Defines the address width of the nrf24l01+ transceiver.
Definition: nrf24l01p.h:49
NRF24L01P_PIPE0
@ NRF24L01P_PIPE0
RX pipe 0.
Definition: nrf24l01p.h:79
nrf24l01p_preload
int nrf24l01p_preload(const nrf24l01p_t *dev, char *data, unsigned int size)
Preload TX FIFO with payload to transmit.
gpio.h
Low-level GPIO peripheral driver interface definitions.
nrf24l01p_unregister
int nrf24l01p_unregister(nrf24l01p_t *dev, unsigned int pid)
Unregister the nrf24l01+ transceiver from his ID.
nrf24l01p_set_power
int nrf24l01p_set_power(const nrf24l01p_t *dev, int pwr)
Set the transmit power for the nrf24l01+ transceiver device.
nrf24l01p_write_reg
int nrf24l01p_write_reg(const nrf24l01p_t *dev, char reg, char write)
Write one register to the nrf24l01+ transceiver.
NRF24L01P_RETR_250US
@ NRF24L01P_RETR_250US
retransmit delay is 250us
Definition: nrf24l01p.h:100
nrf24l01p_get_id
void nrf24l01p_get_id(const nrf24l01p_t *dev, unsigned int *pid)
Get ID from the nrf24l01p transceiver.
nrf24l01p_t::ce
gpio_t ce
GPIO pin to initialize as chip enable.
Definition: nrf24l01p.h:40
nrf24l01p_set_txmode
int nrf24l01p_set_txmode(const nrf24l01p_t *dev)
Set the nrf24l01+ into TX mode.
NRF24L01P_PWR_N6DBM
@ NRF24L01P_PWR_N6DBM
power is - 6dBm
Definition: nrf24l01p.h:71
nrf24l01p_t::listener
unsigned listener
Place to store an ID in.
Definition: nrf24l01p.h:43
NRF24L01P_DR_1MBS
@ NRF24L01P_DR_1MBS
datarate is 1 Mbps
Definition: nrf24l01p.h:61
nrf24l01p_on
int nrf24l01p_on(const nrf24l01p_t *dev)
Power on the nrf24l01+ transceiver.
nrf24l01p_set_address_width
int nrf24l01p_set_address_width(const nrf24l01p_t *dev, nrf24l01p_aw_t aw)
Set the address width for the nrf24l01+ transceiver.
NRF24L01P_DR_2MBS
@ NRF24L01P_DR_2MBS
datarate is 2 Mbps
Definition: nrf24l01p.h:62
nrf24l01p_set_payload_width
int nrf24l01p_set_payload_width(const nrf24l01p_t *dev, nrf24l01p_rx_pipe_t pipe, uint8_t width)
Set the RX payload width for the nrf24l01+ transceiver.
nrf24l01p_t::spi
spi_t spi
SPI device to initialize.
Definition: nrf24l01p.h:39
spi_t
unsigned int spi_t
Default type for SPI devices.
Definition: spi.h:118
NRF24L01P_RETR_2500US
@ NRF24L01P_RETR_2500US
retransmit delay is 2500us
Definition: nrf24l01p.h:109
nrf24l01p_register
void nrf24l01p_register(nrf24l01p_t *dev, unsigned int *pid)
Register a given ID to the nrf24l01+ transceiver.
nrf24l01p_enable_dynamic_payload
int nrf24l01p_enable_dynamic_payload(const nrf24l01p_t *dev, nrf24l01p_rx_pipe_t pipe)
Enable dynamic payload for the pipe on give nrf24l01+ transceiver.
nrf24l01p_t::irq
gpio_t irq
GPIO pin to initialize as interrupt request.
Definition: nrf24l01p.h:42