Thyone-I click
PRVIH_PAR_RECENICA_SA_PRODUCT_PAGE_DA_ISPRATE_CELINU
[click Product page](CLICK_PRODUCT_PAGE_LINK)
Click library
- Author : Stefan Ilic
- Date : Dec 2023.
- Type : UART type
Software Support
We provide a library for the Thyone-I 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 Thyone-I Click driver.
Standard key functions :
thyonei_cfg_setup
Config Object Initialization function.
void thyonei_cfg_setup(thyonei_cfg_t *cfg)
Thyone-I configuration object setup function.
Thyone-I Click configuration object.
Definition: thyonei.h:212
thyonei_init
Initialization function.
err_t thyonei_init(thyonei_t *ctx, thyonei_cfg_t *cfg)
Thyone-I initialization function.
Thyone-I Click context object.
Definition: thyonei.h:188
thyonei_default_cfg
Click Default Configuration function.
void thyonei_default_cfg(thyonei_t *ctx)
Thyone-I default configuration function.
Example key functions :
thyonei_get_req
This command can be used to set individual setting parameters in flash of Thyone-I click board.
err_t thyonei_get_req(thyonei_t *ctx, uint8_t settings_index, uint8_t *param_len, uint8_t *parameter)
Thyone-I get individual parameters function.
thyonei_multicast_data_req
This command provides the multicast data transmission to a group of modules configured with the same MAC GROUP ADDRESS of Thyone-I click board.
err_t thyonei_multicast_data_req(thyonei_t *ctx, uint8_t message_len, uint8_t *message)
Thyone-I multicast data function.
thyonei_unicast_data_req
This command provides the unicast data transmission to the configured MAC DESTINATION ADDRESS of Thyone-I click board.
err_t thyonei_unicast_data_req(thyonei_t *ctx, uint8_t message_len, uint8_t *message)
Thyone-I unicast data function.
Example Description
This example demonstrates the use of the Thyone-I click board by sending and receiving data and displaying them on the USB UART.
The demo application is composed of two sections :
Application Init
Initializes the driver and performs the click default configuration and setting the MAC addresses and mode.
{
log_cfg_t log_cfg;
LOG_MAP_USB_UART( log_cfg );
log_init( &logger, &log_cfg );
log_info( &logger, " Application Init " );
{
log_error( &logger, " Communication init." );
for ( ; ; );
}
uint8_t tmp_data [ 4 ] = { 0 };
uint8_t len = 0;
log_printf( &logger, " Thyone-I serial number: 0x" );
for( uint8_t cnt = 0; cnt < len; cnt++ )
{
log_printf( &logger, "%.2X", ( uint16_t ) tmp_data[ cnt ] );
}
log_printf( &logger, "\r\n" );
log_printf( &logger, "= = = = = = = = = = = = = = =\r\n" );
log_printf( &logger, " Thyone-I factory reset request: \r\n" );
log_printf( &logger, " Thyone-I Set Mode to normal mode: \r\n" );
tmp_data[ 0 ] = 0;
log_printf( &logger, " Thyone-I Set RF-Profile to 0: \r\n" );
tmp_data[ 0 ] = 0;
log_printf( &logger, " Thyone-I Set MAC Group ID to 0xAA: \r\n" );
log_printf( &logger, " Thyone-I Set Source MAC address: \r\n" );
log_printf( &logger, " Thyone-I Set Destination MAC address: \r\n" );
log_info( &logger, " Application Task " );
}
#define THYONEI_INDEX_MAC_GROUP_ID
Definition: thyonei.h:119
#define THYONEI_CMD_FACTORY_RESET_REQ
Definition: thyonei.h:84
#define THYONEI_INDEX_MAC_DEST_ADDRESS
Definition: thyonei.h:118
#define THYONEI_CMD_SET_REQ
Definition: thyonei.h:78
#define THYONEI_INDEX_RF_PROFILE
Definition: thyonei.h:113
#define THYONEI_INDEX_MODULE_MODE
Definition: thyonei.h:131
#define THYONEI_INDEX_MAC_SOURCE_ADDRESS
Definition: thyonei.h:117
#define THYONEI_INDEX_SERIAL_NUMBER
Thyone-I settings indexes.
Definition: thyonei.h:106
#define THYONEI_MAP_MIKROBUS(cfg, mikrobus)
MikroBUS pin mapping.
Definition: thyonei.h:171
err_t thyonei_set_req(thyonei_t *ctx, uint8_t settings_index, uint8_t parameters_length, uint8_t *parameters)
Thyone-I set individual parameters function.
err_t thyonei_send_command(thyonei_t *ctx, uint8_t command, uint16_t payload_length, uint8_t *payload)
Thyone-I send command function.
err_t thyonei_generic_read(thyonei_t *ctx, uint8_t *data_out, uint16_t len)
Thyone-I data reading function.
void application_init(void)
Definition: main.c:73
#define SOURCE_ADDRESS
Definition: main.c:41
#define MAC_GROUP_ADDRESS
Definition: main.c:39
#define DESTINATION_ADDRESS
Definition: main.c:43
#define PROCESS_BUFFER_SIZE
Definition: main.c:31
Application Task
Transmitter mode - Sending data to the devices within range ( thyonei_broadcast_data_req ), with same MAC group ( thyonei_multicast_data_req )
and with the selected MAC destination address ( thyonei_unicast_data_req ).
Receiver mode - Reads and processes all incoming data and displays them on the USB UART.
{
#if ( TRANSMITTER_MAC_ADDRESS == SOURCE_ADDRESS )
#define BRODCAST_MESSAGE "Brodcast"
log_printf( &logger, " Thyone-I sending broadcast message: \r\n" );
Delay_ms( 5000 );
#define MULTICAST_MESSAGE "Multicast"
log_printf( &logger, " Thyone-I sending multicast message: \r\n" );
Delay_ms( 5000 );
#define UNICAST_MESSAGE "Unicast"
log_printf( &logger, " Thyone-I sending unicast message: \r\n" );
Delay_ms( 5000 );
#else
#endif
}
#define THYONEI_CMD_DATA_CNF
Definition: thyonei.h:74
#define THYONEI_CMD_DATA_IND
Definition: thyonei.h:76
err_t thyonei_broadcast_data_req(thyonei_t *ctx, uint8_t message_len, uint8_t *message)
Thyone-I brodcast data function.
void application_task(void)
Definition: main.c:154
#define MULTICAST_MESSAGE
#define MESSAGE
Thyone-I Message.
Definition: main.c:52
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.ThyoneI
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.