angle7  2.0.0.0
Main Page

Angle 7 Click

Angle 7 Click is a compact add-on board that detects the absolute angular position of a permanent magnet. This board features the AS5600, a programmable Hall-based rotary magnetic position sensor with a high-resolution 12-bit analog or PWM output from ams AG.

Click Product page


Click library

  • Author : Stefan Filipovic
  • Date : May 2022.
  • Type : I2C type

Software Support

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

Standard key functions :

Example key functions :

Example Description

This example demonstrates the use of Angle 7 Click board by reading and displaying

the magnet's angular position in degrees and analog voltage output as well as the magnet's status and magnitude.

The demo application is composed of two sections :

Application Init

Initializes the driver and performs the Click default configuration.

void application_init ( void )
{
log_cfg_t log_cfg;
angle7_cfg_t angle7_cfg;
LOG_MAP_USB_UART( log_cfg );
log_init( &logger, &log_cfg );
log_info( &logger, " Application Init " );
// Click initialization.
angle7_cfg_setup( &angle7_cfg );
ANGLE7_MAP_MIKROBUS( angle7_cfg, MIKROBUS_1 );
if ( I2C_MASTER_ERROR == angle7_init( &angle7, &angle7_cfg ) )
{
log_error( &logger, " Communication init." );
for ( ; ; );
}
if ( ANGLE7_ERROR == angle7_default_cfg ( &angle7 ) )
{
log_error( &logger, " Default configuration." );
for ( ; ; );
}
log_info( &logger, " Application Task " );
}

Application Task

Reads the magnet's angular position in degrees and analog voltage output

as well as the magnet's status and magnitude and displays the results on the USB UART approximately every 100ms.

void application_task ( void )
{
float voltage, raw_angle, angle;
uint16_t magnitude;
uint8_t status;
if ( ADC_ERROR != angle7_read_an_pin_voltage ( &angle7, &voltage ) )
{
log_printf( &logger, " AN voltage: %.3f V\r\n", voltage );
}
if ( ANGLE7_OK == angle7_get_angle ( &angle7, &angle ) )
{
log_printf ( &logger, " Angle: %.2f Degrees\r\n", angle );
}
if ( ANGLE7_OK == angle7_get_magnitude ( &angle7, &magnitude ) )
{
log_printf ( &logger, " Magnitude: %u\r\n", magnitude );
}
if ( ANGLE7_OK == angle7_get_status ( &angle7, &status ) )
{
log_printf ( &logger, " Status:" );
{
log_printf ( &logger, " Magnet Detected \r\n Magnet Strength:" );
{
log_printf ( &logger, " Too Strong \r\n\n" );
}
else if ( status & ANGLE7_STATUS_MAGNET_TOO_WEAK )
{
log_printf ( &logger, " Too Weak \r\n\n" );
}
else
{
log_printf ( &logger, " Good \r\n\n" );
}
}
else
{
log_printf ( &logger, " Magnet Not Detected \r\n\n" );
}
}
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.Angle7

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.


ANGLE7_ERROR
@ ANGLE7_ERROR
Definition: angle7.h:254
ANGLE7_STATUS_MAGNET_TOO_WEAK
#define ANGLE7_STATUS_MAGNET_TOO_WEAK
Definition: angle7.h:151
ANGLE7_OK
@ ANGLE7_OK
Definition: angle7.h:253
ANGLE7_STATUS_MAGNET_TOO_STRONG
#define ANGLE7_STATUS_MAGNET_TOO_STRONG
Definition: angle7.h:152
application_task
void application_task(void)
Definition: main.c:67
angle7_init
err_t angle7_init(angle7_t *ctx, angle7_cfg_t *cfg)
Angle 7 initialization function.
angle7_t
Angle 7 Click context object.
Definition: angle7.h:207
ANGLE7_STATUS_MAGNET_DETECTED
#define ANGLE7_STATUS_MAGNET_DETECTED
Angle 7 STATUS register settings.
Definition: angle7.h:150
angle7_cfg_t
Angle 7 Click configuration object.
Definition: angle7.h:231
angle7_default_cfg
err_t angle7_default_cfg(angle7_t *ctx)
Angle 7 default configuration function.
ANGLE7_MAP_MIKROBUS
#define ANGLE7_MAP_MIKROBUS(cfg, mikrobus)
MikroBUS pin mapping.
Definition: angle7.h:192
application_init
void application_init(void)
Definition: main.c:31
angle7_get_magnitude
err_t angle7_get_magnitude(angle7_t *ctx, uint16_t *magnitude)
Angle 7 get magnitude function.
angle7_get_angle
err_t angle7_get_angle(angle7_t *ctx, float *angle)
Angle 7 get angle function.
angle7_read_an_pin_voltage
err_t angle7_read_an_pin_voltage(angle7_t *ctx, float *data_out)
Angle 7 read AN pin voltage level function.
angle7_cfg_setup
void angle7_cfg_setup(angle7_cfg_t *cfg)
Angle 7 configuration object setup function.
angle7_get_status
err_t angle7_get_status(angle7_t *ctx, uint8_t *status)
Angle 7 get status function.