WizPro / MaxWiz · Customer Documentation

WizProGenX 客户技术文档合集

本合集说明如何装载数据到烧写器、如何启动脱机烧写 （GenXxCmdLinM.exe 命令行 / MWGWPCMD.dll 动态库）， 并附带通信协议与二次开发说明，便于产线与客户系统集成。

文档包版本 · 2026-08-05 含 HTML + PDF + EXE/DLL 离线可用 · 请保持文件夹完整

集成方式总览

产线 / 客户系统通常分两步：先把镜像装载到烧写器（开关参数加载 HEX 等，或直接加载工程文件），再启动脱机烧写。启动烧写目前提供命令行工具、动态库，以及按协议自行 USB 串口控制三种方式。

步骤方式程序 / 库 / 文档用途
① 装载数据 开关参数加载文件 AppXX.exe -CP=... -LF=... 选芯片、加载 HEX/BIN 等，并下载到烧写器缓存
工程文件加载 AppXX.exe xxx.PMW OFF 打开 APP 生成的 .PMW 工程并下载到烧写器；OFF 表示下载后自动关闭（视产品）
② 启动烧写 命令行工具 GenXxCmdLinM.exe 通过串口/TCP 发送复位、自动烧写等命令
动态库 API MWGWPCMD.dll 客户程序直接调用导出函数启动脱机烧写
USB 串口直接控制 《烧写器基本控制命令和响应 - RV5》 客户按协议帧自行通过 USB 串口与烧写器通信并控制烧写
注意：GenXxCmdLinM.exe、MWGWPCMD.dll 以及 USB 串口协议控制，均用于在烧写器已装载好数据之后启动 / 控制烧写； 装载本身请使用「① 上位机装载」：开关参数（-CP/-LF 等）或工程文件（AppXX.exe xxx.PMW OFF，工程须由 APP 生成）。 自行按协议通信时请阅读「④ 控制命令与响应」。

文档组成

点击下方卡片可直接进入对应章节。发给客户时请将整个文件夹打包发送（勿只发单个 HTML）。

DOC 01 · HTML

上位机装载命令行

开关参数 -CP/-LF 加载 HEX 等；或 AppXX.exe xxx.PMW OFF 加载 APP 生成的工程。

DOC 02 · EXE + PDF

GenXxCmdLinM 启动烧写

独立命令行工具：-COM/-DoProgA 等；需同目录 MAXWIZERRI.dll 解析返回并写 Log。

DOC 03 · DLL

MWGWPCMD.dll 动态库

WPStarAutoProgRT 启动脱机烧写；WPxReadAdressRT 读地址（仅部分特定 APP 支持）。

DOC 04 · PDF

烧写器基本控制命令和响应 - RV5

USB 串口直接控制：主机与烧写器之间的通信帧、命令码与应答定义。

DOC 05 · PDF

WizProGenX 系列二次开发说明 - V0

上位机 / 二次开发接口与集成要点说明。

推荐阅读顺序

  1. 先用「① 上位机装载」把工程/镜像下载到烧写器（开关参数或 AppXX.exe xxx.PMW OFF）。
  2. 再按集成形态选择启动烧写方式：脚本用「② GenXxCmdLinM.exe」；进程内嵌入用「③ MWGWPCMD.dll」；自行 USB 串口控制用「④ 控制命令与响应（RV5）」。
  3. 若要自行编写与烧写器通信的程序：先读「⑤ 二次开发说明」，再对照「④ 控制命令与响应」。
打包提示：请保持 index.html、pdfs\、GenXxCmdLinM.exe、 MWGWPCMD.dll、MAXWIZERRI.dll、使用说明.txt、DLL说明.TXT 在同一文件夹内整夹 ZIP 发送。

文件清单

文件说明
index.html本合集入口（总览 + HTML 正文 + PDF 预览）
GenXxCmdLinM.exe启动烧写器烧写的命令行工具
MWGWPCMD.dll启动脱机烧写动态库（另含读地址接口，仅部分 APP 支持）
MAXWIZERRI.dll与 GenXxCmdLinM.exe 配套：解析返回数据并生成 Log
DLL说明.TXTMWGWPCMD.dll 导出函数说明
pdfs/GenXxCmdLinM_Command_Line-V1.pdf《GenX_CmdLin 命令行参数使用说明》
pdfs/WizPro_Protocol_Commands_Responses-RV5.pdf《WizPro 系列烧写器基本控制命令和响应 - RV5》
pdfs/WizProGenX_Secondary_Development-V0.pdf《WizProGenX 系列二次开发的说明 - V0》
使用说明.txt发给客户的简要使用指引

1. 概述

本节说明如何通过上位机可执行文件（如 WizProGenSLB.exe）把芯片型号与目标文件装载并下载到编程器。上位机支持两种启动方式：

模式触发条件行为
开关参数模式（推荐） 出现 -CP / -LF / -LFM 等开关 选芯片 → 加载文件 → 自动下载到编程器 → 成功后退出（Release）
工程文件模式（兼容） 仅传入已存在的 .PMW 工程路径（由 APP 生成），且没有上述开关 打开工程并启动下载

典型流程（D10 开关模式）：

  1. 启动并枚举 / 连接编程器
  2. 解析 -CP、-LF/-LFM 及可选文件开关
  3. 选芯片、加载主程序（可多文件合并）及可选附属文件
  4. 自动执行下载（Download）
  5. Release 构建结束后关闭；部分 DEBUG 构建可保持窗口查看日志
SLB（WizProGenSLB.exe）提示：CLI 加载完成后界面停留在 Chip Setting / 信息显示区，便于查看校验和与日志；数据已加载，可手动切换到 Main Flash 查看。

2. 参数一览（D10 标准开关模式）

开关名不区分大小写。个别产品对可选开关支持不同，见第 7 节。

2.1 必选

开关含义说明
-CP芯片型号须与软件芯片列表名称一致（如 OM6626A）。
-LF主 Flash 目标文件（单个）只能写一个。加载前清空缓冲（等同界面「打开」）。
-LFM主 Flash 追加/合并文件可写多个（最多 16 个）。不清空缓冲，合并进现有主 Flash。

至少需要一个 -LF 或 -LFM。多段镜像请用多个 -LFM（可先用一个 -LF 打开首文件），见第 4 节。

2.2 可选（按产品启用）

开关别名含义典型用途
-LDF—User / Data / EEP 文件用户区、EEPROM、数据 Flash
-LCF—MCU 配置 / Flags（如 JSON）安全标志等（视产品）
-LKEY—密钥文件加密 / 签名 / 命令公钥（视产品）
-LOB-LOLock / Option 文件锁位、Option Byte、NVM 配置

-LO 与 -LOB 等价。

2.3 工程文件用法（.PMW）

AppXX.exe 工程文件名称.PMW
AppXX.exe 工程文件名称.PMW OFF
  • 工程文件扩展名必须为 .PMW，由对应上位机 APP 生成/保存。
  • 第一个参数为工程文件路径；不要与 -CP/-LF 等开关混用。
  • 第二参数 OFF 时，部分产品表示下载到烧写器后自动关闭程序。
  • 一旦出现标准开关（如 -CP），即进入开关参数模式，不再按工程文件模式解析。

3. 写法与路径规则

3.1 等号 / 空格（等效）

App.exe -CP=OM6626A -LF=D:\Bin\app.hex
App.exe -CP OM6626A -LF D:\Bin\app.hex

3.2 路径含空格（推荐引号）

App.exe -CP=ChipName -LF="D:\My Path\firmware.hex"
App.exe -CP ChipName -LF "D:\My Path\firmware.hex"

3.3 目标文件格式

常见：.hex、.bin、.s19 / .s37 / .mot / .srec 等，以具体产品解析器为准。

4. 多文件主程序合并（-LFM）

与界面「打开」+「加载更多文件」对齐：

开关次数缓冲行为
-LF=...只能 1 个清空主缓冲后加载（等同「打开」）
-LFM=...可多个（最多 16）不清空，合并进现有主缓冲（等同「加载更多」）
 
App.exe -CP=OM6626A ^
  -LF=D:\BinaryFile\part1.hex ^
  -LFM=D:\BinaryFile\part2.hex ^
  -LFM=D:\BinaryFile\part3.hex
-LF 只能出现一次；后续文件一律用 -LFM。 日志中的「目标文件首/尾地址」通常反映最后一次加载文件的范围； 校验和按合并后的整段主 Flash 缓冲计算。

5. 完整示例

5.1 最小命令

WizProGenSLB.exe -CP=OM6626A -LF=D:\BinaryFile\app.hex

5.2 多文件 + 附属文件

WizProGenSLB.exe -CP=OM6626A ^
  -LF=D:\BinaryFile\main_a.hex ^
  -LFM=D:\BinaryFile\main_b.hex ^
  -LFM=D:\BinaryFile\main_c.hex ^
  -LDF=D:\BinaryFile\userdata.hex ^
  -LOB=D:\BinaryFile\option.hex ^
  -LCF=D:\BinaryFile\mcu_flags.json ^
  -LKEY=D:\BinaryFile\keys.txt

5.3 工程文件模式

AppXX.exe D:\Project\MyBoard.PMW
AppXX.exe D:\Project\MyBoard.PMW OFF

6. 运行结果与排错

成功

  • 信息区出现类似 Command line ready: CP=... LF(n)=file1 | file2 ...
  • 随后自动下载；Release 下通常成功后退出

失败

  • 信息区打印原因；多数产品写入工作目录 ResDW.Txt（含 Download Failed.）
  • 常见：未联机、芯片名不符、路径错误、只传了一个文件却期望三文件合并校验和

7. 产品差异（摘要）

可执行文件备注
WizProGenSLB.exe完整 -LDF/-LCF/-LKEY/-LOB；CLI 后停在信息区
多数 WizProGen*.exe / MaxWizFMX.exe标准开关集；多文件用多个 -LFM
WizProGenSTX.exe主推 -CP/-LF/-LFM/-LOB
MP300STX.exe另有 -DW/-AP/-BC/-ES/-PG/-VF 等扩展动作开关

8. MP300STX 扩展开关

开关含义
-LO / -LEOption / EEPROM 文件
-5V / -3V接口电压
-DW -AP -BC -ES -PG -VF -RD -OP下载 / 自动编程 / 查空 / 擦除 / 编程 / 校验 / 读出 / 写 Option
 
MP300STX.exe -CP=STM8S208RB -LF=D:\fw.hex -LO=D:\opt.hex -DW -AP

9. 与界面操作对照

界面操作命令行
选择芯片-CP=型号
打开目标文件（清缓冲）-LF=文件（只能一个）
加载更多（合并）多个 -LFM=文件
User/Data / Lock / 配置 / Key-LDF / -LOB / -LCF / -LKEY
下载到编程器开关模式装载成功后自动执行

10. 快速检查清单

GenXxCmdLinM.exe · 启动烧写器烧写

命令行工具（本包已附带 GenXxCmdLinM.exe）
下载 PDF 新窗口打开

1. 用途

GenXxCmdLinM.exe 是独立的命令行监控/控制工具：在烧写器已装载好目标数据后， 通过串口或 TCP 向编程器发送复位、自动烧写、查状态、读校验和、擦除等命令。 Release 版本默认无界面（隐藏窗口），适合产线脚本或上位壳程序调用。

请与同目录的 MAXWIZERRI.dll 合并使用：该库用于解析烧写器返回数据并生成 Log。 缺少此 DLL 时，结果解析 / 日志可能不完整。
与「① 上位机装载」不同：本工具不负责选芯片/加载 HEX，只负责对已就绪的烧写器发起动作。

2. 参数一览（不区分大小写）

参数含义
-COM=xx串口号（如 -COM=25 表示 COM25）
-TCP=host:port网口连接（如 192.168.1.253:1030；端口可省略，默认 1030）
-DEV=n从同目录 ConfigWpg.ini 读取 DEVn（按 Type 选串口或 TCP）
-TimOut=xx超时（秒；内部再按实现换算）
-DoProgA启动自动烧写（Auto-Program / APRG）——须放在命令行末尾
-DoCheck检查编程器状态（CKPG）——须放在末尾
-DoReset复位编程器并读取信息——须放在末尾
-DoRdSum读芯片校验和——须放在末尾
-DoErase擦除芯片——须放在末尾
-EnDpDAT显示全部数据包（调试用）

-DoProgA / -DoCheck / -DoReset 等动作开关应放在命令行最后一项。

3. 示例

GenXxCmdLinM.exe -COM=5 -DoProgA
GenXxCmdLinM.exe -COM=5 -TimOut=30 -DoProgA
GenXxCmdLinM.exe -COM=5 -TimOut=5 -DoReset
GenXxCmdLinM.exe -TCP=192.168.1.253:1030 -DoReset
GenXxCmdLinM.exe -DEV=1 -DoProgA
GenXxCmdLinM.exe -COM=11 -DoCheck
GenXxCmdLinM.exe -COM=25 -DoRdSum
GenXxCmdLinM.exe -COM=25 -DoErase

4. 结果文件

执行结果写入工作目录文本文件，便于脚本读取：

  • 串口：RptGx_COMxx.Txt（如 COM5 → RptGx_COM5.Txt；部分旧说明亦写作 Rpt_COMn.Txt）
  • TCP：RptGx_192_168_1_253_1030.Txt（IP 与端口中的 . / : 转为 _）

5. Windows 调用示例（ShellExecute）

theApp := '[PATH]\GenXxCmdLinM.exe';
thePar := '-COM=5 -TimOut=30 -DoProgA';
ShellExecute(theHandle, 'Open', theApp, thePar, NIL, SW_HIDE);

6. ConfigWpg.ini（配合 -DEV）

[Connection]
Type=TCP
TotDev=1
DEV1=192.168.1.253:1030

; 或串口：
; Type=COM
; DEV1=COM25
完整 PDF 说明见上方「下载 / 新窗口打开」，或打开 pdfs\GenXxCmdLinM_Command_Line-V1.pdf （原名：《GenX_CmdLin 命令行参数使用说明》）。

1. 用途

MWGWPCMD.dll 供客户自研软件以动态库方式直接启动烧写器脱机烧写 （烧写器内需已装载好目标数据）。

详细原文见本目录 DLL说明.TXT。调用约定为 stdcall；下方以 Delphi 风格声明，其它语言按同样约定导入即可。

2. 导出函数

2.1 启动脱机烧写 — WPStarAutoProgRT

Function WPStarAutoProgRT(
  ComNumb: DWord;
  vSumXA, vSumXB: PDWord
): DWord; stdcall;
参数说明
ComNumb串口编号，如 COM5 传 5
vSumXA / vSumXB整数指针，回传 2 个校验和（低 16 位有效）

返回值（4 字节，从低到高为字节 1～4）：

  • 字节 3：通道号（0–11）；0xFF 表示未设置
  • 0xF506 / 0xF500：烧写成功
  • 0xF5xx（非 06/00）：烧写失败，xx 为错误代码
  • 其它：操作失败（含状态信息与错误代码）

2.2 读指定地址数据 — WPxReadAdressRT（非通用）

注意：本接口不是通用功能，仅部分特定 APP / 烧写器产品支持。 集成前请向我方确认当前产品是否开放；不支持的型号请勿调用。 
Function WPxReadAdressRT(
  ComNumb: DWord;
  rBufPT: Pointer;
  vAddrS, vLenB: DWord
): DWord; stdcall;
参数说明
ComNumb串口编号
rBufPT回传缓冲区指针（建议外部准备约 1KB）
vAddrS芯片首地址
vLenB读取长度，1–1024 字节

返回值判定与 WPStarAutoProgRT 相同（0xF506/0xF500 成功等）。

3. MAXWIZERRI.dll

MAXWIZERRI.dll 与 GenXxCmdLinM.exe 合并使用，用于解析烧写器返回数据并生成 Log。 部署时请与 GenXxCmdLinM.exe 放在同一目录（详见「② GenXxCmdLinM」）。 本动态库启动烧写接口（WPStarAutoProgRT）本身不依赖该 DLL。

4. 与其它启动方式的选择

场景建议
批处理、Shell、简易产线脚本GenXxCmdLinM.exe
MES / 自研上位机进程内调用MWGWPCMD.dll
客户自行通过 USB 串口按协议控制「④ 控制命令与响应（RV5）」

WizPro 系列烧写器基本控制命令和响应 · RV5

USB 串口直接控制 / 通信协议 / 命令与应答（PDF）
下载 PDF 新窗口打开

若浏览器无法内嵌预览 PDF，请使用上方「下载」或「新窗口打开」。原中文文件名：WizPro系列烧写器基本控制命令和响应-RV5.pdf

WizProGenX 系列二次开发的说明 · V0

二次开发 / 集成说明（PDF）
下载 PDF 新窗口打开

若浏览器无法内嵌预览 PDF，请使用上方「下载」或「新窗口打开」。原中文文件名：WizProGenX 系列二次开发的说明-V0.pdf