简介这份文档面向需要部署 SAPRO 软件的工程技术人员与自动化调试人员系统梳理了从零完成安装与授权的完整流程帮助解决组件安装顺序混乱、授权配置易出错等实际问题。资源包共 1 个 doc 文件约 48KB以文字步骤说明为主按安装先后顺序组织内容便于对照操作。文档依次覆盖准备工作、HARDLOCK、SCOPE、批处理文件、POL63X 与 POL6876、加密组件等基础组件的安装要点并重点说明两个 KY1 文件的配置方法一个用于功能块自定义参数设定另一个用于软件授权均给出对应 Key 值可直接参考填写。目前已有 2032 人学习下载适合初次接触 SAPRO 的安装人员按序执行也适合作为排错时的对照清单减少因杀毒软件拦截或授权遗漏导致的安装失败。1. 为什么 SAPRO 的安装顺序不能乱从 HARDLOCK 到 KY1 的依赖链装 SAPRO 最反直觉的一点是它不是一个双击 exe 就能跑起来的单体软件而是一套由硬件锁驱动、示波器采集组件、批处理脚本和授权文件串起来的工具链。顺序装错最常见的表现是 SCOPE 能打开但读不到设备或者 POL63X 装完提示找不到加密狗。原因在于 HARDLOCK 提供的是底层加密锁的驱动和运行时后面的 SCOPE、POL63X、POL6876 都要通过它去访问硬件锁而两个 KY1 文件分别承担「功能块自定义参数」和「V4.2 版本授权」两种完全不同的职责装反了授权窗口会在启动时反复弹出。这套流程适合做汽车电子标定、测试台架或者产线工装的工程师尤其是需要在一台新机器上从零复现整套环境的人。2. HARDLOCK 与 SCOPE 的安装顺序及驱动依赖2.1 为什么 HARDLOCK 必须第一个装HARDLOCK 本质上是加密锁的驱动层加运行时库。SCOPE 在启动时会去枚举本机的锁设备如果 HARDLOCK 没装或者装在了 SCOPE 之后SCOPE 的安装程序不会报错但运行时会出现「设备未找到」或者直接闪退。常见做法是先把 HARDLOCK 装完重启一次再确认系统服务里能看到对应的驱动项然后再动 SCOPE。安装 HARDLOCK 时有一个容易被忽略的点安装程序会往系统目录写驱动文件如果杀毒软件在后台拦截了驱动注册安装向导会显示成功但实际驱动没加载。所以摘要里强调的「关闭所有杀毒软件」不是客套话是必须执行的前置动作。# 以管理员身份打开 cmd检查 HARDLOCK 驱动服务是否注册成功 sc query HardlockService # 如果服务不存在说明驱动没装上需要重新以管理员权限运行 HARDLOCK 安装程序 # 正常输出应包含 STATE : 4 RUNNING 或 STATE : 1 STOPPED这段命令的作用是验证 HARDLOCK 的驱动服务有没有真正注册进系统。sc query后面跟的是服务名不同版本的 HARDLOCK 服务名可能略有差异常见的是HardlockService或HASP相关名称。如果返回「指定的服务未安装」不要急着装 SCOPE先把 HARDLOCK 重装一遍并且确认安装时右键选择了「以管理员身份运行」。2.2 SCOPE 安装时的路径与权限参数SCOPE 是采集和示波器交互的前端组件它对安装路径有隐含要求路径里不要带中文和空格。默认路径通常是C:\Program Files\SCOPE如果改成D:\我的工具\SCOPE后面批处理文件调用时会出现路径解析失败。安装时建议保持默认路径或者手动改成纯英文短路径。组件建议安装路径是否需重启依赖前置组件HARDLOCK默认路径是无SCOPEC:\SCOPE否HARDLOCK批处理文件与 SCOPE 同盘否SCOPEPOL63X默认路径是SCOPEPOL6876默认路径否POL63X加密组件默认路径是全部前置表格里的重启列不是随便写的。HARDLOCK 和 POL63X 装完必须重启因为这两个组件会注册内核级驱动或者系统级服务不重启的话后续组件加载不到。SCOPE 和批处理文件属于用户态组件装完可以直接继续。2.3 批处理文件在安装链中的实际作用批处理文件这一步很多人会跳过觉得就是个脚本。实际上它做的是环境变量注册和路径拼接把 SCOPE 的 bin 目录、POL63X 的库目录写进系统 PATH同时生成后续组件需要的配置文件。如果跳过这一步直接装 POL63XPOL63X 启动时会找不到 SCOPE 的动态库。echo off REM 批处理文件典型内容注册环境变量和复制配置文件 setx SCOPE_HOME C:\SCOPE /M setx POL_HOME C:\POL63X /M copy /Y %~dp0config\scope.ini C:\SCOPE\config\scope.ini echo 环境变量与配置已写入 pause这段批处理的核心是setx ... /M/M表示写入系统级环境变量而不是当前用户。%~dp0是批处理文件自身所在目录用它来定位同目录下的 config 文件夹。执行完可以用echo %SCOPE_HOME%验证但注意setx写入的环境变量在新开的 cmd 窗口才生效当前窗口读不到。提示批处理文件执行时如果提示「不是内部或外部命令」通常是 PATH 里缺少系统目录或者批处理本身被杀毒软件隔离了。先确认文件在不在再检查 PATH。3. POL63X 与 POL6876 的安装及加密组件处理3.1 POL63X 与 POL6876 的先后关系POL63X 和 POL6876 是 SAPRO 里负责协议解析和数据处理的两个模块。POL63X 偏底层提供通信和解析库POL6876 偏上层依赖 POL63X 的接口。所以顺序必须是先 POL63X 再 POL6876反过来装 POL6876 会在安装末尾报「缺少依赖组件」。装 POL63X 时有一个参数值得注意安装向导里会问是否安装「示例工程」和「文档」如果只是产线用这两个可以取消勾选能省几百兆空间也能减少后面加密组件扫描的文件数量。POL6876 安装时则会检测 POL63X 的版本号版本不匹配会直接拒绝安装。# 安装完成后验证 POL63X 的库文件是否注册 reg query HKLM\SOFTWARE\POL63X /v Version # 检查 POL6876 依赖的 POL63X 接口是否存在 dir C:\POL63X\bin\pol_core.dllreg query查的是注册表里 POL63X 写入的版本信息如果返回「找不到指定的注册表项」说明 POL63X 没装成功或者装到了非默认路径。dir那行是确认核心动态库在不在POL6876 启动时会去加载这个 dll缺了就会报模块找不到。3.2 加密组件安装前必须关闭杀毒软件的原因加密组件这一步是整个流程里最容易被杀毒软件破坏的环节。它做的事情包括向加密锁写入授权信息、注册系统级钩子、修改部分可执行文件的校验值。这些行为在杀毒软件看来和恶意软件高度相似会被拦截或者直接删除文件。摘要里反复强调关闭杀毒软件就是因为这个。实际操作时光退出杀毒软件界面不够还要确认后台服务也停了。Windows Defender 的话需要在「病毒和威胁防护」里临时关闭实时保护第三方杀毒软件要检查托盘图标是否真的退出有些只是最小化到托盘驱动还在跑。杀毒软件状态加密组件安装结果典型现象完全关闭成功安装完成授权可写入仅退出界面失败安装中途报错文件被删实时保护开启失败安装完成但授权无效仅加白名单可能成功取决于拦截规则表格里「仅加白名单」这一行是很多人的误区以为把安装目录加白名单就行但加密组件还会往系统目录写文件白名单覆盖不到所以最稳妥的还是安装期间完全关闭。3.3 两个 KY1 文件的区别与安装位置两个 KY1 文件名字一样但用途完全不同。第一个 KY1 是「功能块自定义参数设定」对应 Automation Object supportKey 1 是1baqr5j-16fnnbe。这个文件决定的是软件里哪些功能块可用、参数范围是多少。第二个 KY1 是「软件授权」对应 Version V4.2 EnableKey 1 是h6331zg-a6lx8ru-ks7vjm7-lvy5npc。这个文件决定的是软件能不能启动、启动时会不会弹授权窗口。安装时两个 KY1 都要装顺序是先装功能块 KY1再装授权 KY1。如果先装授权启动时授权窗口会弹出来但因为功能块参数还没写入部分菜单是灰的。装完两个 KY1 后启动软件如果还弹 Enable 窗口说明授权 KY1 没写进去需要重新装一遍授权 KY1 并确认杀毒软件是关闭状态。# 确认 KY1 文件是否被正确识别以管理员身份运行 # 查看加密锁内已写入的授权项 hardlock_tool.exe --list-keys # 预期输出应包含两条记录 # Key Type: Automation Object, Key: 1baqr5j-16fnnbe # Key Type: Version V4.2, Key: h6331zg-a6lx8ru-ks7vjm7-lvy5npchardlock_tool.exe是 HARDLOCK 自带的命令行工具不同版本名字可能不同常见的有hasp_srm_view或厂商提供的专用工具。--list-keys会列出当前锁里写入的所有授权项。如果只看到一条说明另一个 KY1 没写成功需要重新执行对应的 KY1 安装程序。注意这个命令要在杀毒软件关闭的状态下跑否则工具本身可能被拦截。4. 安装后的验证与常见故障排查4.1 启动时 Enable 窗口反复弹出的排查路径Enable 窗口弹出是装完 SAPRO 后最高频的问题。它的触发条件是授权 KY1 没有生效。排查顺序是先确认杀毒软件是否关闭再确认授权 KY1 是否写入最后确认系统时间是否正确。加密锁的授权通常和系统时间挂钩如果机器时间被改到了授权有效期之外也会弹窗。# 检查系统时间是否在授权有效期内 date /t time /t # 重新写入授权 KY1假设安装程序在 D:\KY1_Auth D:\KY1_Auth\setup.exe /silent /key:h6331zg-a6lx8ru-ks7vjm7-lvy5npcdate /t和time /t是快速确认系统时间的方式。如果时间不对先校准时间再重装授权 KY1。/silent参数让安装程序静默执行/key:后面跟的是授权码。不同版本的 KY1 安装程序参数可能不同如果/silent不生效就去掉它手动点。4.2 SCOPE 读不到设备的驱动层检查SCOPE 能打开但读不到设备问题通常出在 HARDLOCK 驱动层。检查步骤是先看设备管理器里有没有带感叹号的未知设备再用 HARDLOCK 自带工具确认锁是否被识别最后看 SCOPE 的日志里报的是哪个设备 ID。# 查看设备管理器中的加密锁设备状态 pnputil /enum-devices /class USB # 查看 SCOPE 运行日志中的设备枚举记录 type C:\SCOPE\logs\scope.log | findstr /i devicepnputil是 Windows 自带的驱动管理工具/enum-devices /class USB会列出所有 USB 类设备加密锁通常以 HID 或 USB 设备形式出现。如果列表里没有锁设备说明驱动没加载或者锁没插好。findstr /i device是在 SCOPE 日志里过滤设备相关行能看到 SCOPE 实际枚举到了哪些设备 ID和锁的 ID 对不上就是驱动层的问题。4.3 批处理文件执行失败的 PATH 与权限问题批处理文件执行失败最常见的报错是「不是内部或外部命令」这个报错本身和批处理内容无关是系统 PATH 里缺少C:\Windows\System32导致的。另一个常见原因是批处理文件被放在了带中文的路径下%~dp0解析出来带中文后面的 copy 命令就会失败。REM 修复 PATH 缺失导致的批处理执行失败 set PATH%PATH%;C:\Windows\System32;C:\Windows REM 然后再执行批处理 call install_batch.bat这段代码是在当前会话里临时补全 PATHcall是让批处理在当前会话执行而不是开新窗口这样环境变量能继承。如果补了 PATH 还是报错就把批处理文件移到纯英文路径下再试。注意set PATH只对当前 cmd 窗口有效关掉就没了要永久生效得用setx。注意所有涉及加密锁写入的操作都必须在杀毒软件完全关闭的状态下进行。装完后再把杀毒软件开回来不影响已写入的授权。5. 多版本共存与 KY1 授权迁移的进阶技巧5.1 同一台机器装多个 SAPRO 版本的隔离方法产线机器有时候需要同时装 V4.2 和更早的版本做对比测试。直接装两个版本会冲突因为 HARDLOCK 驱动和 POL63X 的注册表项是全局的。可行的做法是用虚拟机隔离每个虚拟机装一个版本加密锁通过 USB 直通挂载。如果必须物理机共存就要在装第二个版本前把第一个版本的 POL63X 注册表项导出备份装完后按需切换。# 导出当前 POL63X 注册表配置 reg export HKLM\SOFTWARE\POL63X pol63x_v42.reg # 切换到另一个版本前先导入对应版本的注册表 reg import pol63x_v40.regreg export把注册表项导出成 .reg 文件reg import是导入。切换版本的本质就是切换注册表里的路径和版本号。这个方法的前提是两个版本的 POL63X 安装目录不同如果装到了同一个目录文件会被覆盖导出注册表也救不回来。5.2 KY1 授权从旧机器迁移到新机器的注意事项加密锁授权通常是锁硬件的直接复制 KY1 文件到新机器不一定能用。迁移的正确做法是在新机器上装好 HARDLOCK 和加密组件然后用 KY1 安装程序重新写入授权码。如果锁本身是 USB 锁把锁插到新机器上驱动装好后授权会跟着锁走不需要重新写 KY1。如果是软授权就需要联系供应商重新生成绑定新机器硬件信息的授权文件。授权类型迁移方式是否需要重新写 KY1USB 硬件锁拔锁插到新机否软授权绑定主板重新生成授权是软授权绑定网卡重新生成授权是网络锁配置指向锁服务器否表格里网络锁这一行值得单独说网络锁的授权不在本机KY1 文件里写的是锁服务器的地址所以迁移时只要新机器能访问到锁服务器就行不需要重新写 KY1。判断自己的锁是哪种看 HARDLOCK 工具里显示的锁类型即可。5.3 用日志定位 KY1 写入失败的精确原因KY1 写入失败时安装程序通常只给一个笼统的报错。要看精确原因得去翻 HARDLOCK 的日志。日志一般在C:\ProgramData\HARDLOCK\logs或者安装目录的 log 文件夹下文件名带日期。重点看error和fail关键字附近的内容常见的有「锁未找到」「授权码格式错误」「已有同类型授权」三类。# 在 HARDLOCK 日志目录下搜索最近的错误记录 findstr /i /c:error /c:fail C:\ProgramData\HARDLOCK\logs\*.log # 如果提示已有同类型授权先清除旧授权再重写 hardlock_tool.exe --remove-key Automation Object hardlock_tool.exe --install-key 1baqr5j-16fnnbefindstr的/c:参数是精确匹配字符串/i是忽略大小写。搜出来的行会带时间戳对照安装时间就能定位到是哪一步出的问题。--remove-key和--install-key是 HARDLOCK 工具的清除和写入命令清除时参数是授权类型名而不是授权码写入时才是授权码。这两个命令执行前务必确认杀毒软件是关闭的否则工具本身可能被拦截导致清除不干净。本文还有配套的精品资源点击获取
