rn4871  2.0.0.0
Main Page

RN4871 click

RN4871 click carries the RN4871 Bluetooth® 4.2 low energy module from Microchip.The click is designed to run on a 3.3V power supply. It uses ASCII Command Interface over UART for communication with target microcontroller, with additional functionality provided by the following pins on the mikroBUS™ line: RST, CS, and INT.

click Product page


Click library

  • Author : MikroE Team
  • Date : jun 2020.
  • Type : UART GSM/IOT type

Software Support

We provide a library for the Rn4871 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 form compilers IDE(recommended way), or downloaded from our LibStock, or found on mikroE github account.

Library Description

This library contains API for Rn4871 Click driver.

Standard key functions :

  • Config Object Initialization function.

    void rn4871_cfg_setup ( rn4871_cfg_t *cfg );

  • Initialization function.

    RN4871_RETVAL rn4871_init ( rn4871_t *ctx, rn4871_cfg_t *cfg );

Example key functions :

  • This function gets message from 'void rn4871_receive function if flag was set. This function replaces '*' (character with end of string) with '0x00' and stores received message to process_buffer

    uint8_t rn4871_read ( rn4871_t *ctx, uint8_t *process_buffer );

  • The function receives character by waits for '#' - character to start parsing message, waits for '*' - character to stop parsing message and sets flag if whole and properly formated message is received.

    void rn4871_receive ( rn4871_t *ctx, char tmp );

  • The function connects to slave device with desired register address by secures the connection and entering data stream mode.

    void rn4871_connect ( rn4871_t *ctx, char *p_addr );

Examples Description

This example reads and processes data from RN4871 clicks.

The demo application is composed of two sections :

Application Init

Initializes UART driver. Initializes device and parser.

void application_init ( void )
{
log_cfg_t log_cfg;
// Logger initialization.
LOG_MAP_USB_UART( log_cfg );
log_cfg.level = LOG_LEVEL_DEBUG;
log_cfg.baud = 115200;
log_init( &logger, &log_cfg );
log_info( &logger, "---- Application Init ----" );
// Click initialization.
RN4871_MAP_MIKROBUS( cfg, MIKROBUS_1 );
rn4871_init( &rn4871, &cfg );
{
}
{
}
memset( &rn4871.device_buffer, 0, 255 );
log_printf( &logger, " >>> app init done <<< \r\n" );
}

Application Task

If 'MASTER' - connects to 'SLAVE', sends message and disconnects. If 'SLAVE' - waits for connect request and message from 'MASTER' and LOGs received message.

void application_task ( void )
{
rn4871_process( );
{
rn4871_connect( &rn4871, &RN4871_ADDR_SLAVE[ 0 ] );
log_printf( &logger, ">>> sending data <<<\r\n" );
rn4871_disconnect( &rn4871 );
}
{
msg_flag = rn4871_read( &rn4871, &receive_buffer[ 0 ] );
if ( msg_flag == 1 )
{
log_printf( &logger, ">>> data received <<<\r\n" );
log_printf( &logger, ">>> data : " );
log_printf( &logger, "%s\r\n", ptr );
}
}
}

The full application code, and ready to use projects can be installed directly form compilers IDE(recommneded) or found on LibStock page or mikroE GitHub accaunt.

Other mikroE Libraries used in the example:

  • MikroSDK.Board
  • MikroSDK.Log
  • Click.Rn4871

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.


rn4871_disconnect
void rn4871_disconnect(rn4871_t *ctx)
Disconnecting from slave device.
rn4871_read
uint8_t rn4871_read(rn4871_t *ctx, uint8_t *process_buffer)
Reading received message.
RN4871_ADDR_SLAVE
uint8_t RN4871_ADDR_SLAVE[13]
Definition: main.c:45
rn4871_connect
void rn4871_connect(rn4871_t *ctx, char *p_addr)
Connecting to slave device.
RN4871_ID_MASTER
#define RN4871_ID_MASTER
Definition: rn4871.h:78
rn4871_initialize
void rn4871_initialize(rn4871_t *ctx, char *p_addr)
Initialization RN4871 module.
RN4871_DEVICETYPE_SLAVE
#define RN4871_DEVICETYPE_SLAVE
Definition: rn4871.h:75
ptr
char * ptr
Definition: main.c:51
application_task
void application_task(void)
Definition: main.c:113
RN4871_MTYPE_MSG
#define RN4871_MTYPE_MSG
Definition: rn4871.h:80
RN4871_DTYPE_STRING
#define RN4871_DTYPE_STRING
Definition: rn4871.h:81
message_payload
uint8_t message_payload[17]
Definition: main.c:46
dev_type
uint8_t dev_type
Definition: main.c:48
RN4871_DEVICETYPE_MASTER
#define RN4871_DEVICETYPE_MASTER
Definition: rn4871.h:74
rn4871_cfg_t
Click configuration structure definition.
Definition: rn4871.h:129
rn4871_init
RN4871_RETVAL rn4871_init(rn4871_t *ctx, rn4871_cfg_t *cfg)
Initialization function.
RN4871_MAP_MIKROBUS
#define RN4871_MAP_MIKROBUS(cfg, mikrobus)
Definition: rn4871.h:52
msg_flag
uint8_t msg_flag
Definition: main.c:50
application_init
void application_init(void)
Definition: main.c:77
rn4871_cfg_setup
void rn4871_cfg_setup(rn4871_cfg_t *cfg)
Config Object Initialization function.
RN4871_ADDR_MASTER
uint8_t RN4871_ADDR_MASTER[13]
Definition: main.c:44
receive_buffer
uint8_t receive_buffer[255]
Definition: main.c:49
rn4871_send
void rn4871_send(rn4871_t *ctx, uint8_t msg_type, uint16_t data_type, uint8_t id, uint8_t *payload)
Send message function.