uwb4  2.1.0.0
Main Page

UWB 4 click

PRVIH_PAR_RECENICA_SA_PRODUCT_PAGE_DA_ISPRATE_CELINU

[click Product page](CLICK_PRODUCT_PAGE_LINK)


Click library

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

Software Support

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

Standard key functions :

Example key functions :

  • uwb4_cmd_run This function sends a specified command to the click module.
    void uwb4_cmd_run ( uwb4_t *ctx, uint8_t *cmd );
  • uwb4_cmd_set This function sets a value to a specified command of the click module.
    void uwb4_cmd_set ( uwb4_t *ctx, uint8_t *cmd, uint8_t *value );
  • uwb4_reset_device This function resets the device by toggling the reset pin logic state.
    void uwb4_reset_device ( uwb4_t *ctx );

Example Description

This example demonstrates the use of UWB 4 click board by showing the UWB ranging between two click boards configured as initiator and responder.

The demo application is composed of two sections :

Application Init

Initializes the driver and logger.

void application_init ( void )
{
log_cfg_t log_cfg;
uwb4_cfg_t uwb4_cfg;
LOG_MAP_USB_UART( log_cfg );
log_init( &logger, &log_cfg );
log_info( &logger, " Application Init " );
// Click initialization.
uwb4_cfg_setup( &uwb4_cfg );
UWB4_MAP_MIKROBUS( uwb4_cfg, MIKROBUS_1 );
if ( UART_ERROR == uwb4_init( &uwb4, &uwb4_cfg ) )
{
log_error( &logger, " Communication init." );
for ( ; ; );
}
log_info( &logger, " Application Task " );
app_state = UWB4_POWER_UP;
log_printf( &logger, ">>> APP STATE - POWER UP <<<\r\n\n" );
}

Application Task

Application task is split in few stages:

  • UWB4_POWER_UP:

    Powers up the device and reads system information.

  • UWB4_CONFIG_EXAMPLE:

    Configures device for UWB ranging.

  • UWB4_EXAMPLE:

    Reads and parses the UWB ranging information.

void application_task ( void )
{
switch ( app_state )
{
{
if ( UWB4_OK == uwb4_power_up( &uwb4 ) )
{
app_state = UWB4_CONFIG_EXAMPLE;
log_printf( &logger, ">>> APP STATE - CONFIG EXAMPLE <<<\r\n\n" );
}
break;
}
{
if ( UWB4_OK == uwb4_config_example( &uwb4 ) )
{
app_state = UWB4_EXAMPLE;
log_printf( &logger, ">>> APP STATE - EXAMPLE <<<\r\n\n" );
}
break;
}
{
uwb4_example( &uwb4 );
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.UWB4

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.


uwb4_cmd_set
void uwb4_cmd_set(uwb4_t *ctx, uint8_t *cmd, uint8_t *value)
UWB 4 cmd set function.
UWB4_OK
@ UWB4_OK
Definition: uwb4.h:185
application_task
void application_task(void)
Definition: main.c:192
UWB4_CONFIG_EXAMPLE
@ UWB4_CONFIG_EXAMPLE
Definition: main.c:76
uwb4_t
UWB 4 Click context object.
Definition: uwb4.h:139
UWB4_POWER_UP
@ UWB4_POWER_UP
Definition: main.c:75
UWB4_EXAMPLE
@ UWB4_EXAMPLE
Definition: main.c:77
uwb4_reset_device
void uwb4_reset_device(uwb4_t *ctx)
UWB 4 reset device function.
uwb4_cfg_setup
void uwb4_cfg_setup(uwb4_cfg_t *cfg)
UWB 4 configuration object setup function.
uwb4_cmd_run
void uwb4_cmd_run(uwb4_t *ctx, uint8_t *cmd)
UWB 4 cmd run function.
application_init
void application_init(void)
Definition: main.c:159
uwb4_cfg_t
UWB 4 Click configuration object.
Definition: uwb4.h:161
UWB4_MAP_MIKROBUS
#define UWB4_MAP_MIKROBUS(cfg, mikrobus)
MikroBUS pin mapping.
Definition: uwb4.h:125
uwb4_init
err_t uwb4_init(uwb4_t *ctx, uwb4_cfg_t *cfg)
UWB 4 initialization function.