lr14  2.1.0.0
Main Page

LR 14 click

PRVIH_PAR_RECENICA_SA_PRODUCT_PAGE_DA_ISPRATE_CELINU

[click Product page](CLICK_PRODUCT_PAGE_LINK)


Click library

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

Software Support

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

Standard key functions :

Example key functions :

  • lr14_cmd_run This function sends a specified command to the click module.
    void lr14_cmd_run ( lr14_t *ctx, uint8_t *cmd );
  • lr14_cmd_set This function sets a value to a specified command of the click module.
    void lr14_cmd_set ( lr14_t *ctx, uint8_t *cmd, uint8_t *value );
  • lr14_cmd_get This function is used to get the value of a given command from the click module.
    void lr14_cmd_get ( lr14_t *ctx, uint8_t *cmd );

Example Description

This example demonstrates the use of LR 14 click board by showing the communication between two click boards configured in P2P network mode.

The demo application is composed of two sections :

Application Init

Initializes the driver and logger.

void application_init ( void )
{
log_cfg_t log_cfg;
lr14_cfg_t lr14_cfg;
LOG_MAP_USB_UART( log_cfg );
log_init( &logger, &log_cfg );
log_info( &logger, " Application Init " );
// Click initialization.
lr14_cfg_setup( &lr14_cfg );
LR14_MAP_MIKROBUS( lr14_cfg, MIKROBUS_1 );
if ( UART_ERROR == lr14_init( &lr14, &lr14_cfg ) )
{
log_error( &logger, " Communication init." );
for ( ; ; );
}
log_info( &logger, " Application Task " );
app_state = LR14_POWER_UP;
log_printf( &logger, ">>> APP STATE - POWER UP <<<\r\n\n" );
}

Application Task

Application task is split in few stages:

  • LR14_POWER_UP:

    Powers up the device, performs a device factory reset and reads system information.

  • LR14_CONFIG_EXAMPLE:

    Configures device for the LoRa P2P network mode.

  • LR14_EXAMPLE:

    Performs a LoRa P2P example by exchanging messages with another LR 14 click board.

void application_task ( void )
{
switch ( app_state )
{
{
if ( LR14_OK == lr14_power_up( &lr14 ) )
{
app_state = LR14_CONFIG_EXAMPLE;
log_printf( &logger, ">>> APP STATE - CONFIG EXAMPLE <<<\r\n\n" );
}
break;
}
{
if ( LR14_OK == lr14_config_example( &lr14 ) )
{
app_state = LR14_EXAMPLE;
log_printf( &logger, ">>> APP STATE - EXAMPLE <<<\r\n\n" );
}
break;
}
{
lr14_example( &lr14 );
break;
}
default:
{
log_error( &logger, " APP STATE." );
break;
}
}
}

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

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.


lr14_cmd_get
void lr14_cmd_get(lr14_t *ctx, uint8_t *cmd)
LR 14 cmd get function.
lr14_init
err_t lr14_init(lr14_t *ctx, lr14_cfg_t *cfg)
LR 14 initialization function.
lr14_cmd_set
void lr14_cmd_set(lr14_t *ctx, uint8_t *cmd, uint8_t *value)
LR 14 cmd set function.
lr14_cmd_run
void lr14_cmd_run(lr14_t *ctx, uint8_t *cmd)
LR 14 cmd run function.
LR14_MAP_MIKROBUS
#define LR14_MAP_MIKROBUS(cfg, mikrobus)
MikroBUS pin mapping.
Definition: lr14.h:136
LR14_EXAMPLE
@ LR14_EXAMPLE
Definition: main.c:62
lr14_cfg_t
LR 14 Click configuration object.
Definition: lr14.h:168
LR14_CONFIG_EXAMPLE
@ LR14_CONFIG_EXAMPLE
Definition: main.c:61
application_task
void application_task(void)
Definition: main.c:178
LR14_OK
@ LR14_OK
Definition: lr14.h:191
LR14_POWER_UP
@ LR14_POWER_UP
Definition: main.c:60
lr14_cfg_setup
void lr14_cfg_setup(lr14_cfg_t *cfg)
LR 14 configuration object setup function.
lr14_t
LR 14 Click context object.
Definition: lr14.h:149
application_init
void application_init(void)
Definition: main.c:145