ism  2.0.0.0
Main Page

ISM click

ISM Click is a compact add-on board that contains a complete wireless RF digital data transceiver. This board features the RFM75, a low-power, high-performance 2.4GHz GFSK transceiver from RF Solutions. The RFM75 transceiver is configurable through SPI serial interface and operates with only 3.3V in the worldwide ISM frequency band from 2400MHz up to 2527MHz. The embedded packet processing engines enable their entire operation with a simple MCU as a radio system. Burst mode transmission and up to 2Mbps air data rate make it suitable for applications requiring ultra-low power consumption.

click Product page


Click library

  • Author : Nenad Filipovic
  • Date : Mar 2021.
  • Type : SPI type

Software Support

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

Standard key functions :

Example key functions :

Example Description

This library contains API for the ISM Click driver. This example transmits/receives and processes data from ISM clicks.

The demo application is composed of two sections :

Application Init

Initializes driver and performs the default configuration.

void application_init ( void )
{
log_cfg_t log_cfg;
ism_cfg_t ism_cfg;
LOG_MAP_USB_UART( log_cfg );
log_init( &logger, &log_cfg );
log_info( &logger, " Application Init " );
// Click initialization.
ism_cfg_setup( &ism_cfg );
ISM_MAP_MIKROBUS( ism_cfg, MIKROBUS_1 );
if ( SPI_MASTER_ERROR == ism_init( &ism, &ism_cfg ) )
{
log_error( &logger, " Application Init Error. " );
log_info( &logger, " Please, run program again... " );
for ( ; ; );
}
ism_default_cfg ( &ism );
Delay_ms( 100 );
#ifdef DEMO_APP_TRANSMITTER
log_printf( &logger, " Application Mode: Transmitter\r\n" );
#else
log_printf( &logger, " Application Mode: Receiver\r\n" );
#endif
log_info( &logger, " Application Task " );
}

Application Task

Transmitter/Receiver task depends on uncommented code. Receiver logging each received byte to the UART for data logging, while transmitter send messages every 1 second.

void application_task ( void )
{
#ifdef DEMO_APP_TRANSMITTER
ism_transmit_packet( &ism, ISM_CMD_W_TX_PAYLOAD_NOACK, demo_message_1, 9 );
log_printf( &logger, " Tx : %s", demo_message_1 );
Delay_ms( 1000 );
ism_transmit_packet( &ism, ISM_CMD_W_TX_PAYLOAD_NOACK, demo_message_2, 12 );
log_printf( &logger, " Tx : %s", demo_message_2 );
Delay_ms( 1000 );
#else
uint8_t rx_buf[ ISM_MAX_PACKET_LEN ] = { 0 };
ism_receive_packet( &ism, &rx_buf[ 0 ] );
if ( rx_buf[ 0 ] )
{
log_printf( &logger, " Rx : %s", rx_buf );
}
#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.Ism

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.


ISM_CMD_W_TX_PAYLOAD_NOACK
#define ISM_CMD_W_TX_PAYLOAD_NOACK
Definition: ism.h:114
ISM_MAP_MIKROBUS
#define ISM_MAP_MIKROBUS(cfg, mikrobus)
MikroBUS pin mapping.
Definition: ism.h:196
ism_switch_rx_mode
err_t ism_switch_rx_mode(ism_t *ctx)
ISM switch RX mode function.
ism_cfg_setup
void ism_cfg_setup(ism_cfg_t *cfg)
ISM configuration object setup function.
ism_default_cfg
void ism_default_cfg(ism_t *ctx)
ISM default configuration function.
application_task
void application_task(void)
Definition: main.c:77
ism_t
ISM Click context object.
Definition: ism.h:214
ism_switch_tx_mode
err_t ism_switch_tx_mode(ism_t *ctx)
ISM switch TX mode function.
ism_receive_packet
err_t ism_receive_packet(ism_t *ctx, uint8_t *rx_data)
ISM receive packet function.
application_init
void application_init(void)
Definition: main.c:36
ism_device_config
err_t ism_device_config(ism_t *ctx)
ISM device configuration function.
ISM_MAX_PACKET_LEN
#define ISM_MAX_PACKET_LEN
ISM maximum packet length.
Definition: ism.h:157
ism_cfg_t
ISM Click configuration object.
Definition: ism.h:235
ism_init
err_t ism_init(ism_t *ctx, ism_cfg_t *cfg)
ISM initialization function.
ism_transmit_packet
err_t ism_transmit_packet(ism_t *ctx, uint8_t type, uint8_t *tx_data, uint8_t len)
ISM transmit package function.