准确检测磁性物体在所有三个空间维度上的运动和方向,从而在各种应用中实现精确的位置跟踪
A
A
硬件概览
它是如何工作的?
3D Hall 14 Click 基于 Melexis 的高精度 3 轴磁力计 MLX90394,采用 Triaxis® 霍尔技术,在各种应用中提供卓越性能和增强位置感应。MLX90394 专为微功耗应用设计,非常适合电池供电的解决方案。它能够精确测量三个轴(X、Y 和 Z)上的磁场,并将这些测量值和 IC 温度转换为 16 位数据字。这些数据点通过 I2C 接口进行通信。传感器的操作灵活,允许根据需求或连续进行测量,并且用户可以选择刷新率。尽管尺寸紧凑,MLX90394 在噪声性能方面表现出色,并在各种配置下保持低功耗。MLX90394 的一个突出特点是其智能唤醒模式,允许整个系统进入深度睡眠状态,直到检测到磁场变化。该检测可以基于不同的标准:与初始测量值的变化(静态增量)、与先前测量
值的变化(动态增量)或超过预定义阈值(绝对值)。该功能通过在活跃和睡眠模式之间切换设备来确保高效的电源管理,有效捕捉忙碌和缓慢变化的磁场。正如前面提到的,3D Hall 14 Click 非常适用于各种应用。它可以用于电池供电的工具、家用电器(白色家电)、工业机械、智能家居设备、家庭安全系统以及许多其他需要精确可靠位置感应的场景。此 Click 板™ 采用独特设计格式,支持 MIKROE 新引入的 "Click Snap" 功能。与标准化版本的 Click 板不同,这一功能允许通过断开 PCB,使主传感器区域可移动,开创了许多新的实现可能性。得益于 Snap 功能,MLX90394 可以通过直接访问标记为 1-8 的引脚信号自主运行。此外,Snap 部分包括指定和固定的螺
丝孔位置,使用户能够将 Snap 板固定在所需位置。3D Hall 14 Click 使用标准的 2 线 I2C 接口与主 MCU 通信,支持快速模式和高达 1MHz 的频率。除了 I2C 引脚外,此 Click 板™ 还在 mikroBUS™ 插座的 INT 引脚上具有中断信号,以提供超过编程阈值的通知。该中断可以作为变化唤醒(WOC)中断输出或同步输出。此 Click 板™ 只能在 3.3V 逻辑电压水平下操作。在使用具有不同逻辑电平的 MCU 之前,必须进行适当的逻辑电压电平转换。此外,该 Click 板™ 配有一个包含函数和示例代码的库,可用作进一步开发的参考。
功能概述
开发板
Curiosity PIC32 MZ EF 开发板是一个完全集成的 32 位开发平台,特点是高性能的 PIC32MZ EF 系列(PIC32MZ2048EFM),该系列具有 2MB Flash、512KB RAM、集成的浮点单元(FPU)、加密加速器和出色的连接选项。它包括一个集成的程序员和调试器,无需额外硬件。用户可以通过 MIKROE
mikroBUS™ Click™ 适配器板扩展功能,通过 Microchip PHY 女儿板添加以太网连接功能,使用 Microchip 扩展板添加 WiFi 连接能力,并通过 Microchip 音频女儿板添加音频输入和输出功能。这些板完全集成到 PIC32 强大的软件框架 MPLAB Harmony 中,该框架提供了一个灵活且模块化的接口
来应用开发、一套丰富的互操作软件堆栈(TCP-IP、USB)和易于使用的功能。Curiosity PIC32 MZ EF 开发板提供了扩展能力,使其成为连接性、物联网和通用应用中快速原型设计的绝佳选择。
微控制器概述
MCU卡片 / MCU

建筑
PIC32
MCU 内存 (KB)
2048
硅供应商
Microchip
引脚数
100
RAM (字节)
524288
使用的MCU引脚
mikroBUS™映射器
“仔细看看!”
Click board™ 原理图

一步一步来
项目组装
实时跟踪您的结果
应用程序输出
1. 应用程序输出 - 在调试模式下,“应用程序输出”窗口支持实时数据监控,直接提供执行结果的可视化。请按照提供的教程正确配置环境,以确保数据正确显示。

2. UART 终端 - 使用UART Terminal通过USB to UART converter监视数据传输,实现Click board™与开发系统之间的直接通信。请根据项目需求配置波特率和其他串行设置,以确保正常运行。有关分步设置说明,请参考提供的教程。

3. Plot 输出 - Plot功能提供了一种强大的方式来可视化实时传感器数据,使趋势分析、调试和多个数据点的对比变得更加直观。要正确设置,请按照提供的教程,其中包含使用Plot功能显示Click board™读数的分步示例。在代码中使用Plot功能时,请使用以下函数:plot(insert_graph_name, variable_name);。这是一个通用格式,用户需要将“insert_graph_name”替换为实际图表名称,并将“variable_name”替换为要显示的参数。

软件支持
库描述
该库包含 3D Hall 14 Click 驱动程序的 API。
关键功能:
c3dhall14_get_magnetic_flux
- 此功能读取 X、Y 和 Z 轴的原始值,并将其转换为微特斯拉的磁通数据。c3dhall14_get_temperature
- 此功能读取原始温度值并将其转换为摄氏度。c3dhall14_set_range
- 此功能设置磁通测量范围。
开源
代码示例
完整的应用程序代码和一个现成的项目可以通过NECTO Studio包管理器直接安装到NECTO Studio。 应用程序代码也可以在MIKROE的GitHub账户中找到。
/*!
* @file main.c
* @brief 3D Hall 14 Click example
*
* # Description
* This example demonstrates the use of 3D Hall 14 click board by reading
* the magnetic field strength from 3 axes and the sensor internal temperature.
*
* The demo application is composed of two sections :
*
* ## Application Init
* Initializes the driver and performs the click default configuration.
*
* ## Application Task
* Reads data from the sensor and displays them on the USB UART every 200ms.
*
* @author Stefan Filipovic
*
*/
#include "board.h"
#include "log.h"
#include "c3dhall14.h"
static c3dhall14_t c3dhall14;
static log_t logger;
void application_init ( void )
{
log_cfg_t log_cfg; /**< Logger config object. */
c3dhall14_cfg_t c3dhall14_cfg; /**< Click config object. */
/**
* Logger initialization.
* Default baud rate: 115200
* Default log level: LOG_LEVEL_DEBUG
* @note If USB_UART_RX and USB_UART_TX
* are defined as HAL_PIN_NC, you will
* need to define them manually for log to work.
* See @b LOG_MAP_USB_UART macro definition for detailed explanation.
*/
LOG_MAP_USB_UART( log_cfg );
log_init( &logger, &log_cfg );
log_info( &logger, " Application Init " );
// Click initialization.
c3dhall14_cfg_setup( &c3dhall14_cfg );
C3DHALL14_MAP_MIKROBUS( c3dhall14_cfg, MIKROBUS_1 );
if ( I2C_MASTER_ERROR == c3dhall14_init( &c3dhall14, &c3dhall14_cfg ) )
{
log_error( &logger, " Communication init." );
for ( ; ; );
}
if ( C3DHALL14_ERROR == c3dhall14_default_cfg ( &c3dhall14 ) )
{
log_error( &logger, " Default configuration." );
for ( ; ; );
}
log_info( &logger, " Application Task " );
}
void application_task ( void )
{
float x_axis = 0;
float y_axis = 0;
float z_axis = 0;
float temperature = 0;
if ( C3DHALL14_OK == c3dhall14_get_magnetic_flux ( &c3dhall14, &x_axis, &y_axis, &z_axis ) )
{
log_printf( &logger, " X-axis: %.1f uT\r\n", x_axis );
log_printf( &logger, " Y-axis: %.1f uT\r\n", y_axis );
log_printf( &logger, " Z-axis: %.1f uT\r\n", z_axis );
}
if ( C3DHALL14_OK == c3dhall14_get_temperature ( &c3dhall14, &temperature ) )
{
log_printf( &logger, " Internal temperature: %.2f C\r\n\n", temperature );
}
}
int main ( void )
{
/* Do not remove this line or clock might not be set correctly. */
#ifdef PREINIT_SUPPORTED
preinit();
#endif
application_init( );
for ( ; ; )
{
application_task( );
}
return 0;
}
// ------------------------------------------------------------------------ END