DW200 门禁系统配置项文档（DejaOS版本）

<span id=category></span>
## 系统信息配置（sysInfo） 
### 基础信息

| 配置项               | 类型   | 默认值                   | 说明                                |
| -------------------- | ------ | ------------------------ | ----------------------------------- |
| `sysInfo.mac`        | String | ""                       | 设备 MAC 地址，硬件唯一标识，不可修改                       |
| `sysInfo.uuid`       | String | ""                       | 设备 UUID，设备唯一标识，不可修改                           |
| `sysInfo.sn`         | String | ""                       | 设备序列号，不可修改                          |
| `sysInfo.deviceName` | String | "欢迎使用"               | 设备名称                            |
| `sysInfo.deviceNum`  | Number | 0                        | 设备编号                            |
| `sysInfo.appVersion` | String | "dw200_v20_access_2.0.0" | 应用版本号，不可修改                          |
| `sysInfo.createTime` | String | "2024-08-23 10:49:00"    | 应用发布日期，不可修改                        |

### 音频配置

| 配置项            | 类型   | 默认值 | 范围  | 说明         |
| ----------------- | ------ | ------ | ----- | ------------ |
| `sysInfo.volume`  | Number | 60     | 0-60  | 语音音量     |
| `sysInfo.volume2` | Number | 100    | 0-100 | 按键音量     |
| `sysInfo.volume3` | Number | 100    | 0-100 | 蜂鸣提示音量 |

### 心跳配置

| 配置项               | 类型   | 默认值 | 说明                      |
| -------------------- | ------ | ------ | ------------------------- |
| `sysInfo.heart_en`   | Number | 1      | 心跳开关 (0:关闭, 1:开启) |
| `sysInfo.heart_time` | Number | 60     | 心跳间隔(秒) ，最小30秒             |
| `sysInfo.heart_data` | String | ""     | 心跳数据内容              |

[回到顶部](#category)

### 显示配置

| 配置项                 | 类型   | 默认值 | 说明                                |
| ---------------------- | ------ | ------ | ----------------------------------- |
| `sysInfo.language`     | Number | 0      | UI 语言 (0:中文, 1:英文)            |
| `sysInfo.dateFormat`   | Number | 1      | 日期格式 (1:年/月/日, 2:日/月/年)   |
| `sysInfo.timeFormat`   | Number | 1      | 时间格式 (1:24 小时制, 2:12 小时制) |

### 功能配置

| 配置项                             | 类型   | 默认值             | 说明                              |
| ---------------------------------- | ------ | ------------------ | --------------------------------- |
| `sysInfo.time`                     | String | 当前时间戳                 | 系统时间(秒级时间戳)              |
| `sysInfo.com_passwd`               | String | "1234567887654321" | 16位，设备配置码密码校验                    |
| `sysInfo.nfc`                      | Number | 1                  | NFC 功能开关 (0:关闭, 1:开启)     |
| `sysInfo.nfc_identity_card_enable` | Number | 1                  | 云证开关 (1:物理卡号, 3:云证获取) |
| `sysInfo.autoRestart`              | Number | 3                  | 自动重启 (-1:关闭, 0-23:整点重启) |

### 上报配置

| 配置项                   | 类型   | 默认值 | 说明                       |
| ------------------------ | ------ | ------ | -------------------------- |
| `sysInfo.reportCount`    | Number | 50     | 通行记录上报批处理数量     |
| `sysInfo.reportInterval` | Number | 5000   | 通行记录上报时间间隔(毫秒) |

## 网络信息配置（netInfo）

### 基础网络配置

| 配置项                         | 类型   | 默认值 | 说明                                    |
| ------------------------------ | ------ | ------ | --------------------------------------- |
| `netInfo.type`                 | Number | 1      | 网络类型 (1:以太网, 2:WiFi)       |
| `netInfo.dhcp`                 | Number | 0      | DHCP 模式 (0:动态, 1:静态)              |
| `netInfo.ip`                   | String | ""     | IP 地址                                 |
| `netInfo.gateway`              | String | ""     | 网关地址                                |
| `netInfo.subnetMask`           | String | ""     | 子网掩码                                |
| `netInfo.dns`                  | String | ""     | DNS 服务器                              |
| `netInfo.netMac`               | String | ""     | 网络 MAC 地址                           |
| `netInfo.fixed_macaddr_enable` | Number | 0      | 设备MAC模式 (0:默认 MAC, 2:自定义 MAC) |

[回到顶部](#category)

### WiFi 配置

| 配置项         | 类型   | 默认值     | 说明      |
| -------------- | ------ | ---------- | --------- |
| `netInfo.ssid` | String | "admin"    | WiFi SSID |
| `netInfo.psk`  | String | "password" | WiFi 密码 |

### NTP 时间同步配置

| 配置项                 | 类型   | 默认值         | 说明                              |
| ---------------------- | ------ | -------------- | --------------------------------- |
| `netInfo.ntp`          | Number | 2              | NTP 开关 (0:关闭, 2:定时同步) |
| `netInfo.ntpAddr`      | String | "182.92.12.11" | NTP 服务器地址                    |
| `netInfo.ntpHour`      | Number | 14             | 对时时间(小时) ，0~23，对应ntp=2                   |
| `netInfo.ntpLocaltime` | Number | 8              | 网络时间时区                          |

## MQTT信息配置（mqttInfo）

| 配置项                  | 类型   | 默认值                        | 说明                  |
| ----------------------- | ------ | ----------------------------- | --------------------- |
| `mqttInfo.mqttAddr`     | String | "123.57.175.193:61615" | MQTT 服务器地址，支持以 "mqtt://" 开头（可省略）       |
| `mqttInfo.clientId`     | String | ""                            | MQTT 客户端 ID，默认为设备序列号，传空```""``` 将恢复默认        |
| `mqttInfo.clientIdSuffix`     | Number | 0 | clientId后是否要加三位随机数  (0:否, 1:是)       |
| `mqttInfo.qos`          | Number | 1                             | QoS 等级 (0, 1, 2)    |
| `mqttInfo.mqttName`     | String | "admin"                       | MQTT 用户名           |
| `mqttInfo.password`     | String | "password"                    | MQTT 密码             |
| `mqttInfo.prefix`       | String | ""                            | MQTT 主题前缀         |
| `mqttInfo.cleanSession` | Number | 0                             | 清理会话 (0:否, 1:是) |

[回到顶部](#category)

## UI界面配置（uiInfo）
 
 | 配置项                  | 类型   | 默认值 | 说明                               |
| ----------------------- | ------ | ------ | ---------------------------------- |
| `uiInfo.sn_show`        | Number | 1      | sn号显示/隐藏 (0:隐藏, 1:显示)   |
| `uiInfo.ip_show`        | Number | 1      | IP 地址显示/隐藏 (0:隐藏, 1:显示)  |
| `uiInfo.statusBar`      | Number | 1      | 状态栏显示/隐藏 (0:隐藏, 1:显示)   |
| `uiInfo.show_unlocking` | Number | 1      | 密码按钮显示/隐藏 (0:隐藏, 1:显示) |
| `uiInfo.buttonText`     | String | "密码" | 密码按钮文本                       |
| `uiInfo.rotation` | Number | 1        | 屏幕旋转角度 (0:0°, 1:90°, 2:180°, 3:270°) |
| `uiInfo.horBgImage`       | String | ""     | 水平背景图(Base64 格式) |
| `uiInfo.verBgImage`       | String | ""      | 垂直背景图(Base64 格式) |

## 门禁信息配置（doorInfo）

| 配置项                      | 类型   | 默认值 | 说明                                      |
| --------------------------- | ------ | ------ | ----------------------------------------- |
| `doorInfo.openMode`         | Number | 0      | 开门模式 (0:正常, 1:常开, 2:常闭) |
| `doorInfo.openTime`         | Number | 2000   | 开门时长(毫秒)                            |
| `doorInfo.openTimeout`      | Number | 10     | 开门超时时长(秒)                          |
| `doorInfo.onlinecheck`      | Number | 0      | 在线验证开关 (0:关闭, 1:开启)，离线验证失败走在线验证             |
| `doorInfo.timeout`          | Number | 2000   | 在线验证超时时长(毫秒)                    |
| `doorInfo.offlineAccessNum` | Number | 2000   | 数据库离线通行最大存储数量                      |

## 扫码信息配置（scanInfo）
 
 | 配置项              | 类型   | 默认值 | 说明                              |
| ------------------- | ------ | ------ | --------------------------------- |
| `scanInfo.de_type`  | Number | 64511  | 码制类型                          |
| `scanInfo.sMode`    | Number | 0      | 扫码模式 (0:间隔模式, 1:单次模式) |
| `scanInfo.interval` | Number | 1000   | 间隔模式下的间隔时间(毫秒)                |

[回到顶部](#category)

## 刷卡信息配置（nfcInfo）

| 配置项                  | 类型   | 默认值         | 说明                                          |
| ----------------------- | ------ | -------------- | --------------------------------------------- |
| `nfcInfo.nfcType`       | Number | 1              | 读卡方式 (1:普通模式, 2:固定扇区, 3:一卡一密) |
| `nfcInfo.sectorNumber`  | String、Number | ""              | 读卡扇区号，"" 或者0到15整数数字                     |
| `nfcInfo.blockNumber`   | String、Number | ""              | 读卡块号，相对块号，支持 ""、0、1、2          |
| `nfcInfo.secretkeyType` | Number | 1              | 密钥类型 (1:0x60, 2:0x61)                     |
| `nfcInfo.secretkey`     | String | "FFFFFFFFFFFF" | 读卡密钥，12字符的十六进制字符串   |

说明：sectorNumber与blockNumber不为空则根据配置项读指定位置卡号，否则返回物理卡号

## 蓝牙信息配置（bleInfo）
 
 | 配置项              | 类型   | 默认值 | 说明                              |
| ------------------- | ------ | ------ | --------------------------------- |
| `bleInfo.mac`  | String | 出厂地址  | mac地址                          |
| `bleInfo.name`    | String | 默认与设备sn一致  | 蓝牙名称 |

## 扫码配置项映射表

### 系统信息配置
| 扫码配置项                 | 系统配置项                         | 说明            |
| -------------------------- | ---------------------------------- | --------------- |
| `devnum`                   | `sysInfo.deviceNum`                | 设备编号        |
| `devname`                  | `sysInfo.deviceName`               | 设备名称        |
| `volume`                   | `sysInfo.volume`                   | 语音音量，0-60        |
| `volume2`                  | `sysInfo.volume2`                  | 按键音量，0-100        |
| `volume3`                  | `sysInfo.volume3`                  | 蜂鸣音量，0-100        |
| `heart_en`                 | `sysInfo.heart_en`                 | 心跳开关(0:关闭, 1:开启)        |
| `heart_time`               | `sysInfo.heart_time`               | 心跳间隔(秒) ，最小30秒        |
| `heart_data`               | `sysInfo.heart_data`               | 心跳数据        |
| `nfc_identity_card_enable` | `sysInfo.nfc_identity_card_enable` | 云证开关 (1:物理卡号, 3:云证获取)        |
| `dateFormat`               | `sysInfo.dateFormat`               | 日期格式 (1:年/月/日, 2:日/月/年)        |
| `timeFormat`               | `sysInfo.timeFormat`               | 时间格式(1:24 小时制, 2:12 小时制)        |
| `autoRestart`              | `sysInfo.autoRestart`              | 自动重启 (-1:关闭, 0-23:整点重启)        |
| `com_passwd`               | `sysInfo.com_passwd`               | 配置密码，16位        |
| `language`                 | `sysInfo.language`                 | 语言设置(0:中文, 1:英文)        |
| `time`                     | `sysInfo.time`                     | 系统时间        |

[回到顶部](#category)

### 网络信息配置
| 扫码配置项                 | 系统配置项                         | 说明            |
| -------------------------- | ---------------------------------- | --------------- |
| `ntpAddr`                  | `netInfo.ntpAddr`                  | NTP 服务器地址  |
| `ntp`                      | `netInfo.ntp`                      | NTP 开关 (0:关闭, 2:定时同步)        |
| `ntpHour`                  | `netInfo.ntpHour`                  | 对时时间(小时) ，0~23，对应ntp=2        |
| `net_type`                 | `netInfo.type`                     | 网络类型(1:以太网, 2:WiFi)        |
| `ip_mode`                  | `netInfo.dhcp`                     | DHCP 模式 (0:动态, 1:静态)       |
| `ip`                       | `netInfo.ip`                       | IP 地址         |
| `gateway`                  | `netInfo.gateway`                  | 网关            |
| `dns`                      | `netInfo.dns`                      | DNS 服务器      |
| `macaddr`                  | `netInfo.netMac`                   | 网络 MAC        |
| `fixed_macaddr_enable`     | `netInfo.fixed_macaddr_enable`     | MAC 地址模式 (0:默认 MAC, 2:自定义 MAC)    |
| `mask`                     | `netInfo.subnetMask`               | 子网掩码        |
| `ssid`                     | `netInfo.ssid`                     | WiFi SSID       |
| `psk`                      | `netInfo.psk`                      | WiFi 密码       |
| `ntpLocaltime`             | `netInfo.ntpLocaltime`             | 时区            |

### MQTT信息配置
| 扫码配置项                 | 系统配置项                         | 说明            |
| -------------------------- | ---------------------------------- | --------------- |
| `mqttaddr`                 | `mqttInfo.mqttAddr`                | MQTT 服务器地址，支持以 "mqtt://" 开头（可省略） |
| `mqttusername`             | `mqttInfo.mqttName`                | MQTT 用户名     |
| `mqttpassword`             | `mqttInfo.password`                | MQTT 密码       |
| `mqttprefix`               | `mqttInfo.prefix`                  | MQTT 主题前缀   |
| `mqttqos`                  | `mqttInfo.qos`                     | MQTT QoS 等级 (0, 1, 2)   |
| `mqttclientid`             | `mqttInfo.clientId`                | MQTT 客户端 ID  |
| `clientIdSuffix`             | `mqttInfo.clientIdSuffix`                | clientId是否加三位随机数(0:否, 1:是)  |
| `cleanSession`             | `mqttInfo.cleanSession`            | 清理会话 (0:否, 1:是)        |

### UI界面配置
| 扫码配置项                 | 系统配置项                         | 说明            |
| -------------------------- | ---------------------------------- | --------------- |
| `sn_show`                  | `uiInfo.sn_show`                   | 序列号显示 (0:隐藏, 1:显示)      |
| `ip_show`                  | `uiInfo.ip_show`                   | IP 显示 (0:隐藏, 1:显示)         |
| `buttonText`               | `uiInfo.buttonText`                | 按钮文本        |
| `show_unlocking`           | `uiInfo.show_unlocking`            | 显示开锁按钮 (0:隐藏, 1:显示)    |
| `statusBar`           | `uiInfo.statusBar`            | 显示底部状态栏 (0:隐藏, 1:显示)    |
| `rotation`                 | `uiInfo.rotation`                  | 屏幕旋转 (0:0°, 1:90°, 2:180°, 3:270°)        |

[回到顶部](#category)

### 门禁信息配置
| 扫码配置项                 | 系统配置项                         | 说明            |
| -------------------------- | ---------------------------------- | --------------- |
| `openMode`                 | `doorInfo.openMode`                | 开门模式 (0:正常, 1:常开, 2:常闭)        |
| `openTime`                 | `doorInfo.openTime`                | 开门时长(毫秒)       |
| `openTimeout`              | `doorInfo.openTimeout`             | 开门超时(秒)        |
| `onlinecheck`              | `doorInfo.onlinecheck`             | 在线验证(0:关闭, 1:开启)，离线验证失败走在线验证        |
| `onlineTimeout`            | `doorInfo.timeout`                 | 在线验证超时(毫秒)    |

### 扫码信息配置
| 扫码配置项                 | 系统配置项                         | 说明            |
| -------------------------- | ---------------------------------- | --------------- |
| `de_type`                  | `scanInfo.de_type`                 | 码制            |
| `s_mode`                   | `scanInfo.sMode`                   | 扫码模式 (0:间隔模式, 1:单次模式)        |
| `interval`                 | `scanInfo.interval`                | 扫码间隔(毫秒)        |

### 刷卡信息配置
| 扫码配置项                 | 系统配置项                         | 说明            |
| -------------------------- | ---------------------------------- | --------------- |
| `nfc`                      | `nfcInfo.nfc`                      | NFC 开关  (0:关闭, 1:开启)       |
| `nfcType`                  | `nfcInfo.nfcType`                  | NFC 读卡方式(1:普通模式, 2:固定扇区, 3:一卡一密)    |
| `sectorNumber`             | `nfcInfo.sectorNumber`             | 读卡扇区，""或0到15整数数字        |
| `blockNumber`              | `nfcInfo.blockNumber`              | 读卡块号，相对块号，支持 ""、0、1、2        |
| `secretkeyType`            | `nfcInfo.secretkeyType`            | 密钥类型(1:0x60, 2:0x61)        |
| `secretkey`                | `nfcInfo.secretkey`                | 读卡密钥，12字符的十六进制字符串        |

[回到顶部](#category)

---

## 配置说明

### 配置方式

1. **MQTT 远程配置**: 通过 MQTT 协议远程修改配置
2. **扫码配置**: 通过二维码扫描进行配置

### 配置验证

- 所有配置项在保存前都会进行格式验证
- MQTT 配置会进行连接测试
- 扫码配置会校验配置码格式
- 无效配置会被拒绝并回滚到默认值

### 配置备份

- 配置文件会自动备份到 `/app/data/config/` 目录
- 设备重置时会恢复默认配置

### 注意事项

1. 网络配置、MQTT配置、音频配置、心跳配置修改后会自动重启设备生效
2. 修改NFC开关（`nfcInfo.nfc`）、云证开关（`sysInfo.nfc_identity_card_enable`）、自动重启配置（`sysInfo.autoRestart`）、码制类型（`scanInfo.de_type`）后会自动重启设备生效

---

## 版本信息

- 文档版本: 1.0
- 最后更新: 2025-09-19
  
[回到顶部](#category)