ccrf3  2.0.0.0
Main Page

ccRF 3 click

The clicks will enable you to add a low-power consumption radio transceiver at 433 MHz frequency. ccRF 3 click is designed to run on a 3.3V power supply. It communicates with the target microcontroller over SPI interface.

click Product page


Click library

  • Author : Stefan Ilic
  • Date : Oct 2021.
  • Type : SPI type

Software Support

We provide a library for the ccRF3 Click as well as a demo application (example), developed using MikroElektronika compilers. The demo can run on all the main MikroElektronika development boards.

Package can be downloaded/installed directly from NECTO Studio Package Manager(recommended way), downloaded from our LibStock™ or found on Mikroe github account.

Library Description

This library contains API for ccRF3 Click driver.

Standard key functions :

Example key functions :

Example Description

This example demonstrates the use of ccRF 3 click board.

The demo application is composed of two sections :

Application Init

Initializes the driver, performs the default configuration and enables the selected mode.

void application_init ( void )
{
log_cfg_t log_cfg;
ccrf3_cfg_t ccrf3_cfg;
LOG_MAP_USB_UART( log_cfg );
log_init( &logger, &log_cfg );
log_printf( &logger, " Application Init \r\n" );
// Click initialization.
ccrf3_cfg_setup( &ccrf3_cfg );
CCRF3_MAP_MIKROBUS( ccrf3_cfg, MIKROBUS_1 );
if ( SPI_MASTER_ERROR == ccrf3_init( &ccrf3, &ccrf3_cfg ) )
{
log_error( &logger, " Communication init." );
for ( ; ; );
}
log_printf( &logger, "----------------------\r\n" );
log_printf( &logger, " Hardware reset\r\n" );
ccrf3_hw_reset( &ccrf3 );
Delay_ms ( 1000 );
if ( CCRF3_ERROR == ccrf3_default_cfg ( &ccrf3 ) )
{
log_error( &logger, " Default configuration." );
for ( ; ; );
}
log_printf( &logger, "----------------------\r\n" );
#ifdef DEMO_APP_TRANSMITTER
ccrf3_set_tx_mode( &ccrf3 );
log_printf( &logger, " Transmitter mode\r\n" );
#else
ccrf3_set_rx_mode( &ccrf3 );
log_printf( &logger, " Receiver mode\r\n" );
#endif
log_printf( &logger, "----------------------\r\n" );
Delay_ms ( 100 );
log_printf( &logger, " Application Task \r\n" );
log_printf( &logger, "----------------------\r\n" );
}

Application Task

Depending on the selected mode, it reads the received data or sends the desired message every 2 seconds. All data is being logged on the USB UART where you can track their changes.

void application_task ( void )
{
#ifdef DEMO_APP_TRANSMITTER
log_printf( &logger, " Sent message: MikroE\r\n" );
log_printf( &logger, " Packet number: %u\r\n", ccrf3.packet_counter );
log_printf( &logger, "----------------------\r\n" );
Delay_ms ( 1000 );
Delay_ms ( 1000 );
#else
uint8_t num_bytes = ccrf3_receive_rx_data( &ccrf3, &rx_buffer[ 0 ] );
if ( num_bytes )
{
log_printf( &logger, " Received message: " );
for ( uint8_t cnt = 3; cnt < rx_buffer[ 0 ]; cnt++ )
{
log_printf( &logger, "%c", rx_buffer[ cnt ] );
}
log_printf( &logger, " Packet number: %u", ccrf3.packet_counter );
log_printf( &logger, "\r\n----------------------\r\n" );
}
#endif
}

The full application code, and ready to use projects can be installed directly from NECTO Studio Package Manager(recommended way), downloaded from our LibStock™ or found on Mikroe github account.

Other Mikroe Libraries used in the example:

  • MikroSDK.Board
  • MikroSDK.Log
  • Click.ccRF3

Additional notes and informations

Depending on the development board you are using, you may need USB UART click, USB UART 2 Click or RS232 Click to connect to your PC, for development systems with no UART to USB interface available on the board. The terminal available in all MikroElektronika compilers, or any other terminal application of your choice, can be used to read the message.


ccrf3_cfg_setup
void ccrf3_cfg_setup(ccrf3_cfg_t *cfg)
ccRF 3 configuration object setup function.
CCRF3_MAP_MIKROBUS
#define CCRF3_MAP_MIKROBUS(cfg, mikrobus)
MikroBUS pin mapping.
Definition: ccrf3.h:371
ccrf3_send_tx_data
void ccrf3_send_tx_data(ccrf3_t *ctx, uint8_t *tx_data, uint8_t n_bytes)
Send TX data function.
ccrf3_cfg_t
ccRF 3 Click configuration object.
Definition: ccrf3.h:413
ccrf3_set_tx_mode
void ccrf3_set_tx_mode(ccrf3_t *ctx)
Set TX mode function.
application_task
void application_task(void)
Definition: main.c:89
ccrf3_cmd_strobe
uint8_t ccrf3_cmd_strobe(ccrf3_t *ctx, uint8_t cmd)
Set command strobe function.
CCRF3_ERROR
@ CCRF3_ERROR
Definition: ccrf3.h:440
ccrf3_set_rx_mode
void ccrf3_set_rx_mode(ccrf3_t *ctx)
Set RX mode function.
ccrf3_default_cfg
err_t ccrf3_default_cfg(ccrf3_t *ctx)
ccRF 3 default configuration function.
TEXT_TO_SEND
#define TEXT_TO_SEND
Definition: main.c:25
ccrf3_t
ccRF 3 Click context object.
Definition: ccrf3.h:389
application_init
void application_init(void)
Definition: main.c:33
ccrf3_init
err_t ccrf3_init(ccrf3_t *ctx, ccrf3_cfg_t *cfg)
ccRF 3 initialization function.
ccrf3_receive_rx_data
uint8_t ccrf3_receive_rx_data(ccrf3_t *ctx, uint8_t *rx_data)
Receive RX data function.
ccrf3_hw_reset
void ccrf3_hw_reset(ccrf3_t *ctx)
Hardware reset function.