Difference between revisions of "Matrix - Button/zh"
From FriendlyELEC WiKi
(→连接) |
(→连接NanoPC-T2) |
||
(69 intermediate revisions by 6 users not shown) | |||
Line 1: | Line 1: | ||
+ | [[Matrix - Button|English]] | ||
==介绍== | ==介绍== | ||
− | [[File:Btn01.jpg|thumb| | + | [[File:Btn01.jpg|thumb|按键]] |
− | + | * 模块Matrix-Button用于检测按键事件。 | |
+ | * 未按时输出高电平,按下后输出低电平。 | ||
==特性== | ==特性== | ||
− | * | + | * 使用标准的3 PIN接口 |
− | * | + | * 尺寸为 8x24mm |
+ | * PCB尺寸(mm):8x24 | ||
+ | [[File:btn002.png | frameless|400px|BTN-01.PCB]] | ||
− | + | * 引脚说明: | |
− | = | + | {| class="wikitable" |
− | + | |- | |
− | + | |名称 || 描述 | |
+ | |- | ||
+ | |S || GPIO | ||
+ | |- | ||
+ | |V || 电源5V | ||
+ | |- | ||
+ | |G || 地 | ||
+ | |} | ||
− | == | + | ==工作原理== |
− | + | * Matrix-Button主要器件是一个瞬时(非自锁)按钮开关,通过3-Pin 2.54mm排针中的S信号输出按钮开关的状态。 | |
− | + | * 平时没有按下按钮时触点断开,S输出高电平;当按下按钮时触点导通,S输出低电平,直到松开才恢复高电平。 | |
− | + | ||
− | + | ==硬件连接== | |
− | + | ===连接NanoPi NEO/NanoPi NEO Air=== | |
− | + | NanoPi M1和NanoPi NEO以及NanoPi NEO Air的前24Pin引脚定义是一模一样的,所以它们操作Matrix配件的步骤是一样的,并且使用同一份代码。<br> | |
− | + | ||
− | + | ||
− | + | ||
− | int main( | + | 参考下图连接模块:<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:Matrix-Button_nanopi_m1.jpg|frameless|600px|Matrix-Button_nanopi_m1]] | ||
+ | |||
+ | 连接说明: | ||
+ | {| class="wikitable" | ||
+ | |- | ||
+ | |Matrix-Button || NanoPi M1 | ||
+ | |- | ||
+ | |S || Pin7 | ||
+ | |- | ||
+ | |V || Pin4 | ||
+ | |- | ||
+ | |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:Matrix-Button_NanoPC-T2.jpg|frameless|600px|Matrix-Button_NanoPC-T2]] | ||
+ | |||
+ | 连接说明: | ||
+ | {| class="wikitable" | ||
+ | |- | ||
+ | |Matrix-Button || NanoPC-T2 | ||
+ | |- | ||
+ | |S || Pin15 | ||
+ | |- | ||
+ | |V || Pin29 | ||
+ | |- | ||
+ | |G || Pin30 | ||
+ | |} | ||
+ | |||
+ | ==编译运行测试程序== | ||
+ | 启动开发板并运行Debian系统,进入系统后克隆Matrix代码仓库: | ||
+ | <syntaxhighlight lang="bash"> | ||
+ | $ apt-get update && apt-get install git | ||
+ | $ git clone https://github.com/friendlyarm/matrix.git | ||
+ | </syntaxhighlight> | ||
+ | 克隆完成后会得到一个名为matrix的目录。 | ||
+ | |||
+ | 编译并安装Matrix: | ||
+ | <syntaxhighlight lang="bash"> | ||
+ | $ cd matrix | ||
+ | $ make && make install | ||
+ | </syntaxhighlight> | ||
+ | |||
+ | 运行测试程序: | ||
+ | <syntaxhighlight lang="bash"> | ||
+ | $ matrix-gpio_int | ||
+ | </syntaxhighlight> | ||
+ | 注意:此模块并不支持热插拔,启动系统前需要确保硬件连接正确。<br> | ||
+ | 运行效果如下:<br> | ||
+ | <syntaxhighlight lang="bash"> | ||
+ | Waiting event... | ||
+ | Device[0] value is 1 | ||
+ | </syntaxhighlight> | ||
+ | 按下按键时会检测到事件。 | ||
+ | |||
+ | ==代码说明== | ||
+ | 所有的开发板都共用一套Matrix代码,本模块的测试示例代码为matrix-gpio_int,内容如下: | ||
+ | <syntaxhighlight lang="c"> | ||
+ | int main(int argc, char ** argv) | ||
{ | { | ||
− | 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 41: | 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