\mainpage Main Page
4x4 RGB click is a matrix of 16 intelligent RGB elements, forming a 4x4 display screen.
- Author : MikroE Team
- Date : Jan 2020.
- Type : GPIO type
We provide a library for the 4x4Rgb 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 form compilers IDE(recommended way), or downloaded from our LibStock, or found on mikroE github account.
This library contains API for 4x4Rgb Click driver.
c4x4rgb_cfg_setup
This function initializes click configuration structure to init state.
void c4x4rgb_cfg_setup ( c4x4rgb_cfg_t *cfg, drv_logic_t logic_zero, drv_logic_t logic_one, uint8_t select_ctrl_pin );
c4x4rgb_init
This function initializes all necessary pins and peripherals used for this click.
err_t c4x4rgb_init ( c4x4rgb_t *ctx, c4x4rgb_cfg_t *cfg );
c4x4rgb_set_diode
This function allows to set color of one diode.
err_t c4x4rgb_set_diode ( c4x4rgb_t *ctx, uint32_t diode_num, uint32_t diode_color );
c4x4rgb_fill_screen
This function sets every diode on selected color.
void c4x4rgb_fill_screen ( c4x4rgb_t *ctx, uint32_t fill_color );
This application is used for powering 4x4 RGB LED matrix.
The demo application is composed of two sections :
Initialization driver enables - GPIO.
void application_init ( void )
{
c4x4rgb_cfg_t cfg;
// Click initialization.
c4x4rgb_cfg_setup( &cfg, &c4x4rgb_logic_zero, &c4x4rgb_logic_one, C4X4RGB_CTRL_PIN_IN1 );
C4X4RGB_MAP_MIKROBUS( cfg, MIKROBUS_1 );
c4x4rgb_init( &c4x4rgb, &cfg );
c4x4rgb_fill_screen( &c4x4rgb, C4X4RGB_COLOR_WHITE );
Delay_ms( 100 );
c4x4rgb_color_mash();
Delay_ms( 2000 );
}
This is an example which demonstrates the use of 4x4 RGB Click board. This simple example shows all ten numbers in different colors on 4x4 RGB click. The 4x4 RGB click carries a matrix of 16 RGB LEDs and an MCP1826 low dropout regulator. These LEDs actually consist of three single colored LEDs ( Red, Green and Blue ) in a single package. Various colors can be reproduced by mixing the intensity of each LED.
void application_task ( void )
{
c4x4rgb_snake( C4X4RGB_COLOR_BLUE );
Delay_ms( 500 );
c4x4rgb_snake_return( C4X4RGB_COLOR_LIGHT_BLUE );
Delay_ms( 1000 );
c4x4rgb_snake( C4X4RGB_COLOR_GREEN );
Delay_ms( 500 );
c4x4rgb_snake_return( C4X4RGB_COLOR_YELLOW );
Delay_ms( 1000 );
c4x4rgb_snake( C4X4RGB_COLOR_RED );
Delay_ms( 500 );
c4x4rgb_snake_return( C4X4RGB_COLOR_PURPLE );
Delay_ms( 1000 );
c4x4rgb_fill_screen( &c4x4rgb, C4X4RGB_COLOR_WHITE );
Delay_ms( 100 );
}
The full application code, and ready to use projects can be installed directly form compilers IDE(recommneded) or found on LibStock page or mikroE GitHub accaunt.
Other mikroE Libraries used in the example:
- MikroSDK.Board
- MikroSDK.Log
- Click.4x4Rgb
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.