门禁标品配置项文档（DejaOS版本）

<span id=category></span>
## 人脸配置（face）

| MQTT配置项               | 扫码配置项  |类型   | 默认值                   | 说明                                |
| -------------------- | ------ |------ |  ------------------------ | ----------------------------------- |
| `face.similarity`        | `similarity`| Int | 0.5    | 人脸识别相似度 （范围0-1）小数点后一位            |
| `face.livenessOff`       | `livenessOff`| Int | 1  | 活体检测 1 开 0 关       |
| `face.livenessVal`         | `livenessVal`| Int | 5  | 活体检测阈值 （范围0-10）整数    |
| `face.showNir` | `showNir`| Int | 0  | 红外框 1 开 0 关 默认关     |
| `face.stranger` | `stranger`| Int | 1 | 未注册人脸提示 0:"无语音", 1:"播放 请先注册刷脸凭证", 2:"播放 未登记人员"       |
| `face.voiceMode` |` voiceMode`| Int | 1   | 识别成功后播放语音 0:"无语音",1:"播放名字", 2:"播放问候语"  |
| `face.voiceModeDate` | `voiceModeDate`| String | "欢迎光临"    | 问候语内容   |
| `face.recheck` | `recheck`| Int | 0    | 重检开关 1 开 0 关，打开后重检时间为8s   |

## MQTT配置（mqtt）

| MQTT配置项                 | 扫码配置项 | 类型   | 默认值                        | 说明                  |
| ----------------------- | ------ |------ | ----------------------------- | --------------------- |
| `mqtt.addr`     | `addr`| String | "mqtt://192.168.10.202:1883" | mqtt地址 (格式为 mqtt://192.168.1.1:1883)   |
| `mqtt.clientId`    | ` -` | String | 设备序列号  | MQTT 客户端 ID，不可修改 |
| `mqtt.clientIdSuffix`     | `clientIdSuffix`| Int | 0 | clientId后是否要加三位随机数  (0:否, 1:是)       |
| `mqtt.qos`          | `qos`| Int | 1      | QoS0，At most once，至多一次 QoS1，At least once，至少一次 QoS2，Exactly once，确保只有一次 (可选 0, 1, 2)    |
| `mqtt.username`    | `username`| String | ""  | mqtt 账号     |
| `mqtt.password`     | `mqttpassword`| String | ""  | mqtt 密码    |
| `mqtt.prefix`    | `prefix`| String | ""     | MQTT 订阅主题的前缀    |
| `mqtt.onlinecheck`    | `onlinecheck`| Int | 0    | 在线验证开关 1 先走离线，失败再走在线验证 0 只走离线    |
| `mqtt.timeout`    | `timeout`| Int | 5   | 在线验证超时时间，单位 s    |
| `mqtt.willTopic`    | `willTopic`| String | "access_device/v2/event/offline"  | 遗嘱 设备断开连接自动发送    |
| `mqtt.cleanSession`    | `cleanSession`| Int | 0  | 清除会话开关， 1 开 0 关    |

[回到顶部](#category)

## 网络配置（net）

| MQTT配置项                         | 扫码配置项 |类型   | 默认值 | 说明                                    |
| ------------------------------ | ------ | ------ | ------ | --------------------------------------- |
| `net.type`                | `type`    | Int | 1      | 网络类型 (1:以太网, 2:WiFi)       |
| `net.dhcp`                | `dhcp`    | Int | 2     | dhcp为1：自定义网络配置，即手动设置静态IP，ip、gateway、subnetMask、dns必须传入且不可为空；dhcp为2：设备配置为 DHCP 模式，自动获取动态 IP，无须传入其余参数         |
| `net.ip`                   | `ip`   | String | ""     | IP 地址        |
| `net.gateway`             | `gateway`    | String | ""     | 网关地址                                |
| `net.mask`           | `mask`   | String | ""     | 子网掩码                                |
| `net.dns`                 | `dns`    | String | ""     | DNS 服务器                              |
| `net.mac`               | `mac`   | String | ""     | 网络 MAC 地址，联网后自动读取，自定义无效                           |
| `net.ssid`| `ssid`    | String | ""    | type传入2：设备使用WiFi连接，ssid、pwd参数必须传入且不可为空 |
| `net.psk`  | `psk`   | String | "" | type传入2：设备使用WiFi连接，ssid、pwd参数必须传入且不可为空 |

[回到顶部](#category)

## 时钟配置（ntp）

| MQTT配置项                 | 扫码配置项 | 类型   | 默认值         | 说明                              |
| ---------------------- | ------ | ------ | -------------- | --------------------------------- |
| `ntp.server`     | `server`   | String | "182.92.12.11" | ntp对时服务器ip      |
| `ntp.gmt`| `gmt`  | Int | 8              | 时区 中国为 8        |
| `ntp.timeZone` | `timeZone`  | String | Asia/Shanghai      | 时区，参考[附表 1 时区配置]-时区键名列    |

## 通行配置（access）
 
 | MQTT配置项                  | 扫码配置项| 类型   | 默认值 | 说明                               |
| ----------------------- | ------ |------ |  ------ | ---------------------------------- |
| `access.offlineAccessNum` | `offlineAccessNum` | Int | 2000     | 通行记录存储最大数量   |
| `access.relayTime`   | `relayTime`| Int | 3    | 继电器打开时长，单位s  |
| `access.fire` | `fire` | Int | 0    | 火警开关 1:开 0:关   |
| `access.fireStatus`| `fireStatus` | Int | 0     | 火警状态 1:预警 0:正常|
| `access.tamper`  | `tamper`| Int | 0 | 防拆报警开关 1开 0 关 ，备注：防拆功能暂不支持     |
| `access.uploadToCloud`  | `uploadToCloud`| Int | 0 | 通行记录上传照片开关 1开 0 关    |

## 基础配置（base）

| MQTT配置项                      | 扫码配置项 | 类型   | 默认值 | 说明                                      |
| --------------------------- | ------ |------ | ------ | ----------------------------------------- |
| `base.language`       | `language`   | String | 国内版："CN"，国际版："EN"   | 语言，国内版为"CN"不可修改，国际版支持'EN', 'ES', 'FR', 'DE', 'RU', 'AR', 'PT', 'KO' |
| `base.password`        | `password`  | String | "password"   | 进入后台密码     |
| `base.firstLogin`      | `firstLogin` | Int | 0    | 是否第一次登录后台 0 未登录 1 已登录（不可修改）   |
| `base.screenOff`     | `screenOff`  | Int | 0      | 熄屏时间，单位分钟，0从不    |
| `base.screensaver` | `screensaver` | Int | 0   | 屏幕保护，单位分钟，0从不   |
| `base.brightness` | `brightness` | Int | 70   |白色补光灯亮度 ： 0-100  |
| `base.nirBrightness` | `-` | Int | 80   |红外补光灯亮度 ： 0-100，暂不支持修改  |
| `base.volume` | `volume` | Int | 10   | 喇叭音量：0-10  |
| `base.showIp` | `showIp` | Int | 1   | 是否显示 ip 1显示 0 隐藏  |
| `base.showSn`| `showSn`  | Int | 1   | 是否显示 sn 1显示 0 隐藏   |
| `base.showProgramCode` | `showProgramCode` | Int | 1   | 小程序码 显示 1 显示 0 隐藏 ，暂不支持 |
| `base.appMode`| `appMode`  | Int | 1   | 0: 标准模式 1: 简约模式  |
| `base.backlight` | `backlight` | Int | 70   |屏幕背光：0-100   |

## 系统配置（sys）

| MQTT配置项                      | 扫码配置项  | 类型   | 默认值 | 说明                                      |
| --------------------------- | ------ | ------ | ------ | ----------------------------------------- |
| `sys.mac`        |   | String | ""   | mac地址，不可修改 |
| `sys.uuid`        |   | String | ""   | UUID，不可修改     |
| `sys.sn`     |   | String | ""    | 设备sn，不可修改   |
| `sys.model`    |   | String | ""  | 设备型号，不可修改    |
| `sys.appVersion` |  | String | ""    |固件版本号，不可修改  |
| `sys.releaseTime` |  | String | ""    | 更新时间，不可修改  |
| `sys.heart_en` | `heart_en` | Int | 1   | 心跳1开 0 关  |
| `sys.heart_time` | `heart_time` | Int | 30   | 心跳间隔，单位s，最小 30s   |
| `sys.nfc`| `nfc`  | Int | 1   |刷卡开关 1开 0 关   |
| `sys.pwd` | `pwd` | Int | 1   |密码开门开关 1开 0 关   |
| `sys.strangerImage` | `strangerImage` | Int | 1   |陌生人保存图片开关 1开 0 关   |
| `sys.nfcIdentityCardEnable`| `nfcIdentityCardEnable`  | Int | 1   |云证开关 3:云证获取 1:物理卡号   |
| `sys.scanInterval`| `scanInterval`  | Int | 1   | 扫码间隔，单位s   |

[回到顶部](#category)

---

## 配置说明

### 配置方式

1. **MQTT 远程配置**: 通过 MQTT 协议远程修改配置
2. **扫码配置**: 通过二维码扫描进行配置
（1）配置码前缀 `___VF102_CONFIG_V1.1.0___`
（2）配置内容格式 `{ addr = "mqtt://192.168.10.202:1883" }`
（3）升级码格式 `{update_flag=1,update_addr="XXX",update_md5="XXX"}`，其中 `update_addr`为存放升级包的url地址，`update_md5`为升级包的md5值

### 配置验证

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

### 配置备份

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

### 注意事项

1. NTP 开关（`ntp.ntp`）、ntp对时服务器ip（`ntp.server`）、时区（`ntp.gmt`，`ntp.timeZone`）、语言（`base.language`）后会自动重启设备生效

## 附表 1 时区配置
1、亚洲时区
| 时区键名     | UTC偏移     | 时区名称     | 主要城市     | 夏令时规则/偏移     |
| -------- | ------ | ------- | -------------------------- |------------------------- |
| Asia/Dubai	  | +04:00   | Gulf Standard Time      | 迪拜（阿联酋）|  无  |
|Asia/Karachi	|+05:00	|Pakistan Standard Time	|卡拉奇（巴基斯坦）| 无  |
|Asia/Kolkata	|+05:30	|India Standard Time	|加尔各答（印度）|  无  |
|Asia/Dhaka	|+06:00	|Bangladesh Standard Time	|达卡（孟加拉国）|  无  |
|Asia/Bangkok	|+07:00	|Indochina Time	|曼谷（泰国）|  无  |
|Asia/Jakarta	|+07:00	|Western Indonesia Time	|雅加达（印度尼西亚）|  无  |
|Asia/Shanghai	|+08:00	|China Standard Time	|北京（中国）|  无  |
|Asia/Hong_Kong	|+08:00	|Hong Kong Time	|香港（中国）|  无  |
|Asia/Taipei	|+08:00	|Taiwan Standard Time	|台北（中国）|  无  |
|Asia/Singapore	|+08:00	|Singapore Standard Time	|新加坡|  无  |
|Asia/Seoul	|+09:00	|Korea Standard Time	|首尔（韩国）|  无  |
|Asia/Tokyo	|+09:00	|Japan Standard Time	|东京（日本）|  无  |
|Australia/Perth	|+08:00	|Australian Western Standard Time(Perth)	|珀斯（澳大利亚）|  无  |
|Australia/Sydney	|+10:00	|Australian Western Standard Time(Sydney)	|悉尼（澳大利亚）|  无  |

2、美洲时间
| 时区键名     | UTC偏移     | 时区名称     | 主要城市     | 夏令时规则/偏移     |
| -------- | ------ | ------- | -------------------------- |------------------------- |
| America/Adak	| -10:00	| Hawaii-Aleutian Standard Time	| 阿达克（美国）|  3月第二个周日 - 11月第一个周日 (偏移: -09:00)  |
| America/Anchorage	| -09:00	| Alaska Standard Time	| 安克雷奇（美国）|  3月第二个周日 - 11月第一个周日 (偏移: -08:00)  |
| America/Los_Angeles	| -08:00	| Pacific Standard Time	| 洛杉矶（美国）|   3月第二个周日 - 11月第一个周日 (偏移: -07:00)  |
| America/Denver	| -07:00	| Mountain Standard Time	| 丹佛（美国）|  3月第二个周日 - 11月第一个周日 (偏移: -06:00)  |
| America/Chicago	| -06:00	| Central Standard Time	| 芝加哥（美国）|  3月第二个周日 - 11月第一个周日 (偏移: -05:00)  |
| America/Mexico_City	| -06:00	| Central Time	| 墨西哥城（墨西哥）|   无  |
| America/New_York	| -05:00	| Eastern Standard Time	| 纽约（美国）|   3月第二个周日 - 11月第一个周日 (偏移: -04:00) |
| America/Toronto	| -05:00	| Eastern Standard Time	| 多伦多（加拿大）|  3月第二个周日 - 11月第一个周日 (偏移: -04:00)  |
| America/Bogota	| -05:00	| Colombia Time	| 波哥大（哥伦比亚）|   无  |
| America/Lima	| -05:00	| Peru Time	| 利马（秘鲁）|  无  |
| America/Santiago	| -04:00	| Chile Time	| 圣地亚哥（智利）|  9月第一个周六 - 4月第一个周六 (南半球规则) (偏移: -03:00)  |
| America/Sao_Paulo	| -03:00	| Brazil Time	| 圣保罗（巴西）|  无  |
| America/Argentina/Buenos_Aires	| -03:00	| Argentina Time	| 布宜诺斯艾利斯（阿根廷）|  无  |

3、欧洲时区
| 时区键名     | UTC偏移     | 时区名称     | 主要城市     |夏令时规则/偏移     |
| -------- | ------ | ------- | -------------------------- |------------------------- |
| Europe/Lisbon	| +00:00	| Portugal Time	| 里斯本（葡萄牙）| 3月最后一个周日 - 10月最后一个周日 (偏移: +01:00)  |
| Europe/London	| +00:00	| Greenwich Mean Time	| 伦敦（英国）|  3月最后一个周日 - 10月最后一个周日 (偏移: +01:00)  |
| Europe/Amsterdam	| +01:00	| Central European Time	| 阿姆斯特丹（荷兰）| 3月最后一个周日 - 10月最后一个周日 (偏移: +02:00)  |
| Europe/Berlin	| +01:00	| Central European Time	| 柏林（德国）|  3月最后一个周日 - 10月最后一个周日 (偏移: +02:00)  |
| Europe/Paris	| +01:00	| Central European Time	| 巴黎（法国）|  3月最后一个周日 - 10月最后一个周日 (偏移: +02:00)  |
| Europe/Madrid	| +01:00	| Central European Time	| 马德里（西班牙）|  3月最后一个周日 - 10月最后一个周日 (偏移: +02:00)  |
| Europe/Rome	| +01:00	| Central European Time	| 罗马（意大利）|  3月最后一个周日 - 10月最后一个周日 (偏移: +02:00)  |
| Europe/Stockholm	| +01:00	| Central European Time	| 斯德哥尔摩（瑞典）|  3月最后一个周日 - 10月最后一个周日 (偏移: +02:00)  |
| Europe/Athens	| +02:00	| Eastern European Time	| 雅典（希腊）|  3月最后一个周日 - 10月最后一个周日 (偏移: +03:00)  |
| Europe/Istanbul	| +03:00	| Turkey Time	| 伊斯坦布尔（土耳其）|  无  |

4、大洋洲时区
| 时区键名     | UTC偏移     | 时区名称     | 主要城市     |夏令时规则/偏移     |
| -------- | ------ | ------- | -------------------------- |------------------------- |
| Atlantic/Azores	| -01:00	| Azores Time	| 亚速尔群岛|  3月最后一个周日 - 10月最后一个周日 (偏移: +00:00)  |

5、太平洋时区
| 时区键名     | UTC偏移     | 时区名称     | 主要城市     |夏令时规则/偏移     |
| -------- | ------ | ------- | -------------------------- |------------------------- |
| Pacific/Guam	| +10:00	| Guam Time	| 关岛（美国）|  无  |
| Pacific/Noumea	| +11:00	| New Caledonia Time	| 努美阿（新喀里多尼亚）|  无  |
| Pacific/Auckland	| +12:00	| New Zealand Standard Time	| 奥克兰（新西兰）|  9月最后一个周日 - 4月第一个周日 (偏移: +13:00)  |
| Pacific/Fiji	| +12:00	| Fiji Time	| 斐济|  11月第二个周日 - 1月第二个周日 (规则常变动) (偏移: +13:00)  |
| Pacific/Midway	| -11:00	| Smoa Standard Time	| 中途岛（美国）|  无  |
| Pacific/Honolulu	| -10:00	| Hawaii Standard Time	| 檀香山（美国）|  无  |

## 版本信息

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