1. 文档概述

本文档主要阐述了无锡力捷丰的OPTEEQ Sensor Module传感器多功能模块及OPTEEQ传感器工具（OPTEEQ Sensor Tool）与Allegro A31315-AR传感器芯片的使用指南。

目前传感器多功能模块支持的Allegro A31315-AR的芯片型号具体如下:

芯片厂家	芯片系列	芯片型号
Allegro	A31315-AR	A31315LOLATR-XZ-S-AR-10
		A31315LOLATR-XY-S-AR-10

表 11芯片型号

1.1. 配套说明

文档版本与算法版本相互配套，需同步匹配使用。本文档适配的算法版本关系如下：

文档版本	芯片算法版本
V2.4	A31315-AR 2.0

表 12版本配套

2. 传感器多功能模块S03

OPTEEQ Sensor Module，中文名称为传感器多功能模块（简称“传感器模块”），是无锡力捷丰科技有限公司推出的一款工业级、多通道的传感器多功能工具。它搭载了高性能处理器，支持多种接口连接，拥有丰富的芯片算法，适配多种测试设备，具有烧录速度快、稳定性高、适配性高、外形精巧方便的优点，可满足多种传感器芯片的标定、烧录、测试需求。

S03传感器模块为OPTEEQ Sensor Module的一个子型号，该产品采用直流电源供电方式，支持SICI、SENT、SPC、PWM、Biphase、MANCHESTER等协议，主要适用于传感器烧录标定场景。

传感器多功能模块具备的特点有：

• 四通道独立，可支持不同芯片同时进行烧录和标定。
• 100M/1000M自适应网口。
• 采用直流方式供电，接线方式灵活，安全可靠。
• 1GB大容量板载动态内存。
• 提供丰富的动态库，可供外部扩展，进行二次开发。
• 提供Labview、C#等DEMO。
• 外形精巧，可集成至多种生产设备中。

2.1. 产品结构

2.1.1. 外观及接口

传感器模块外观及接口如下图所示：

图 21外观及接口

接口名称	接口描述	功能描述
Output	信号输出接口	输出接口采用的是2.54间距的24PIN的牛角（MALE）插座。
Reset	IP地址复位键	在机器正常运行的情况下，按下IP复位按键（Reset）5秒以上，复位完成后重启模块，IP地址即可复位到出厂默认的IP地址192.168.0.100。
Extension	可扩展UART接口	可扩展UART接口采用JST的1.5mm间距的4 PIN连接器，型号为S4B-ZR-SM4A-TF。
Off/On	电源开关	控制整个设备的通断电。
Power/CH1/CH2/CH3/CH4/Stauts/User	设备指示灯	用于反馈设备信息及通道状态。相关信息可参考指示灯章节内容。
PWR	电源接口	连接电源接口（接口型号为PJ-002A）给设备提供DC 12V电压。
ETH	网口	使用超五类及以上型号的网线，接入网络。

表 21接口描述

2.1.2. 指示灯

传感器模块共有7个LED指示灯，其中包括1个电源指示灯，4个通道状态指示灯、1个设备状态指示灯和1个用户指示灯，信号灯不同状态所代表的含义如下表所示：

指示灯类型	指示灯名称	指示灯状态	事件类型
电源指示灯	Power	红灯常亮	设备上电。
		灯不亮	设备关机。
通道指示灯	CH1/CH2/CH3/CH4	绿灯常亮	通道准备就绪或烧录完成。
		绿灯闪烁	通道正在烧录。
		红灯常亮	通道烧录失败。
设备状态指示灯	Status	绿灯常亮	配套软件与设备已连接。
		红灯常亮	配套软件与设备未连接或连接断开。
用户指示灯	User	—	暂未开放。

表 22指示灯

2.2. 接线定义

S03传感器模块输出接口定义如下图所示：

图 22接口定义

传感器模块烧录线束示例图如下所示：

图 23烧录线束示例图

以传感器烧录模块的通道1连接A31315LOLATR-XZ-S-AR-10芯片为例，具体连接方式请参考下图：

图 24 连接示意图

2.3. 快速安装

2.3.1. 装箱清单

传感器模块具体装箱清单如下所示： 

物品名称	物品规格	数量
设备	S03传感器模块	1
六类网线	2m	1
烧录线束	24 PIN 0.5m	1
电源适配器	GS25A12-P1J	1
U盘	64 GB	1
固定背板	186*83 mm	1

表 23装箱清单

U盘的文件清单可查看U盘中“readme.txt”文件。

2.3.2. 连接线缆

确认装箱物品无误后，请参考本章节连接线缆。

传感器模块连接示意图如下图所示，其余线缆及设备请自行准备。

图 24连接示意图

说明：自备网线需使用超五类及以上型号的网线。

2.3.3. 供电检查

线缆连接完毕后，需打开传感器模块电源开关，观察指示灯，当电源指示灯（Power）状态为红色常亮时，传感器模块供电成功。

传感器模块采用电源适配器供电，使用传感器模块配套发货的电源适配器，连接电源和传感器模块电源接口进行供电。

说明：传感器模块正常工作时，请勿带电插拔芯片。

2.4. 产品规格

2.4.1. 电气参数

S03传感器模块相关电器参数如下表所示：

指标参数	参数值
输入额定电压	12±0.5 V/DC
最大输入功率	36 W
静态电流	500±5 mA

表 24电气参数

2.4.2. 设备规格

传感器模块相关设备参数如下表所示：

指标参数	参数值
信号输入/输出连接器	24 PIN，2 ROW，PITCH=2.54 mm
ETH 连接器	RJ45
可扩展UART接口	4 PIN，1 ROW，PITCH=1.5 mm
设备运行环境温度	5℃ ～ 40℃
储存温度	-15℃ ～ 50℃
相对湿度	10% ～ 90% RH（非冷凝）
SD 卡容量	默认为32GB
设备尺寸	164.3*161*30.2 mm
设备重量	505 g

表 25设备规格

图 25尺寸图

背板尺寸如下图所示：

图 26固定背板尺寸

2.5. 
许可证

许可证（License）是一种合法授权许可，用于授权用户使用传感器模块的指定通道、烧录特定的芯片。许可证与烧录设备是相互绑定的，许可证分为芯片授权许可证和通道授权许可证2类。

芯片授权许可证：芯片授权许可证是烧录器烧录指定芯片的授权许可。在进行烧录前，必须先保证该芯片的授权许可证已导入到烧录设备中。新购买的烧录器在出厂前，已将所购买芯片的许可证导入到烧录器中。若后期单独购买芯片授权许可证时，需要先完成许可证的导入。有关更多信息，请参考许可证管理章节内容。

通道授权许可证：通道授权许可证为烧录设备可用通道数量的授权许可文件。如果您有开通更多烧录通道的需求，请购买烧录器通道授权许可证并导入到对应设备。有关更多信息及导入方法，请参考许可证管理章节内容。

3. OPTEEQ Sensor Tool

传感器模块需配套使用软件OPTEEQ Sensor Tool（OPTEEQ传感器工具，下文简称“传感器工具”）。

传感器模块发货时，配套发货的U盘中包含适配传感器模块的软件，用户可参考安装软件进行安装。

3.1. 软件描述

3.1.1. 运行要求

传感器工具运行设备要求：

• CPU：Intel(R) Core(TM) i3以上。
• 内存：4G 以上。
• 显示分辨率：1024*768 以上。 

传感器工具支持的操作系统：

• Windows 10/11（64位）。

3.1.2. 操作界面

在安装配套软件后，打开传感器工具可看到首页。软件界面首页，分为菜单栏、设备区、日志区和操作区四个区域，界面首页不同分区的显示内容因目标芯片型号有些许差异，用于适配不同芯片特性。界面分区如下图所示:

图 31操作界面

这四个区域的介绍如下所示：

①菜单栏：设备配置、设置、帮助。

②设备区：连接烧录设备、选择传感器模块通道及传感器型号。

③日志区：显示设备的日志信息。

④操作区：对传感器数据进行导入导出、写入等操作。

3.1.3. 日志

传感器模块记录用户操作以及系统异常等相关日志信息，协助用户维护系统和定位故障。

3.2. 安装软件

传感器模块正常供电后，需在电脑端安装其配套的传感器工具，用于设置传感器相关参数，进行标定、烧录等操作。

3.2.1. 获取安装程序

在安装软件之前，请先将随箱发货的U盘接入电脑，打开U盘文件，获取“OpteeQ_Sensor_Tool_Setup.exe”安装程序，并存放至本地文件夹。

3.2.2. 安装并运行

请按照下列步骤安装传感器工具：

1. 双击“OpteeQ_Sensor_Tool_Setup.exe”运行程序。
2. 选择安装语言。可选择“简体中文”或“English”，单击“确定”。

图 32选择语言

• 选择安装路径。若需自定义安装路径，单击“浏览”，选择目录后单击“确定”，单击“下一步”。

说明：自定义安装路径时，建议将软件安装至D盘。

图 33选择安装路径

• 创建桌面快捷方式。勾选“创建桌面快捷方式”并单击“下一步”。

图 34桌面快捷方式

• 准备安装。确认安装路径及附加任务信息无误后，单击“安装”。

图 35准备安装

• 运行传感器工具。勾选“运行OpteeQ Sensor Tool”并单击“完成”。安装完成后，可在电脑桌面看到传感器工具图标，双击图标也可运行传感器工具。

图 36运行软件

3.3. 操作指南

本章节主要介绍传感器工具通用操作流程及界面功能。

3.3.1. 连接传感器模块

将传感器模块连接至传感器工具，对传感器数据进行处理。

传感器工具与传感器模块连接时需要保证电脑与设备在同一局域网内，既可将传感器模块通过网线与电脑直连，也可将设备与电脑接入同一局域网。设备出厂默认的IP地址为：192.168.0.100。

连接传感器工具的步骤如下：

打开传感器工具，输入传感器模块IP地址，选择烧录通道及传感器型号，单击“连接”。

图 37连接传感器模块

传感器模块连接成功后，传感器工具底部状态为“已连接设备”。

传感器工具支持多开，适用于需同时烧录或标定多个传感器的场景。
操作方式：打开首个界面后，再次双击桌面传感器工具图标，即可快速开启第二个独立界面，选择另外的通道进行连接；重复此操作，可按需打开多个界面。

3.3.2. 烧录指南

烧录指南作用为编辑芯片相关数据并进行写入。

图 38操作界面

• 注册表区：查看注册表列表。
• 数据展示区：显示该芯片EEPROM内的相关数据。
• 操作区：对传感器数据进行刷新、导入导出等操作。

3.3.2.1. 手动写入

在首页的注册表区域，选择需要进行修改的寄存器，选中后左侧对应的区域对应的位置背景显示为黄色，选择十进制或16进制其中之一进行修改，单击“写入”，所修改的数据将以二进制显示在数据展示区。

图 39手动写入

3.3.2.2. 导入/导出

单击界面操作区“导入”，可将数据导入至EEPROM。

单击界面操作区“导出”，可将当前EEPROM内容以“csv”文件导出。

3.3.2.3. 全片写入

全片写入的作用为将首页的数据展示区的数据烧录至传感器中。

使用场景如下：

• 在首页注册表区域选择需修改的寄存器并进行参数调整，支持多次选择与修改；完成后单击首页操作区”全片写入”，将当前界面数据烧录至传感器中。
• 将数据进行导入后，单击首页操作区”全片写入”，将当前界面数据烧录至传感器中。

3.3.2.4. 刷新

单击界面操作区“刷新”，可使传感器工具重新读取传感器EEPROM内容。

3.3.3. 日志

在传感器工具首页，可在日志区查看用户操作以及系统异常等相关日志信息，协助用户维护系统和定位故障。

图 310日志

3.3.4. 设备配置

设备配置菜单下可进行“文件管理”、“网络配置”、“更新设备”及“参数导出”等操作。

图 311设备配置

3.3.4.1. 网络配置

网络配置页面显示了设备当前的网络参数信息，您可以在此页面修改相关网络参数，修改后需要重启传感器模块才能生效。

图 312网络配置

3.3.4.2. 文件管理

文件管理页面显示了设备中的日志及算法相关内容，您可以“下载”或“删除”这些文件，下载后文件默认保存在安装目录“../download”文件夹内。

图 313文件管理

3.3.4.3. 许可证管理

许可证管理界面的列表中展示了烧录器当前芯片许可证的情况。芯片授权许可证及通道授权许可证均为“.xml”格式的文件，在装箱发货的U盘内“Lic”文件夹中存放。

用户可以单击“添加通道许可证”或“添加许可证”，选择对应许可证文件单击“打开”，进行添加。

图 325许可证管理

3.3.4.4. 更新设备

本页面显示了当前连接设备的型号及固件版本，您可单击“本地导入”选择对应的更新包，对设备固件进行升级。

图 314更新设备

3.3.4.5. 参数导出

单击“参数导出”可将设备相关参数全部导出至软件安装根目录下的“device.info”文件内。

图 315参数导出

3.3.5. 设置

设置包括了“语言”、“导入芯片包”功能。

图 316设置

语言可切换软件界面显示语言类型，目前支持中文/英文，切换后重新打开软件生效。

3.3.5.1. 导入芯片包

若用户新购入芯片算法，需导入更新包、芯片包更新传感器模块后才可对传感器进行标定烧录。

说明：首次购买模块时，已预集成对应已购芯片的芯片包。

导入芯片包步骤如下：

1. 打开传感器工具，选择“设置 > 导入芯片包”。

图 317导入芯片包

• 选择要导入芯片包。在本地选择需要导入的文件后，单击“打开”，文件开始导入。

3.3.6. 帮助

单击“帮助 > 关于”可查看软件版本等相关信息。

图 318版本信息

3.4. DLL命令说明

为了您能够方便地在其自身的程序（如用 C、C#、C++、LabView、Python 等环境编写的测试程序）中实现烧录功能，我们提供了 DLL 命令说明文件以及一套 API 编程。具体内容，请参考文档《力捷丰 SG 系列烧录器 DLL 接口命令说明》。

《力捷丰 SG 系列烧录器 DLL 接口命令说明》中包含了烧录器通用命令及Lua API参考命令，目标传感器芯片专属Lua API命令请参考Lua API参考章节内容。

获取方式：

1. 官网获取：登录官网www.opteeq.com，选择“支持与服务 > 下载中心”，下载相应资料。
2. 售后获取：联系力捷丰官方售后人员，获取相应资料。

3.5. Lua API参考

该章节主要描述了目标传感器芯片专属Lua API命令参考。

3.5.1. dev:Init()

描述:

初始化总线，设置FPGA时钟，建立与芯片的通信。

语法:

dev:Init()

示例:

result=dev:Init()

参数:

无

返回值:

true：成功

false：失败

3.5.2. dev:UnInit()

描述:

反初始化，关闭FPGA的时钟使能，设置VDD与VOUT为0V。

语法:

dev:UnInit()

示例:

result=dev:UnInit()

参数:

无

返回值:

true：成功

false：失败

3.5.3. dev:Read()

描述:

读取对应寄存器地址的数据。

语法:

dev: Read(DWORD dwAddr)

示例:

data = dev:Read(0x05)

参数:

dwAddr：寄存器地址

返回值:

返回读取到的数据，类型是字符串，十六进制形式表示，共8个字符（32位数据）。

例：“01000002”，表示回读的EEPROM寄存器0X05的数据是0x01000002，高字节在前。

3.5.4. dev:Write()

描述:

向对应寄存器地址写入数据。

语法:

dev:Write(DWORD dwAddr, DWORD dwData)

示例:

dev:Write(0x17, 0x00004000)

参数:

dwAddr：寄存器地址

dwData：要写入的寄存器数据

返回值:

true：成功

false：失败

3.5.5. dev:ReadAll()

描述:

回读EEPROM所有数据。

语法:

dev:ReadAll()

示例:

data = dev:ReadAll()

参数:

无

返回值:

返回读取到的数据，以字符串表示十六进制数，类型是string。

例：“01000002000007F8000000000000000000000000000008000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000200000400000200010003FE330000000001C5FFFF000014B800052001000000000007400200080400 000000000000000000000000”。

包含44个8字符的数据，每8个字符分别表示一个EEPROM寄存器的数据。地址小的寄存器数据排列在前，开头的8个字符对应EEPROM寄存器0x05的值，最后的8个字符对应EEPROM寄存器0x3F的值，每8个字符中高字节在前。

3.5.6. dev:WriteAll()

描述:

向所有可写的EEPROM寄存器中写入数据（读EEPROM的最后3个寄存器无意义，不进行写入）。

语法:

dev:WriteAll(string strData)

示例:

result=dev:WriteAll(“01000002000007F8000000000000000000000000000008000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000200000400000200010003FE330000000001C5FFFF000014B800052001000000000007400200080400”)

参数:

strData：待写入的EEPROM全片数据，以字符数组表示十六进制数，每8个字符表示一个寄存器数据。数据部分的字符个数必须是328，不允许出现[0-9，a-f, A-F]以外的数据，地址小的寄存器数据排列在前，每8个字符中高字节在前。

返回值:

true：成功

false：失败

4. 联系我们

如果您有任何疑问或建议，可通过以下方式联系我们获得帮助：

• 电话：拨打售后电话400-002-3598或0510-81813667。
• 官网：登录官网www.opteeq.com，选择“联系我们”，获取联系电话。也可填写留言，等待售后人员联系。
• 邮件：发送反馈内容邮件至contact@opteeq.com，我们会尽快联系您。

5. 术语

A
Analog	模拟信号
C
CHn	通道号。
CLK	时钟信号。
CPU	Central Processing Unit，中央处理器。
CRC	Cyclic Redundancy Check，循环冗余校验。
D
DLL	Dynamic Link Library，动态链接库文件。
E
EEPROM	Electrically Erasable Programmable ROM，带电可擦可编程只读存储器。
F
FPGA	Field Programmable Gate Array，现场可编程门阵列。
G
GND	电线接地端。
H
hex	一种文件扩展名，hex文件通常用来记录芯片数据。
I
I/O	Input/Output，输入/输出。
L
LED	light-emitting diode，发光二极管。
log	一种文件扩展名，日志文件格式。
M
MCU	Master Control Unit，主控制器。
N
NorFlash	非易失闪存。
O
opj/oprj	一种文件扩展名，工程文件格式。
OTP	One Time Programmable，一次性可编程。
P
PIN	引脚。
ping	工作在TCP/IP网络体系结构中应用层的一个服务命令。
PITCH	间距。
PoE	Power over Ethernet，以太网供电。
PSI5	Peripheral Sensor Interface协议，是用于汽车传感器上的一种通信协议，主要用于汽车的安全气囊传感器。
PWM	Pulse width Modulation，脉宽调制协议。
R
RAM	Random Access Memory，随机存取存储器。
RESET	重置。
ROW	排。
S
SICI	英飞凌传感器编程接口。
SN	serial number，序列号。
so	一种文件扩展名，算法文件格式。
SPC	short PWM code，基于SENT单边半字节传输协议的增强版。
SENT	Single Edge Nibble Transmission，单边半字节传输通信协议。
T
tar	一种文件扩展名，设备更新文件格式。
V
VCC	Volt Current Condenser，电路的供电电压。
VDD	Drain Voltage，器件内部的工作电压。

表 51术语