Difference between revisions of "Matrix - Soil Moisture Sensor"

From FriendlyELEC WiKi
Jump to: navigation, search
(→‎Basic Device Operation工作原理)
 
(9 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
[[Matrix - Soil Moisture Sensor/zh|查看中文]]
 
[[Matrix - Soil Moisture Sensor/zh|查看中文]]
  
−
==介绍==
+
==Introduction==
−
[[File:Matrix - Soil_Moisture_Sensor.jpg|thumb|土壤湿度检测模块]]
+
[[File:Matrix - Soil_Moisture_Sensor.jpg|thumb|Soil Moisture Sensor Module]]
−
* 模块Matrix-Soil_Moisture_Sensor是一个简易土壤湿度检测传感器模块，适用于对土壤湿度的检测。
+
* The Matrix-Soil_Moisture_Sensor is a simple and straightforward-to-use soil moisture detection module.
−
*选定合适的测量地点，确保钢针不会碰到石块之类坚硬物体，保持土壤原有的松紧程度，握紧传感器体垂直插入土壤，插入时不能前后左右晃动，以确保模块与土壤紧密接触，模块输出与被测土壤湿度成比例的模拟信号。
+
* Before plug the module to a target soil make sure the target soil doesn’t contain rocks. Then point the pads perpendicular to the soil, push it in and make the module close contact to the soil and the module will output analog signals which are proportional to the soil’s moisture condition.
−
*以提高测试准确度，建议在一个测试点附近的小范围内多测试几次求平均值。
+
* To improve the test result it is suggested to take the average of multiple test results.
−
*模块测量数据，会受到盐分，土壤成分，密度等各种因素干扰。
+
* The test result can be influenced by various factors: soil density, soil composition and etc.
  
−
==特性==
+
==Hardware Specification==
−
* 使用标准的3 PIN接口
+
* Standard 3 PIN Interface
−
* 尺寸为 20x60mm
+
* PCB Dimension(mm): 20 x 60
−
* PCB尺寸（mm）：20x60
+
 
[[File:Soil_Moisture_Sensor1.png | frameless|350px|Soil_Moisture_Sensor.PCB]]
 
[[File:Soil_Moisture_Sensor1.png | frameless|350px|Soil_Moisture_Sensor.PCB]]
  
−
* 引脚说明:
+
* Pin Description:
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
−
|名称 || 描述
+
|Pin || Description
 
|-
 
|-
 
|S    || GPIO
 
|S    || GPIO
 
|-
 
|-
−
|V    || 电源5V
+
|V    || Supply Voltage 5V
 
|-
 
|-
−
|G    || 地
+
|G    || Ground
 
|}
 
|}
  
−
==工作原理==
+
==Basic Device Operation==
−
* 模块两片测试电极间的阻值与环境的湿度成比例，利用电极间电阻变化测量周围土壤水分湿度。土壤越干燥，输出电压越小。越湿润输出电压越大。模块输出的模拟信号再通过AD转换数字信号信号，即可得到土壤湿度值。
+
* The resistance of the two pads(probes) is proportional to the moisture of surrounding environment. When the measured soil becomes increasingly drier the output voltage becomes lower and vice versa. The output analog signals of the module can be converted to digital signals (values of soil moisture) via AD conversion.
−
* 它利用电磁脉冲原理、根据电磁波在介质中传播频率来测量土壤的表观介电常数(ε)，从而得到土壤容积含水量(θv)。
+
* It measures surrounding soil's apparent dielectric constant(ε) and calculates its moisture value(θv).
−
* 使用说明：传感器模块使用的是adc模拟输入输出，这里直接把传感器模块接到PCF8591转换模块上即可检查到土壤湿度值。
+
* This module uses adc inputs/outputs and converts analog signals to digital signals (moisture value) with PCF8591.
  
−
===连接NanoPi M1===
+
==Applications==
−
参考下图连接模块：<br>
+
===Connect to NanoPi M1===
 +
Refer to the following connection diagram to connect the module to the NanoPi M1:<br>
 
[[File:Matrix-Soil_Moisture_Sensor_nanopi_m1.jpg|frameless|600px|Matrix-Soil_Moisture_Sensor_nanopi_m1]]
 
[[File:Matrix-Soil_Moisture_Sensor_nanopi_m1.jpg|frameless|600px|Matrix-Soil_Moisture_Sensor_nanopi_m1]]
  
−
连接说明：
+
Connection Details:
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
Line 47: Line 47:
 
|}
 
|}
  
−
===连接NanoPi 2===
+
===Connect to NanoPi 2===
−
参考下图连接模块：<br>
+
Refer to the following connection diagram to connect the module to the NanoPi 2:<br>
 
[[File:Matrix-Soil_Moisture_Sensor_nanopi_2.jpg|frameless|600px|Matrix-Soil_Moisture_Sensor_nanopi_2]]
 
[[File:Matrix-Soil_Moisture_Sensor_nanopi_2.jpg|frameless|600px|Matrix-Soil_Moisture_Sensor_nanopi_2]]
  
−
连接说明：
+
Connection Details:
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
Line 63: Line 63:
 
|}
 
|}
  
−
===连接NanoPi M2 / NanoPi 2 Fire===
+
===Connect to NanoPi M2/NanoPi 2 Fire===
−
NanoPi M2和NanoPi 2 Fire的40 Pin引脚定义是一模一样的，所以它们操作Matrix配件的步骤是一样的，这里仅以NanoPi M2为例。<br>
+
Refer to the following connection diagram to connect the module to the NanoPi M2/ NanoPi 2 Fire:<br>
−
参考下图连接模块：<br>
+
 
[[File:Matrix-Soil_Moisture_Sensor_nanopi_m2.jpg|frameless|600px|Matrix-Soil_Moisture_Sensor_nanopi_m2]]
 
[[File:Matrix-Soil_Moisture_Sensor_nanopi_m2.jpg|frameless|600px|Matrix-Soil_Moisture_Sensor_nanopi_m2]]
  
−
连接说明：
+
Connection Details:
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
Line 80: Line 79:
 
|}
 
|}
  
−
===连接NanoPC-T2===
+
===Connect to NanoPi M3===
−
参考下图连接模块：<br>
+
Refer to the following connection diagram to connect the module to the NanoPi M3:<br>
 +
[[File:Matrix-Soil_Moisture_Sensor_nanopi_m3.jpg|frameless|600px|Matrix-Soil_Moisture_Sensor_nanopi_m3]]
 +
 
 +
Connection Details:
 +
{| class="wikitable"
 +
|-
 +
|Matrix-Soil_Moisture_Sensor ||     
 +
|-
 +
|GND    || NanoPi M3 Pin9
 +
|-
 +
|5V    || NanoPi M3 Pin2
 +
|-
 +
|S      || Matrix-Analog_to_Digital_Converter A0
 +
|}
 +
 
 +
===Connect to NanoPC-T2===
 +
Refer to the following connection diagram to connect the module to the NanoPC-T2:<br>
 
[[File:Matrix-Soil_Moisture_Sensor_NanoPC-T2.jpg|frameless|600px|Matrix-Soil_Moisture_Sensor_NanoPC-T2]]
 
[[File:Matrix-Soil_Moisture_Sensor_NanoPC-T2.jpg|frameless|600px|Matrix-Soil_Moisture_Sensor_NanoPC-T2]]
  
−
连接说明：
+
Connection Details:
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
Line 96: Line 111:
 
|}
 
|}
  
−
==编译运行测试程序==
+
==Compile & Run Test Program==
−
启动开发板并运行Debian系统，进入系统后克隆Matrix代码仓库：
+
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>
−
克隆完成后会得到一个名为matrix的目录。
+
If your cloning is done successfully a "matrix" directory will be generated.
  
−
编译并安装Matrix：
+
Compile and install Matrix:
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
 
$ cd matrix
 
$ cd matrix
Line 110: Line 125:
 
</syntaxhighlight>
 
</syntaxhighlight>
  
−
运行测试程序：
+
Run test program:
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
 
$ matrix-adc
 
$ matrix-adc
 
</syntaxhighlight>
 
</syntaxhighlight>
−
注意：此模块并不支持热插拔，启动系统前需要确保硬件连接正确。<br>
+
Note: this module is not plug and play therefore before running the module please make sure it is connected to an ARM board.<br>
−
运行效果如下：<br>
+
Here is what you should observe:<br>
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
 
The channel0 value is 2460
 
The channel0 value is 2460
 
</syntaxhighlight>
 
</syntaxhighlight>
  
−
==代码说明==
+
==Code Sample==
−
所有的开发板都共用一套Matrix代码，本模块的测试示例代码为matrix-analog_to_digital_converter，内容如下:
+
This Matrix code sample can work with all the ARM boards mentioned in this module's wiki. The name of this code sample is "matrix-analog_to_digital_converter". Here is its source code:
 
<syntaxhighlight lang="c">
 
<syntaxhighlight lang="c">
 
int main(int argc, char ** argv)
 
int main(int argc, char ** argv)
Line 150: Line 165:
 
}
 
}
 
</syntaxhighlight>
 
</syntaxhighlight>
−
API说明参考维基：[[Matrix API reference manual/zh|Matrix API reference manual]] <br>
+
For more details about this APIs called in this code sample refer to [[Matrix API reference manual]] <br>
 +
 
 +
==Resources==
  
−
==相关资料==
+
==Update Log==
 +
===August-10-2016===
 +
* Created English wiki

Latest revision as of 01:13, 10 August 2016

查看中文

1 Introduction

Soil Moisture Sensor Module
  • The Matrix-Soil_Moisture_Sensor is a simple and straightforward-to-use soil moisture detection module.
  • Before plug the module to a target soil make sure the target soil doesn’t contain rocks. Then point the pads perpendicular to the soil, push it in and make the module close contact to the soil and the module will output analog signals which are proportional to the soil’s moisture condition.
  • To improve the test result it is suggested to take the average of multiple test results.
  • The test result can be influenced by various factors: soil density, soil composition and etc.

2 Hardware Specification

  • Standard 3 PIN Interface
  • PCB Dimension(mm): 20 x 60

Soil_Moisture_Sensor.PCB

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

3 Basic Device Operation

  • The resistance of the two pads(probes) is proportional to the moisture of surrounding environment. When the measured soil becomes increasingly drier the output voltage becomes lower and vice versa. The output analog signals of the module can be converted to digital signals (values of soil moisture) via AD conversion.
  • It measures surrounding soil's apparent dielectric constant(ε) and calculates its moisture value(θv).
  • This module uses adc inputs/outputs and converts analog signals to digital signals (moisture value) with PCF8591.

4 Applications

4.1 Connect to NanoPi M1

Refer to the following connection diagram to connect the module to the NanoPi M1:
Matrix-Soil_Moisture_Sensor_nanopi_m1

Connection Details:

Matrix-Soil_Moisture_Sensor
GND NanoPi M1 Pin9
5V NanoPi M1 Pin2
S Matrix-Analog_to_Digital_Converter A0

4.2 Connect to NanoPi 2

Refer to the following connection diagram to connect the module to the NanoPi 2:
Matrix-Soil_Moisture_Sensor_nanopi_2

Connection Details:

Matrix-Soil_Moisture_Sensor
GND NanoPi 2 Pin9
5V NanoPi 2 Pin2
S Matrix-Analog_to_Digital_Converter A0

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:
Matrix-Soil_Moisture_Sensor_nanopi_m2

Connection Details:

Matrix-Soil_Moisture_Sensor
GND NanoPi M2 Pin9
5V NanoPi M2 Pin2
S Matrix-Analog_to_Digital_Converter A0

4.4 Connect to NanoPi M3

Refer to the following connection diagram to connect the module to the NanoPi M3:
Matrix-Soil_Moisture_Sensor_nanopi_m3

Connection Details:

Matrix-Soil_Moisture_Sensor
GND NanoPi M3 Pin9
5V NanoPi M3 Pin2
S Matrix-Analog_to_Digital_Converter A0

4.5 Connect to NanoPC-T2

Refer to the following connection diagram to connect the module to the NanoPC-T2:
Matrix-Soil_Moisture_Sensor_NanoPC-T2

Connection Details:

Matrix-Potentiometer
GND NanoPC-T2 USB Host GND
5V NanoPC-T2 USB Host 5V
S Matrix-Analog_to_Digital_Converter A0

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-adc

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:

The channel0 value is 2460

6 Code Sample

This Matrix code sample can work with all the ARM boards mentioned in this module's wiki. The name of this code sample is "matrix-analog_to_digital_converter". Here is its source code: 

int main(int argc, char ** argv)
{
    int i = 0;
    int value = 0;
    int channel = 0;
 
    if (boardInit() < 0) {
        printf("Fail to init board\n");
        return -1;
    }
 
    if (argc == 2)
        channel = atoi(argv[1]);
    system("modprobe "DRIVER_MODULE);
    signal(SIGINT, intHandler);
    for (i=0; i<ADC_READ_TIMES; i++) {
        if (pcf8591Read(channel, &value) != -1) {
            printf("The channel%d value is %d\n", channel, value);
        } else {
            printf("Fail to get channel%d value\n", channel);
        }
    }
    system("rmmod "DRIVER_MODULE);
 
    return 0;
}

For more details about this APIs called in this code sample refer to Matrix API reference manual

7 Resources

8 Update Log

8.1 August-10-2016

  • Created English wiki
Retrieved from "https://wiki.friendlyelec.com/wiki/index.php?title=Matrix_-_Soil_Moisture_Sensor&oldid=6754"