Ambient 3 Click
Ambient 3 Click demo application is developed using the NECTO Studio, ensuring compatibility with mikroSDK's open-source libraries and tools. Designed for plug-and-play implementation and testing, the demo is fully compatible with all development, starter, and mikromedia boards featuring a mikroBUS™ socket.
Click Library
- Author : MikroE Team
- Date : Dec 2019.
- Type : I2C type
Software Support
Example Description
This example demonstrates the use of Ambient 3 Click board.
Example Libraries
- MikroSDK.Board
- MikroSDK.Log
- Click.Ambient3
Example Key Functions
- ambient3_cfg_setup Config Object Initialization function.
void ambient3_cfg_setup(ambient3_cfg_t *cfg)
Config Object Initialization function.
Click configuration structure definition.
Definition ambient3.h:268
- ambient3_init Initialization function.
AMBIENT3_RETVAL ambient3_init(ambient3_t *ctx, ambient3_cfg_t *cfg)
Initialization function.
Click ctx object definition.
Definition ambient3.h:245
- ambient3_default_cfg Click Default Configuration function.
void ambient3_default_cfg(ambient3_t *ctx)
Default Config Initialization function.
- ambient3_get_device_temperature This function reads device temperature.
uint8_t ambient3_get_device_temperature(ambient3_t *ctx)
Getting temperature function.
- ambient3_get_data_in_LUX This function reads data in LUX.
uint16_t ambient3_get_data_in_LUX (
ambient3_t *ctx );
- This function reads CCT data in K. uint16_t ambient3_get_cct_data ( ambient3_t *ctx );
Application Init
Initializes the driver and logger.
{
log_cfg_t log_cfg;
LOG_MAP_USB_UART( log_cfg );
log_init( &logger, &log_cfg );
log_info( &logger, "---- Application Init ----" );
Delay_ms ( 100 );
}
#define AMBIENT3_MAP_MIKROBUS(cfg, mikrobus)
Definition ambient3.h:66
void application_init(void)
Definition main.c:35
Application Task
Reads the device temperature, and daylight in LUX and logs results to USB UART each second.
{
log_printf( &logger, " - Device temperature in Celsius : %u\r\n", ( uint16_t ) temperature );
log_printf( &logger, " - Light in LUX : %u\r\n", data_lux );
log_printf( &logger, " --------------------\r\n" );
Delay_ms ( 1000 );
}
uint16_t ambient3_get_data_in_lux(ambient3_t *ctx)
This function reads data in LUX.
void application_task()
Definition main.c:62
Application Output
This Click board can be interfaced and monitored in two ways:
- Application Output - Use the "Application Output" window in Debug mode for real-time data monitoring. Set it up properly by following this tutorial.
- UART Terminal - Monitor data via the UART Terminal using a USB to UART converter. For detailed instructions, check out this tutorial.
Additional Notes and Information
The complete application code and a ready-to-use project are available through the NECTO Studio Package Manager for direct installation in the NECTO Studio. The application code can also be found on the MIKROE GitHub account.