Difference between revisions of "Matrix - Fire Sensor"

From FriendlyELEC WiKi
Jump to: navigation, search
(Update Log)
Line 25: Line 25:
 
* The YS-17 is an infrared flame detector monitoring the infrared spectral band for specific patterns given off by hot gases. Radiation of flames and fires is sensed using a specialized infrared receiver and then converted to an electronic signal. This signal is compared with a threshold signal and when it reaches the threshold value the module will output a low level.
 
* The YS-17 is an infrared flame detector monitoring the infrared spectral band for specific patterns given off by hot gases. Radiation of flames and fires is sensed using a specialized infrared receiver and then converted to an electronic signal. This signal is compared with a threshold signal and when it reaches the threshold value the module will output a low level.
  
 +
==硬件连接==
 +
===连接NanoPi M1===
 +
参考下图连接模块:<br>
 +
[[File:Matrix-Fire_Sensor_nanopi_m1.jpg|frameless|600px|Matrix-Fire_Sensor_nanopi_m1]]
 +
 +
连接说明:
 +
{| class="wikitable"
 +
|-
 +
|Matrix-Fire_Sensor || NanoPi M1
 +
|-
 +
|S    || Pin7
 +
|-
 +
|V    || Pin4
 +
|-
 +
|G    || Pin6
 +
|}
 +
 +
===连接NanoPi 2===
 +
参考下图连接模块:<br>
 +
[[File:Matrix-Fire_Sensor_nanopi_2.jpg|frameless|600px|Matrix-Fire_Sensor_nanopi_2]]
 +
 +
连接说明:
 +
{| class="wikitable"
 +
|-
 +
|Matrix-Fire_Sensor || 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-Fire_Sensor_nanopi_m2.jpg|frameless|600px|Matrix-Fire_Sensor_nanopi_m2]]
 +
 +
连接说明:
 +
{| class="wikitable"
 +
|-
 +
|Matrix-Fire_Sensor || NanoPi M2
 +
|-
 +
|S    || Pin7
 +
|-
 +
|V    || Pin4
 +
|-
 +
|G    || Pin6
 +
|}
 +
 +
===连接NanoPC-T2===
 +
参考下图连接模块:<br>
 +
[[File:Matrix-Fire_Sensor_NanoPC-T2.jpg|frameless|600px|Matrix-Fire_Sensor_NanoPC-T2]]
 +
 +
连接说明:
 +
{| class="wikitable"
 +
|-
 +
|Matrix-Fire_Sensor || 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, board;
 +
    int retSize = -1;
 +
    char value[ARRAY_SIZE(dev)];
 +
 +
    if ((board = boardInit()) < 0) {
 +
        printf("Fail to init board\n");
 +
        return -1;
 +
    }
 +
   
 +
    if (argc == 2)
 +
        dev[0].pin = atoi(argv[1]);
 +
    system("modprobe "DRIVER_MODULE);
 +
    signal(SIGINT, intHandler);
 +
    if (board == BOARD_NANOPI_T2)
 +
        dev[0].pin = GPIO_PIN(15);
 +
    printf("Use GPIO_PIN(%d)\n", dev[0].pin);
 +
    if ((devFD =sensorInit(dev, ARRAY_SIZE(dev))) == -1) {
 +
        printf("Fail to init sensor\n");
 +
        goto err;
 +
    }
 +
    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("Device[%d] value is %d\n", i, value[i]);
 +
        }
 +
    }
 +
    sensorDeinit(devFD);
 +
err:   
 +
    system("rmmod "DRIVER_MODULE);
 +
    return 0;
 +
}
 +
</syntaxhighlight>
 +
API说明参考维基:[[Matrix API reference manual/zh|Matrix API reference manual]] <br>
 +
<!---
 
==Download Matrix Source Code==
 
==Download Matrix Source Code==
 +
--->
  
 
==Update Log==
 
==Update Log==

Revision as of 10:08, 19 June 2016

查看中文

1 Introduction

Fire Sensor
  • The Matrix-Fire_Sensor module is a flame detector module. It uses the YS-17 flame detector to detect flames or fires. It can detect flames or fires whose wavelengths are between 760nm and 1100nm. Its detecting angle is up to 60 degrees. Its sensitivity can be adjusted via the potentiometer.

2 Features

  • Standard 3 PIN Interface
  • PCB Dimension(mm): 16 x 24

Fire Sensor.PCB

  • Pin Description:
Pin Description
S GPIO
V Supply Voltage 5V
G Ground

3 Basic Device Operation

  • The YS-17 is an infrared flame detector monitoring the infrared spectral band for specific patterns given off by hot gases. Radiation of flames and fires is sensed using a specialized infrared receiver and then converted to an electronic signal. This signal is compared with a threshold signal and when it reaches the threshold value the module will output a low level.

4 硬件连接

4.1 连接NanoPi M1

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

连接说明:

Matrix-Fire_Sensor NanoPi M1
S Pin7
V Pin4
G Pin6

4.2 连接NanoPi 2

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

连接说明:

Matrix-Fire_Sensor NanoPi 2
S Pin7
V Pin4
G Pin6

4.3 连接NanoPi M2 / NanoPi 2 Fire

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

连接说明:

Matrix-Fire_Sensor NanoPi M2
S Pin7
V Pin4
G Pin6

4.4 连接NanoPC-T2

参考下图连接模块:
Matrix-Fire_Sensor_NanoPC-T2

连接说明:

Matrix-Fire_Sensor 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");
        return -1;
    }
 
    if (argc == 2)
        dev[0].pin = atoi(argv[1]);
    system("modprobe "DRIVER_MODULE);
    signal(SIGINT, intHandler);
    if (board == BOARD_NANOPI_T2)
        dev[0].pin = GPIO_PIN(15);
    printf("Use GPIO_PIN(%d)\n", dev[0].pin);
    if ((devFD =sensorInit(dev, ARRAY_SIZE(dev))) == -1) {
        printf("Fail to init sensor\n");
        goto err;
    }
    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("Device[%d] value is %d\n", i, value[i]);
        }
    }
    sensorDeinit(devFD);
err:    
    system("rmmod "DRIVER_MODULE);
    return 0;
}

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

7 Update Log

7.1 Feb-24-2016

  • Added Sections 1, 2, 3 and 4

7.2 Feb-26-2016

  • Translated into English