Difference between revisions of "Matrix - Button/zh"
From FriendlyELEC WiKi
(→准备工作) |
(→连接NanoPC-T2) |
||
(27 intermediate revisions by 3 users not shown) | |||
Line 24: | Line 24: | ||
==工作原理== | ==工作原理== | ||
− | *Matrix-Button主要器件是一个瞬时(非自锁)按钮开关,通过3-Pin 2.54mm排针中的S信号输出按钮开关的状态。 | + | * Matrix-Button主要器件是一个瞬时(非自锁)按钮开关,通过3-Pin 2.54mm排针中的S信号输出按钮开关的状态。 |
− | *平时没有按下按钮时触点断开,S输出高电平;当按下按钮时触点导通,S输出低电平,直到松开才恢复高电平。 | + | * 平时没有按下按钮时触点断开,S输出高电平;当按下按钮时触点导通,S输出低电平,直到松开才恢复高电平。 |
− | == | + | ==硬件连接== |
− | + | ===连接NanoPi NEO/NanoPi NEO Air=== | |
− | + | NanoPi M1和NanoPi NEO以及NanoPi NEO Air的前24Pin引脚定义是一模一样的,所以它们操作Matrix配件的步骤是一样的,并且使用同一份代码。<br> | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | 参考下图连接模块:<br> | |
− | < | + | [[File:Matrix-Button_nanopi_NEO.jpg|frameless|600px|Matrix-Button_nanopi_NEO]] |
− | + | ||
− | + | ||
− | + | 连接说明: | |
− | + | {| class="wikitable" | |
− | + | |- | |
− | + | |Matrix-Button || NanoPi NEO | |
− | + | |- | |
− | + | |S || Pin7 | |
− | + | |- | |
− | + | |V || Pin4 | |
− | + | |- | |
− | + | |G || Pin6 | |
− | + | |} | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | === | + | ===连接NanoPi M1=== |
− | + | 参考下图连接模块:<br> | |
− | [[File: | + | [[File:Matrix-Button_nanopi_m1.jpg|frameless|600px|Matrix-Button_nanopi_m1]] |
连接说明: | 连接说明: | ||
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
− | |Matrix-Button || NanoPi | + | |Matrix-Button || NanoPi M1 |
|- | |- | ||
− | |S | + | |S || Pin7 |
|- | |- | ||
|V || Pin4 | |V || Pin4 | ||
|- | |- | ||
− | |G | + | |G || Pin6 |
|} | |} | ||
− | === | + | ===连接NanoPi 2=== |
− | + | 参考下图连接模块:<br> | |
− | < | + | [[File:Matrix-Button_nanopi_2.jpg|frameless|600px|Matrix-Button_nanopi_2]] |
− | + | ||
− | + | ||
− | + | ||
− | + | 连接说明: | |
− | + | {| class="wikitable" | |
− | + | |- | |
− | + | |Matrix-Button || NanoPi 2 | |
− | + | |- | |
− | + | |S || Pin7 | |
− | + | |- | |
− | + | |V || Pin4 | |
+ | |- | ||
+ | |G || Pin6 | ||
+ | |} | ||
− | === | + | ===连接NanoPi M2 / NanoPi 2 Fire=== |
− | + | NanoPi M2和NanoPi 2 Fire的40 Pin引脚定义是一模一样的,所以它们操作Matrix配件的步骤是一样的,这里仅以NanoPi M2为例。<br> | |
− | < | + | 参考下图连接模块:<br> |
− | + | [[File:Matrix-Button_nanopi_m2.jpg|frameless|600px|Matrix-Button_nanopi_m2]] | |
− | + | ||
− | + | ||
− | + | 连接说明: | |
− | + | {| class="wikitable" | |
− | + | |- | |
− | + | |Matrix-Button || NanoPi M2 | |
+ | |- | ||
+ | |S || Pin7 | ||
+ | |- | ||
+ | |V || Pin4 | ||
+ | |- | ||
+ | |G || Pin6 | ||
+ | |} | ||
− | === | + | ===连接NanoPi M3=== |
− | < | + | 参考下图连接模块:<br> |
− | + | [[File:Matrix-Button_nanopi_m3.jpg|frameless|600px|Matrix-Button_nanopi_m3]] | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | 连接说明: | |
− | { | + | {| class="wikitable" |
− | + | |- | |
− | + | |Matrix-Button || NanoPi M3 | |
− | + | |- | |
− | + | |S || Pin7 | |
− | + | |- | |
− | + | |V || Pin4 | |
− | + | |- | |
− | + | |G || Pin6 | |
− | + | |} | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | === | + | ===连接NanoPC-T2/NanoPC-T3=== |
− | + | 由于NanoPC-T2跟NanoPC-T3的引脚是一样的,所以连接方式是一样的,这里仅以T2为例,参考下图连接模块:<br> | |
− | [[File: | + | [[File:Matrix-Button_NanoPC-T2.jpg|frameless|600px|Matrix-Button_NanoPC-T2]] |
连接说明: | 连接说明: | ||
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
− | |Matrix-Button || | + | |Matrix-Button || NanoPC-T2 |
|- | |- | ||
− | |S | + | |S || Pin15 |
|- | |- | ||
− | |V || | + | |V || Pin29 |
|- | |- | ||
− | |G | + | |G || 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-gpio_int |
− | + | ||
</syntaxhighlight> | </syntaxhighlight> | ||
− | + | 注意:此模块并不支持热插拔,启动系统前需要确保硬件连接正确。<br> | |
− | + | 运行效果如下:<br> | |
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash"> | ||
− | + | Waiting event... | |
+ | Device[0] value is 1 | ||
</syntaxhighlight> | </syntaxhighlight> | ||
+ | 按下按键时会检测到事件。 | ||
− | == | + | ==代码说明== |
+ | 所有的开发板都共用一套Matrix代码,本模块的测试示例代码为matrix-gpio_int,内容如下: | ||
<syntaxhighlight lang="c"> | <syntaxhighlight lang="c"> | ||
− | + | int main(int argc, char ** argv) | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | int main( | + | |
{ | { | ||
− | int i; | + | int i, board; |
int retSize = -1; | int retSize = -1; | ||
− | char value[ARRAY_SIZE( | + | char value[ARRAY_SIZE(dev)]; |
− | + | ||
− | if ((devFD =sensorInit( | + | if ((board = boardInit()) < 0) |
+ | printf("Fail to init board\n"); | ||
+ | |||
+ | if (argc == 2) { | ||
+ | dev[0].pin = atoi(argv[1]); | ||
+ | } | ||
+ | printf("Using GPIO_PIN(%d)\n", dev[0].pin); | ||
+ | system("modprobe "DRIVER_MODULE); | ||
+ | signal(SIGINT, intHandler); | ||
+ | if (board == BOARD_NANOPI_T2) | ||
+ | dev[0].pin = GPIO_PIN(15); | ||
+ | if ((devFD =sensorInit(dev, ARRAY_SIZE(dev))) == -1) { | ||
printf("Fail to init sensor\n"); | printf("Fail to init sensor\n"); | ||
return -1; | return -1; | ||
} | } | ||
− | printf(" | + | printf("Waiting event...\n"); |
− | if (( retSize = sensorRead(devFD, value, ARRAY_SIZE( | + | if ((retSize = sensorRead(devFD, value, ARRAY_SIZE(dev))) == -1) { |
printf("Fail to read sensors\n"); | printf("Fail to read sensors\n"); | ||
} | } | ||
Line 214: | Line 184: | ||
i = 0; | i = 0; | ||
for (i=0; i<retSize; i++) { | for (i=0; i<retSize; i++) { | ||
− | printf(" | + | printf("dev[%d] value: %d\n", i, value[i]); |
} | } | ||
} | } | ||
sensorDeinit(devFD); | sensorDeinit(devFD); | ||
+ | system("rmmod "DRIVER_MODULE); | ||
return 0; | return 0; | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
− | + | API说明参考维基:[[Matrix API reference manual/zh|Matrix API reference manual]] <br> | |
− | + | ||
− | + | ||
− | + | ||
==相关资料== | ==相关资料== |
Latest revision as of 08:43, 10 November 2016
Contents
1 介绍
- 模块Matrix-Button用于检测按键事件。
- 未按时输出高电平,按下后输出低电平。
2 特性
- 使用标准的3 PIN接口
- 尺寸为 8x24mm
- PCB尺寸(mm):8x24
- 引脚说明:
名称 | 描述 |
S | GPIO |
V | 电源5V |
G | 地 |
3 工作原理
- Matrix-Button主要器件是一个瞬时(非自锁)按钮开关,通过3-Pin 2.54mm排针中的S信号输出按钮开关的状态。
- 平时没有按下按钮时触点断开,S输出高电平;当按下按钮时触点导通,S输出低电平,直到松开才恢复高电平。
4 硬件连接
4.1 连接NanoPi NEO/NanoPi NEO Air
NanoPi M1和NanoPi NEO以及NanoPi NEO Air的前24Pin引脚定义是一模一样的,所以它们操作Matrix配件的步骤是一样的,并且使用同一份代码。
参考下图连接模块:
Matrix-Button_nanopi_NEO
连接说明:
Matrix-Button | NanoPi NEO |
S | Pin7 |
V | Pin4 |
G | Pin6 |
4.2 连接NanoPi M1
连接说明:
Matrix-Button | NanoPi M1 |
S | Pin7 |
V | Pin4 |
G | Pin6 |
4.3 连接NanoPi 2
连接说明:
Matrix-Button | NanoPi 2 |
S | Pin7 |
V | Pin4 |
G | Pin6 |
4.4 连接NanoPi M2 / NanoPi 2 Fire
NanoPi M2和NanoPi 2 Fire的40 Pin引脚定义是一模一样的,所以它们操作Matrix配件的步骤是一样的,这里仅以NanoPi M2为例。
参考下图连接模块:
连接说明:
Matrix-Button | NanoPi M2 |
S | Pin7 |
V | Pin4 |
G | Pin6 |
4.5 连接NanoPi M3
参考下图连接模块:
Matrix-Button_nanopi_m3
连接说明:
Matrix-Button | NanoPi M3 |
S | Pin7 |
V | Pin4 |
G | Pin6 |
4.6 连接NanoPC-T2/NanoPC-T3
由于NanoPC-T2跟NanoPC-T3的引脚是一样的,所以连接方式是一样的,这里仅以T2为例,参考下图连接模块:
Matrix-Button_NanoPC-T2
连接说明:
Matrix-Button | NanoPC-T2 |
S | Pin15 |
V | Pin29 |
G | 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-gpio_int
注意:此模块并不支持热插拔,启动系统前需要确保硬件连接正确。
运行效果如下:
Waiting event... Device[0] value is 1
按下按键时会检测到事件。
6 代码说明
所有的开发板都共用一套Matrix代码,本模块的测试示例代码为matrix-gpio_int,内容如下:
int main(int argc, char ** argv) { int i, board; int retSize = -1; char value[ARRAY_SIZE(dev)]; if ((board = boardInit()) < 0) printf("Fail to init board\n"); if (argc == 2) { dev[0].pin = atoi(argv[1]); } printf("Using GPIO_PIN(%d)\n", dev[0].pin); system("modprobe "DRIVER_MODULE); signal(SIGINT, intHandler); if (board == BOARD_NANOPI_T2) dev[0].pin = GPIO_PIN(15); if ((devFD =sensorInit(dev, ARRAY_SIZE(dev))) == -1) { printf("Fail to init sensor\n"); return -1; } printf("Waiting event...\n"); if ((retSize = sensorRead(devFD, value, ARRAY_SIZE(dev))) == -1) { printf("Fail to read sensors\n"); } if (retSize > 0) { i = 0; for (i=0; i<retSize; i++) { printf("dev[%d] value: %d\n", i, value[i]); } } sensorDeinit(devFD); system("rmmod "DRIVER_MODULE); return 0; }
API说明参考维基:Matrix API reference manual