Difference between revisions of "Matrix - Relay"
(→硬件连接) |
(→编译运行测试程序) |
||
Line 95: | Line 95: | ||
|} | |} | ||
− | == | + | ==Compile & Run Test Program== |
− | + | Boot your ARM board with Debian and copy the matrix code: | |
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash"> | ||
$ apt-get update && apt-get install git | $ 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> | ||
− | + | If your cloning is done successfully a "matrix" directory will be generated. | |
− | + | Compile and install Matrix: | |
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash"> | ||
$ cd matrix | $ cd matrix | ||
Line 109: | Line 109: | ||
</syntaxhighlight> | </syntaxhighlight> | ||
− | + | Run test program: | |
<syntaxhighlight lang="bash"> | <syntaxhighlight lang="bash"> | ||
$ matrix-gpio_out | $ matrix-gpio_out | ||
</syntaxhighlight> | </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"> | <syntaxhighlight lang="bash"> | ||
1: gpio status change | 1: gpio status change |
Revision as of 15:00, 23 June 2016
Contents
1 Introduction
- The Matrix-Relay module is a SPDT relay which is an electrically operated switch. Relays are used where it is necessary to control a circuit by a low-power signal. In a electric system it is used to protect electrical circuits from overload or faults.
2 Features
- 1 Form C
- 5V supply voltage, GPIO signal: 3.3/5V
- Current on-contact up to 10A
- LED indicator
- 2.54 mm spacing pin
- PCB dimension (mm): 24 x 48
- Pin Description:
Pin | Description |
S | GPIO |
V | Supply Voltage 5V |
G | Ground |
3 Basic Device Operation
This is an SPDT relay. Its supply voltage is 5V and current on-contact is up to 10A. It can drive AC or DC high power loads. NO is Normally Open. NC is Normally Closed. COM is Common. When writing high to pin S NO will be open and NC will be closed.
4 Applications
4.1 Connect to NanoPi M1
Refer to the following connection diagram to connect the module to the NanoPi M1:
Connection Details:
Matrix-Relay | NanoPi M1 |
S | Pin7 |
V | Pin4 |
G | Pin6 |
4.2 Connect to NanoPi 2
Refer to the following connection diagram to connect the module to the NanoPi 2:
Connection Details:
Matrix-Relay | NanoPi 2 |
S | Pin7 |
V | Pin4 |
G | 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:
Connection Details:
Matrix-Relay | NanoPi M2 |
S | Pin7 |
V | Pin4 |
G | Pin6 |
4.4 Connect to NanoPC-T2
Refer to the following connection diagram to connect the module to the NanoPC-T2:
Matrix-Relay_NanoPC-T2
Connection Details:
Matrix-Relay | NanoPC-T2 |
S | Pin15 |
V | Pin29 |
G | 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-gpio_out
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:
1: gpio status change 2: gpio status change 3: gpio status change 4: gpio status change 5: gpio status change
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
7 Resources
8 Update Log
8.1 Feb-19-2016
- Added Section 5