# nfc

**Repository Path**: mqinglang/nfc

## Basic Information

- **Project Name**: nfc
- **Description**: 运行在相机上
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-26
- **Last Updated**: 2026-07-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# NetForCamera (nfc)

运行在大华摄像机嵌入式平台上的安防网络网关程序。摄像机同时充当"防区模块"，
程序把摄像机抓的图片、IO 报警状态、串口物联网小模块（485 传感器）数据，通过
自定义 TCP/UDP 协议桥接给报警主机和图片备份服务器。

## 通信通道

| 通道 | 角色 | 端口 | 说明 |
|---|---|---|---|
| TcpFoCamera | TCP 客户端 | 摄像机 6000 | 抓图命令、物联网板卡命令、接收报文 |
| TcpForAlarm | TCP 服务端 | 6902 | 报警主机接入，`IALARM:`+13 位长度帧协议 |
| TcpForAlarmImg | TCP 客户端 | 报警主机 6901 | IO 报警时主动上传报警图片（XML） |
| TcpForImgDev | TCP 客户端 | 图片服务器 6000 | 每 500ms 备份一张图片（可开关） |
| UdpForAlarm | UDP 组播 | 224.0.0.17:6905 | 设备发现（SearchDevice）应答 |

各通道通过 `GlobalData` 中的静态全局队列解耦，由定时器轮询搬运数据。

## Timer 单位（分支不同）

- `master`（V3 ARM）：使用官方 `toolkit::Timer(float second, ...)`，参数单位为秒。
  `Timer(0.5f)` = 500ms，`Timer(20.0f)` = 20 秒。
- `release/csky`（V2 C-SKY）：仍使用整数 0.1 秒实现，`Timer(5)` = 500ms，
  `Timer(200)` = 20 秒。

两个分支合并涉及 Timer 的改动时必须人工校对数值，不能直接照搬。

## 目录结构

```
src/ inc/        业务代码
3rd/ZLToolKit/   官方 ZLToolKit 快照（静态库，未做本地修改）
xml/             TinyXML 2.6.2（静态库，含 CVE-2021-42260 防死循环补丁）
cmake/toolchain/ V3 ARM 交叉编译工具链配置
docs/            版本迭代历史、交付包规范及修改原因
toolchain/        三代交叉工具链归档（压缩包不提交）
```

## 构建与打包

- V3 ARM Release：`./build_for_arm.sh`
- V3 ARM 正式集成包：`./package_for_arm.sh`
- Linux x86_64 Debug：`./build_host.sh`
- Windows x64 Release：`build_for_win.bat`（VS2019）
- V2 C-SKY：切换到 `release/csky` 分支后使用该分支的构建脚本

ARM 交付包输出到 `package_output/`，命名和包内内容见
[交付包命名与打包规范](docs/交付包命名与打包规范.md)。配置文件位于
`/mnt/mtd/Config/<exe>Config.ini`，首次运行自动生成。

## 分支与版本

- `master`：V3 ARM 新核心，当前程序版本 `3.0.0`
- `release/csky`：旧 csky 版维护线，只修 bug，修完 merge 回 master
- tag `v2024.12.25.1-csky`：V2 C-SKY 现场版本
- tag `v3.0.0`：V3 ARM 首个标准化交付版本

完整迭代原因与修改清单见 [docs/版本迭代历史.md](docs/版本迭代历史.md)。

## 文档维护要求

任何业务代码、构建系统、配置项、平台适配或发布流程变更，都必须在同一个提交中更新
`docs/版本迭代历史.md`，并同步修改 README 或对应专题文档。禁止先提交代码、后补文档。