VISCA协议控制镜头（可见光相机）

接口为TTL（3.3V），波特率为9600bps;
通信协议采用VISCA，典型通信协议见下表。

x 默认1; y 默认9

变焦	8x 01 04 07 00 FF	T/W 停止
	8x 01 04 07 02 FF （变倍+）	默认前端设置的速度，变倍+ 焦距增大，变倍-焦距减小
	8x 01 04 07 03 FF （变倍-）	默认前端设置的速度，变倍+ 焦距增大，变倍-焦距减小
	8x 01 04 07 2p FF （变倍+） 8x 01 04 07 3p FF （变倍-）	T/W 操作；p=0 (Low) to 7 (High)，代表变焦速度自动变焦与手动变焦下p,q均为1。部分Tofu版本支持在客户端中调节变倍速度。
	8x 01 04 47 0p 0q 0r 0s FF	0xpqrs 变焦到指定坐标
	8x 01 04 06 02 FF （开） 8x 01 04 06 03 FF （关）	数字变倍开和关
调焦	8x 01 04 08 00 FF	N/F 停止
	8x 01 04 08 02 FF （聚焦+ ） 8x 01 04 08 03 FF （聚焦- ）	默认速度调焦，手动调焦用此协议。聚焦+聚焦近处，聚焦-聚焦远处。
	8x 01 04 38 02 FF （自动聚焦） 8x 01 04 38 03 FF （手动聚焦）	聚焦自动/手动模式
	8x 01 04 38 10 FF	聚焦自动模式/手动模式切换
	8x 01 04 18 01 FF	一次聚焦模式
镜头初始化	8x 01 04 19 01 FF	镜头初始化

查询指令：

命令	查询接口	查询回复包	说明
ZOOM 坐标查询	8x 09 04 47 FF	y0 50 0p 0q 0r 0s FF	pqrs: zoom 坐标，焦距越大数值越大

Pelco-D协议镜头控制（热红外相机）

如果使用Pelco-D方式控制镜头请使用TTL 3.3V接口，波特率9600。若使用RS485请将TTL接口转换为RS485电平。

指令如下：

命令	指令	说明
ZOOM查询	FF 02 00 55 00 00 57	02为ID号，57为合校验，自行更改热红外使用ID号为02
ZOOM回复	FF 02 00 5D pq rs sm	pq rs为返回镜头位置值，sm是除FF外的合校验，焦距越大数值越大
变倍+	FF 02 00 20 00 00 22	焦距增大，变倍+/-结束后应自动触发自动聚焦
变倍-	FF 02 00 40 00 00 42	焦距减小
聚焦+	FF 02 01 00 00 00 03	手动聚焦控制指令
聚焦-	FF 02 00 80 00 00 82	聚焦+为近处聚焦，聚焦-为远处聚焦。

可通过客户端相机透传接口发送上述指令，记录对应倍率下的数值，按照倍率表格式编写对应倍率表，通过TVMS软件倍率表导入功能导入对应的倍率表。

倍率表格式与导入方式

整机产品无需自行导入，出厂已导入标定后的倍率表。

若使用第三方相机或镜头，倍率查询需要提供一个倍率表，倍率表格式是". txt"，文件名请勿使用中文。

倍率表数据左侧为倍率值，为从1开始的整数倍数，右侧为对应的十六进制的数值，字母均使用大写，中间以“=”隔开，

每个倍率值占一行，格式请严格按照案例填写，数值应根据倍率值增大而增大。

如倍率为2倍时pqrs返回值对应0x0453，即填写 “2=0453”。

倍率表通过 TVMS软件导入到AI板卡中，导入时需选择对应的波段。选择文件后导入即可，如果倍率表格式无误会弹窗提示导入成功。若有提示错误请检查倍率表文件格式。

镜头倍率表案例，文件格式为 .txt 。

倍率表格式案例如下。

1=0000
2=1122
3=1D1E
4=2464
5=2988
6=2D7A
7=30B0
8=3365
9=35B7
10=37C3
11=398B
12=3B17
13=3C50
14=3D54
15=3DC9
16=3DF0
17=3E30
18=3E80
19=3EF0
20=3F72
21=3F90
22=3FAF
23=3FC2
24=3FE2
25=4000

倍率表自动生成

💡 可使用Deepseek R1深度思考模式直接导入厂家提供的Excel或者Word格式的倍率表文件，复制以下提示词进行自动生成。

标红色的部分请自行替换实际的倍数范围与列数。

生成后请务必检查是否有错误。

📃Prompt：

仅提取第一列中的1到25的正整数数值，每个数值对应第二列的十六进制数，如果没有对应的正整数，则通过上下行数值与同一行对应的十六进制数值做线性映射计算出正整数对应的十六进制数，
形成一个文本文档，每一行格式是”正整数=对应的十六进制数“，十六进制数都以4位数字表达，直接给出结果内容

第三方设备接入要求