Difference between revisions of "Matrix - Compact Kit B/zh"

From FriendlyELEC WiKi
Jump to: navigation, search
(特性)
(连接NanoPi M2 / NanoPi 2 Fire)
 
(13 intermediate revisions by 3 users not shown)
Line 38: Line 38:
 
* PCB尺寸(mm):64X40
 
* PCB尺寸(mm):64X40
 
[[File:Matrix-Compact_Kit_B_PCB.png|frameless|400px|]]
 
[[File:Matrix-Compact_Kit_B_PCB.png|frameless|400px|]]
[[File:Matrix-Compact_Kit_B01.png |thumb|300px|Matrix-Compact_Kit_B接口布局]]
 
 
* '''40pin排母GPIO管脚定义'''
 
* '''40pin排母GPIO管脚定义'''
 
::{| class="wikitable"
 
::{| class="wikitable"
Line 84: Line 83:
 
|39  || DGND          ||40    || SPI2_CLK/GPIOC9
 
|39  || DGND          ||40    || SPI2_CLK/GPIOC9
 
|}
 
|}
[[File:Matrix-Compact_Kit_B3*10.png |thumb|300px|Matrix-Compact_Kit_B接口布局]]
 
 
* '''30pin排针管脚定义'''
 
* '''30pin排针管脚定义'''
 
::{| class="wikitable"
 
::{| class="wikitable"
Line 124: Line 122:
 
|}
 
|}
  
==下载Matrix源码==
+
==硬件连接==
Matrix配件相关的代码是完全开源的,统一由一个仓库进行管理:https://github.com/friendlyarm/matrix.git <br>
+
===连接NanoPi M1===
该仓库里不同的分支代表着Matrix配件所支持的不同开发板。<br>
+
参考下图连接模块:<br>
* nanopi分支用于支持NanoPi;
+
[[File:Matrix-Compact_Kit_B_nanopi_m1.jpg|frameless|600px|Matrix-Compact_Kit_B_nanopi_m1]]
* nanopi2分支用于支持NanoPi 2;
+
* tiny4412分支用于支持Tiny4412;
+
* raspberrypi分支用于支持RaspberryPi;
+
  
在主机PC上安装git,以Ubuntu14.04为例
+
===连接NanoPi M2 / NanoPi 2 Fire===
<syntaxhighlight lang="bash">
+
NanoPi M2和NanoPi 2 Fire的40 Pin引脚定义是一模一样的,所以它们操作Matrix配件的步骤是一样的,这里仅以NanoPi M2为例。<br>
$ sudo apt-get install git
+
参考下图连接模块:<br>
</syntaxhighlight>
+
[[File:Matrix-Compact_Kit_B_nanopi_m2.jpg|frameless|600px|Matrix-Compact_Kit_B_nanopi_m2]]
 +
 
 +
===连接NanoPi M3===
 +
参考下图连接模块:<br>
 +
[[File:Matrix-Compact_Kit_B_nanopi_m3.jpg|frameless|600px|Matrix-Compact_Kit_B_nanopi_m3]]
  
克隆Matrix配件代码仓库
+
==编译运行测试程序==
 +
启动开发板并运行Debian系统,进入系统后克隆Matrix代码仓库:
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
 +
$ apt-get update && apt-get install git
 
$ git clone https://github.com/friendlyarm/matrix.git
 
$ git clone https://github.com/friendlyarm/matrix.git
 
</syntaxhighlight>
 
</syntaxhighlight>
克隆完成后会得到一个名为matrix的目录,里面存放着所有Matrix配件的代码。
+
克隆完成后会得到一个名为matrix的目录。
  
==与NanoPi 2 Fire连接使用==
+
编译并安装Matrix:
===硬件连接===
+
参考下图连接模块Matrix-Compact_Kit_B和NanoPi 2:<br>
+
[[File:Matrix-Compact_Kit_B_nanopi2.jpg|frameless|600px|Matrix-Compact_Kit_B_nanopi2]]
+
 
+
===编译测试程序===
+
进入Matrix代码仓库,切换到nanopi2分支
+
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
 
$ cd matrix
 
$ cd matrix
$ git checkout nanopi2
+
$ make && make install
 
</syntaxhighlight>
 
</syntaxhighlight>
  
编译Matrix配件代码
+
运行测试程序:
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
$ make CROSS_COMPILE=arm-linux- clean
+
$ matrix-compact_kit
$ make CROSS_COMPILE=arm-linux-
+
$ make CROSS_COMPILE=arm-linux- install
+
</syntaxhighlight>
+
注意:请确保你的主机PC当前使用的交叉编译器为NanoPi 2配套的arm-linux-gcc-4.9.3。<br>
+
编译成功后库文件位于install/lib目录下,测试程序位于install/usr/bin目录下,硬件驱动模块位于modules目录。<br>
+
硬件驱动模块位于modules目录下,对应的驱动源码都包含在在NanoPi 2的Linux内核仓库里:https://github.com/friendlyarm/linux-3.4.y.git <br>
+
 
+
===拷贝测试程序===
+
将带有Debian系统的SD卡插入一台运行Linux的电脑,可以挂载SD卡上的boot和rootfs分区。<br>
+
假设rootfs分区的挂载路径为/media/rootfs,执行以下命令将Matrix的硬件驱动、库文件和测试程序拷贝到NanoPi 2的文件系统上。<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>
+
 
+
===测试LCD显示===
+
将SD卡重新插入NanoPi 2,上电启动,在Debian的shell终端中执行以下命令。<br>
+
<syntaxhighlight lang="bash">
+
$ cd /modules
+
$ insmod fbtft_device.ko name=matrix-st7735s gpios=dc:58,reset:63,cs:59
+
$ sudo FRAMEBUFFER=/dev/fb-st7735s startx &
+
</syntaxhighlight>
+
fbtft_device是LCD驱动,成功加载驱动后,可以看到LCD被清屏。<br>
+
startx命令会将1寸屏作为桌面显示设备,运行效果如下:<br>
+
[[File:matrix-cpt_kit_b_result1.png|frameless|600px|matrix-cpt_kit_b_result_lcd]]
+
 
+
===测试蜂鸣器===
+
将蜂鸣器的跳线接到ON,执行以下命令控制蜂鸣器:<br>
+
<syntaxhighlight lang="bash">
+
$ cd /modules
+
$ insmod matrix_pwm.ko
+
$ matrix-buzzer
+
 
</syntaxhighlight>
 
</syntaxhighlight>
 +
注意:此模块并不支持热插拔,启动系统前需要确保硬件连接正确。<br>
 
运行效果如下:<br>
 
运行效果如下:<br>
[[File:matrix-buzzer_result.png|frameless|600px|matrix-buzzer_result]] <br>
 
可以听到蜂鸣器在响,默认输出的PWM频率为1KHz,占用比为50%。
 
 
===控制LED===
 
{| class="wikitable"
 
|-
 
|LED  || CPU GPIO        || Linux索引号 || 物理索引号
 
|-
 
|红色LED1 || GPIOB28    || 60          || 28
 
|-
 
|绿色LED2 || GPIOC7    || 71          || 31
 
|-
 
|蓝色LED3 || ALIVEGPIO3 || 163          || 37
 
|-
 
|黄色LED4 || GPIOC11    || 75          || 35
 
|}
 
以LED1为例,执行以下命令控制LED:
 
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
$ cd /sys/class/gpio/
+
LED blinking 1
$ echo 60 > export
+
LED blinking 2
$ echo out > gpio60/direction
+
Button:  1 1 1
$ echo 1 > gpio60/value
+
The channel0 value is 2070
 +
The angle is 336.3
 +
Pwm start
 +
Pwm stop
 
</syntaxhighlight>
 
</syntaxhighlight>
1表示点亮LED1,0表示熄灭LED1。
 
  
===读按键值===
+
运行Qt程序,测试TFT屏:
{| class="wikitable"
+
|-
+
|按键 || CPU GPIO  || Linux索引号 || 物理索引号
+
|-
+
|KEY1 || GPIOC10    || 74  || 36
+
|-
+
|KEY2 || GPIOC12    || 76  || 38
+
|-
+
|KEY3 || GPIOC9      || 73  || 40
+
|}
+
以KEY1为例,执行以下命令读取按键值:
+
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
$ cd /sys/class/gpio/
+
cd matrix/demo/nanopi-status
$ echo 74 > export
+
./build.sh
$ echo in > gpio74/direction
+
./run.sh /dev/fb-st7735s
$ cat gpio74/value
+
 
</syntaxhighlight>
 
</syntaxhighlight>
当KEY1按下时value=0,KEY1弹起时value=1。
+
程序会显示出系统的基本信息,效果如下:<br>
 +
[[File:st7735s-status.pnc|frameless|600px|st7735s-status]]
  
===测试AD转换===
+
==代码说明==
执行以下命令获得Channel0的AD转换值:
+
所有的开发板都共用一套Matrix代码,本模块的测试示例代码为matrix-compact_kit,内容如下:
<syntaxhighlight lang="bash">
+
<syntaxhighlight lang="c">
$ cd /modules
+
int main(int argc, char ** argv)
$ insmod pcf8591.ko
+
{
$ matrix-adc
+
    int board;
 +
   
 +
    if ((board = boardInit()) < 0) {
 +
        printf("Fail to init board\n");
 +
        return -1;
 +
    }
 +
    testLED(board);
 +
    readButton();
 +
    readADC();
 +
    readCompass();
 +
    testPWM(board);
 +
    // readTemp();
 +
    // testIR();
 +
   
 +
    return 0;
 +
}
 
</syntaxhighlight>
 
</syntaxhighlight>
通过旋转可调电阻可以改变AD转换值,运行效果如下:<br>
+
API说明参考维基:[[Matrix API reference manual/zh|Matrix API reference manual]] <br>
[[File:matrix-cpt_kit_result2.png|frameless|600px|matrix-cpt_kit_result_ad]]
+
 
+
===测试指南针===
+
执行以下命令获得当前方向:
+
<syntaxhighlight lang="bash">
+
$ matrix-compass
+
</syntaxhighlight>
+
通过改变开发板的朝向可以获得不同的方向值,运行效果如下:<br>
+
[[File:matrix-cpt_kit_result3.png|frameless|600px|matrix-cpt_kit_result_cps]]
+
 
+
===测试温度传感器===
+
注意:引脚反接会损坏原件,请参考下图连接模块Matrix-Compact_Kit_B和温度传感器DS18B20:<br>
+
[[File:Matrix-Compact_Kit_B_ds18b20.jpg|frameless|600px|Matrix-Compact_Kit_B_ds18b20]]
+
 
+
执行以下命令操作温度传感器:
+
<syntaxhighlight lang="bash">
+
$ cd /modules
+
$ insmod w1-gpio.ko
+
$ insmod w1-gpio-board.ko gpio=72
+
$ matrix-temp_sensor
+
</syntaxhighlight>
+
gpio=72表示使用引脚GPIOC8,72是该引脚在Linux里的索引号。<br>
+
运行效果如下:<br>
+
[[File:matrix-temperature_sensor_result.png|frameless|600px|matrix-temperature_sensor_result]]
+
 
+
===测试红外接收头===
+
参考下图连接模块Matrix-Compact_Kit和红外接收头VS1833B:<br>
+
[[File:Matrix-Compact_Kit_B_vs1833b.jpg|frameless|600px|Matrix-Compact_Kit_B_vs1833b]]
+
 
+
执行以下命令操作红外接收头:
+
<syntaxhighlight lang="bash">
+
$ cd /modules
+
$ insmod matrix_ir_recv.ko gpio=92
+
</syntaxhighlight>
+
gpio=92表示使用引脚GPIOC28,92是该引脚在Linux里的索引号。<br>
+
成功加载驱动后,会在/dev/input/目录下生成一个event设备节点,这里假设生成的设备节点为event1。<br>
+
 
+
开源软件input-utils可以读取event设备的数据,它的使用方法如下:<br>
+
<syntaxhighlight lang="bash">
+
$ apt-get install input-utils
+
$ input-events 1
+
</syntaxhighlight>
+
1表示读设备节点event1。<br>
+
 
+
用一个普通的遥控器往模块发送数据,可看到运行效果如下:<br>
+
[[File:matrix-ir_receiver_result.png|frameless|600px|matrix-ir_receiver_result]]
+
 
+
===通过Python控制===
+
 
+
==与NanoPi连接使用==
+
 
+
==与Tiny4412连接使用==
+
 
+
==与RaspberryPi连接使用==
+
 
+
==与Arduino连接使用==
+
  
 
==相关资料==
 
==相关资料==
 
*[Schematic]([http://wiki.friendlyarm.com/wiki/images/9/90/SCHEMATIC1_martix_compact_B.pdf Matrix - Compact Kit B-Schematic.pdf])
 
*[Schematic]([http://wiki.friendlyarm.com/wiki/images/9/90/SCHEMATIC1_martix_compact_B.pdf Matrix - Compact Kit B-Schematic.pdf])

Latest revision as of 09:39, 15 July 2016

English

1 介绍

Matrix-Compact Kit B.png
  • Matrix - Compact_Kit_B是为Nanopi 2 Fire的接口开发的一款紧凑、简洁的多功能开发者套件,该套件由一系列常用电气元件经过精心构建而成,色彩斑斓,资源丰富,包括了按键、LED、无源蜂鸣器、ADC、指南针、温度传感器、红外接收器、TFT等14种资源。该套件可以直接通过40pin排母和NanoPi2 Fire连接。除了丰富的板上资源以外,您还可以通过扩展的IO口外接模块,基于本产品开发出功能丰富的应用。

2 资源

Matrix - Compact Kit B集成的元件如下:

  • 0.9 TFT LCD
  • 轻触开关3个
  • 5mm LED4个
  • 无源蜂鸣器
  • ADC
  • 滑动变阻器
  • 40pin排母
  • 4pin排针---I2C接口
  • 4pin排针---UART接口
  • 3pin双排针---3.3V和GND
  • 18B20温度传感器
  • 红外接收器
  • 3pin排座10个---3个模拟IO,7个数字IO(其中两个可复用为PWM,四个复用为SPI 接口)
  • 指南针

3 特性

  • PCB尺寸(mm):64X40

Matrix-Compact Kit B PCB.png

  • 40pin排母GPIO管脚定义
Pin# Name Pin# Name
1 SYS_3.3V 2 VDD_5V
3 I2C0_SDA 4 VDD_5V
5 I2C0_SCL 6 DGND
7 GPIOD8/PPM 8 UART3_TXD/GPIOD21
9 DGND 10 UART3_RXD/GPIOD17
11 UART4_TX/GPIOB29 12 GPIOD1/PWM0
13 GPIOB30 14 DGND
15 GPIOB31 16 GPIOC14/PWM2
17 SYS_3.3V 18 GPIOB27
19 SPI0_MOSI/GPIOC31 20 DGND
21 SPI0_MISO/GPIOD0 22 UART4_RX/GPIOB28
23 SPI0_CLK/GPIOC29 24 SPI0_CS/GPIOC30
25 DGND 26 GPIOB26
27 I2C1_SDA 28 I2C1_SCL
29 GPIOC8 30 DGND
31 GPIOC7 32 GPIOC28
33 GPIOC13/PWM1 34 DGND
35 SPI2_MISO/GPIOC11 36 SPI2_CS/GPIOC10
37 AliveGPIO3 38 SPI2_MOSI/GPIOC12
39 DGND 40 SPI2_CLK/GPIOC9
  • 30pin排针管脚定义
Pin# Name Pin# Name Pin# Name
1 GND 2 VDD_5V 3 A1_PCF
4 GND 5 VDD_5V 6 A2_PCF
7 GND 8 VDD_5V 9 A3_PCF
10 GND 11 VDD_5V 12 D1_Pi11
13 GND 14 VDD_5V 15 D2_Pi33
16 GND 17 VDD_5V 18 D3_Pi16
19 GND 20 VDD_5V 21 D4_Pi19
22 GND 23 VDD_5V 24 D5_Pi21
25 GND 26 VDD_5V 27 D6_Pi23
28 GND 29 VDD_5V 30 D7_Pi24
18B20和红外接收接口布局
  • 18B20和红外接收管脚定义
模块 Pin# Name Pin# Name Pin# Name
18B20 1 VDD_5V 2 DATA 3 GND
红外接收管 1 DATA 2 GND 3 VDD_5V

4 硬件连接

4.1 连接NanoPi M1

参考下图连接模块:
Matrix-Compact_Kit_B_nanopi_m1

4.2 连接NanoPi M2 / NanoPi 2 Fire

NanoPi M2和NanoPi 2 Fire的40 Pin引脚定义是一模一样的,所以它们操作Matrix配件的步骤是一样的,这里仅以NanoPi M2为例。
参考下图连接模块:
Matrix-Compact_Kit_B_nanopi_m2

4.3 连接NanoPi M3

参考下图连接模块:
Matrix-Compact_Kit_B_nanopi_m3

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-compact_kit

注意:此模块并不支持热插拔,启动系统前需要确保硬件连接正确。
运行效果如下:

LED blinking 1
LED blinking 2
Button:  1 1 1
The channel0 value is 2070
The angle is 336.3
Pwm start
Pwm stop

运行Qt程序,测试TFT屏:

cd matrix/demo/nanopi-status
./build.sh
./run.sh /dev/fb-st7735s

程序会显示出系统的基本信息,效果如下:
st7735s-status

6 代码说明

所有的开发板都共用一套Matrix代码,本模块的测试示例代码为matrix-compact_kit,内容如下:

int main(int argc, char ** argv)
{
    int board;
 
    if ((board = boardInit()) < 0) {
        printf("Fail to init board\n");
        return -1;
    }
    testLED(board);
    readButton();
    readADC();
    readCompass();
    testPWM(board);
    // readTemp();
    // testIR();
 
    return 0;
}

API说明参考维基:Matrix API reference manual

7 相关资料