3.1 扫码器新配置字段说明

# 目录

一、[文档概述](#文档概述)

二、[配置字段说明](#配置字段说明)
1. [通用配置(common_config)](#title_common_config)
2. [信道配置(channel)](#title_channel)
3. [行为动作配置(action)](#title_action)
4. [音频配置(audio)](#title_audio)
5. [解码器配置(decoder)](#title_decoder)
6. [云证配置(eid)](#title_eid)
7. [ISP 配置(isp)](#title_isp)
8. [网络配置(net)](#title_net)
9. [NFC 配置(nfc)](#title_nfc)
10. [NTP 配置(ntp)](#title_ntp)
11. [OUTPUT 配置(output)](#title_output)
12. [配置密码(passwd)](#title_passwd)
13. [版本号(version)](#title_version)
14. [微光 485 协议配置(vg485)](#title_vg485)
15. [微光通信协议配置(vgpro)](#title_vgpro)
16. [按键配置(tkey)](#title_tkey)
17. [PSAM(psam)](#title_psam)
18. [安全模块配置(safe_relay)](#title_safe)

# 一、文档概述
1. 为了满足客户在使用我司设备时的不同应用场景，3.1版本的固件留有一些配置字段以供用户自定义固件程序行为，满足一些较为通用的使用诉求。为避免我司固件开发人员，软件开发人员，测试人员与生产人员在日常工作中因对这些配置字段不明晰而导致其工作内容错误，现书写此文档作为3.1配置字段唯一释疑。
2. 本文档中对各个模块的配置字段多用表格描述，其表头含义如下表所示：

# 二、配置字段说明

## 1. [通用配置](#title_back)
```txt
	该模块的字段重要用于保存设备的信息，如 devmac 之类的设备唯一标识，或者devnum，devname等用户自定义设备信息。
	同时包含部分字段用于设备扫码升级，扫码重启等功能。
```
### 配置字段详情如下

| 字段名 | 类型 | 长度 | 外部可见性 | 读写性 | 功能描述 | 默认值 | 补充说明 |
| :-----------: | :--: | :--: | :--------: | :----: | :----------------------: | :-------------------: | :----------------------------------------------------------- |
| uuid | str | 127 | √ | RW/RO | 设备SN | 不固定 | 标品固件此字段不可进行配置，门禁版本可在出厂烧录时进行唯一一次配置。 &nbsp;&nbsp;&nbsp;&nbsp;未配置时该字段等同于 `devmac` 字段 该字段改动在有蓝牙的设备上会同步改动ble_name字段 |
| uuid_sta | str | 15 | × | RW | 标识是否可以修改 devmac | unset(门禁)/set(标品) | 该字段为开发人员内部字段，用于标识 uuid 是否可被配置。 unset 表明可配（未被设置）， set 表明不可配（已被设置） |
| userid | str | 255 | √ | RW | 用户自定义SN | device_sn | 用户自定义，可多次修改**** |
| devmac | str | 127 | √ | RO | 设备的的唯一 ID | 不固定 | 根据设备chipid 计算出的更简短的唯一ID(16进制字符串),不可修改。 理论上每台设备此ID唯一，可认为是设备唯一标识 根据 Soc 型号不同该字段长度可能有变化 |
| devname | str | 127 | √ | RW | 为ui界面显示的公司名称 | 苏州酷豆物联 | 用户自定义，可多次修改 |
| devnum | int | 4 | √ | RW | 自定义 sn | 0 | 用户自定义，可多次修改 |
| update_haddr | str | 255 | × | RW | 扫码升级，升级包地址 | unset | 扫码升级保存升级地址的字段，该字段不对外开放 仅在本模块的update_flg字段为真时(`1`)，才会生效 |
| update_md5 | str | 32 | × | RW | 扫码升级，升级包 MD6 | unset | 扫码升级保存升级包MD5，该字段不对外开放 仅在本模块的update_flg字段为真时(`1`)，才会生效 |
| update_flg | bool | 4 | × | RW | 扫码升标志位 | 0 | 标识是否处于扫码升级模式，有以下有效值： &nbsp;&nbsp;&nbsp;&nbsp;true(1)：设备处于扫码升级模式 &nbsp;&nbsp;&nbsp;&nbsp;false(0)：设备不处于扫码升级模式 |
| update_reboot | bool | 4 | × | RW | 扫码升级，升级后是否重启 | 0 | 标识设备扫码升级后是否重启，有以下有效值： &nbsp;&nbsp;&nbsp;&nbsp;true(1)：设备升级后重启 &nbsp;&nbsp;&nbsp;&nbsp;false(0)：设备升级后不重启 |
| era_uboot | bool | 4 | × | RW | 擦除u-boot标志位 | 0 | 该字段标识是否擦除 u-boot，`暂未支持`，不对外开放 |
| reboot | bool | 4 | × | RW | 设备重启标志位 | 0 | 用于扫码重启 true(1)：设备重启 false(0)：设备不重启 |
| dev_sta | int | 4 | × | RW | 设备状态标志位 | 1 | 标识设备的状态 测试状态：0（门禁和控制板） 正常状态：1（通用） 禁用状态：2（通用） 火警状态：3（门禁和控制板） |
---

## 2. [信道配置](#title_back)
    该模块的配置为设备数据通道相关配置
- 配置字段详情如下

| 字段名 | 类型 | 长度 | 外部可见性 | 外部读写性 | 功能描述 | 默认值 | 补充说明 |
| :---------------: | :---------: | :--: | :--------: | :--------: | :---------------------: | :-----------------------: | :----------------------------------------------------------- |
| p_rs485_i | string | 31 | √ | RW | rs485 参数 | "115200-8-N-1" | 目前485共有四个通道 i=0或1或2或3 [点此跳转](#p_rs485_0) |
| p_rs232_i | string | 31 | √ | RW | rs232参数 | "115200-8-N-1" | 目前232共有四个通道 i=0或1或2或3 [点此跳转](#p_rs232_0) |
| p_ttl_i | string | 31 | √ | RW | ttl参数 | "115200-8-N-1" | 目前ttl共有四个通道 i=0或1或2或3 [点此跳转](#p_ttl_0) |
| p_wiegand_i_mode | int | 4 | √ | RW | 韦根发送模式 | 2 | 默认是韦根34模式，目前wiegand共有四个通道,i=0或1或2或3[点此跳转](#p_wiegand_0_mode) |
| p_wiegand_i_btime | int | 4 | √ | RW | 韦根忙时时间 | 50 | 该参数可配置韦根通信忙时时间，单位为毫秒(ms),i=0或1或2或3 |
| p_wiegand_i_ftime | int | 4 | √ | RW | 韦根闲时时间 | 100 | 该参数可配置韦根通信闲时时间，单位为毫秒(ms)，i=0或1或2或3 |
| touttime | int | 4 | √ | RW | tcp 连接超时时间 | 2 | 该参数可配置值范围为 `0` ~ `5`, 单位是`秒(s)` |
| houttime | int | 4 | √ | RW | http 连接超时时间 | 2 | 该参数可配置值范围为 `0` ~ `5`, 单位是`秒(s)` |
| taddr | string[300] | 299 | √ | RW | tcp 服务器地址 | "192.168.1.1" | 需要连接时按照格式改为自己的服务器地址 |
| port | short | 2 | √ | RW | 端口号 | 8080 | 其取值范围应与 端口号定义保持一致，为 `0-65535` |
| haddr | string[300] | 299 | √ | RW | http服务器地址以及端口 | "http://192.168.1.1:8080" | 需要连接时按照格式改为自己的服务器地址和端口号 |
| usb_kup_delay | int | 4 | √ | RW | usb虚拟键盘抬起延时时间 | 10000 | 单位：微秒 |
| usb_kdown_delay | int | 4 | √ | RW | usb虚拟键盘按下延时时间 | 10000 | 单位：微秒 |
| usbkbw_capslk | int | 4 | √ | RW | 大小写锁定开关 | 0 | [点此跳转](#usbkbw_capslk) |

1.[p_rs485_0](#p_rs485_0_back)

- 该参数可配置 rs485 信道参数，可配置的参数及可配置值如下：
- 支持的波特率为`300`, `2400`, `4800`, `9600`, `19200`,`38400`, `57600`, `115200`,`460800`,`921600`
- 支持的数据位为`5`, `6`, `7`, `8`
- 支持的校验位为`N`, `O`, `E`
- 支持的停止位为`1`, `2`

2.[p_rs232_0](#p_rs232_0_back)

- 该参数可配置 rs232信道参数，可配置的参数及可配置值如下：
- 该字段类型为`字符串`，最大长度为`31`字节。
- 支持的波特率为`300`, `2400`, `4800`, `9600`, `19200`, `38400`, `57600`, `115200`,`460800`,`921600`
- 支持的数据位为`5`, `6`, `7`, `8`
- 支持的校验位为`N`, `O`, `E`
- 支持的停止位为`1`, `2`

3.[p_ttl_0](#p_ttl_0_back)

- 该参数可配置ttl信道参数，可配置的参数及可配置值如下：
- 该字段类型为`字符串`，最大长度为`31`字节。
- 支持的波特率为`300`, `2400`, `4800`, `9600`, `19200`, `38400`, `57600`, `115200`,`460800`,`921600`
- 支持的数据位为`5`, `6`, `7`, `8`
- 支持的校验位为`N`, `O`, `E`
- 支持的停止位为`1`, `2`

4.[p_wiegand_0_mode](#p_wiegand_0_mode_back)

- p_wiegand_0_mode = 1，韦根`26`模式，26 bit发送，2个bit校验位+24个bit数据位

- p_wiegand_0_mode = 2，韦根`34`模式，34 bit发送，2个bit校验位+32个bit数据位

- p_wiegand_0_mode = 3，韦根`128`模式

- p_wiegand_0_mode = 4，韦根`256`模式

- p_wiegand_0_mode = 5，韦根`2048`模式

- p_wiegand_0_mode = 6，韦根`自定义`模式

注意：该模式下可自己封装一次发送的bit位数，最大发送6400位
  			该模式下用户自己封装的char类型数组中每个元素对应实际发送的一个bit位
  			例如：char data[26] = &quot;00101010111111101111100000"
  			代表用户自定义发送26bit，
  			其中第0个bit位是对第1\~12bit位的偶校验位
  			其中第25个bit位是对第13\~24bit位的奇校验位
  韦根小盒仅支持验证26、34bit的韦根模式，
  所以自定义模式下若用韦根小盒做测试，仅能验证26、34bit的自定义模式，且对应的校验位也需要用户自己计算好

5.[usbkbw_capslk](#usbkbw_capslk_back)

- 该参数为 usb 虚拟键盘的大小写锁定开关（模拟键盘 Caps Lock 按键）
- 当电脑当前状态（通过真实键盘大小写按键操作）为小写状态时，该配置项，`1`：开启大写，`0`：关闭大写
- 当电脑当前状态（通过真实键盘大小写按键操作）为大写状态时，该配置项，`1`：开启小写，`0`：关闭小写

## 3. [行为动作配置](#title_back)

该模块的配置为设备行为动作相关配置
- 配置字段详情如下

| 字段名 | 类型 | 外部可见性 | 外部读写性 | 功能描述 | 默认值 | 补充说明 |
| :--------: | :--: | :--------: | :--------: | :------------------: | :----: | :--------------------------------------------------: |
| beepd | int | YES | RW | 蜂鸣器延时 | 30 | [点此跳转](#beepd) |
| wled | int | YES | RW | 灯光控制 | 1 | [点此跳转](#wled) |
| ledd | int | YES | RW | 闪灯延时 | 200 | [点此跳转](#ledd) |
| relayd | int | YES | RW | 继电器延时 | 1000 | [点此跳转](#relayd) |
| brightness | int | YES | RW | 白色补光灯亮度 | 200 | [点此跳转](#brightness) |
| volctl | int | YES | RW | 电平控制 | 1 | [点此跳转](#volctl) |
| ascan | int | YES | RW | 扫码后动作 | 1 | [点此跳转](#ascan) |
| awifi_s | int | YES | RW | 网络传输成功行为 | 1089 | [点此跳转](#awifi_s) |
| awifi_f | int | YES | RW | 网络传输失败行为 | 2049 | [点此跳转](#awifi_f) |
| anfc | int | YES | RW | 刷卡后动作 | 1 | [点此跳转](#anfc) |
| backlight | int | YES | RW | LCD 背光亮度 | 100 | [点此跳转](#backlight) |
| boot_music | int | YES | RW | 设备开机语音 | 0 | [点此跳转](#boot_music) |
| afinger | int | YES | RW | 识别到指纹数据后动作 | 1 | [点此跳转](#afinger) |

1.[beepd](#beepd_back)

- 该字段为配置设备蜂鸣器延时时间，该参数可对用户开放，用户可具有读写权限。
- 该字段类型为`整型`，大小为`4`字节，
- 该字段的有效值范围为`0 - 1000`， 默认值为`30`，单位为`毫秒(ms)`

2.[wled](#wled_back)

- 该字段为配置设备灯光行为，该参数可对用户开放，用户可具有读写权限。
- 该字段类型为`整型`，大小为`4`字节，
- 该字段是根据bit位值生效的标志位，对应bit位写1使能，写0禁用。其bit位定义如下：
  1.  bit1: 白灯控制位  
  2.  bit2: 红灯控制位
  3.  bit3: 绿灯控制位
  4.  bit4: 蓝灯控制位

3.[ledd](#ledd_back)

- 该字段可配置灯光闪烁延时时间，该参数可对用户开放，用户具有读写权限
- 该字段类型为`整型`， 长度为`4`字节
- 该字段的有效值范围为`0 - 1000`， 默认值为`200`，单位为`毫秒(ms)`

4.[relayd](#relayd_back)

- 该字段可配置继电器延时时间， 该参数可对用户开放，用户可具有读写权限
- 该字段类型为`整型`，长度为`4`字节，该参数的单位为 `毫秒(ms)`
- 该字段的有效值范围为`0 - 10000`， 默认值为`1000`，单位为`毫秒(ms)`

5.[brightness](#brightness_back)

- 该字段可配置白色补光灯亮度， 该参数可对用户开放，用户可具有读写权限
- 该字段类型为`整型`，长度为`4`字节
- 该字段的有效范围为`0 ~ 255`，默认值为`200`

6.[volctl](#volctl_back)

- 该字段可==配置高电平输出的输出电压==，该参数可对用户开放，用户可具有读写权限
- 该字段的类型为`整型`，长度为`4`字节
- 该参数默认值为`1`, 可配置值如下：
  1. 如果配置 `volctl=1`，则高电平输出电压为`3.3V`
  2. 如果配置 `volctl=0`，则高电平输出电压为`4.3V`
- 该字段需要先配置高电平输出生效
  注：该字段对应的动作函数有问题，需要进一步查看

7.[ascan](#ascan_back)

- 该字段可配置扫码后动作，该参数可对用户开放，用户可具有读写权限。
- 该字段类型为`整型`，大小为`4`字节。
- 该字段是根据bit位值生效的标志位，如下bit位写`1`使能，写`0`禁用。其bit位定义如下：
  1.  bit0: 蜂鸣器控制位
  2.  bit1: 白灯闪烁控制位
  3.  bit2: 红灯闪烁控制位
  4.  bit3: 绿灯闪烁控制位
  5.  bit4: 输出高电平控制位，该bit位使能后，扫码输出高电平，具体输出电压可通过`volctl`字段配置
  6.  bit5: 蓝灯闪烁控制位
  7.  bit6: 动作继电器控制
  8.  bit7: 该bit位并未有特殊含义，建议写`0`
  9.  bit8: 支付码闪灯控制位，该bit位使能后，根据支付码闪烁灯光
  10. bit9:  支付闪灯音频控制器控制位，该bit位使能后，根据支付码闪烁对应的灯光并播放音频
- 该字段默认值为`1`，即配置扫码后动作蜂鸣器

8.[awifi_s](#awifi_s_back)

- 该字段为配置网络传输成功行为，该参数可对用户开放，用户可具有读写权限。
- 网络传输指的是通过网络协议的方式传输数据，只有在通过网络 TCP 协议，网络 HTTP 协议收发数据时才会触发该行为
- 该字段类型为`整型`，大小为`4`字节。
- 该字段是根据bit位值生效的标志位，其bit位定义如下：
 1. bit0: 蜂鸣器控制位
 2. bit1: 白灯闪烁控制位
 3. bit2: 红灯闪烁控制位
 4. bit3: 绿灯闪烁控制位
 5. bit4: 输出高电平控制位
 6. bit5: 蓝灯闪烁控制位
 7. bit6: 动作继电器控制
 8. bit7、bit8、bit9暂无定义，为0即可
 9. bit10：成功语音提示, 该bit位使能播放成功语音
 10. bit11：失败语音提示, 该bit位使能播放失败语音
- 该配置字段默认值为`2`， 即 (0x01 << 1)，即使能 `白灯闪烁`

9.[awifi_f](#awifi_f_back)

- 该字段为配置网络传输失败行为，该参数可对用户开放，用户可具有读写权限。
- 网络传输指的是通过网络协议的方式传输数据，只有在通过网络 TCP 协议，网络 HTTP 协议收发数据时才会触发该行为
- 该字段类型为`整型`，大小为`4`字节。
- 该字段是根据bit位值生效的标志位，其bit位定义如下：
 1. bit0: 蜂鸣器控制位
 2. bit1: 白灯闪烁控制位
 3. bit2: 红灯闪烁控制位
 4. bit3: 绿灯闪烁控制位
 5. bit4: 输出高电平控制位
 6. bit5: 蓝灯闪烁控制位
 7. bit6: 动作继电 器控制
 8. bit7、bit8、bit9暂无定义，为0即可
 9. bit10：成功语音提示, 该bit位使能播放成功语音
 10. bit11：失败语音提示, 该bit位使能播放失败语音
- 该配置字段默认值为`4`， 即 (0x01 << 2) ，即使能 `红灯闪烁`

10.[anfc](#anfc_back)

- 该字段为，该参数可对用户开放，用户可具有读写权限。
- 该字段类型为`整形`，大小为4字节。
- 该字段是根据bit位值生效的标志位，其bit位定义如下：
 1. bit0: 蜂鸣器控制位
 2. bit1: 白灯闪烁控制位
 3. bit2: 红灯闪烁控制位
 4. bit3: 绿灯闪烁控制位
 5. bit4: 输出高电平控制位
 6. bit5: 蓝灯闪烁控制位
 7. bit6: 动作继电器控制
- 该配置字段默认值为`1`， 即`0x01 << 0`，使能 `蜂鸣器`

11.[backlight](#backlight_back)
- 该字段可配置 LCD 的背光亮度，该参数可对用户开放，用户可具有读写权限。
- 该字段类型为`整型`，大小为`4`字节。
- 该字段的有效值范围为`0 ~ 100`， 默认值为`100`
- 该字段只有设备在拥有 LCD 屏幕时生效。

12.[boot_music](#boot_music_back)
- 该字段可配置设备开机语音是否启用，该参数可对用户开放，用户可具有读写权限。
- 该字段类型为`整型`，大小为`4`字节。
- 该字段的有效值为`0`和`1`， 默认值为`0`。
- 该字段是可认为是 bool 类型的字段使用，其有效值含义如下：
  1.  如果配置 `boot_music=0`, 代表`禁用`开机语音，设备开机时无语音动作
  2.  如果配置 `boot_music=1`, 代表`启用`开机语音，设备开机时播放文件系统内 `/vgapp/wav/0.wav`这条音频。

12.[afinger](#afinger_back)
- 该字段可配置设备识别到指纹数据后动作，该参数可对用户开放，用户可具有读写权限。
- 该字段类型为`整型`，大小为`4`字节。
- 该字段是根据bit位值生效的标志位，如下bit位写`1`使能，写`0`禁用。其bit位定义如下：
  1.  bit0: 蜂鸣器控制位
  2.  bit1: 白灯闪烁控制位
  3.  bit2: 红灯闪烁控制位
  4.  bit3: 绿灯闪烁控制位
  5.  bit4: 输出高电平控制位，该bit位使能后，扫码输出高电平，具体输出电压可通过`volctl`字段配置
  6.  bit5: 蓝灯闪烁控制位
  7.  bit6: 动作继电器控制
- 该字段默认值为`1`，即识别到指纹数据后动作蜂鸣器
---

## 4. [音频配置](#title_back)
    该模块的配置为音频相关配置
- 配置字段详情如下

| 字段名 | 类型 | 外部可见性 | 外部读写性 | 功能描述 | 默认值 | 补充说明 |
| :----: | :--: | :--------: | :--------: | :--------------: | :----: | :-------------------------------------: |
| volume | int | √ | RW | 音频播放声音大小 | 30 | [点此跳转](#valume) |

1.[volume](#valume_back)

- 该字段可配置设备音频声音大小，该参数可对用户开放，用户可具有读写权限。
- 该字段类型为`整型`，大小为`4`字节。
- 该字段的有效值为`0 ~ 60`， 默认值为`30`。

---

## 5. [解码器配置](#title_back)
    该模块的配置为解码器相关配置
- 配置字段详情如下

| 字段名 | 类型 | 外部可见性 | 外部读写性 | 功能描述 | 默认值 | 补充说明 |
| :-------------: | :--: | :--------: | :--------: | :----------------: | :---------------------------------: | :----------------------------------------------------------: |
| de_type | int | √ | RW | 码制类型 | 64511 | [点此跳转](#de_type) |
| decoder | int | √ | RW | 解码引擎类型 | 1 | [点此跳转](#decoder_key) |
| s_mode | int | √ | RW | 配置扫码模式 | 0 | [点此跳转](#s_mode) |
| interval | int | √ | RW | 扫码间隔时间 | 200 | [点此跳转](#interval) |
| search_timeout | int | × | - | 检索码的超时时间 | 80 | [点此跳转](#search_timeout) |
| decoder_timeout | int | × | - | 解码的超时时间 | 100 | [点此跳转](#decoder_timeout) |
| search_mode | int | × | - | 解码引擎对应策略 | 0 | [点此跳转](#search_mode) |
| decoder_mode | int | √ | RW | 解码引擎特性配置 | 3 | [点此跳转](#decoder_mode) |
| qr_mode | int | × | - | qr 码的参数配置 | 15 | [点此跳转](#qr_mode) |
| decoder_delay | int | × | - | 两次解码之间的延时 | 1 | [点此跳转](#decoder_delay) |
| ocr_mode | int | √ | RW | ocr 模式 | 1 | [点此跳转](#ocr_mode) |
| ocr_template | str | x | - | ocr 识别模板 | "1&8&14&30&2&8&14&30&2&8&14&30&2&0" | 无补充说明 |

1.[de_type](#de_type_back)

- 该字段可配置解码码制，该参数可对用户开放，用户可具有读写权限。
- 该字段类型为`整型`，大小为`4`字节。
- 该字段是根据bit位值生效的标志位，其==bit位定义==如下：
 1. bit0：`QR` 码控制位， 该位置 `1` 使能该码。对应的 int 值为 （0x01 << (VBAR_SYM_QRCODE - 1)） = `1`
 2. bit1：`EAN8` 码控制位， 该位置 `1` 使能该码。对应的 int 值为 （0x01 << (VBAR_SYM_EAN8 - 1)） = `2`
 3. bit2：`EAN13` 码控制位， 该位置 `1` 使能该码。对应的 int 值为 （0x01 << (VBAR_SYM_EAN13 - 1)） = `4`
 4. bit3：`ISBN13` 码控制位， 该位置 `1` 使能该码。对应的 int 值为 （0x01 << (VBAR_SYM_CODE39 - 1)） = `8`
 5. bit4：`CODE39` 码控制位， 该位置 `1` 使能该码。对应的 int 值为 （0x01 << (VBAR_SYM_CODE93 - 1)） = `16`
 6. bit5：`CODE93` 码控制位， 该位置 `1` 使能该码。对应的 int 值为 （0x01 << (VBAR_SYM_CODE128 - 1)） = `32`
 7. bit6：`CODE128` 码控制位， 该位置 `1` 使能该码。对应的 int 值为 （0x01 << (VBAR_SYM_DATABAR_EXP - 1)）= `64`
 8. bit7：`DATABAR` 码控制位， 该位置 `1` 使能该码。对应的 int 值为 （0x01 << (VBAR_SYM_DATABAR - 1)） = `128`
 9. bit8：`DATABAR_EXP` 码控制位， 该位置 `1` 使能该码。对应的 int 值为 （0x01 << (VBAR_SYM_DATABAR_EXP - 1)）= `256`
 10. bit9：`PDF417` 码控制位， 该位置 `1` 使能该码。对应的 int 值为 （0x01 << (VBAR_SYM_PDF417 - 1)） = `512`
 11. bit10：`MATAMATRIX` 码控制位， 该位置 `1` 使能该码。对应的 int 值为 （0x01 << (VBAR_SYM_DATAMATRIX - 1)） = `1024`
 12. bit11：`ITF` 码控制位， 该位置 `1` 使能该码。对应的 int 值为 （0x01 << (VBAR_SYM_ITF - 1)） = `2048`
 13. bit12：`ISBN10` 码控制位， 该位置 `1` 使能该码。对应的 int 值为 （0x01 << (VBAR_SYM_ISBN10 - 1)） = `4096`
 14. bit13：`UPCE` 码控制位， 该位置 `1` 使能该码。对应的 int 值为 （0x01 << (VBAR_SYM_UPCE - 1)） = `8192`
 15. bit14：`UPCA` 码控制位， 该位置 `1` 使能该码。对应的 int 值为 （0x01 << (VBAR_SYM_UPCA - 1)） = `16384`
 16. bit15：`AZTEC` 码控制位， 该位置 `1` 使能该码。对应的 int 值为 （0x01 << (VBAR_SYM_AZTEC - 1)） = `32768`
 17. bit16：`CODABAR` 码控制位， 该位置 `1` 使能该码。对应的 int 值为 （0x01 << (VBAR_SYM_CODABAR - 1)） = `65536`
 18. bit17：`CODE11` 码控制位， 该位置 `1` 使能该码。对应的 int 值为 （0x01 << (VBAR_SYM_CODE11 - 1)） = `131072`
 19. bit18：`TRIOPTIC` 码控制位， 该位置 `1` 使能该码。对应的 int 值为 （0x01 << (VBAR_SYM_TRIOPTIC - 1)） = `262144`
 20. bit19：`TELEPEN` 码控制位， 该位置 `1` 使能该码。对应的 int 值为 （0x01 << (VBAR_SYM_TELEPEN - 1)） = `524288`
 21. bit20：`STRT25` 码控制位， 该位置 `1` 使能该码。对应的 int 值为 （0x01 << (VBAR_SYM_STRT25 - 1)） = `1048576`
 22. bit21：`MATRIX25` 码控制位， 该位置 `1` 使能该码。对应的 int 值为 （0x01 << (VBAR_SYM_MATRIX25 - 1)） = `2097152`
 23. bit22：`CHINAPOST` 码控制位， 该位置 `1` 使能该码。对应的 int 值为 （0x01 << (VBAR_SYM_CHINAPOST - 1)） = `4194304`
 24. bit23：`MSI` 码控制位， 该位置 `1` 使能该码。对应的 int 值为 （0x01 << (VBAR_SYM_MSI - 1)） = `8388608`
 25. bit24：`CODABLOCK` 码控制位， 该位置 `1` 使能该码。对应的 int 值为 （0x01 << (VBAR_SYM_CODABLOCK - 1)） = `16777216`
 26. bit25：`MAXICODE` 码控制位， 该位置 `1` 使能该码。对应的 int 值为 （0x01 << (VBAR_SYM_MAXICODE - 1)） = `33554432`
 27. bit26：`RSS` 码控制位， 该位置 `1` 使能该码。对应的 int 值为 （0x01 << (VBAR_SYM_RSS - 1)） = `67108864`
 28. bit27：`OCR` 码控制位， 该位置 `1` 使能该码。对应的 int 值为 （0x01 << (VBAR_SYM_OCR - 1)） = `134217728`
- 该字段的默认值为 `64511`, 对应的使能码制度为 `QR`, `EAN8`, `EAN13`, `ISBN13`, `CODE39`, `CODE93`, `CODE128`, `DATABAR`, `DATABAR_EXP`, `ITF`, `ISBN10`, `UPCE`, `UPCA`, `AZTEC`

2.[decoder](#decoder_key_back)

- 该字段为，该参数可对用户开放，用户可具有读写权限。
- 该字段类型为`整型`，大小为`4`字节。
- 该字段默认值为`1`，有效值为`1`，即现在仅有一种解码引擎

3.[s_mode](#s_mode_back)
- 该字段可配置扫码模式，该参数可对用户开放，用户可具有读写权限。
- 该字段类型为`整型`，大小为`4`字节。
- 该字段的有效值为`0`和`1`， 默认值为`0`。
- 该字段的==有效值释义==如下：
  1. `0`，配置扫码模式为`间隔模式`，即同一扫码间隔内只输出一次扫码数据（所有扫到的码只输出1个有效的）
  2. `1`，配置扫码模式为`单次模式`，即相同时间内，相同的码值只输出一次

4.[interval](#interval_back)

- 该字段可配置扫码间隔时间，该参数可对用户开放，用户可具有读写权限。
- 该字段类型为`整型`，大小为`4`字节。
- 该字段的单位为`毫秒(ms)`， 默认值为 `200` ms
- 该字段只有扫码模式配置为`间隔模式时生效`

5.[search_timeout](#search_timeout_back)
- 该字段可配置检索码的超时时间，该参数默认不对外开放。
- 该字段类型为`整型`，大小为`4`字节。
- 该字段的 默认值为`80`，单位为`毫秒(ms)`。

6.[decoder_timeout](#decoder_timeout_back)
- 该字段可配置解码的超时时间，该参数默认不对外开放。
- 该字段类型为`整型`，大小为`4`字节。
- 该字段的 默认值为`100`，单位为`毫秒(ms)`。

7.[search_mode](#search_mode_back)
- 该字段可配置解码引擎的策略，该参数默认不对外开放。
- 该字段类型为`整型`，大小为`4`字节。
- 该字段的 默认值为`0`。
- 不同引擎对应的解码策略不同，详情==联系开发==
#TODO:解码引擎策略后续补充

8.[decoder_mode](#decoder_mode_back)

- 该字段可配置解码引擎的特性，该参数可对外开放，权限为可读可写。
- 该字段类型为`整型`，大小为`4`字节。
- 该字段的 默认值为`3`。
- 不同引擎对应的解码特性不同，详情==联系开发==
#TODO:解码引擎特性后续补充

9.[qr_mode](#qr_mode_back)
- 该字段可配置对 qr 码的单独设置，默认不对外开放。
- 该字段类型为`整型`，大小为`4`字节。
- 该字段的 默认值为`15`。
- 该字段是根据bit位值生效的标志位，其bit位定义如下：
  1. bit1: 使能该 bit 控制位，可使解码引擎支持对`图像占比较小的qr码的支持`  
  2. bit2: 使能该 bit 控制位，可使解码引擎支持`定位符不是方形的qr码`，该字段默认可不开
  3. bit3: 使能该 bit 控制位，可使解码引擎支持`qr码识别增强`，针对医疗、异常、拉丝场景，普通场景可不开
  4. bit4: 使能该 bit 控制位，可使解码引擎支持`打点qr码增强（耗时操作）`，普通场景可不开
  5. bit5: 使能该 bit 控制位，可使解码引擎支持`无静区二维码（耗时操作）`，，默认不开
- ==默认值 `15`==， 即开启了`对图像占比较小的qr码的支持`，`定位符不是方形的qr码`，`qr码识别增强`，`打点qr码增强（耗时操作）`。

10.[decoder_delay](#decoder_delay_back)
- 该字段可配置解码线程的休眠时间，该字段不对外开放。
- 该字段类型为`整型`，大小为`4`字节。
- 该字段的 默认值为`1`。

12.[ocr_mode](#ocr_mode_back)
- 该字段可配置扫码器的 ocr 模式，可对外开放，用户具有读写权限。
- 该字段类型为`整型`，大小为`4`字节。
- 该字段的默认值为`1`，其有效值及释义如下
  1. 该字段值为`1`时标识配置 ocr 模式为`普通ocr模式` 
  2. 该字段值为`2`时标识配置 ocr 模式为`反色ocr模式`
  3. 该字段值为`3`时标识配置 ocr 模式为 `同时开启普通ocr模式和反色ocr模式`
---

## 6. [云证配置](#title_back)
    该模块的配置为云证模块相关配置
- 配置字段详情如下

| 字段名 | 类型 | 长度 | 外部可见性 | 外部读写性 | 功能描述 | 默认值 | 补充说明 |
| :--------: | :-----: | :--: | :--------: | :--------: | :----------------------------------------------------------: | :------------------: | :----------------------------------------------------------: |
| id_timeout | int | 4 | √ | RW | 云证超时时间 | 2 | 单位：秒 |
| id_appid | str[32] | 31 | √ | RW | 云证应用的appid | "1621503" | 暂无补充说明 |
| id_envcode | int | 4 | √ | RW | 云证环境编码 | 52302 | 暂无补充说明 |
| id_port | int | 4 | √ | RW | 云证端口 | 9989 | 暂无补充说明 |
| id_ipaddr | str[64] | 63 | √ | RW | 云证ip地址 | "deviceid.dxiot.com" | 暂无补充说明 |
| eid_len | int | 4 | √ | RW | 云证单次读卡长度 | 54 | 此默认值是刷卡合理长度 最大为252 |

---

## 7. [ISP 配置](#title_back)
    该模块的配置为sensor 的 isp 参数相关配置
- 配置字段详情如下

| 字段名 | 类型 | 外部可见性 | 外部读写性 | 功能描述 | 默认值 | 补充说明 |
| :----: | :--: | :--------: | :--------: | :--------------: | :----: | :----------------------------------------------------: |
| ST | int | √ | RO | 标识sensor型号 | 0 | [点此跳转](#isp_explain) |
| A1 | int | √ | RW | isp main func | 0 | [点此跳转](#isp_explain) |
| B1 | int | √ | RW | isp sub func | 2 | [点此跳转](#isp_explain) |
| C1 | int | √ | RW | 图像目标亮度值 | 100 | [点此跳转](#isp_explain) |
| D1 | int | √ | RW | 目标亮度占比 | 90 | [点此跳转](#isp_explain) |
| E1 | int | √ | RW | 计算时的采样间隔 | 32 | [点此跳转](#isp_explain) |
| F1 | int | √ | RW | 最大曝光值 | 1700 | [点此跳转](#isp_explain) |
| G1 | int | √ | RW | 最小曝光值 | 400 | [点此跳转](#isp_explain) |
| H1 | int | √ | RW | 最大增益值 | 256 | [点此跳转](#isp_explain) |
| I1 | int | √ | RW | 最小增益值 | 32 | [点此跳转](#isp_explain) |
| J1 | int | √ | RO | 起始曝光值 | 150 | [点此跳转](#isp_explain) |
| K1 | int | √ | RO | 起始增益值 | 64 | [点此跳转](#isp_explain) |
| L1 | int | √ | RO | - | 120 | [点此跳转](#isp_explain) |
| M1 | int | √ | RO | - | 0 | [点此跳转](#isp_explain) |
| N1 | int | √ | RO | - | 3 | [点此跳转](#isp_explain) |
| O1 | int | √ | RO | - | 0 | [点此跳转](#isp_explain) |
| P1 | int | √ | RO | - | 0 | [点此跳转](#isp_explain) |
| Q1 | int | √ | RO | - | 0 | [点此跳转](#isp_explain) |
| R1 | int | √ | RO | - | 0 | [点此跳转](#isp_explain) |
| S1 | int | √ | RO | - | 0 | [点此跳转](#isp_explain) |
| T1 | int | √ | RO | - | 0 | [点此跳转](#isp_explain) |
| U1 | int | √ | RO | - | 60 | [点此跳转](#isp_explain) |
| V1 | int | √ | RO | - | 2 | [点此跳转](#isp_explain) |
| W1 | int | √ | RO | - | 60 | [点此跳转](#isp_explain) |
| X1 | int | √ | RO | - | 100 | [点此跳转](#isp_explain) |
| Y1 | int | √ | RO | - | 0 | [点此跳转](#isp_explain) |
| Z1 | int | √ | RO | - | 1 | [点此跳转](#isp_explain) |
---

1.[isp 整体参数说明](#isp_explain_back)

- ISP 参数共有 27 个，分别为 `A1` ~ `Z1`, 以及 `ST`。其中 `ST`，`J1` ~ `Z1` 配置工具不可配，其余字段可通过配置工具进行配置。
- 上述配置工具不可配置字段中，`ST`,`J1`,`K1`可通过 app 的 menuconfig 进行配置，其余只能在代码内修改init宏默认值
- `ST` 字段标识的是 sonsor 的型号，现有已经添加的 sensor 型号有以下几种：
  1.  VBAR_B_CAPTURER_SENSOR_TYPE_UNKNOWN，0   
  2.  VBAR_B_CAPTURER_SENSOR_TYPE_SC031GS，1   
  3.  VBAR_B_CAPTURER_SENSOR_TYPE_OV7251， 2   
  4.  VBAR_B_CAPTURER_SENSOR_TYPE_OV7725， 3  
  5.  VBAR_B_CAPTURER_SENSOR_TYPE_SC132GS，4  
  6.  VBAR_B_CAPTURER_SENSOR_TYPE_SC230AI，5  
  7.  VBAR_B_CAPTURER_SENSOR_TYPE_SC201CS，6
- UNKNOWN 标识除以上 6 中之外的所有 sensor，上述表格中的参数默认值均为字段 `ST` = `VBAR_B_CAPTURER_SENSOR_TYPE_UNKNOWN` 时
- 下面表格为 sensor 类型对应参数默认值的对照表。仅为 `A1` ~ `J1` 字段，剩余字段均与上表相同

| 字段名 | SC031GS | OV7251 | OV7725 | SC132GS | SC230AI | SC201CS |
| :----: | :-----: | :----: | :----: | :-----: | :-----: | :-----: |
| A1 | 0 | 0 | 0 | 0 | 0 | 0 |
| B1 | 2 | 2 | 2 | 2 | 2 | 2 |
| C1 | 100 | 100 | 100 | 100 | 100 | 100 |
| D1 | 90 | 90 | 90 | 90 | 90 | 90 |
| E1 | 32 | 32 | 32 | 32 | 32 | 32 |
| F1 | 1700 | 1700 | 1700 | 1700 | 1700 | 1700 |
| G1 | 400 | 400 | 400 | 400 | 400 | 400 |
| H1 | 256 | 256 | 256 | 256 | 256 | 256 |
| I1 | 32 | 32 | 32 | 32 | 32 | 32 |
| J1 | 150 | 150 | 150 | 150 | 150 | 150 |
| K1 | 64 | 64 | 64 | 64 | 64 | 64 |
- 概念补充：
 1. 曝光（Exposure）：指摄像机感光元件（例如传感器）感光时间的长短，通常用来控制摄像头的拍摄亮度。 增大曝光时间可以使得影像更亮，但过度曝光会造成色彩饱和度下降，丢失细节等问题；
 2. 增益（Gain）：指在放大图像信号的过程中，调整的放大倍数。增加增益可提高图像亮度，降低增益可减少噪声，但同时也带来了图像的粗糙度和信噪比下降等问题；
 3. 图像目标亮度（Target luminance）：是一个目标光强值，通常用于ISP算法自动调节曝光和增益，以达到一个最终理想的画面质量。 当目标亮度值调得太低，会导致细节丧失，画面灰暗； 当目标亮度值调得太高，会导致图像曝光过度，细节丢失。
---

## 8. [网络配置](#title_back)
    该模块的配置为网络模块相关配置
- 配置字段详情如下

| 字段名 | 类型 | 长度 | 外部可见性 | 外部读写性 | 功能描述 | 默认值 | 补充说明 |
| :--------------------: | :-----: | :--: | :--------: | :--------: | :------------------: | :-----------------: | :----------------------------------------------------------- |
| net_type | int | 4 | √ | RW | 网络类型 | 1 | 该字段标识了当前的网络类型，其有效值分别有以下几种: &nbsp;&nbsp;&nbsp;&nbsp;1. VBAR_M_NET_TYPE_NONE = 0x00 &nbsp;&nbsp;&nbsp;&nbsp;2. VBAR_M_NET_TYPE_ETH = 0x01 &nbsp;&nbsp;&nbsp;&nbsp;3. VBAR_M_NET_TYPE_WIFI = 0x02 &nbsp;&nbsp;&nbsp;&nbsp;4. VBAR_M_NET_TYPE_MODEM = 0x04 |
| ip_mode | int | 4 | √ | RW | IP 获取模式 | 0 | 该字段标识了当前的 IP 获取类型，其有效值分别有以下几种: &nbsp;&nbsp;&nbsp;&nbsp;0: 自动获取 &nbsp;&nbsp;&nbsp;&nbsp;1: 静态 IP |
| ==net_consum== | int | 4 | √ | RW | net consum | 0 | 该字段仅有配置逻辑，无使用逻辑 |
| ==net_consum_outtime== | int | 4 | √ | RW | net consum outtime | 10 | 该字段仅有配置逻辑，无使用逻辑 |
| ping | int | 4 | ==√== | RW | 是否启用ping测试 | 0 | 0：关闭ping网络测试 1：开启ping网络测试 |
| ping_ip | str[20] | 19 | ==√== | RW | ping命令的目标IP地址 | 8.8.8.8 | 需要测试时改为对应 IP 地址 |
| ssid | str[32] | 31 | √ | RW | wifi 名称 | "Vguang_JS" | <div style="text-align: center;">---</div> |
| psk | str[64] | 63 | √ | RW | wifi 密码 | "vguangjs_o0" | <div style="text-align: center;">---</div> |
| ip | str[20] | 19 | √ | RW | 静态 IP | "0.0.0.0" | <div style="text-align: center;">配置 IP 获取为静态 IP 时生效</div> |
| mask | str[20] | 19 | √ | RW | 静态子网掩码 | "0.0.0.0" | <div style="text-align: center;">配置 IP 获取为静态 IP 时生效</div> |
| gateway | str[20] | 19 | √ | RW | 静态网关 | "0.0.0.0" | <div style="text-align: center;">配置 IP 获取为静态 IP 时生效</div> |
| dns | str[20] | 19 | √ | RW | 静态 DND | "0.0.0.0" | <div style="text-align: center;">配置 IP 获取为静态 IP 时生效</div> |
| fixed_macaddr_enable | int | 4 | √ | RW | mac模式 | 1 | 该字段标识了当前的 MAC 获取类型，其有效值分别有以下几种: &nbsp;&nbsp;&nbsp;&nbsp;0: 设备默认（硬件mac地址） &nbsp;&nbsp;&nbsp;&nbsp;1: 固定 MAC（chip_id） &nbsp;&nbsp;&nbsp;&nbsp;2: 自定义 MAC(自定义值取决于配置字段 macaddr) |
| macaddr | str[32] | 31 | √ | RW | mac 地址 | "00:00:00:00:00:00" | <div style="text-align: center;">配置 MAC 获取为自定义 MAC 时生效</div> |
| user | str[32] | 31 | √ | RW | 4G 用户名 | 无 | 暂无描述 |
| password | str[64] | 63 | √ | RW | 4G 密码 | 无 | 暂无描述 |
| apn | str[20] | 19 | √ | RW | 4G APN | 无 | 暂无描述 |
---

## 9. [NFC 配置](#title_back)
    该模块的配置为 NFC 模块相关配置
- 配置字段详情如下

| 字段名 | 类型 | 长度 | 外部可见性 | 外部读写性 | 功能描述 | 默认值 | 补充说明 |
| :----------------------: | :-----: | :--: | :--------: | :--------: | :-------------------------------: | :------------: | :----------------------------------------------------------- |
| nfc | int | 1 | √ | RW | nfc 开关 | 1 | 该字段标识了当前的 NFC 工作状态，其有效值分别有以下几种: &nbsp;&nbsp;&nbsp;&nbsp;0: 使能 NFC &nbsp;&nbsp;&nbsp;&nbsp;1: 禁用 NFC |
| nfc_work_mode | int | 4 | √ | RW | nfc 工作模式 | 1 | 该字段标识了当前的 NFC 工作模式，其有效值分别有以下几种: &nbsp;&nbsp;&nbsp;&nbsp;0: 用户交互模式 （一旦识别到卡，接下来一定会有用户交互） &nbsp;&nbsp;&nbsp;&nbsp;1: 主动模式 |
| ==nfc_14443p4_enable== | int | 1 | √ | RW | 是否使能 NFC 支持 ISO14443-4 协议 | 0 | 该字段仅有配置逻辑，无配置后使用逻辑 |
| ==nfc_afi== | int | 1 | √ | RW | 应用族识别符，应用的卡预选准则 | 0 | AFI 为 0x00： 表示不使用 AFI 进行过滤，所有卡片都应响应请求。 该字段仅有配置逻辑，无配置后使用逻辑[点此跳转](#afi_explain) |
| ==nfc_afi_enable== | int | 1 | √ | RW | 应用族识别开关 | 0 | 是否开启AFI 进行过滤 该字段仅有配置逻辑，无配置后使用逻辑 |
| nfc_identity_card_enable | int | 1 | √ | RW | 配置是否读取身份证物理卡号 | 1 | 该字段标识了当前的 NFC 是否读取身份证物理卡号，其有效值分别有以下几种: &nbsp;&nbsp;&nbsp;&nbsp;0: 禁用 NFC 读取身份证物理卡号 &nbsp;&nbsp;&nbsp;&nbsp;1: 使能 NFC 读取身份证物理卡号 3: 云证在线读取身份证 |
| ==nfc_card_braud_tx== | int | 1 | √ | RW | nfc 发送波特率 | 1 | 猜测！！！NFC 波特率有 106 kbps、212 kbps 和 424kbps 三种该字段仅有配置逻辑，无配置后使用逻辑 |
| ==nfc_card_braud_rx== | int | 1 | √ | RW | nfc 接收波特率 | 1 | 该字段仅有配置逻辑，无配置后使用逻辑 |
| ==nfc_f_braud== | int | 1 | √ | RW | RFID 位传输速率 | 8 | 该字段仅有配置逻辑，无配置后使用逻辑 |
| ==nfc_f_scode== | int | 2 | √ | RW | -- | 65535 |  syscode是FeliCa协议中的系统代码 该字段仅有配置逻辑，无配置后使用逻辑 |
| ==nfc_f_reqcode== | int | 1 | √ | RW | -- | 0 | FeliCa协议中的请求代码 该字段仅有配置逻辑，无配置后使用逻辑 |
| ==nfc_card_protocol== | int | 4 | √ | RW | 使能的卡协议 | 1 | 该字段标识了当前的 NFC 支持的协议，该字段为 flag 标志位，其有效 bit 位有以下几个: &nbsp;&nbsp;&nbsp;&nbsp;bit0: ISO14443-A 106kbps &nbsp;&nbsp;&nbsp;&nbsp;bit1: ISO14443-B 106kbps &nbsp;&nbsp;&nbsp;&nbsp;bit3: ISO15693 该字段仅有配置逻辑，无配置后使用逻辑 |
| ==nfc_timeout_ms== | int | 4 | √ | RW | 读卡超时时间 | 200 | <div style="text-align: center;">当前 NFC 读取卡数据的超时时间，单位为`毫秒（ms）`</div> 该字段仅有配置逻辑，无配置后使用逻辑 |
| ==nfc_m1_sec0_key== | str[17] | 16 | √ | RW | m1卡0扇区密钥 | "ffffffffffff" | 该字段仅有配置逻辑，无配置后使用逻辑 |
| ==nfc_m1_blk0s== | str[16] | 15 | √ | RW | -- | "" | 猜测是一个数组，用来向虚拟m1卡block0写数据 该字段仅有配置逻辑，无配置后使用逻辑 |
| ==check_m1== | int | 1 | √ | RW | -- | 0 | 检测虚拟m1卡 该字段仅有配置逻辑，无配置后使用逻辑 |
| ==nfc_sak28== | int | 1 | √ | RW | -- | 0 |  cpu卡和m1卡二合一. 0: 默认当作m1卡, 1:当作cpu卡 该字段仅有配置逻辑，无配置后使用逻辑 |
| sector_switch | int | 1 | √ | RW | 刷卡上报模式 | 0 | 0: 上报卡号 1: 固定扇区 2: 一卡一密 3：开启psam模式 |
| key_type | int | 1 | √ | RW | 密钥类型 | 96 | 0x60->KEY A 0x61->KEY B 该字段用于 sector_switch 为 1或 2 时 |
| blk_num | int | 1 | √ | RW | 块号 | 8 | 0 ~ 0xFF 该字段用于 sector_switch 为 1或 2 时 |
| nfc_card_gain | int | 1 | × | RW | 配置接收器增益 | 88 | 软件层面对刷卡信号强度的寄存器设置[点此跳转](#nfc_card_gain) |
| nfc_N_stength_output | int | 1 | × | RW | 输出 N 驱动器的电导 | 15 | 调节输出功率以及后面的消耗电流和工作距离[点此跳转](#nfc_N_stength_output) |
| nfc_N_stength_timer | int | 1 | × | RW | 输出 N 驱动器的电导 | 8 | 便于时间的调制, 它可用来调节调制系数[点此跳转](#nfc_N_stength_timer) |
| nfc_P_stength_output | int | 1 | × | RW | 输出 P 驱动器的电导 | 63 | 调节输出功率以及后面的消耗电流和工作距离[点此跳转](#nfc_P_stength_output) |
| nfc_P_stength_timer | int | 1 | × | RW | 输出 P 驱动器的电导 | 32 | 便于时间的调制, 它可用来调节调制系数[点此跳转](#nfc_P_stength_timer) |
| keycpt | str[32] | 31 | ==√== | RW | 密钥加密 | "D5932817FABD" | 该字段用于 sector_switch 为 2 时，生成对应卡的密钥读取数据 |
| keya | str[32] | 31 | ==√== | RW | A密钥 | "ffffffffffff" | 扇区尾块的密钥A |
| keyb | str[32] | 31 | ==√== | RW | B密钥 | "ffffffffffff" | 扇区尾块的密钥B |
| nfc_version | str[64] | 63 | √ | RW | nfc 版本 | "" | <div style="text-align: center;">当前 NFC 版本</div> |

1.[nfc_afi](#afi_explain_back)

- ISO/IEC 14443 Type B 是一种非接触式智能卡通信协议。在该协议的请求命令（如 REQB 或 WUPB）中，AFI 被用作过滤条件，用于选择特定类型的卡片。
- AFI 为非零值，只有那些支持指定 AFI 的卡片才会响应请求，使用时需要参考具体的通信协议。
- 默认为 0 ，即不使用 AFI 进行过滤，所有卡片都应响应请求。

2.[nfc_card_gain](#nfc_card_gain_back)

- 对于 mh1608、ws1850s 两款刷卡芯片有效，可调整刷卡的信号强度，具体请参考对应的芯片手册，对应RFCfgReg寄存器
- 可配置的值有：8（0000 1000即18dB）、24（0001 1000即23dB）、40（0010 1000即28dB）、56（0011 1000即23dB）、72（0100 1000即33dB）、88（0101 1000即38dB）、104（0110 1000即43dB）、120（0111 1000即48dB）
- 默认为88 ，即38dB。

3.[nfc_N_stength_output](#nfc_N_stength_output_back)

- 对于 mh1608、ws1850s 两款刷卡芯片有效，可调整刷卡的信号强度，具体请参考对应的芯片手册，对应 GsNReg 寄存器的 4-7 bit 位，调节输出功率以及后面的消耗电流和工作距离。
- 最大值为 0xF ，0 ~ 15。
- 默认为15 。

4.[nfc_N_stength_timer](#nfc_N_stength_timer_back)

- 对于 mh1608、ws1850s 两款刷卡芯片有效，可调整刷卡的信号强度，具体请参考对应的芯片手册，对应 GsNReg 寄存器的 0-3 bit 位，调节输出功率以及后面的消耗电流和工作距离。与 nfc_N_stength_output 共同组成 GsNReg 寄存器的 8 个 bit 位。
- 最大值为 0xF ，0 ~15。
- 默认为8 。

5.[nfc_P_stength_output](#nfc_P_stength_output_back)

- 对于 mh1608、ws1850s 两款刷卡芯片有效，可调整刷卡信号强度，具体请参考对应的芯片手册，对应 CWGsPReg 寄存器（8 bit）
- 默认为 63 。

6.[nfc_P_stength_timer](#nfc_P_stength_timer_back)

- 对于 mh1608、ws1850s 两款刷卡芯片有效，可调整刷卡信号强度，具体请参考对应的芯片手册，对应 ModGsReg 寄存器（8 bit）
- 默认为 32 。

---

## 10. [NTP 配置](#title_back)
    该模块的配置为 NTP 模块相关配置
- 配置字段详情如下

| 字段名 | 类型 | 外部可见性 | 外部读写性 | 功能描述 | 默认值 | 补充说明 |
| :----------: | :--: | :--------: | :--------: | :----------------: | :----------: | :----------------------------------------------------------- |
| ntp_en | char | √ | RW | 使能/禁用 NTP 服务 | 0 | 该字段位 NTP 服务`启用/禁用`控制字段，其有效值分别有以下几种: &nbsp;&nbsp;&nbsp;&nbsp;0: 禁用 NTP 服务 &nbsp;&nbsp;&nbsp;&nbsp;1: 启用 NTP 服务，ntp按照固定间隔时间同步 2: ntp每24小时按照固定时间同步 |
| ntp_addr | str | √ | RW | ntp服务器地址 | 182.92.12.11 | <div style="text-align: center;">---</div> |
| ntp_port | int | √ | RW | ntp服务器端口 | 123 | <div style="text-align: center;">---</div> |
| ntp_timeout | int | √ | RW | ntp同步超时时间 | 5 | <div style="text-align: center;">单位为`秒（s）`</div> |
| ntp_interval | int | √ | RW | ntp同步间隔 | 43200 | <div style="text-align: center;">单位为`秒（s）`</div> |
| ntp_hour | char | √ | RW | ntp 固定时间同步 | 23 | <div style="text-align: center;">定时同步，23 即为每天 23：00 自动同步时间</div>范围0 ~ 23 |

## 11. [OUTPUT 配置](#title_back)
    该模块的配置为 OUTPUT 模块相关配置
- 配置字段详情如下

| 字段名 | 类型 | 长度 | 外部可见性 | 外部读写性 | 功能描述 | 默认值 | 补充说明 |
| :--------------: | :------: | :--: | :--------: | :--------: | :-------------------------------------: | :---------------------------------------------------------: | :----------------------------------------------------------- |
| `通用配置` | -------- | --- | ---------- | ---------- | ---------- | ---------- | --------- |
| w_mode | int | 4 | √ | RW | 设备工作模式 | 1 | [点此跳转](#w_mode) |
| owifi | int | 4 | √ | RW | wifi 或者以太网输出端口选择 | 1 | [点此跳转](#owifi) |
| ~~eth~~ | ~~int~~ | | ~~√~~ | ~~RW~~ | ~~有线网络输出端口选择~~ | ~~1~~ | ~~ [点此跳转](#eth)~~（已弃用） |
| wifipra | str[301] | 300 | √ | RW | 网络协议参数 | "" | <div style="text-align: center;">即 网络协议中，字段 otherparams 的值</div> |
| ~~vg~~ | ~~int~~ | | ~~√~~ | ~~RW~~ | ~~韦根输出端口选择~~ | ~~1~~ | ~~该字段标识了当前韦根输出端口，其有效值分别有以下几种: &nbsp;&nbsp;&nbsp;&nbsp;1: 以`韦根26`输出数据 &nbsp;&nbsp;&nbsp;&nbsp;2: 以`韦根34`输出数据~~（已弃用） |
| index_485 | int | 4 | √ | RW | 485/232 通道下标 | 1 | 当 ochannel 选择是 485（232）后，进一步通过该字段选择走 485（232）的哪一个通道 [点此跳转](#index_485) |
| index_ttl | int | 4 | √ | RW | ttl 通道下标 | 1 | 当 ochannel 选择是 ttl 后，进一步通过该字段选择走 ttl 的哪一个通道，与 index_485 用法一致[点此跳转](#index_485) |
| index_wiegand | int | 4 | √ | RW | wiegand 通道下标 | 1 | 当 ochannel 选择是 wiegand 后，进一步通过该字段选择走 wiegand 的哪一个通道，与 index_485 用法一致[点此跳转](#index_485) |
| heart_en | int | 1 | √ | RW | 心跳开关 | 1 | 控制网络心跳起停，定义如下： 1：启用 0：禁用 此字段控制的是所有心跳，目前只有网络有心跳 |
| heart_time | int | 4 | √ | RW | 心跳 发送时间 | 60 | 设置网络心跳间隔时间，单位`秒(s)`，仅在 `heart_en=1` 时生效 |
| heart_data | str[512] | 511 | √ | RW | 心跳数据 | "www.vguang.cn" | 设置网络心跳数据，仅在 `heart_en=1` 时生效 |
| `云证配置` | -------- | | ---------- | ---------- | ---------- | ---------- | --------- |
| nfc_otag | int | 4 | √ | RW | 配置云证选择输出身份证信息 | 0 | [点此跳转](#nfc_otag) |
| online_id_format | int | 4 | √ | RW | 配置身份证信息输出格式 | 1 | 该字段标识了当前身份证信息输出格式，其有效值分别有以下几种: &nbsp;&nbsp;&nbsp;&nbsp;1: OL_ID_ASCII -- 以 ASCII 格式输出身份证信息 &nbsp;&nbsp;&nbsp;&nbsp;2: OL_ID_JSON -- 以 JSON 格式输出身份证信息 &nbsp;&nbsp;&nbsp;&nbsp;3: OL_ID_TLV -- 以 TLV 格式输出身份证信息(3.1代码中处理逻辑与 1 相同) |
| `扫码配置` | -------- | | ---------- | ---------- | ---------- | ---------- | --------- |
| ochannel | int | 4 | √ | RW | 普通模式输出端口 | 1 | [点此跳转](#ochannel) |
| dchannel | int | 4 | √ | RW | 二次开发模式和升级模式输出端口 | 1 | [点此跳转](#dchannel) |
| chorc | int | 4 | √ | RW | 二维码前后缀格式 | 1 | 该字段标识了当前二维码数据的输出格式，其有效值分别有以下几种: &nbsp;&nbsp;&nbsp;&nbsp;1: APP_OUTPUT_SYMBOL_FIX_FORMAT_STRING -- 以字符串格式输出二维码数据 &nbsp;&nbsp;&nbsp;&nbsp;2: APP_OUTPUT_SYMBOL_FIX_FORMAT_HEX -- 以十六进制格式输出二维码数据 |
| prefix | str[301] | 300 | √ | RW | 二维码输出前缀 | "" | 字段值为二维码输出的前缀，最大长度为300字节 |
| postfix | str[301] | 300 | √ | RW | 二维码输出后缀 | "" | 字段值为二维码输出的后缀，最大长度为300字节 |
| ft | int | 4 | √ | RW | 二维码数据输出格式 | 0 | [点此跳转](#ft) |
| nl | int | 4 | √ | RW | 输出二维码是否添加回车 | 0 | 该字段配置输出的二维码数据是否添加回车，其有效值分别有以下几种: &nbsp;&nbsp;&nbsp;&nbsp;0: 输出的二维码数据不添加回车 &nbsp;&nbsp;&nbsp;&nbsp;1: 输出的二维码数据添加回车 |
| cr | int | 4 | √ | RW | 输出二维码是否添加换行 | 0 | 该字段配置输出的二维码数据是否添加换行，其有效值分别有以下几种: &nbsp;&nbsp;&nbsp;&nbsp;0: 输出的二维码数据不添加换行 &nbsp;&nbsp;&nbsp;&nbsp;1: 输出的二维码数据添加换行 |
| `刷卡配置` | -------- | | ---------- | ---------- | ---------- | ---------- | --------- |
| nochannel | int | 4 | √ | RW | 普通模式下nfc数据输出端口选择 | 1 | [同扫码配置 ochannel 字段，点此跳转](#ochannel) |
| ndchannel | int | 4 | √ | RW | 开发模式下nfc数据输出端口选择 | 1 | [同扫码配置 dchannel 字段，点此跳转](#dchannel) |
| ord | int | 4 | √ | RW | 配置NFC数据顺序为正序/反序 | 1 | 该字段配置输出的NFC数据为正序或者反序，其有效值分别有以下几种: &nbsp;&nbsp;&nbsp;&nbsp;0: 输出的NFC数据为正序 &nbsp;&nbsp;&nbsp;&nbsp;1: 输出的NFC数据为反序 |
| idord | int | 4 | √ | RW | 身份证数据端序 | 1 | 该字段配置输出的身份证数据为正序或者反序，其有效值分别有以下几种: &nbsp;&nbsp;&nbsp;&nbsp;1: 输出的NFC数据为正序 &nbsp;&nbsp;&nbsp;&nbsp;0: 输出的NFC数据为反序  |
| st | int | 4 | √ | RW | NFC输出数据起始位 | 1 | 该值范围为 `1` ~ `8` |
| len | int | 4 | √ | RW | NFC输出数据长度 | 8 | 该值范围为 `1` ~ `8` |
| nft_add_zero | int | 4 | √ | RW | 配置是否补全数据到10位（unit_test字段） | 1 | 该字段配置输出的 NFC 数据为是否用0补全至10位，其有效值分别有以下几种: &nbsp;&nbsp;&nbsp;&nbsp;1: 补全数据至10位 &nbsp;&nbsp;&nbsp;&nbsp;0：不补全 eg: 数据为0x42 &nbsp;&nbsp;&nbsp;&nbsp;如果配置为1，输出数据为：00 00 00 00 00 00 00 00 00 42 &nbsp;&nbsp;&nbsp;&nbsp;如果配置为0，输出数据为：42  |
| nft | int | 4 | √ | RW | 配置nfc数据输出格式（unit_test字段） | 2 | 该字段配置输出的 NFC 数据输出格式，其有效值分别有以下几种: &nbsp;&nbsp;&nbsp;&nbsp;1: 原始二进制字符转换成16进制格式的字符 ：0x86 --> 0x3836 &nbsp;&nbsp;&nbsp;&nbsp;2：原始二进制字符转换成10进制格式的字符 ：0x12233846 --> 0x333034323938303534 &nbsp;&nbsp;&nbsp;&nbsp;4：在韦根26下输出低3个字节 |
| horc | int | 4 | √ | RW | 配置nfc的前后缀格式 | 1 | 该字段标识了当前NFC数据前后缀的输出格式，其有效值分别有以下几种: &nbsp;&nbsp;&nbsp;&nbsp;0: APP_OUTPUT_NFC_FIX_FORMAT_STRING -- 以字符串格式输出NFC数据前后缀 &nbsp;&nbsp;&nbsp;&nbsp;1: APP_OUTPUT_NFC_FIX_FORMAT_HEX -- 以十六进制格式输出NFC数据前后缀 |
| pri | str[301] | 300 | √ | RW | NFC数据前缀 | "" | 字段值为 NFC 输出数据的前缀，最大长度为300字节 |
| pos | str[301] | 300 | √ | RW | NFC数据后缀 | "" | 字段值为 NFC 输出数据的后缀，最大长度为300字节 |
| nnl | int | 4 | √ | RW | 输出的 NFC 数据是否添加回车 | 0 | 该字段配置输出的 NFC 数据是否添加回车，其有效值分别有以下几种: &nbsp;&nbsp;&nbsp;&nbsp;0: 输出的 NFC 数据不添加回车 &nbsp;&nbsp;&nbsp;&nbsp;1: 输出的 NFC 数据添加回车 |
| ncr | int | 4 | √ | RW | 输出的 NFC 数据是否添加换行 | 0 | 该字段配置输出的 NFC 数据是否添加换行，其有效值分别有以下几种: &nbsp;&nbsp;&nbsp;&nbsp;0: 输出的 NFC 数据不添加换行 &nbsp;&nbsp;&nbsp;&nbsp;1: 输出的 NFC 数据添加换行 |
| `蓝牙配置` | -------- | | ---------- | ---------- | ---------- | ---------- | --------- |
| blochannel | int | 4 | √ | RW | | |  |
| bldchannel | int | 4 | √ | RW | | |  |
| blhorc | int | 4 | √ | RW | | |  |
| blpri | str[301] | 300 | √ | RW | | |  |
| blpos | str[301] | 300 | √ | RW | | |  |
| blft | int | 4 | √ | RW | | |  |
| blnl | int | 4 | √ | RW | | |  |
| blcr | int | 4 | √ | RW | | |  |
| `指纹配置` | -- | | -- | -- | -- | -- | -- |
| frochannel | int | 4 | √ | RW | 普通输出通道 | 1 | [同 ochannel 字段，点此跳转](#ochannel) |
| frdchannel | int | 4 | √ | RW | 开发协议输出通道 | 1 | [同 dchannel 字段，点此跳转](#dchannel) |
| frhorc | int | 4 | √ | RW | 前后缀格式 | 1：以字符串格式输出数据 2：以十六进制格式输出二维码数据 | |
| frpri | str[301] | 300 | √ | RW | 前缀（字符串） | | |
| frpos | str[301] | 300 | √ | RW | 后缀（字符串） | | |
| frft | int | 4 | √ | RW | 输出数据格式 | 0：原始数据（810字节十六进制字节） 1：转16进制字符串 | |
| frnl | int | 4 | √ | RW | 加回车 | | |
| frcr | int | 4 | √ | RW | 加换行 | | |

1.[w_mode](#w_mode_back)
- 该字段配置设备的工作模式，默认为普通模式，下面为该字段的有效值及说明：
  1.  WORK_MODE_NORMAL     = CFGBIT(0)  = `1`,         设备处于`普通模式`
  2.  WORK_MODE_PROTOCOL   = CFGBIT(1)  = `2`,         设备处于`开发模式`
  3.  WORK_MODE_TOOL       = CFGBIT(2)  = `4`,         设备处于`工具模式`
  4.  WORK_MODE_CALL       = CFGBIT(4)  = `16`,        设备处于`拷机模式`
  5.  WORK_MODE_UPDATE     = CFGBIT(5)  = `32`,        设备处于`升级模式`
  6.  WORK_MODE_SENS       = CFGBIT(6)  = `64`,        设备处于`感应模式`
  7.  WORK_MODE_PAY        = CFGBIT(7)  = `128`,       设备处于`支付模式`
  8.  WORK_MODE_SCAN       = CFGBIT(8)  = `256`,       设备处于`扫码枪模式`
  9.  WORK_MODE_RESTART    = CFGBIT(9)  = `512`,       设备处于`开关机模式`
  10. WORK_MODE_ACCESS_CTL = CFGBIT(10) = `1024`,      设备处于`访客模式`
  11. WORK_MODE_FACTORY    = CFGBIT(28) = `268435456`, 设备处于`工厂模式`
- 设备同一时间只能处于一种工作模式下，不可同时将多个bit位置1

2.[owifi](#owifi_back)
- 该字段配置设备的wifi或者以太网的输出模式，下面为该字段的有效值及说明：
  1. OUTPUT_OWIFI_HTTP     = CFGBIT(0) | CFGBIT(4), = `17`， wifi的输出模式为同时处于 `普通HTTP`，`普通HTTPS` 模式
  2. OUTPUT_OWIFI_HTTP_PRO = CFGBIT(1) | CFGBIT(5), = `34`， wifi的输出模式为同时处于 `协议HTTP`，`协议HTTPS` 模式
  3. OUTPUT_OWIFI_TCP      = CFGBIT(2),             = `4`，  wifi的输出模式为 `普通TCP` 模式
  4. OUTPUT_OWIFI_TCP_PRO  = CFGBIT(3),             = `8`，  wifi的输出模式为 `协议TCP` 模式
  5. OUTPUT_OWIFI_HTTPS    = CFGBIT(4),             = `16`， wifi的输出模式为 `普通HTTPS` 模式
  6. OUTPUT_OWIFI_HTTPS_PRO= CFGBIT(5),             = `32`， wifi的输出模式为 `协议HTTPS` 模式
- 该字段默认值为 `1`，即仅处于普通http模式下

~~3.[eth](#eth_back)~~~~~~（已弃用）

- ~~该字段配置设备的有线网络的输出模式，下面为该字段的有效值及说明：~~
  1. ~~OUTPUT_TTL2NET_TCP      = CFGBIT(0) = `1`， 有线网络的输出模式为 `普通TCP` 模式~~
  2. ~~OUTPUT_TTL2NET_TCP_PRO  = CFGBIT(1) = `2`， 有线网络的输出模式为 `协议TCP` 模式~~
  3. ~~OUTPUT_TTL2NET_HTTP     = CFGBIT(2) = `4`， 有线网络的输出模式为 `普通HTTP` 模式~~
  4. ~~OUTPUT_TTL2NET_HTTP_PRO = CFGBIT(3) = `8`， 有线网络的输出模式为 `协议HTTP` 模式~~
  5. ~~OUTPUT_TTL2NET_UDP      = CFGBIT(4) = `16`，有线网络的输出模式为 `普通UDP` 模式~~
- ~~该字段默认值为 `1`，即仅处于普通 TCP 模式下~~

4.[nfc_otag](#nfc_otag_back)

- 该字段配置云证输出身份证信息时输出的具体内容。该参数是一个 flag 标志位，其 bit 位定义如下：
  1.  bit0: 姓名               
  2.  bit1: 性别
  3.  bit2: 民族
  4.  bit3: 出生
  5.  bit4: 住址
  6.  bit5: 公民身份号码
  7.  bit6: 签发机关
  8.  bit7: 有效期起始日期
  9.  bit8: 有效期截止日期
  10. bit9: base64格式的照片数据
- 该字段上述 bit 位置`1`启用对应输出，置`0`禁用
- 该字段默认值为 `0`，即输出身份证信息所有信息

5.[ochannel](#ochannel_back)
- 该字段配置扫码器处于普通模式下的输出信道。该参数的bit位定义如下：
 1. bit0: CHANNEL_`USBKBW ` = (0x01 << 0) = `1`
 2. bit1: CHANNEL_`RS485 ` = (0x01 << 1) = `2`
 3. bit2: CHANNEL_`TTL ` = (0x01 << 2) = `4`
 4. bit3: CHANNEL_`WIFI ` = (0x01 << 3) = `8`
 5. bit4: CHANNEL_`WIEGAND ` = (0x01 << 4) = `16`
 6. bit5: CHANNEL_`TTL2NET ` = (0x01 << 5) = `32`
 7. bit6: CHANNEL_`ETH ` = (0x01 << 6) = `64`
 8. bit7: CHANNEL_`USB_VUART` = (0x01 << 7) = `128`
 9. bit8: CHANNEL_`USBHID ` = (0x01 << 8) = `256`
 10. bit9: CHANNEL_`4G ` = (0x01 << 9) = `512`
 11. bit11: CHANNEL_`BLE ` = (0x01 << 11) = `2048` 
- 将该字段的信道对应 bit 置 1 即可使能普通模式下该通道的数据输出，置 0 禁用该通道输出、
- 字段默认值为 1 ，即默认配置普通模式输出通道为 `USBKBW`

6.[dchannel](#dchannel_back)
- 该字段配置扫码器处于开发模式下的输出模式。该参数的bit位定义如下：
 1. DEVELOP_CHANNEL_`VRPC_USBHID ` = (0x01 << 0) = `1`
 2. DEVELOP_CHANNEL_`VRPC_RS485 ` = (0x01 << 1) = `2`
 3. DEVELOP_CHANNEL_`VRPC_TTL ` = (0x01 << 2) = `4`
 4. DEVELOP_CHANNEL_`PRO_RS485 ` = (0x01 << 3) = `8`
 5. DEVELOP_CHANNEL_`PRO_TTL ` = (0x01 << 4) = `16`
 6. DEVELOP_CHANNEL_`PRO_MULT_RS485` = (0x01 << 5) = `32`
 7. DEVELOP_CHANNEL_`VGPRO ` = (0x01 << 6) = `64`
 8. DEVELOP_CHANNEL_`CUSTOMER ` = (0x01 << 7) = `128`
 9. DEVELOP_CHANNEL_`HTTPPRO ` = (0x01 << 8) = `256`
 10. DEVELOP_CHANNEL_`VRPC_OR_VGPRO ` = (0x01 << 0) | (0x01 << 1) | (0x01 << 2) = `7`
- 将该字段的信道对应 bit 置 1 即可使能开发模式下该通道的数据输出，置 0 禁用该模式输出
- 字段默认值为 1 ，即默认配置开发模式输出为 USB 通道 VRPC 协议

7.[ft](#ft_back)

- 该字段配置扫码器处于开发模式下的输出模式。该参数的bit位定义如下：
 1. OUTPUT_SYM_FT_DEC_STR2HEX_BYTE = (0x01 << 0) = `1`
 2. OUTPUT_SYM_FT_DEC_STR2HEX_BYTE_REV = (0x01 << 1) = `2`
 3. OUTPUT_SYM_FT_HEX_STR2HEX_BYTE = (0x01 << 2) = `4`
 4. OUTPUT_SYM_FT_HEX_STR2HEX_BYTE_REV = (0x01 << 3) = `8`
 5. OUTPUT_SYM_FT_PIDVID_DECSTR2HEX_BYTE = (0x01 << 4) = `16`
 6. OUTPUT_SYM_FT_PIDVID_DECSTR2HEX_BYTE_REV = (0x01 << 5) = `32`
 7. OUTPUT_SYM_FT_PIDVID_DECSTR2HEX_LOW3_BYTE = (0x01 << 6) = `64`
- 该字段配置设备输出二维码数据的格式
- 字段默认值为 0 ，即二维码数据不进行任何个数转换，直接输出原数据

8.[index_485](#index_485_back)

- 该字段配置扫码器的输出通道下标。该参数的bit位定义如下：
  1. index_485 = CFGBIT(0) = 1，即数据输出通道为 1 通道
  2. index_485 = CFGBIT(1) = 2，即数据输出通道为 2 通道
  3. index_485 = CFGBIT(2) = 4，即数据输出通道为 3 通道
  4. index_485 = CFGBIT(3) = 8，即数据输出通道为 4 通道
  
- 注意：目前协议模式、普通模式都支持该字段的配置和控制

但在协议模式下该字段仅控制扫码、刷卡等数据上报时的通道选择

而设备的协议命令应答数据不受该字段的配置和控制

index_ttl、index_wiegand配置方法类似

- 字段默认值为 1 ，即为 1 通道
---

## 12. [PASSWORD 配置](#title_back)
    该模块的配置为 PASSWORD 模块相关配置
- 配置字段详情如下

|   字段名   |  类型   | 长度 | 外部可见性 | 外部读写性 | 功能描述 |       默认值       | 补充说明                 |
| :--------: | :-----: | :--: | :--------: | :--------: | :------: | :----------------: | :----------------------- |
| com_passwd | str[64] |  63  |     √      |     RW     | 管理密码 | "1234567887654321" | 用于对配置信息做安全管理 |
---

## 13. [VERSION 配置](#title_back)
    该模块的配置为 VERSIOB 模块相关配置
- 配置字段详情如下

| 字段名 | 类型 | 外部可见性 | 外部读写性 | 功能描述 | 默认值 | 补充说明 |
| :-----: | :---------------------------------------: | :--------: | :--------: | :--------------: | :----: | :----------------------------- |
| version | str | √ | RW | 设备的固件版本号 | "" | 在进行版本号检查时使用此版本号 |
---

## 14. [VG485 配置](#title_back)
    该模块的配置为 vg485 协议 模块相关配置
- 配置字段详情如下

|       字段名       |     类型      | 长度 | 外部可见性 | 外部读写性 |   功能描述   |      默认值      | 补充说明         |
| :----------------: | :-----------: | :--: | :--------: | :--------: | :----------: | :--------------: | :--------------- |
|     rs485_ver      |      int      |  4   |     √      |     RW     |   485版本    |        7         |                  |
|      rs485_sn      |    str[10]    |  9   |     √      |     RW     | 主设备 SN 号 |     abcdefgh     | 实际sn为8位      |
|      rs485_id      | unsigned char |  1   |     √      |     RW     |  主设备 id   |        1         | 从1开始，不能为0 |
|     rs485_key      |    str[20]    |  19  |     √      |     RW     |     密钥     | UnQkvNpXMq5yVy7D |                  |
|   rs485_timeout    |      int      |  4   |     √      |     RW     |   超时时间   |      864000      |                  |
| rs485_poll_timeout |      int      |  4   |     √      |     RW     |   轮询间隔   |        10        |                  |
---

## 15. [VGPRO 配置](#title_back)
    该模块的配置为 vg 通信协议 模块相关配置
- 配置字段详 情如下

| 字段名 | 类型 | 外部可见性 | 外部读写性 | 功能描述 | 默认值 | 补充说明 |
| :---------: | :--: | :--------: | :--------: | :-----------: | :----: | :-------------------------------------------: |
| head1 | int | √ | RW | vgpro head[0] | 0x55 | |
| head2 | int | √ | RW | vgpro head[1] | 0xAA | |
| auto_report | int | √ | RW | 数据上报方式 | 1 | [点此跳转](#auto_report) |

1.[auto_report](#auto_report_back)

- 该字段配置扫码器微光通信协议的数据上报模式。
  1. 0x81: 主动上报模式，扫描器使用 0x33 指令主动发送数据到上位机带有数据区分标志
  2. 0x01: 主动上报模式，扫描器使用 0x30 指令主动发送数据到上位机无数据区分标志
  3. 0x80: 命令模式，上位机发送 0x33 指令获取数据带有数据区分标志
  4. 0x00: 命令模式，上位机发送 0x30 指令获取数据无数据区分标志
- 字段默认值为 1 ，主动上报模式，扫描器使用 0x30 指令主动发送数据到上位机无数据区分标志

---

## 16. [按键 配置](#title_back)
		该模块的配置为 m20设备触摸按键 相关配置
- 配置字段详情如下

|     字段名      | 类型 | 外部可见性 | 外部读写性 |    功能描述    | 默认值 | 补充说明                         |
| :-------------: | :--: | :--------: | :--------: | :------------: | :----: | :------------------------------- |
|     tkey_en     | int  |     √      |     RW     |    按键开关    |   1    | 0关闭 1打开                      |
|  tkey_light_en  | int  |     √      |     RW     | 按键背光灯模式 |   1    | 按键背光灯模式 0常灭 1常亮 2休眠 |
| tkey_interval_s | int  |     √      |     RW     |  休眠时间间隔  |   60   | 单位 秒(s)                       |

| tkey_light_en值 | 功能 | 补充说明 |
| :-------------: | :--: | :----------------------------------------------------------- |
| 0 | 常灭 | 开机后背光灯熄灭，被按键亮灯500ms |
| 1 | 常亮 | 开机后背光灯亮起，被按键灭灯500ms |
| 2 | 休眠 | 开机后背光灯亮起，间隔时间（配置）内无键按下，熄灭背光灯 直接按一个键，背光灯亮起，被按键灭灯500ms 同时按下多个按键，点亮所有按键背光灯，不记录按键值 |

## 17. [PSAM 配置](#title_back)
		该模块的配置为 使用微光发卡协议的PSAM 相关配置
- 配置字段详情如下

| 字段名 | 类型 | 外部可见性 | 外部读写性 | 功能描述 | 默认值 | 补充说明 |
| :--------: | :--: | :--------: | :--------: | :----------------: | :----: | :------------------------ |
| sector_switch | int | √ | RW | 刷卡上报模式 | 0 | 0: 上报卡号 1: 固定扇区 2: 一卡一密 3：开启psam模式 |
| vg_psam_key | string | √ | W | psam卡的密码（默认psam密码是空，只有配置了此密码，才可使用）| “”“” | 这个配置密码是混淆后的密码|

## 18. [安全模块配置](#title_back)
    该模块的配置为安全模块相关配置
- 配置字段详情如下

| 字段名 | 类型 | 外部可见性 | 外部读写性 | 功能描述 | 默认值 | 补充说明 |
| :--------------: | :----: | :--------: | :--------: | :-----------------------: | :----------------------------------------------------------: | :----------------------------: |
| safe_open | int | √ | RW | 安全模块使能 | 0 | 0：关闭 1：打开 |
| safe_keytype | int | √ | RW | 安全模块所有密钥类型 | 1 | 1：AES 2：SM2 4：SM4 |
| safe_key_pub | string | √ | RW | 密钥或SM2的公钥 | 5de3dd7f5b7 25c7d27f360 19a2ddd94f3 866e0d383c9 3bd51780e93 8a2ddda4f | 暂无补充说明 |
| safe_iv_pri | string | √ | RW | 向量或SM2的私钥 | 39fe007b83c 92bd527f360 19a2ddd94f5 da3dd7f1780 e93828e3601 a1d8cb9f8 | 暂无补充说明 |
| old_safe_key_pub | string | √ | - | 上一次旧的密钥或SM2的公钥 | 5de3dd7f5b7 25c7d27f360 19a2ddd94f3 866e0d383c9 3bd51780e93 8a2ddda4f | 暂无补充说明 |
| old_safe_iv_pri | string | √ | - | 上一次旧的向量或SM2的私钥 | 39fe007b83c 92bd527f360 19a2ddd94f5 da3dd7f1780 e93828e3601 a1d8cb9f8 | 暂无补充说明 |

#

## 三、修改记录表

| | | | 修改表记录 | | |
| ------ | -------- | -------- | ------------------------------------------------------------ | ------ | -------- |
| 版本号 | 修改原因 | 修改类型 | 修改内容摘要 | 修改人 | 修改时间 |
| 1.0 | 更新文档 | | 1、修改错误描述 2、添加新字段的描述 3、删除无用字段 | 黄泽 | 2025/4/3 |
| | | | | | |
| | | | | | |
| | | | | | |