Nothing Special   »   [go: up one dir, main page]

Skip to content

C47D/nRF24_Component

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

nRF24 Component for PSoC4, PSoC5LP and PSoC6

The nRF24 component is developed as a personal project, it surely can be improved, pull request are always welcome!.

What do you need to use this component?

You need:

  • SPI Master Full duplex.

  • Digital output (software driven) for the /SS (Chip Select).

  • Digital output (software driven) for the CE signal.

  • OPTIONAL: Digital input for the IRQ signal.

The SPI Master component, SS, CE and IRQ (IRQ is optional) pins must be provided by the user on the project schematic. See the image below for an example.

nRF24_sch_example

Example projects

See nRF24 Example Projects for basic example projects using this component!.

How to use this component on your PSoC project?

You can directly clone this repo inside your project directory and update it as you want. After that you have to include it into your project dependencies.

If you want you can also include this repo as a git submodule.

API

The functions provided by this component try to be as clear as possible, so the user should not need to check the component documentation to know what a function does.

All the functions on the NRF_FUNCS files are intended to be used directly by the user, so no need to use the functions on the NRF_LL_SPI and NRF_COMMANDS files.

The following code style where used on the NRF_REGS file to ease finding the available registers and bitfields:

  • NRF_REG_x means this is a register, where x is the register name as documented on the nRF24 datasheet.

  • NRF_x_BIT_y means this is a bit field on a register, where x is the register name and y is the name of the bitfield as documented on the nRF24 datasheet.

Current version: 3.0

The current component symbol is shown below:

Component

The customizer or configuration window is where the PSoC Creator "magic" happens, the custom customizers are ugly so i'm also trying to write a customizer in C# and add it to the component (Work in Progress), this is not really well documented and i'm pretty bad at desining GUI's so if you know C# and UI you can help me out.

The component configuration is separated in two tabs:

  • nRF Configuration

In this tab all the configurable nRF24 registers are layed out, at the right of the window is a small description on each register field, it's better if you have a copy of the nRF24 datasheet at hand.

nRF_Configuration

  • Hardware Interface

In this tab the user need to provide the names of the SPI Master component used for communication with the nRF24 radio, the name of the pin used to control the SS (slave select) and the pin used to control the CE pin.

nRF_SPI

nRF24 Component configuration.

Note: All the functions assumes your component is named nRF24 on your schematic.

Set Rx pipes and Tx pipe address.

To set the Tx address of the radio you should use the nRF24_set_tx_address(addr, size) function where addr will be set as the Tx address of the radio and size should be up to the configured address width configured on the radio. Example of use:

const uint8_t my_addr[] = {0xBA, 0xAD, 0xC0, 0xFF, 0xEE};

nRF24_set_tx_address(my_addr, sizeof my_addr);

Remember the addresses of the nRF24 radio starts with the LSB so the real Tx address of the radio will be: 0xEEFFC0ADBA.

Coding style

The code style in the v2.0 will be similar to the Linux kernel coding style, for this the tool clang-format is used, the repo contains the .clang-format file.