Difference between revisions of "Matrix - 3-Axis Digital Compass"

From FriendlyELEC WiKi
Jump to: navigation, search
(Connect to NanoPi M2 / NanoPi 2 Fire)
 
(60 intermediate revisions by 3 users not shown)
Line 1: Line 1:
[[Matrix - 3-Axis Digital Compass|English]]
+
[[Matrix - 3-Axis Digital Compass/zh|查看中文]]
  
==介绍==
+
==Introduction==
[[File:Example.jpg|thumb|3-Axis Digital Accelerometer]]
+
[[File:Matrix-3_Axis_Digital_Compass.jpg|thumb|3-Axis Digital Compass]]
此配件搭载了一颗HMC5883L芯片,HMC5883L是Honeywel公司的一款三轴数字指南针芯片,12-bit ADC,精度可达1~2度,采用I2C方式通讯。此配件集成了3.3V电源转换IC给HMC5883L供电,您只需连接5V电源和主控的I2C接口就可以使用。
+
* The Matrix-3_Axis_Digital_Compass module is designed to measure the direction and functions like to a compass.
 +
* It utilizes the HMC5883L chip. The HMC5883L includes high-resolution HMC118X series magneto-resistive sensors plus an ASIC containing amplification, automatic degaussing strap drivers, offset cancellation, and a 12-bit ADC that enables 1° to 2° compass heading accuracy. It achieves 2 milli-gauss field resolution in ±8 gauss fields. These sensors’ solid-state construction with very low cross-axis sensitivity is designed to measure both the direction and the magnitude of Earth’s magnetic fields, from milli-gauss to 8 gauss.  It has an I2C serial bus interface.
 +
* It integrates a 3.3V power conversion IC allowing it to be powered by an external 5V power source. It can be controlled by an I2C master.
  
 
+
==Features==
==特性==
+
 
* I2C,3.3V
 
* I2C,3.3V
* 1~2度精度
+
* 1° to 2° compass heading accuracy
* 2.54mm排针接口,接线方便,通用性强
+
* 2.54 mm spacing pin
* PCB尺寸(mm):16x16
+
* PCB Dimension(mm): 16 x 16
 
[[File:Example.jpg|frameless|400px|重力加速度PCB]]
 
[[File:Example.jpg|frameless|400px|重力加速度PCB]]
  
==工作原理==
+
* Pin Description:
我们的指南针模块就是通过测量环境的磁场,从而运算得出模块现时所指的方向角度。
+
{| class="wikitable"
指南针模块的返回值范围是0~360度。除了可以进行每秒数千次的角度测量,它能让客户自己定义方向,纠正磁场环境偏差等。HMC5883LL 使用是一个IIC 协议所定义的简化后的通信接口协议,通过这一文件,数据传输速率是标准模式100kbps 或400kbps 速率,如I2C 总线规格中所规定。总线位格式是一个8 位数据/地址传送和1 位应答位。格式的数据字节(有效载荷)应区分HMC5883L 从机上的大小写的ASCII 字符或二进制数据,以及返回的二进制数据。
+
|-
 +
|Pin || Description
 +
|-
 +
|SDA    || I2C SDA
 +
|-
 +
|SCL    || I2C SCL
 +
|-
 +
|5V      || Supply Voltage 5V
 +
|-
 +
|GND    || Ground
 +
|}
  
 +
==Basic Device Operation==
 +
* The Honeywell HMC5883L magnetoresistive sensor circuit is a trio of sensors and application specific support circuits to measure magnetic fields. With power supply applied, the sensor converts any incident magnetic field in the sensitive axis directions to a differential voltage output. The magnetoresistive sensors are made of a nickel-iron (Permalloy) thin-film and patterned as a resistive strip element. In the presence of a magnetic field, a change in the bridge resistive elements causes a corresponding change in voltage across the bridge outputs. These resistive elements are aligned together to have a common sensitive axis (indicated by arrows in the pinout diagram) that will provide positive voltage change with magnetic fields increasing in the sensitive direction. Because the output is only proportional to the magnetic field component along its axis, additional sensor bridges are placed at orthogonal directions to permit accurate measurement of magnetic field in any orientation.
 +
* The HMC5883L communicates via a two-wire I2C bus system as a slave device. It has 8-bit read address and 8-bit write address. This device supports standard and fast modes, 100kHz and 400kHz, respectively, but does not support the high speed mode (Hs). The bus bit format is an 8-bit Data/Address send and a 1-bit acknowledge bit. The format of the data bytes (payload) shall be case sensitive ASCII characters or binary data to the HMC5883L slave, and binary data returned. Negative binary values will be in two’s complement form. The default (factory) HMC5883L 8-bit slave address is 0x3C for write operations, or 0x3D for read operations.
 +
* The module has an I2C interface which complies to the I2C standard protocol and the connection diagram is as follows
 +
[[File:三轴重力.png|frameless|400px|三轴重力加速度]]
  
==使用方法==
+
<!---
===连接===
+
==Download Matrix Source Code==
*连接到NanoPi
+
All the matrix modules' code samples are open source. They are maintained on GitHub - https://github.com/friendlyarm/matrix.git <br>
::GND针脚:    接地
+
Each branch in this hub contains the matrix modules' code samples for a board that the matrix modules can work with.<br>
::5V:  接5V
+
* The nanopi branch contains the matrix modules' code samples for the NanoPi
::SCL:  I2C SCL
+
* The nanopi 2 branch contains the matrix modules' code samples for the NanoPi 2
::SDA:  I2C SDA
+
* The tiny4412 branch contains the matrix modules' code samples for the Tiny4412
[[File:pass&NanoPi.png|frameless|600px|NanoPi+pass]]
+
* The raspberrypi branch contains the matrix modules' code samples for the RaspberryPi
  
==工作原理==
+
Please follow the steps below to get the source code:<br>
*HMC5883L 是一款小巧的高集成三轴数字指南针芯片,包含最先进的高分辨率HMC118X系列磁阻传感器,并附带Honeywel专利的集成电路包括放大器、自动消磁驱动器、偏差校准、能使指南针精度控制在1°~2°的12位模数转换器,能在±8高斯的磁场中实现5毫高斯分辨率测量。
+
Install the git utility on a PC running Ubuntu14.04
*片内的磁阻元件两两对齐,形成一个共同的敏感轴(如图上的箭头所示),在磁场存在的情况下,磁阻传感器的变化将引起跨电桥输出电压的相应变动。随着磁场在敏感方向上不断增强,电压也就正向增长,输出与沿着该轴方向上的磁阻元件变化成比例,其他磁阻电桥放置在正交方向上,就能精密测量其他方向的磁场强度。 传感器内部还可产生标准磁场而进行的自测试(不论是正向配置还是负向配置),再去测量此标准磁场强度并输出。
+
<syntaxhighlight lang="bash">
*而这里采用I2C通信,接线方式如下图:
+
$ sudo apt-get install git
[[File:三轴重力.png|frameless|400px|三轴重力加速度]]
+
</syntaxhighlight>
  
 +
Clone the matrix code from GitHub
 +
<syntaxhighlight lang="bash">
 +
$ git clone https://github.com/friendlyarm/matrix.git
 +
</syntaxhighlight>
 +
If this is successful a "matrix" directory will be generated, which will contain all the matrix modules' code samples.
 +
--->
 +
 +
 +
==Applications==
 +
===Connect to NanoPi M1===
 +
Refer to the following connection diagram to connect the module to the NanoPi M1:<br>
 +
[[File:Matrix-3_Axis_Digital_Compass_nanopi_m1.jpg|frameless|600px|Matrix-3_Axis_Digital_Compass_nanopi_m1]]
 +
 +
Connection Details:
 +
{| class="wikitable"
 +
|-
 +
|Matrix-3_Axis_Digital_Compass || NanoPi M1     
 +
|-
 +
|SDA    || Pin3
 +
|-
 +
|SCL    || Pin5
 +
|-
 +
|5V    || Pin4
 +
|-
 +
|GND    || Pin6
 +
|}
 +
 +
===Connect to NanoPi 2===
 +
Refer to the following connection diagram to connect the module to the NanoPi 2:<br>
 +
[[File:Matrix-3_Axis_Digital_Compass_nanopi_2.jpg|frameless|600px|Matrix-3_Axis_Digital_Compass_nanopi_2]]
 +
 +
Connection Details:
 +
{| class="wikitable"
 +
|-
 +
|Matrix-3_Axis_Digital_Compass || NanoPi 2     
 +
|-
 +
|SDA    || Pin3
 +
|-
 +
|SCL    || Pin5
 +
|-
 +
|5V    || Pin4
 +
|-
 +
|GND    || Pin6
 +
|}
 +
 +
===Connect to NanoPi M2 / NanoPi 2 Fire===
 +
Refer to the following connection diagram to connect the module to the NanoPi M2/ NanoPi 2 Fire.<br>
 +
[[File:Matrix-3_Axis_Digital_Compass_nanopi_m2.jpg|frameless|600px|Matrix-3_Axis_Digital_Compass_nanopi_m2]]
 +
 +
Connection Details:
 +
{| class="wikitable"
 +
|-
 +
|Matrix-3_Axis_Digital_Compass || NanoPi M2     
 +
|-
 +
|SDA    || Pin3
 +
|-
 +
|SCL    || Pin5
 +
|-
 +
|5V    || Pin4
 +
|-
 +
|GND    || Pin6
 +
|}
 +
 +
===Connect to NanoPC-T2===
 +
Refer to the following connection diagram to connect the module to the NanoPC-T2<br>
 +
[[File:Matrix-3_Axis_Digital_Compass_nanopc-T2.jpg|frameless|600px|Matrix-3_Axis_Digital_Compass_NanoPC-T2]]
 +
 +
Connection Details:
 +
{| class="wikitable"
 +
|-
 +
|Matrix-3_Axis_Digital_Compass || NanoPC-T2
 +
|-
 +
|SDA    || Pin6
 +
|-
 +
|SCL    || Pin5
 +
|-
 +
|5V    || Pin29
 +
|-
 +
|GND    || Pin30
 +
|}
 +
 +
<!---
 +
==Connect to NanoPi 2==
 +
===Hardware Connection===
 +
Please refer to the following connection diagram to connect the Matrix-3_Axis_Digital_Compass to the NanoPi 2:<br>
 +
[[File:Matrix-3_Axis_Digital_Compass_nanopi_2.jpg|frameless|600px|Matrix-3_Axis_Digital_Compass_nanopi_2]]
 +
 +
Connection Details:
 +
{| class="wikitable"
 +
|-
 +
|Matrix-3_Axis_Digital_Compass || NanoPi 2     
 +
|-
 +
|SDA    || Pin3
 +
|-
 +
|SCL    || Pin5
 +
|-
 +
|5V    || Pin4
 +
|-
 +
|GND    || Pin6
 +
|}
 +
 +
===Compile Test Program===
 +
Please login the matrix hub and enter the nanopi2 branch
 +
<syntaxhighlight lang="bash">
 +
$ cd matrix
 +
$ git checkout nanopi2
 +
</syntaxhighlight>
 +
 +
Compile the Matrix code
 +
<syntaxhighlight lang="bash">
 +
$ make CROSS_COMPILE=arm-linux- clean
 +
$ make CROSS_COMPILE=arm-linux-
 +
$ make CROSS_COMPILE=arm-linux- install
 +
</syntaxhighlight>
 +
Note: please make sure to install the cross compiler "arm-linux-gcc-4.9.3" on your PC, which is used to compile files for the NanoPi 2.<br>
 +
Generated library files are under the "install/lib" directory. The test program is under the "install/usr/bin" directory. The modules are under the "modules" directory.<br>
 +
The modules are under the "modules" directory. The driver's source code is in github: https://github.com/friendlyarm/linux-3.4.y.git <br>
 +
 +
 +
 +
===Run Test Program===
 +
 +
Please insert a TF card which is flashed with Debian to a Linux host and mount its boot and rootfs sections.<br>
 +
We assume the rootfs is mounted to /media/rootfs then please run the following commands to copy the module, library and test program to the card.<br>
 +
<syntaxhighlight lang="bash">
 +
$ cp modules /media/rootfs/ -r
 +
$ cp install/lib/* /media/rootfs/lib/ -d
 +
$ cp install/usr/bin/* /media/rootfs/usr/bin/
 +
</syntaxhighlight>
 +
 +
Insert this TF card to your NanoPi 2, power on and run the following command to start the matrix-compass program.<br>
 +
<syntaxhighlight lang="bash">
 +
$ matrix-compass
 +
</syntaxhighlight>
 +
Note: this module is not plug and play therefore before running the module please make sure it is connected to a NanoPi 2.<br>
 +
Here is what you should expect:<br>
 +
[[File:matrix-compass_result.png|frameless|600px|matrix-compass_result]]
  
===Linux下的C示例===
+
===Code Sample===
 
<syntaxhighlight lang="c">
 
<syntaxhighlight lang="c">
#include <stdio.h>
+
int main(int argc, char ** argv)
#include <stdlib.h>
+
{
 +
    int devFD;
 +
    double angle;
  
 +
    if ((devFD = hmc5883Init()) == -1) {
 +
        printf("Fail to init hmc5883\n");
 +
        return -1;
 +
    }
 +
 +
    if ((angle = hmc5883Read(devFD)) == -1) {
 +
        printf("Fail to read hmc5883\n");
 +
        hmc5883DeInit(devFD);
 +
        return -1;
 +
    }
 +
    printf("The angle is %f\n", angle);
 +
    printf("You are heading ");
 +
    if((angle < 22.5) || (angle > 337.5 )) {         
 +
        printf("South\n");
 +
    }
 +
    else if((angle > 22.5) && (angle < 67.5 )) {
 +
        printf("South-West\n");
 +
    }
 +
    else if((angle > 67.5) && (angle < 112.5 )) { 
 +
        printf("West\n");
 +
    }
 +
    else if((angle > 112.5) && (angle < 157.5 )) { 
 +
        printf("North-West\n");
 +
    }
 +
    else if((angle > 157.5) && (angle < 202.5 )) { 
 +
        printf("North\n");
 +
    }
 +
    else if((angle > 202.5) && (angle < 247.5 )) { 
 +
        printf("NorthEast\n");
 +
    }
 +
    else if((angle > 247.5) && (angle < 292.5 )) { 
 +
        printf("East\n");
 +
    }
 +
    else if((angle > 292.5) && (angle < 337.5 )) { 
 +
        printf("SouthEast\n");
 +
    }
 +
    hmc5883DeInit(devFD);
 +
    return 0;
 +
}
 
</syntaxhighlight>
 
</syntaxhighlight>
  
===编译并运行示例===
+
==Connect to NanoPi==
 +
===Preparations===
 +
Please install a Debian on a NanoPi and an appropriate cross compiler on a PC. Please refer to wiki: [[NanoPi/zh|NanoPi]] <br>
 +
Compile a NanoPi kernel. Note: please use the kernel's source code from the nanopi-v4.1.y-matrix branch.<br>
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
 +
$ git clone https://github.com/friendlyarm/linux-4.x.y.git
 +
$ cd linux-4.x.y
 +
$ git checkout nanopi-v4.1.y-matrix
 +
$ make nanopi_defconfig
 +
$ touch .scmversion
 +
$ make
 +
</syntaxhighlight>
  
 +
===Hardware Connection===
 +
Please refer to the following connection diagram to connect the Matrix-3_Axis_Digital_Compass module to the NanoPi <br>
 +
[[File:matrix-3_axis_digital_compass_nanopi.jpg|frameless|600px|matrix-3_axis_digital_compass_nanopi]]
 +
 +
Connection Details:
 +
{| class="wikitable"
 +
|-
 +
|Matrix-3_Axis_Digital_Compass || NanoPi     
 +
|-
 +
|SDA    || Pin3
 +
|-
 +
|SCL    || Pin5
 +
|-
 +
|5V      || Pin4
 +
|-
 +
|GND    || Pin6
 +
|}
 +
 +
===Compile Test Program===
 +
Please login the matrix hub and enter the nanopi branch
 +
<syntaxhighlight lang="bash">
 +
$ cd matrix
 +
$ git checkout nanopi
 
</syntaxhighlight>
 
</syntaxhighlight>
将编译生成的adxl34x通过ftp上传到开发板上运行即可测试。
 
  
==相关资料==
+
Compile the matrix code
 +
<syntaxhighlight lang="bash">
 +
$ make CROSS_COMPILE=arm-linux- clean
 +
$ make CROSS_COMPILE=arm-linux-
 +
$ make CROSS_COMPILE=arm-linux- install
 +
</syntaxhighlight>
 +
Note: please make sure to install the cross compiler "arm-linux-gcc-4.4.3" on your PC, which is used to compile files for the NanoPi-Debian.<br>
 +
Generated library files are under the "install/lib" directory. Applications are under the "install/usr/bin" directory. The test program for the "Matrix-3_Axis_Digital_Compass" module is "matrix-compass".<br>
 +
 
 +
===Run Test Program===
 +
Please copy the library files and test program to the NanoPi
 +
<syntaxhighlight lang="bash">
 +
$ cp install/usr/bin/* nanopi_rootfs/usr/bin/
 +
$ cp install/lib/* nanopi_rootfs/lib/ -d
 +
</syntaxhighlight>
 +
 
 +
Power on the NanoPi and run the following command in Debian's terminal <br>
 +
Note: this module is not plug and play therefore before running the module please make sure it is connected to a NanoPi.
 +
<syntaxhighlight lang="bash">
 +
$ matrix-3_axis_digital_compass
 +
</syntaxhighlight>
 +
 
 +
===Code Sample===
 +
<syntaxhighlight lang="c">
 +
int main(int argc, char ** argv)
 +
{
 +
    int devFD;
 +
    double angle;
 +
 
 +
    if ((devFD = hmc5883Init()) == -1) {
 +
        printf("Fail to init hmc5883\n");
 +
        return -1;
 +
    }
 +
 
 +
    if ((angle = hmc5883Read(devFD)) == -1) {
 +
        printf("Fail to read hmc5883\n");
 +
        hmc5883DeInit(devFD);
 +
        return -1;
 +
    }
 +
    printf("The angle is %f\n", angle);
 +
    printf("You are heading ");
 +
    if((angle < 22.5) || (angle > 337.5 )) {         
 +
        printf("South\n");
 +
    }
 +
    else if((angle > 22.5) && (angle < 67.5 )) {
 +
        printf("South-West\n");
 +
    }
 +
    else if((angle > 67.5) && (angle < 112.5 )) { 
 +
        printf("West\n");
 +
    }
 +
    else if((angle > 112.5) && (angle < 157.5 )) { 
 +
        printf("North-West\n");
 +
    }
 +
    else if((angle > 157.5) && (angle < 202.5 )) { 
 +
        printf("North\n");
 +
    }
 +
    else if((angle > 202.5) && (angle < 247.5 )) { 
 +
        printf("NorthEast\n");
 +
    }
 +
    else if((angle > 247.5) && (angle < 292.5 )) { 
 +
        printf("East\n");
 +
    }
 +
    else if((angle > 292.5) && (angle < 337.5 )) { 
 +
        printf("SouthEast\n");
 +
    }
 +
    hmc5883DeInit(devFD);
 +
    return 0;
 +
}
 +
</syntaxhighlight>
 +
 
 +
==Connect to Tiny4412==
 +
===Preparations===
 +
Please refer to the Tiny4412's user's manual to install a UbuntuCore on the Tiny4412 and install an appropriate cross compiler on a PC.<br>
 +
Note: only the Tiny4412SDK-1506 carrier board can work with this module.
 +
 
 +
===Hardware Connection===
 +
Please refer to the following diagram to connect the Matrix-3_Axis_Digital_Compass to the Tiny4412 <br>
 +
[[File:matrix-3_axis_digital_compass_tiny4412.jpg|frameless|600px|matrix-3_axis_digital_compass_tiny4412]]
 +
 
 +
Connection Details:
 +
{| class="wikitable"
 +
|-
 +
|Matrix-3_Axis_Digital_Compass || Tiny4412     
 +
|-
 +
|SDA    || CON18 SDA
 +
|-
 +
|SCL    || CON18 SCL
 +
|-
 +
|5V      || CON18 5V
 +
|-
 +
|GND    || CON18 GND
 +
|}
 +
 
 +
===Compile Test Program===
 +
Please login the Matrix hub and enter the matrix-tiny4412 branch
 +
<syntaxhighlight lang="bash">
 +
$ cd matrix
 +
$ git checkout tiny4412
 +
</syntaxhighlight>
 +
 
 +
Compile the matrix code
 +
<syntaxhighlight lang="bash">
 +
$ make CROSS_COMPILE=arm-linux-gnueabihf- clean
 +
$ make CROSS_COMPILE=arm-linux-gnueabihf-
 +
$ make CROSS_COMPILE=arm-linux-gnueabihf- install
 +
</syntaxhighlight>
 +
Note: please make sure to install the cross compiler "arm-linux-gnueabihf-gcc-4.7.3" on your PC, which is used to compile files for the Tiny4412-UbuntuCore.<br>
 +
Generated library files are under the "install/lib" directory. Applications are under the "install/usr/bin" directory. The test program for the "Matrix-3_Axis_Digital_Compass" module is "matrix-compass".
 +
 
 +
===Run Test Program===
 +
Please copy the library files and test program to the Tiny4412
 +
<syntaxhighlight lang="bash">
 +
$ cp install/usr/bin/* tiny4412_rootfs/usr/bin/
 +
$ cp install/lib/* tiny4412_rootfs/lib/ -d
 +
</syntaxhighlight>
 +
 
 +
Power on the Tiny4412 and run the following command in UbuntuCore's terminal <br>
 +
Note: this module is not plug and play therefore before running the module please make sure it is connected to a Tiny4412.
 +
<syntaxhighlight lang="bash">
 +
$ matrix-3_axis_digital_compass
 +
</syntaxhighlight>
 +
 
 +
===Code Sample===
 +
<syntaxhighlight lang="c">
 +
int main(int argc, char ** argv)
 +
{
 +
    int devFD;
 +
    double angle;
 +
 
 +
    if ((devFD = hmc5883Init()) == -1) {
 +
        printf("Fail to init hmc5883\n");
 +
        return -1;
 +
    }
 +
 
 +
    if ((angle = hmc5883Read(devFD)) == -1) {
 +
        printf("Fail to read hmc5883\n");
 +
        hmc5883DeInit(devFD);
 +
        return -1;
 +
    }
 +
    printf("The angle is %f\n", angle);
 +
    printf("You are heading ");
 +
    if((angle < 22.5) || (angle > 337.5 )) {         
 +
        printf("South\n");
 +
    }
 +
    else if((angle > 22.5) && (angle < 67.5 )) {
 +
        printf("South-West\n");
 +
    }
 +
    else if((angle > 67.5) && (angle < 112.5 )) { 
 +
        printf("West\n");
 +
    }
 +
    else if((angle > 112.5) && (angle < 157.5 )) { 
 +
        printf("North-West\n");
 +
    }
 +
    else if((angle > 157.5) && (angle < 202.5 )) { 
 +
        printf("North\n");
 +
    }
 +
    else if((angle > 202.5) && (angle < 247.5 )) { 
 +
        printf("NorthEast\n");
 +
    }
 +
    else if((angle > 247.5) && (angle < 292.5 )) { 
 +
        printf("East\n");
 +
    }
 +
    else if((angle > 292.5) && (angle < 337.5 )) { 
 +
        printf("SouthEast\n");
 +
    }
 +
    hmc5883DeInit(devFD);
 +
    return 0;
 +
}
 +
</syntaxhighlight>
 +
 
 +
==Connect to RaspberryPi==
 +
 
 +
==Connect to Arduino==
 +
 
 +
--->
 +
 
 +
==Compile & Run Test Program==
 +
Boot your ARM board with Debian and copy the matrix code:
 +
<syntaxhighlight lang="bash">
 +
$ apt-get update && apt-get install git
 +
$ git clone https://github.com/friendlyarm/matrix.git
 +
</syntaxhighlight>
 +
If your cloning is done successfully a "matrix" directory will be generated.
 +
 
 +
Compile and install Matrix:
 +
<syntaxhighlight lang="bash">
 +
$ cd matrix
 +
$ make && make install
 +
</syntaxhighlight>
 +
 
 +
Run test program:
 +
<syntaxhighlight lang="bash">
 +
$ matrix-compass
 +
</syntaxhighlight>
 +
Note: this module is not plug and play therefore before running the module please make sure it is connected to an ARM board.<br>
 +
Here is what you should observe:<br>
 +
<syntaxhighlight lang="bash">
 +
The angle is 305.2
 +
</syntaxhighlight>
 +
305.2 is the angle's value whose range is 0 ~ 360.
 +
 
 +
==Code Sample==
 +
This Matrix code sample can work with all the ARM boards mentioned in this module's wiki. The name of this code sample is "matrix-3_axis_digital_compass". Here is its source code:
 +
<syntaxhighlight lang="c">
 +
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;
 +
}
 +
</syntaxhighlight>
 +
For more details about this APIs called in this code sample refer to [[Matrix API reference manual]] <br>
 +
 
 +
 
 +
==Resources==
 +
[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]
 +
 
 +
==Update Log==
 +
===Feb-23-2016===
 +
* Added the description for "NanoPi 2 branch" in Section 4
 +
* Added driver's source code location in Section 5.2
 +
 
 +
===June-16-2016===
 +
* Re-organized and simplified wiki

Latest revision as of 08:50, 7 July 2016

查看中文

1 Introduction

3-Axis Digital Compass
  • The Matrix-3_Axis_Digital_Compass module is designed to measure the direction and functions like to a compass.
  • It utilizes the HMC5883L chip. The HMC5883L includes high-resolution HMC118X series magneto-resistive sensors plus an ASIC containing amplification, automatic degaussing strap drivers, offset cancellation, and a 12-bit ADC that enables 1° to 2° compass heading accuracy. It achieves 2 milli-gauss field resolution in ±8 gauss fields. These sensors’ solid-state construction with very low cross-axis sensitivity is designed to measure both the direction and the magnitude of Earth’s magnetic fields, from milli-gauss to 8 gauss. It has an I2C serial bus interface.
  • It integrates a 3.3V power conversion IC allowing it to be powered by an external 5V power source. It can be controlled by an I2C master.

2 Features

  • I2C,3.3V
  • 1° to 2° compass heading accuracy
  • 2.54 mm spacing pin
  • PCB Dimension(mm): 16 x 16

重力加速度PCB

  • Pin Description:
Pin Description
SDA I2C SDA
SCL I2C SCL
5V Supply Voltage 5V
GND Ground

3 Basic Device Operation

  • The Honeywell HMC5883L magnetoresistive sensor circuit is a trio of sensors and application specific support circuits to measure magnetic fields. With power supply applied, the sensor converts any incident magnetic field in the sensitive axis directions to a differential voltage output. The magnetoresistive sensors are made of a nickel-iron (Permalloy) thin-film and patterned as a resistive strip element. In the presence of a magnetic field, a change in the bridge resistive elements causes a corresponding change in voltage across the bridge outputs. These resistive elements are aligned together to have a common sensitive axis (indicated by arrows in the pinout diagram) that will provide positive voltage change with magnetic fields increasing in the sensitive direction. Because the output is only proportional to the magnetic field component along its axis, additional sensor bridges are placed at orthogonal directions to permit accurate measurement of magnetic field in any orientation.
  • The HMC5883L communicates via a two-wire I2C bus system as a slave device. It has 8-bit read address and 8-bit write address. This device supports standard and fast modes, 100kHz and 400kHz, respectively, but does not support the high speed mode (Hs). The bus bit format is an 8-bit Data/Address send and a 1-bit acknowledge bit. The format of the data bytes (payload) shall be case sensitive ASCII characters or binary data to the HMC5883L slave, and binary data returned. Negative binary values will be in two’s complement form. The default (factory) HMC5883L 8-bit slave address is 0x3C for write operations, or 0x3D for read operations.
  • The module has an I2C interface which complies to the I2C standard protocol and the connection diagram is as follows

三轴重力加速度


4 Applications

4.1 Connect to NanoPi M1

Refer to the following connection diagram to connect the module to the NanoPi M1:
Matrix-3_Axis_Digital_Compass_nanopi_m1

Connection Details:

Matrix-3_Axis_Digital_Compass NanoPi M1
SDA Pin3
SCL Pin5
5V Pin4
GND Pin6

4.2 Connect to NanoPi 2

Refer to the following connection diagram to connect the module to the NanoPi 2:
Matrix-3_Axis_Digital_Compass_nanopi_2

Connection Details:

Matrix-3_Axis_Digital_Compass NanoPi 2
SDA Pin3
SCL Pin5
5V Pin4
GND Pin6

4.3 Connect to NanoPi M2 / NanoPi 2 Fire

Refer to the following connection diagram to connect the module to the NanoPi M2/ NanoPi 2 Fire.
Matrix-3_Axis_Digital_Compass_nanopi_m2

Connection Details:

Matrix-3_Axis_Digital_Compass NanoPi M2
SDA Pin3
SCL Pin5
5V Pin4
GND Pin6

4.4 Connect to NanoPC-T2

Refer to the following connection diagram to connect the module to the NanoPC-T2
Matrix-3_Axis_Digital_Compass_NanoPC-T2

Connection Details:

Matrix-3_Axis_Digital_Compass NanoPC-T2
SDA Pin6
SCL Pin5
5V Pin29
GND Pin30


5 Compile & Run Test Program

Boot your ARM board with Debian and copy the matrix code:

$ apt-get update && apt-get install git
$ git clone https://github.com/friendlyarm/matrix.git

If your cloning is done successfully a "matrix" directory will be generated.

Compile and install Matrix:

$ cd matrix
$ make && make install

Run test program:

$ matrix-compass

Note: this module is not plug and play therefore before running the module please make sure it is connected to an ARM board.
Here is what you should observe:

The angle is 305.2

305.2 is the angle's value whose range is 0 ~ 360.

6 Code Sample

This Matrix code sample can work with all the ARM boards mentioned in this module's wiki. The name of this code sample is "matrix-3_axis_digital_compass". Here is its source code:

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;
}

For more details about this APIs called in this code sample refer to Matrix API reference manual


7 Resources

HMC5883L_3-Axis_Digital_Compass_IC.pdf

8 Update Log

8.1 Feb-23-2016

  • Added the description for "NanoPi 2 branch" in Section 4
  • Added driver's source code location in Section 5.2

8.2 June-16-2016

  • Re-organized and simplified wiki