Difference between revisions of "Matrix - 3-Axis Digital Compass/zh"
From FriendlyELEC WiKi
(→与NanoPi M2连接使用) |
(→连接NanoPC-T2) |
||
| (16 intermediate revisions by 3 users not shown) | |||
| Line 32: | Line 32: | ||
*HMC5883LL 通过两线I2C 总线系统作为一个从机装置进行通信。数据传输速率是标准模式100kbps 或400kbps 速率。总线位格式是一个8 位数据/地址传送和1 位应答位。格式的数据字节（有效载荷）应区分HMC5883L 从机上的大小写的ASCII 字符或二进制数据，以及返回的二进制数据。负二进制值将是以二进制的补码形式（这涉及到后面读到的数据判断有没有超过正数范围）。 | *HMC5883LL 通过两线I2C 总线系统作为一个从机装置进行通信。数据传输速率是标准模式100kbps 或400kbps 速率。总线位格式是一个8 位数据/地址传送和1 位应答位。格式的数据字节（有效载荷）应区分HMC5883L 从机上的大小写的ASCII 字符或二进制数据，以及返回的二进制数据。负二进制值将是以二进制的补码形式（这涉及到后面读到的数据判断有没有超过正数范围）。 | ||
| − | == | + | ==硬件连接== |
| − | + | ===连接NanoPi NEO/NanoPi NEO Air=== | |
| − | + | NanoPi M1和NanoPi NEO以及NanoPi NEO Air的前24Pin引脚定义是一模一样的，所以它们操作Matrix配件的步骤是一样的，并且使用同一份代码。<br> | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | 参考下图连接模块：<br> | |
| − | < | + | [[File:Matrix-3_Axis_Digital_Compass_nanopi_NEO.jpg|frameless|600px|Matrix-3_Axis_Digital_Compass_nanopi_NEO]] |
| − | + | ||
| − | + | ||
| − | + | 连接说明： | |
| − | + | {| class="wikitable" | |
| − | + | |- | |
| − | + | |Matrix-3_Axis_Digital_Compass || NanoPi NEO | |
| − | + | |- | |
| + | |SDA || Pin3 | ||
| + | |- | ||
| + | |SCL || Pin5 | ||
| + | |- | ||
| + | |5V || Pin4 | ||
| + | |- | ||
| + | |GND || Pin6 | ||
| + | |} | ||
| − | == | + | ===连接NanoPi M1=== |
| − | + | 参考下图连接模块：<br> | |
| − | + | [[File:Matrix-3_Axis_Digital_Compass_nanopi_m1.jpg|frameless|600px|Matrix-3_Axis_Digital_Compass_nanopi_m1]] | |
| − | [[File:Matrix- | + | |
连接说明： | 连接说明： | ||
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
| − | |Matrix-3_Axis_Digital_Compass || NanoPi | + | |Matrix-3_Axis_Digital_Compass || NanoPi M1 |
|- | |- | ||
|SDA || Pin3 | |SDA || Pin3 | ||
| Line 70: | Line 71: | ||
|} | |} | ||
| − | === | + | ===连接NanoPi 2=== |
| − | + | 参考下图连接模块：<br> | |
| − | + | [[File:Matrix-3_Axis_Digital_Compass_nanopi_2.jpg|frameless|600px|Matrix-3_Axis_Digital_Compass_nanopi_2]] | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | [[File:Matrix- | + | |
连接说明： | 连接说明： | ||
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
| − | |Matrix-3_Axis_Digital_Compass || NanoPi | + | |Matrix-3_Axis_Digital_Compass || NanoPi 2 |
|- | |- | ||
|SDA || Pin3 | |SDA || Pin3 | ||
| Line 172: | Line 89: | ||
|} | |} | ||
| − | === | + | ===连接NanoPi M2 / NanoPi 2 Fire=== |
| − | + | NanoPi M2和NanoPi 2 Fire的40 Pin引脚定义是一模一样的，所以它们操作Matrix配件的步骤是一样的，这里仅以NanoPi M2为例。<br> | |
| − | + | 参考下图连接模块：<br> | |
| − | + | [[File:Matrix-3_Axis_Digital_Compass_nanopi_m2.jpg|frameless|600px|Matrix-3_Axis_Digital_Compass_nanopi_m2]] | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | [[File:Matrix- | + | |
连接说明： | 连接说明： | ||
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
| − | |Matrix-3_Axis_Digital_Compass || | + | |Matrix-3_Axis_Digital_Compass || NanoPi M2 |
|- | |- | ||
| − | |SDA || | + | |SDA || Pin3 |
|- | |- | ||
|SCL || Pin5 | |SCL || Pin5 | ||
|- | |- | ||
| − | |5V || | + | |5V || Pin4 |
|- | |- | ||
| − | |GND || | + | |GND || Pin6 |
|} | |} | ||
| − | === | + | ===连接NanoPi M3=== |
| − | + | 参考下图连接模块：<br> | |
| − | + | [[File:Matrix-3_Axis_Digital_Compass_nanopi_m3.jpg|frameless|600px|Matrix-3_Axis_Digital_Compass_nanopi_m3]] | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | [[File: | + | |
连接说明： | 连接说明： | ||
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
| − | |Matrix-3_Axis_Digital_Compass || NanoPi | + | |Matrix-3_Axis_Digital_Compass || NanoPi M3 |
|- | |- | ||
|SDA || Pin3 | |SDA || Pin3 | ||
| Line 390: | Line 126: | ||
|} | |} | ||
| − | === | + | ===连接NanoPC-T2/NanoPC-T3=== |
| − | + | 由于NanoPC-T2跟NanoPC-T3的引脚是一样的，所以连接方式是一样的，这里仅以T2为例，参考下图连接模块：<br> | |
| − | + | [[File:Matrix-3_Axis_Digital_Compass_nanopc-T2.jpg|frameless|600px|Matrix-3_Axis_Digital_Compass_NanoPC-T2]] | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | [[File: | + | |
连接说明： | 连接说明： | ||
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
| − | |Matrix-3_Axis_Digital_Compass || | + | |Matrix-3_Axis_Digital_Compass || NanoPC-T2 |
|- | |- | ||
| − | |SDA || | + | |SDA || Pin6 |
|- | |- | ||
| − | |SCL || | + | |SCL || Pin5 |
|- | |- | ||
| − | |5V || | + | |5V || Pin29 |
|- | |- | ||
| − | |GND || | + | |GND || Pin30 |
|} | |} | ||
| − | == | + | ==编译运行测试程序== |
| − | + | 启动开发板并运行Debian系统，进入系统后克隆Matrix代码仓库： | |
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash"> | ||
| − | $ | + | $ apt-get update && apt-get install git |
| − | $ git | + | $ git clone https://github.com/friendlyarm/matrix.git |
</syntaxhighlight> | </syntaxhighlight> | ||
| + | 克隆完成后会得到一个名为matrix的目录。 | ||
| − | + | 编译并安装Matrix： | |
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash"> | ||
| − | $ | + | $ cd matrix |
| − | $ make | + | $ make && make install |
| − | + | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| − | |||
| − | |||
| − | + | 运行测试程序： | |
| − | + | ||
| − | + | ||
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash"> | ||
| − | $ | + | $ matrix-compass |
| − | + | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| − | + | 注意：此模块并不支持热插拔，启动系统前需要确保硬件连接正确。<br> | |
| − | + | 运行效果如下：<br> | |
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash"> | ||
| − | + | The angle is 305.2 | |
</syntaxhighlight> | </syntaxhighlight> | ||
| − | + | 305.2为角度值，角度值的范围为0~360。 | |
| − | == | + | ==代码说明== |
| + | 所有的开发板都共用一套Matrix代码，本模块的测试示例代码为matrix-3_axis_digital_compass，内容如下: | ||
<syntaxhighlight lang="c"> | <syntaxhighlight lang="c"> | ||
int main(int argc, char ** argv) | int main(int argc, char ** argv) | ||
| Line 527: | Line 176: | ||
int devFD; | int devFD; | ||
double angle; | double angle; | ||
| − | + | int i2cDev = 0; | |
| − | if ((devFD = hmc5883Init()) == -1) { | + | |
| + | if (boardInit() < 0) { | ||
| + | printf("Fail to init board\n"); | ||
| + | return -1; | ||
| + | } | ||
| + | |||
| + | if (argc == 2) | ||
| + | i2cDev = atoi(argv[1]); | ||
| + | if ((devFD = hmc5883Init(i2cDev)) == -1) { | ||
printf("Fail to init hmc5883\n"); | printf("Fail to init hmc5883\n"); | ||
return -1; | return -1; | ||
} | } | ||
| − | + | if ((angle = hmc5883Read(devFD)) != -1) { | |
| − | if ((angle = hmc5883Read(devFD)) | + | printf("The angle is %.1f\n", angle); |
| + | } else { | ||
printf("Fail to read hmc5883\n"); | printf("Fail to read hmc5883\n"); | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
} | } | ||
hmc5883DeInit(devFD); | hmc5883DeInit(devFD); | ||
| + | |||
return 0; | return 0; | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
| − | + | API说明参考维基：[[Matrix API reference manual/zh|Matrix API reference manual]] <br> | |
| − | + | ||
| − | + | ||
| − | + | ||
==相关资料== | ==相关资料== | ||
| − | [http://www51.honeywell.com/aero/common/documents/myaerospacecatalog-documents/Defense_Brochures-documents/HMC5883L_3-Axis_Digital_Compass_IC.pdf HMC5883L_3-Axis_Digital_Compass_IC.pdf] | + | *[datasheet][http://www51.honeywell.com/aero/common/documents/myaerospacecatalog-documents/Defense_Brochures-documents/HMC5883L_3-Axis_Digital_Compass_IC.pdf HMC5883L_3-Axis_Digital_Compass_IC.pdf] |
| + | *[Schematic]([http://wiki.friendlyarm.com/wiki/images/c/c1/Matrix_-_3_Axis_Digital_Compass-Schematic.pdf Matrix-3_Axis_Digital_Compass-Schematic.pdf]) | ||
Latest revision as of 08:41, 10 November 2016
Contents
1 介绍
- 模块Matrix-3_Axis_Digital_Compass的功能为测量方向，相当于指南针。
- 搭载了一颗HMC5883L芯片，HMC5883L利用霍尼韦尔的各种异性磁阻的（AMR）技术，包含最先进的高分辨率HMC118X系列磁阻传感器，并附带Honeywel专利的集成电路包括放大器、自动消磁驱动器、偏差校准、能使指南针精度控制在1°~2°的12位模数转换器，能在±8高斯的磁场中实现5毫高斯分辨率测量。这些传感器的固态结构结合非常低的横轴灵敏度目的是测量方向和地球磁场的大小，采用I2C方式通讯。
- 集成了3.3V电源转换IC给HMC5883L供电，只需连接5V电源和主控的I2C接口就可以使用。
2 特性
- I2C，3.3V
- 1～2度精度
- 2.54mm排针接口，接线方便，通用性强
- PCB尺寸（mm）：16x16
- 引脚说明:
| 名称 | 描述 |
| SDA | I2C SDA |
| SCL | I2C SCL |
| 5V | 电源5V |
| GND | 地 |
3 工作原理
- 片内的磁阻元件两两对齐，形成一个共同的敏感轴(如图上的箭头所示)，在磁场存在的情况下，磁阻传感器的变化将引起跨电桥输出电压的相应变动。随着磁场在敏感方向上不断增强，电压也就正向增长，输出与沿着该轴方向上的磁阻元件变化成比例，其他磁阻电桥放置在正交方向上，就能精密测量其他方向的磁场强度。 传感器内部还可产生标准磁场而进行的自测试(不论是正向配置还是负向配置)，再去测量此标准磁场强度并输出。
- HMC5883LL 通过两线I2C 总线系统作为一个从机装置进行通信。数据传输速率是标准模式100kbps 或400kbps 速率。总线位格式是一个8 位数据/地址传送和1 位应答位。格式的数据字节（有效载荷）应区分HMC5883L 从机上的大小写的ASCII 字符或二进制数据，以及返回的二进制数据。负二进制值将是以二进制的补码形式（这涉及到后面读到的数据判断有没有超过正数范围）。
4 硬件连接
4.1 连接NanoPi NEO/NanoPi NEO Air
NanoPi M1和NanoPi NEO以及NanoPi NEO Air的前24Pin引脚定义是一模一样的，所以它们操作Matrix配件的步骤是一样的，并且使用同一份代码。
参考下图连接模块：
Matrix-3_Axis_Digital_Compass_nanopi_NEO
连接说明：
| Matrix-3_Axis_Digital_Compass | NanoPi NEO |
| SDA | Pin3 |
| SCL | Pin5 |
| 5V | Pin4 |
| GND | Pin6 |
4.2 连接NanoPi M1
参考下图连接模块：
连接说明：
| Matrix-3_Axis_Digital_Compass | NanoPi M1 |
| SDA | Pin3 |
| SCL | Pin5 |
| 5V | Pin4 |
| GND | Pin6 |
4.3 连接NanoPi 2
参考下图连接模块：
连接说明：
| Matrix-3_Axis_Digital_Compass | NanoPi 2 |
| SDA | Pin3 |
| SCL | Pin5 |
| 5V | Pin4 |
| GND | Pin6 |
4.4 连接NanoPi M2 / NanoPi 2 Fire
NanoPi M2和NanoPi 2 Fire的40 Pin引脚定义是一模一样的，所以它们操作Matrix配件的步骤是一样的，这里仅以NanoPi M2为例。
参考下图连接模块：
连接说明：
| Matrix-3_Axis_Digital_Compass | NanoPi M2 |
| SDA | Pin3 |
| SCL | Pin5 |
| 5V | Pin4 |
| GND | Pin6 |
4.5 连接NanoPi M3
参考下图连接模块：
Matrix-3_Axis_Digital_Compass_nanopi_m3
连接说明：
| Matrix-3_Axis_Digital_Compass | NanoPi M3 |
| SDA | Pin3 |
| SCL | Pin5 |
| 5V | Pin4 |
| GND | Pin6 |
4.6 连接NanoPC-T2/NanoPC-T3
由于NanoPC-T2跟NanoPC-T3的引脚是一样的，所以连接方式是一样的，这里仅以T2为例，参考下图连接模块：
Matrix-3_Axis_Digital_Compass_NanoPC-T2
连接说明：
| Matrix-3_Axis_Digital_Compass | NanoPC-T2 |
| SDA | Pin6 |
| SCL | Pin5 |
| 5V | Pin29 |
| GND | Pin30 |
5 编译运行测试程序
启动开发板并运行Debian系统，进入系统后克隆Matrix代码仓库：
$ apt-get update && apt-get install git $ git clone https://github.com/friendlyarm/matrix.git
克隆完成后会得到一个名为matrix的目录。
编译并安装Matrix：
$ cd matrix $ make && make install
运行测试程序：
$ matrix-compass注意：此模块并不支持热插拔，启动系统前需要确保硬件连接正确。
运行效果如下：
The angle is 305.2305.2为角度值，角度值的范围为0~360。
6 代码说明
所有的开发板都共用一套Matrix代码，本模块的测试示例代码为matrix-3_axis_digital_compass，内容如下:
int main(int argc, char ** argv) { int devFD; double angle; int i2cDev = 0; if (boardInit() < 0) { printf("Fail to init board\n"); return -1; } if (argc == 2) i2cDev = atoi(argv[1]); if ((devFD = hmc5883Init(i2cDev)) == -1) { printf("Fail to init hmc5883\n"); return -1; } if ((angle = hmc5883Read(devFD)) != -1) { printf("The angle is %.1f\n", angle); } else { printf("Fail to read hmc5883\n"); } hmc5883DeInit(devFD); return 0; }
API说明参考维基：Matrix API reference manual
7 相关资料
- [datasheet]HMC5883L_3-Axis_Digital_Compass_IC.pdf
- [Schematic](Matrix-3_Axis_Digital_Compass-Schematic.pdf)
