Difference between revisions of "Matrix - LED/zh"
(→下载Matrix源码) |
(→连接NanoPC-T2) |
||
(20 intermediate revisions by 2 users not shown) | |||
Line 29: | Line 29: | ||
3-Pin 2.54mm排针,V接电源,G接地,S信号通过一个三极管放大控制LED的导通或关闭。您可以向S输出静态的高低电平信号,也可以输出变化的PWM信号,信号电平可以是3.3V或5V。当您向S输出高电平时LED以最大亮度发光,低电平就完全熄灭,可变占空比的PWM信号可以调节发光的亮度。 | 3-Pin 2.54mm排针,V接电源,G接地,S信号通过一个三极管放大控制LED的导通或关闭。您可以向S输出静态的高低电平信号,也可以输出变化的PWM信号,信号电平可以是3.3V或5V。当您向S输出高电平时LED以最大亮度发光,低电平就完全熄灭,可变占空比的PWM信号可以调节发光的亮度。 | ||
− | == | + | ==硬件连接== |
− | + | ===连接NanoPi NEO/NanoPi NEO Air=== | |
− | + | NanoPi M1和NanoPi NEO以及NanoPi NEO Air的前24Pin引脚定义是一模一样的,所以它们操作Matrix配件的步骤是一样的,并且使用同一份代码。<br> | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | 参考下图连接模块:<br> | |
− | < | + | [[File:Matrix-LED_nanopi_NEO.jpg|frameless|600px|Matrix-LED_nanopi_NEO]] |
− | + | ||
− | + | ||
− | + | 连接说明: | |
− | + | {| class="wikitable" | |
− | + | |- | |
− | + | |Matrix-LED || NanoPi NEO | |
− | + | |- | |
+ | |S || Pin7 | ||
+ | |- | ||
+ | |V || Pin4 | ||
+ | |- | ||
+ | |G || Pin6 | ||
+ | |} | ||
− | == | + | ===连接NanoPi M1=== |
− | + | 参考下图连接模块:<br> | |
− | + | [[File:Matrix-LED_nanopi_m1.jpg|frameless|600px|Matrix-LED_nanopi_m1]] | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | [[File: | + | |
连接说明: | 连接说明: | ||
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
− | |Matrix-LED || NanoPi | + | |Matrix-LED || NanoPi M1 |
|- | |- | ||
− | |S | + | |S || Pin7 |
|- | |- | ||
|V || Pin4 | |V || Pin4 | ||
|- | |- | ||
− | |G | + | |G || Pin6 |
|} | |} | ||
− | === | + | ===连接NanoPi 2=== |
− | + | 参考下图连接模块:<br> | |
− | < | + | [[File:Matrix-LED_nanopi_2.jpg|frameless|600px|Matrix-LED_nanopi_2]] |
− | + | ||
− | + | ||
− | + | ||
− | + | 连接说明: | |
− | + | {| class="wikitable" | |
− | + | |- | |
− | + | |Matrix-LED || 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-LED_nanopi_m2.jpg|frameless|600px|Matrix-LED_nanopi_m2]] | |
− | + | ||
− | + | ||
− | + | 连接说明: | |
− | + | {| class="wikitable" | |
− | + | |- | |
− | + | |Matrix-LED || NanoPi M2 | |
+ | |- | ||
+ | |S || Pin7 | ||
+ | |- | ||
+ | |V || Pin4 | ||
+ | |- | ||
+ | |G || Pin6 | ||
+ | |} | ||
− | === | + | ===连接NanoPi M3=== |
− | < | + | 参考下图连接模块:<br> |
− | + | [[File:Matrix-LED_nanopi_m3.jpg|frameless|600px|Matrix-LED_nanopi_m3]] | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | 连接说明: | |
− | + | {| class="wikitable" | |
− | + | |- | |
− | + | |Matrix-LED || NanoPi M3 | |
− | + | |- | |
− | + | |S || Pin7 | |
− | + | |- | |
− | + | |V || Pin4 | |
− | + | |- | |
− | + | |G || Pin6 | |
− | + | |} | |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | === | + | ===连接NanoPC-T2/NanoPC-T3=== |
− | + | 由于NanoPC-T2跟NanoPC-T3的引脚是一样的,所以连接方式是一样的,这里仅以T2为例,参考下图连接模块:<br> | |
− | [[File: | + | [[File:Matrix-LED_NanoPC-T2.jpg|frameless|600px|Matrix-LED_NanoPC-T2]] |
连接说明: | 连接说明: | ||
{| class="wikitable" | {| class="wikitable" | ||
|- | |- | ||
− | |Matrix-LED || | + | |Matrix-LED || 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_out |
− | + | ||
</syntaxhighlight> | </syntaxhighlight> | ||
− | + | 注意:此模块并不支持热插拔,启动系统前需要确保硬件连接正确。<br> | |
− | + | 运行效果如下:<br> | |
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash"> | ||
− | + | 1: gpio status change | |
+ | 2: gpio status change | ||
+ | 3: gpio status change | ||
+ | 4: gpio status change | ||
+ | 5: gpio status change | ||
</syntaxhighlight> | </syntaxhighlight> | ||
+ | 可以看到LED在不停地闪烁。 | ||
− | == | + | ==代码说明== |
+ | 所有的开发板都共用一套Matrix代码,本模块的测试示例代码为matrix-gpio_out,内容如下: | ||
<syntaxhighlight lang="c"> | <syntaxhighlight lang="c"> | ||
int main(int argc, char ** argv) | int main(int argc, char ** argv) | ||
{ | { | ||
− | int | + | int pin = GPIO_PIN(7); |
− | int i | + | int i, value, board; |
int ret = -1; | int ret = -1; | ||
− | + | ||
− | if (( | + | if ((board = boardInit()) < 0) { |
− | printf(" | + | printf("Fail to init board\n"); |
+ | return -1; | ||
} | } | ||
− | if ((ret = | + | if (board == BOARD_NANOPI_T2) |
− | printf(" | + | pin = GPIO_PIN(15); |
+ | |||
+ | if (argc == 2) | ||
+ | pin = GPIO_PIN(atoi(argv[1])); | ||
+ | if ((ret = exportGPIOPin(pin)) == -1) { | ||
+ | printf("exportGPIOPin(%d) failed\n", pin); | ||
} | } | ||
− | + | if ((ret = setGPIODirection(pin, GPIO_OUT)) == -1) { | |
− | for (i = 0; i < | + | printf("setGPIODirection(%d) failed\n", pin); |
+ | } | ||
+ | for (i = 0; i < STATUS_CHANGE_TIMES; i++) { | ||
if (i % 2) { | if (i % 2) { | ||
− | + | value = GPIO_HIGH; | |
} else { | } else { | ||
− | + | value = GPIO_LOW; | |
} | } | ||
− | if (ret = | + | if ((ret = setGPIOValue(pin, value)) > 0) { |
− | printf("setGPIOValue(%d) failed\n", | + | printf("%d: GPIO_PIN(%d) value is %d\n", i+1, pin, value); |
+ | } else { | ||
+ | printf("setGPIOValue(%d) failed\n", pin); | ||
} | } | ||
− | |||
sleep(1); | sleep(1); | ||
} | } | ||
− | unexportGPIOPin( | + | unexportGPIOPin(pin); |
return 0; | return 0; | ||
} | } | ||
</syntaxhighlight> | </syntaxhighlight> | ||
− | + | API说明参考维基:[[Matrix API reference manual/zh|Matrix API reference manual]] <br> | |
− | + | ||
− | + | ||
− | + | ||
==相关资料== | ==相关资料== |
Latest revision as of 08:47, 10 November 2016
Contents
1 介绍
Matrix-LED是一个简单的发光二极管模块。3-Pin 2.54mm排针,V接电源,G接地,S信号通过一个三极管放大控制LED的导通或关闭。您可以向S输出静态的高低电平信号,也可以输出变化的PWM信号,信号电平可以是3.3V或5V。当您向S输出高电平时LED以最大亮度发光,低电平就完全熄灭,可变占空比的PWM信号可以调节发光的亮度。
2 特性
- GPIO或PWM控制,3.3/5V电平,亮度通过PWM可调
- 体积小巧
- 2.54mm排针接口
- PCB尺寸(mm):8x24
- 引脚说明:
名称 | 描述 |
S | GPIO |
V | 电源5V |
G | 地 |
3 工作原理
3-Pin 2.54mm排针,V接电源,G接地,S信号通过一个三极管放大控制LED的导通或关闭。您可以向S输出静态的高低电平信号,也可以输出变化的PWM信号,信号电平可以是3.3V或5V。当您向S输出高电平时LED以最大亮度发光,低电平就完全熄灭,可变占空比的PWM信号可以调节发光的亮度。
4 硬件连接
4.1 连接NanoPi NEO/NanoPi NEO Air
NanoPi M1和NanoPi NEO以及NanoPi NEO Air的前24Pin引脚定义是一模一样的,所以它们操作Matrix配件的步骤是一样的,并且使用同一份代码。
参考下图连接模块:
Matrix-LED_nanopi_NEO
连接说明:
Matrix-LED | NanoPi NEO |
S | Pin7 |
V | Pin4 |
G | Pin6 |
4.2 连接NanoPi M1
连接说明:
Matrix-LED | NanoPi M1 |
S | Pin7 |
V | Pin4 |
G | Pin6 |
4.3 连接NanoPi 2
连接说明:
Matrix-LED | 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-LED | NanoPi M2 |
S | Pin7 |
V | Pin4 |
G | Pin6 |
4.5 连接NanoPi M3
参考下图连接模块:
Matrix-LED_nanopi_m3
连接说明:
Matrix-LED | NanoPi M3 |
S | Pin7 |
V | Pin4 |
G | Pin6 |
4.6 连接NanoPC-T2/NanoPC-T3
由于NanoPC-T2跟NanoPC-T3的引脚是一样的,所以连接方式是一样的,这里仅以T2为例,参考下图连接模块:
Matrix-LED_NanoPC-T2
连接说明:
Matrix-LED | 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_out
注意:此模块并不支持热插拔,启动系统前需要确保硬件连接正确。
运行效果如下:
1: gpio status change 2: gpio status change 3: gpio status change 4: gpio status change 5: gpio status change
可以看到LED在不停地闪烁。
6 代码说明
所有的开发板都共用一套Matrix代码,本模块的测试示例代码为matrix-gpio_out,内容如下:
int main(int argc, char ** argv) { int pin = GPIO_PIN(7); int i, value, board; int ret = -1; if ((board = boardInit()) < 0) { printf("Fail to init board\n"); return -1; } if (board == BOARD_NANOPI_T2) pin = GPIO_PIN(15); if (argc == 2) pin = GPIO_PIN(atoi(argv[1])); if ((ret = exportGPIOPin(pin)) == -1) { printf("exportGPIOPin(%d) failed\n", pin); } if ((ret = setGPIODirection(pin, GPIO_OUT)) == -1) { printf("setGPIODirection(%d) failed\n", pin); } for (i = 0; i < STATUS_CHANGE_TIMES; i++) { if (i % 2) { value = GPIO_HIGH; } else { value = GPIO_LOW; } if ((ret = setGPIOValue(pin, value)) > 0) { printf("%d: GPIO_PIN(%d) value is %d\n", i+1, pin, value); } else { printf("setGPIOValue(%d) failed\n", pin); } sleep(1); } unexportGPIOPin(pin); return 0; }
API说明参考维基:Matrix API reference manual