thumbwheel  2.0.0.0
Main Page

Thumbwheel click

Thumbwheel click is a mikroBUS add-on board with a 10-position rotary sprocket connected to a 1-Wire 8-Channel Addressable Switch.

click Product page


Click library

  • Author : Aleksandra Cvjeticanin
  • Date : Mar 2022.
  • Type : One Wire type

Software Support

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

Standard key functions :

Example key functions :

Example Description

This example demonstrates the use of Thumbwheel click board by displaying the exact position of the rotary sprocket.

The demo application is composed of two sections :

Application Init

Initializes the driver and checks the communication.

void application_init ( void )
{
log_cfg_t log_cfg;
thumbwheel_cfg_t thumbwheel_cfg;
LOG_MAP_USB_UART( log_cfg );
log_init( &logger, &log_cfg );
log_info( &logger, " Application Init " );
// Click initialization.
thumbwheel_cfg_setup( &thumbwheel_cfg );
THUMBWHEEL_MAP_MIKROBUS( thumbwheel_cfg, MIKROBUS_1 );
if ( ONE_WIRE_ERROR == thumbwheel_init( &thumbwheel, &thumbwheel_cfg ) )
{
log_error( &logger, " Communication init." );
for ( ; ; );
}
{
log_error( &logger, " Default configuration." );
for ( ; ; );
}
log_info( &logger, " Application Task " );
}

Application Task

Demonstrates the usage of thumbwheel_get_position function which gives the exact position of the rotary sprocket. The position will be displayed on the UART Terminal.

void application_task ( void )
{
static uint8_t old_position = 0xFF;
uint8_t position;
if ( ( THUMBWHEEL_OK == thumbwheel_get_position ( &thumbwheel, &position ) ) &&
( old_position != position ) )
{
log_printf( &logger, " Position: %u \r\n\n", ( uint16_t ) position );
old_position = position;
}
Delay_ms ( 100 );
}

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

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.


thumbwheel_get_position
err_t thumbwheel_get_position(thumbwheel_t *ctx, uint8_t *position)
Thumbwheel get position function.
thumbwheel_cfg_setup
void thumbwheel_cfg_setup(thumbwheel_cfg_t *cfg)
Thumbwheel configuration object setup function.
THUMBWHEEL_OK
@ THUMBWHEEL_OK
Definition: thumbwheel.h:186
thumbwheel_check_communication
err_t thumbwheel_check_communication(thumbwheel_t *ctx)
Thumbwheel check communication function.
application_task
void application_task(void)
Definition: main.c:66
thumbwheel_init
err_t thumbwheel_init(thumbwheel_t *ctx, thumbwheel_cfg_t *cfg)
Thumbwheel initialization function.
THUMBWHEEL_ERROR
@ THUMBWHEEL_ERROR
Definition: thumbwheel.h:187
thumbwheel_t
Thumbwheel Click context object.
Definition: thumbwheel.h:152
THUMBWHEEL_MAP_MIKROBUS
#define THUMBWHEEL_MAP_MIKROBUS(cfg, mikrobus)
MikroBUS pin mapping.
Definition: thumbwheel.h:128
application_init
void application_init(void)
Definition: main.c:30
thumbwheel_cfg_t
Thumbwheel Click configuration object.
Definition: thumbwheel.h:168