RYB080I Click

RYB080I Click is a compact add-on board for seamless Bluetooth Low Energy (LE) communication in various wireless applications. This board features the RYB080I, a 2.4GHz Bluetooth 4.2/5.0 LE module with an integrated antenna from REYAX, based on the TI CC2640R2F ARM® Cortex®-M3 MCU. This module supports dual-device connectivity, operates in both Host and Client roles, and includes a metal cover for EMI protection, ensuring stable performance even in noisy environments. With support for the Generic Attribute Profile (GATT) and easy setup via REYAX AT commands, integration into diverse systems is simplified.

Click Product page

Click library

• Author : Stefan Filipovic
• Date : Aug 2024.
• Type : UART type

Software Support

We provide a library for the RYB080I 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 RYB080I Click driver.

Standard key functions :

• ryb080i_cfg_setup Config Object Initialization function.

  void ryb080i_cfg_setup ( ryb080i_cfg_t *cfg );

• ryb080i_init Initialization function.

  err_t ryb080i_init ( ryb080i_t *ctx, ryb080i_cfg_t *cfg );

• ryb080i_default_cfg Click Default Configuration function.

  err_t ryb080i_default_cfg ( ryb080i_t *ctx );

Example key functions :

• ryb080i_cmd_run This function sends a specified command to the Click module.

  void ryb080i_cmd_run ( ryb080i_t *ctx, uint8_t *cmd );

• ryb080i_cmd_set This function sets a value to a specified command of the Click module.

  void ryb080i_cmd_set ( ryb080i_t *ctx, uint8_t *cmd, uint8_t *param );

• ryb080i_cmd_get This function is used to get the value of a given command from the Click module.

  void ryb080i_cmd_get ( ryb080i_t *ctx, uint8_t *cmd );

Example Description

This example demonstrates the use of RYB080I Click board by processing data from a connected BT device.

The demo application is composed of two sections :

Application Init

Initializes the driver and logger.

void application_init ( void )
{
    log_cfg_t log_cfg;  /**< Logger config object. */
    ryb080i_cfg_t ryb080i_cfg;  /**< Click config object. */

    /** 
     * Logger initialization.
     * Default baud rate: 115200
     * Default log level: LOG_LEVEL_DEBUG
     * @note If USB_UART_RX and USB_UART_TX 
     * are defined as HAL_PIN_NC, you will 
     * need to define them manually for log to work. 
     * See @b LOG_MAP_USB_UART macro definition for detailed explanation.
     */
    LOG_MAP_USB_UART( log_cfg );
    log_init( &logger, &log_cfg );
    log_info( &logger, " Application Init " );

    // Click initialization.
    ryb080i_cfg_setup( &ryb080i_cfg );
    RYB080I_MAP_MIKROBUS( ryb080i_cfg, MIKROBUS_1 );
    if ( UART_ERROR == ryb080i_init( &ryb080i, &ryb080i_cfg ) ) 
    {
        log_error( &logger, " Communication init." );
        for ( ; ; );
    }

    log_info( &logger, " Application Task " );

    app_state = RYB080I_POWER_UP;
    log_printf( &logger, ">>> APP STATE - POWER UP <<<\r\n\n" );
}

Application Task

Application task is split in few stages:

• RYB080I_POWER_UP: Powers up the device and reads the system information.
• RYB080I_CONFIG_EXAMPLE: Sets the BT device name and enables the full power mode.
• RYB080I_EXAMPLE: Performs a BT terminal example by processing all data from connected BT devices and sending back an adequate response messages.

void application_task ( void )
{
    switch ( app_state )
    {
        case RYB080I_POWER_UP:
        {
            if ( RYB080I_OK == ryb080i_power_up( &ryb080i ) )
            {
                app_state = RYB080I_CONFIG_EXAMPLE;
                log_printf( &logger, ">>> APP STATE - CONFIG EXAMPLE <<<\r\n\n" );
            }
            break;
        }
        case RYB080I_CONFIG_EXAMPLE:
        {
            if ( RYB080I_OK == ryb080i_config_example( &ryb080i ) )
            {
                app_state = RYB080I_EXAMPLE;
                log_printf( &logger, ">>> APP STATE - EXAMPLE <<<\r\n\n" );
            }
            break;
        }
        case RYB080I_EXAMPLE:
        {
            ryb080i_example( &ryb080i );
            break;
        }
        default:
        {
            log_error( &logger, " APP STATE." );
            break;
        }
    }
}

Note

We have used the Serial Bluetooth Terminal smartphone application for the test. A smartphone and the Click board must be paired to exchange messages.

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.RYB080I

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. UART terminal is available in all MikroElektronika compilers.