NRF24L01 Class Reference

API for the NRF24L01 Transceiver Module. More...

Detailed Description

• ID: nrf24l01
• Name: NRF24L01 Transceiver
• Category: wifi
• Manufacturer: seeed sparkfun
• Link: http://www.seeedstudio.com/depot/nRF24L01Module-p-1394.html
• Connection: spi

id This module defines the NRF24L01 interface for libnrf24l01

void nrf_handler () {
    std::cout << "Reciever :: " << *((uint32_t *)&(comm->m_rxBuffer[0])) << std::endl;
}

int
main(int argc, char **argv)
{

    comm = new upm::NRF24L01(7, 8);
    comm->setSourceAddress ((uint8_t *) local_address);
    comm->setDestinationAddress ((uint8_t *) broadcast_address);
    comm->setPayload (MAX_BUFFER);
    comm->configure ();
    comm->setSpeedRate (upm::NRF_250KBPS);
    comm->setChannel (99);
    comm->setDataReceivedHandler (nrf_handler);

    signal(SIGINT, sig_handler);

    while (!running) {
        comm->pollListener ();
    }

    std::cout << "exiting application" << std::endl;

    delete comm;
    return 0;
}

    uint32_t dummyData = 0;
    comm = new upm::NRF24L01(7, 8);
    comm->setSourceAddress ((uint8_t *) srcAddress);
    comm->setDestinationAddress ((uint8_t *) destAddress);
    comm->setPayload (MAX_BUFFER);
    comm->setChannel (99);
    comm->configure ();
    comm->setDataReceivedHandler (nrf_handler);

    signal(SIGINT, sig_handler);

    while (!running) {
        memcpy (comm->m_txBuffer, &dummyData, sizeof (dummyData));
        comm->send ();
        std::cout << "devi2 :: sending data ...." << dummyData << std::endl;
        usleep (3000000);
        dummyData += 3000;
    }

    std::cout << "exiting application" << std::endl;

    delete comm;

    sensor = new upm::NRF24L01(7, 8);
    sensor->setBeaconingMode ();

    std::vector<std::string> msgs;

    msgs.push_back ("Hello World 1!!!");
    msgs.push_back ("Hello World 2!!!");
    msgs.push_back ("Hello World 3!!!");
    msgs.push_back ("Hello World 4!!!");
    msgs.push_back ("Hello World 5!!!");

    signal(SIGINT, sig_handler);

    while (!running) {
        for (std::vector<std::string>::iterator item = msgs.begin(); item != msgs.end(); ++item) {
            std::cout << "BROADCASTING " << (*item).c_str() << std::endl;

            for (int i = 0; i < 3; i++) {
                sensor->sendBeaconingMsg ((uint8_t*) (*item).c_str());
                usleep (1000000);
            }
        }
    }

    std::cout << "exiting application" << std::endl;

    msgs.clear();
    delete sensor;

Public Member Functions
	NRF24L01 (uint8_t cs, uint8_t ce)
std::string	name ()
void	init (uint8_t chipSelect, uint8_t chipEnable)
void	configure ()
void	send (uint8_t *value)
void	send ()
void	setSourceAddress (uint8_t *addr)
void	setDestinationAddress (uint8_t *addr)
void	setBroadcastAddress (uint8_t *addr)
void	setPayload (uint8_t load)
void	setDataReceivedHandler (funcPtrVoidVoid handler)
bool	dataReady ()
bool	dataSending ()
void	getData (uint8_t *data)
uint8_t	getStatus ()
bool	rxFifoEmpty ()
void	rxPowerUp ()
void	rxFlushBuffer ()
void	txPowerUp ()
void	powerDown ()
void	setChannel (uint8_t channel)
void	setPower (power_t power)
uint8_t	setSpeedRate (speed_rate_t rate)
void	txFlushBuffer ()
void	pollListener ()
mraa::Result	ceHigh ()
mraa::Result	ceLow ()
mraa::Result	csOn ()
mraa::Result	csOff ()
void	setBeaconingMode ()
void	sendBeaconingMsg (uint8_t *msg)

Data Fields
uint8_t	m_rxBuffer [MAX_BUFFER]
uint8_t	m_txBuffer [MAX_BUFFER]
uint8_t	m_bleBuffer [32]

Constructor & Destructor Documentation

NRF24L01	(	uint8_t	cs,
		uint8_t	ce
	)

Instantiates an NRF24l01 object

Parameters

cs	Chip select pin

Here is the call graph for this function:

Member Function Documentation

std::string name ( )

inline

Returns the name of the component

void init	(	uint8_t	chipSelect,
		uint8_t	chipEnable
	)

Initializes needed GPIO pins and SPI

Parameters

chipSelect	Sets up the chip select pin
chipEnable	Sets up the chip enable pin

Here is the call graph for this function:

Here is the caller graph for this function:

void configure

(

)

Configures the NRF24L01 transceiver

Here is the call graph for this function:

void send

(

uint8_t *

value

)

Sends the buffer data

Parameters

*value

Pointer to the buffer

Here is the call graph for this function:

void send

(

)

Sends the data located in an inner bufer; the user must fill the m_txBuffer buffer

void setSourceAddress

(

uint8_t *

addr

)

Sets a receiving address of the device

Parameters

addr	5-byte address

Here is the call graph for this function:

void setDestinationAddress

(

uint8_t *

addr

)

Sets a recipient address. The nrfSend method sends the data buffer to this address

Parameters

addr	5-byte address

void setBroadcastAddress

(

uint8_t *

addr

)

Sets a broadcasting address

Parameters

addr	5-byte address

void setPayload

(

uint8_t

load

)

Sets the payload size

Parameters

load	Size of the payload (MAX 32)

void setDataReceivedHandler

(

funcPtrVoidVoid

handler

)

Sets the handler to be called when data has been received

Parameters

handler

Handler used for callback

bool dataReady

(

)

Checks if the data has arrived

Here is the call graph for this function:

Here is the caller graph for this function:

bool dataSending

(

)

Checks if the transceiver is in the sending mode

Here is the call graph for this function:

Here is the caller graph for this function:

void getData

(

uint8_t *

data

)

Sinks all the arrived data into a provided buffer

Parameters

load	Size of the payload (MAX 32)

Here is the call graph for this function:

Here is the caller graph for this function:

uint8_t getStatus

(

)

Checks the transceiver state

Here is the caller graph for this function:

bool rxFifoEmpty

(

)

Checks if the receive stack is empty

Here is the caller graph for this function:

void rxPowerUp

(

)

Powers the receiver up

Here is the call graph for this function:

Here is the caller graph for this function:

void rxFlushBuffer

(

)

Flushes the receive stack

Here is the caller graph for this function:

void txPowerUp

(

)

Powers the transmitter up

Here is the caller graph for this function:

void powerDown

(

)

Powers everything down

Here is the call graph for this function:

void txFlushBuffer

(

)

Flushes the transmit stack

Here is the caller graph for this function:

void pollListener

(

)

Pulling the method listening for the arrived data, dataRecievedHandler is triggered if data arrives

Here is the call graph for this function:

mraa::Result ceHigh

(

)

Sets the chip enable pin to HIGH

Here is the caller graph for this function:

mraa::Result ceLow

(

)

Sets the chip enable pin to LOW

Here is the caller graph for this function:

mraa::Result csOn

(

)

Sets the chip select pin to LOW

Here is the caller graph for this function:

mraa::Result csOff

(

)

Sets the chip select pin to HIGH

Here is the caller graph for this function:

void setBeaconingMode

(

)

Configures the NRF24L01 transceiver to behave as a BLE (Bluetooth Low Energy) beaconing devcie.

void sendBeaconingMsg

(

uint8_t *

msg

)

Beacons the provided message to BLE scanners.

Parameters

msg	Beacons the provided message (max length is 16 bytes)

Here is the call graph for this function:

Field Documentation

uint8_t m_rxBuffer[MAX_BUFFER]

Receive buffer

uint8_t m_txBuffer[MAX_BUFFER]

Transmit buffer

uint8_t m_bleBuffer[32]

BLE buffer

---

The documentation for this class was generated from the following files:

• /iotdk/jenkins/workspace/upm-doc-stable/src/nrf24l01/nrf24l01.h
• /iotdk/jenkins/workspace/upm-doc-stable/src/nrf24l01/nrf24l01.cxx