## 风盘控制器项目

### 目录
<!-- TOC -->
* [4寸线控器项目](#4寸线控器项目)
  * [目录](#目录)
  * [1.云端接入指令说明](#1云端接入指令说明)
    * [1.1 运行状态上报](#11-运行状态上报)
    * [1.2 故障上报](#12-故障上报)
    * [1.3 温度设定](#13-温度设定)
    * [1.4 模式设定](#14-模式设定)
    * [1.5 风速设定](#15-风速设定)
    * [1.6 定时设定](#16-定时设定)
    * [1.7 风阀档位控制（分控）](#17-风阀档位控制分控)
    * [1.8 总开关控制（主控）](#18-总开关控制主控)
    * [1.9 运行参数设定](#19-运行参数设定)
    * [1.10 通知显示功能](#110-通知显示功能)
    * [1.11 新风开关控制](#111-新风开关控制)
    * [1.12 风阀开关控制（分控）](#112-风阀开关控制分控)
    * [1.13 风机电压设定](#113-风机电压设定)
    * [1.14 设置指定风阀的角度](#114-设置指定风阀的角度)
  * [2.设计说明](#2设计说明)
    * [2.1 风阀配置设计思路](#21-风阀配置设计思路)
    * [2.2 分控说明](#22-分控说明)
      * [2.2.1 分控从站号](#221-分控从站号)
      * [2.2.2 设计思路](#222-设计思路)
      * [2.2.3 优先级问题](#223-优先级问题)
      * [2.2.4 主控与分控485通讯协议](#224-主控与分控485通讯协议)
<!-- TOC -->


### 1.云端接入指令说明


#### 1.1 运行状态上报
_线控器向云端上报的自己的运行状态_


* 标识符: `status`
* 参数:

```json
{
  "action": "devSend",
  "msgId": 0,
  "deviceCode": "84FCE66AA534",
  "subDeviceId": "",
  "data": {
    "cmd": "status",
    "params": {
      "power": 1,
      "set_max_hum": 25,
      "filter_life_remaining": 80,
      "set_filter_life_time" : 3600000,
      "mode": 1,
      "temperature": 25,
      "humidity": 52,
      "air_quality": 0,
      "co2": 0,
      "fan_speed": 5,
      "timer_status": 1,
      "duration": 0.5
      
    }
  }
}
```

* 参数说明：

| 字段                    | 读写类型 | 类型           | 说明                        |
|-----------------------|------|--------------|---------------------------|
| power                 | W/R  | int          | 电源状态（0：关，1：开）             |
| temperature           | R    | int          | 环境温度                      |
| humidity              | R    | int          | 环境湿度                      |
| mode                  | W/R  | int          | 工作模式（0：制冷，1：制热，3：通风模式）    |
| fan_speed             | W/R  | int          | 风速（1-3）                   |  
| set_temp              | W/R  | int          | 设置温度（16-30）               |
| tw_status             | R    | int          | 二通阀状态 （0：关闭 1；打开）         |
| xf_have               | R    | int          | 是否有新风口模块（0：无，1：有） （暂时不显示） |
| xf_mode               | W/R  | int          | 新风模式（1：自动2：手动新风）          |
| filter_life_remaining | R    | int          | 滤网寿命（0-100%，暂时不显示）        |
| air_quality           | W/R  | int          | PM2.5（暂时不显示）              |
| co2                   | W/R  | int          | 二氧化碳浓度 （暂时不显示）            |
| timer_status          | W/R  | int          | 定时状态(1：有定时；0：无定时)         |
| duration              | W/R  | float        | 定时时间                      |



#### 1.2 故障上报

* 标识符: `fault`
* 参数:

```json
{
    "action": "devSend",
    "msgId": 0,
    "deviceCode": "M1",
    "subDeviceId": "",
    "timestamp": 1231242345,
    "data":{
        "cmd": "fault",
        "params": [
          {
            "code": "故障码1",
            "desc": "故障描述1"
          },
          {
            "code": "故障码2",
            "desc": "故障描述2"
          }
        ]
      
    }
}
```

#### 1.3 电源开关

* 标识符：`setPower`
* 参数：


| 字段    | 类型  | 说明  |
|-------|-----|-----|
| value | int | 开关机 |

* 示例:

```json
{
  "cmd": "setPower",
  "params": {
    "value": 1
  }
}
```
#### 1.4 模式设定

* 标识符：`setMode`
* 参数：

| 字段    | 类型  | 说明                           |
|-------|-----|------------------------------|
| value | int | 预设模式，工作模式（0：制冷，1：制热，3：通风模式）  |

* 示例:

```json
{
    "cmd":"setMode",
    "params": {
        "value": 1
    }
}
```

#### 1.5 风速设定

* 标识符：`setFanLevel`
* 参数：

| 字段    | 类型  | 说明                            |
|-------|-----|-------------------------------|
| value | int | 预设风速( 1：1档； 2：2 档； 3： 3 档；  ) |

* 示例:

```json
{
    "cmd":"setFanLevel",
    "params": {
        "value": 1
    }
}
```
#### 1.6 设置温度

* 标识符：`setTemp`
* 参数：

| 字段    | 类型  | 说明          |
|-------|-----|-------------|
| value | int | 设置温度(16-30) |

* 示例:

```json
{
    "cmd":"setTemp",
    "params": {
        "value": 16
    }
}
```
#### 1.7 设置手动新风

* 标识符：`setXfMode`
* 参数：

| 字段    | 类型  | 说明              |
|-------|-----|-----------------|
| value | int | 手动信封(1：关闭，2：打开) |

* 示例:

```json
{
    "cmd":"setNewFan",
    "params": {
        "value": 1
    }
}
```
#### 1.8 定时设定

* 标识符：`setTimer`
* 参数：

| 字段   | 类型  | 说明      |
|-------|-----|---------|
| value |float| 定时时间(小时 |
| status | int | 1:开启0：关闭 |

* 示例:

```json
{
    "cmd":"setTimer",
    "params": {
        "value": 0.5,
        "status": 1
    }
}
```
#### 1.9 定时设定

* 标识符：`setTimer`
* 参数：

| 字段   | 类型  | 说明      |
|-------|-----|---------|
| value |float| 定时时间(小时 |
| status | int | 1:开启0：关闭 |

* 示例:

```json
{
    "cmd":"setTimer",
    "params": {
        "value": 0.5,
        "status": 1
    }
}
```
#### 1.10 运行参数设定

* 标识符：`setParam`
* 参数：

| 字段    | 类型  | 说明         |
|-------|-----|------------|
| report_duration | int | 数据上报频率(单位：秒) |

* 示例:

```json
{
  "cmd":"setParam",
  "params": {
    "report_duration": 10
  }
}
```

#### 1.11 风机电压设定（预留，APP暂时不做）

* 标识符：`setFanVoltage`
* 参数：

| 字段    | 类型  | 说明                              |
|-------|-----|---------------------------------|
| gear  | int | 档位 （1：一档 2：二挡  3：三档  4：四档 5：五档） |
| value | int | 风机电压 （0-100，1代表0.1V）            |

* 示例:

```json
{
  "cmd":"setFanVoltage",
  "params": {
    "gear": 1,
    "value": 40
  }
}

```