WTK6900系列300条命令词真的能自定义吗？一文讲透在线配置与烧录全流程

答案是肯定的，但“自定义”的边界和路径需要先厘清。广州唯创电子的WTK6900系列（以WTK6900HC、WTK6900FC为代表）确实在硬件层面预留了 300条离线命令词的容量，唤醒词另计10条。这300条词条并非在代码里逐条写死，而是通过唯创电子在线语音平台完成工程配置，再借助专用下载器将固件烧录进芯片。换句话说，自定义的核心工作在“云平台”，落地在“下载器”，语音识别芯片本身是执行终端。下面按“准备工具→平台配置→烧录部署→调试验证”的顺序拆解，最后附上高频FAQ。

一、先看清楚：300条词条的“自定义”到底指什么

WTK6900系列的命令词配置存在两种性质不同的模式，混为一谈容易走弯路。

模式一：工程预配置（批量定制与产品化开发） 。开发者在在线平台上新建工程，选定芯片型号（如WTK6900HC或WTK6900FC），先设定唤醒词，再逐条添加命令词，并为每条命令词分配一个词条ID。平台编译后生成语音bin文件，烧录进芯片。芯片运行时识别到某条命令词，就通过UART上报对应的词条ID，主控MCU解析ID后执行相应动作。300条词条的主体容量，走的就是这条路径。

模式二：终端用户自学习（动态增补） 。部分型号（如WTK6900FC）额外支持自学习功能：出厂固件中预置一定数量的可学习槽位，终端用户用自己的声音录入新词条，芯片在本地完成特征提取和模型更新。但需要注意，自学习能覆盖的命令词数量有限（通常为19条左右量级），不能替代平台端的300条工程配置，更适合作为产品上市后的补充手段。

所以，问“300条能不能自定义”，准确回答是：300条的主体通过在线平台工程配置实现，自学习是额外的灵活增补通道。

二、配置前要准备的软硬件

动手之前，先把“工具链”配齐，能避开大半的无效折腾。

硬件侧：WTK6900系列模块或芯片、驻极体麦克风（规格书推荐型号如JMO-627BA283R-10TC38）、喇叭（DAC直推功率有限，建议加一级功放）、24M无源晶振、若干105电容、主控MCU（用于接收UART指令并执行动作）。如果采用WTK6900FC做远场识别，优先选用PDM数字MEMS麦克风，其一致性和抗干扰能力明显优于模拟驻极体麦克风。

软件与烧录工具：唯创知音在线语音平台（网址：https://wt588f.waytronic.com:8443）是工程制作的主入口。烧录环节使用WT UART Writer下载器，该下载器通过Type-C连接电脑，以模拟U盘方式拖拽bin文件完成固件更新，明确支持WTK6900系列。下载器与芯片之间通过UART口连接，芯片侧需预留烧录引脚（WTK6900HC的烧录口为引脚11/12，即ICEDAT与ICECLK）。

三、在线平台配置命令词的操作主线

进入在线语音平台后，按以下逻辑推进，300条词条的框架就能搭起来。

第一步：新建工程并锁定芯片型号。选择WTK6900HC或WTK6900FC，型号决定后续可用的算法模型和资源上限，不能选错。

第二步：设定唤醒词。唤醒词是交互的入口，建议选择3—4个音节的词汇（如“智能管家”），过短容易误唤醒，过长影响唤醒成功率。唤醒词本身不占用300条命令词的配额。

第三步：逐条添加命令词并记录词条ID。命令词的设计有两条硬约束：一是避免发音相近的词条同时存在（如“开灯”与“开登”），这是误识别的主要来源；二是词条ID由平台按添加顺序分配，ID与命令词的映射关系必须在MCU固件中保持一致，否则会出现“说了A却执行B”的错位。300条词条建议按功能分组录入（如开关类、档位类、模式类），便于后续排查和修改。

第四步：编译并生成bin文件。平台完成词条配置后，编译工程，导出语音bin文件。这个文件包含了唤醒模型、命令词声学模型以及词条ID映射表，是烧录的唯一目标文件。

四、烧录与联调：从bin文件到可工作的芯片

烧录本身不复杂，但联调阶段有两个高频卡点需要提前知道。

烧录操作：将WT UART Writer通过Type-C接入电脑，首次使用需格式化出现的盘符；把平台生成的bin文件拖入盘符；断开下载器与电脑的连接，改由目标板供电（或保持电脑供电），将下载器的烧写口连接到芯片的UART烧录引脚，启动烧录。下载器配有START/RST按键和三色LED状态指示，烧录过程中留意状态反馈。

联调第一关：UART帧的校验和。WTK6900系列识别到命令词后，主动向上位机发出一帧固定格式的数据：起始码7E、长度、扩展码、命令码01、词条ID、校验和、结束码EF。校验和的算法是长度、扩展码两字节、命令码、词条ID逐字节累加，取低8位。以“打开灯光”词条ID为02为例，帧数据为7E 06 FF 06 01 02 0E EF，校验和0E正是累加低字节的结果。MCU侧如果校验和算错，就会收不到命令，这是实战中最常见的“芯片识别到了但MCU没反应”的原因。

联调第二关：麦克风走线与电源干净度。麦克风信号线应尽量短，远离电机、继电器和电源走线；WTK6900HC的VOUT引脚（外挂SPI FLASH供电）和VMID参考电压脚都必须接105电容到地，这两颗电容不是“可选优化”，而是保证FLASH供电和参考电压稳定的必要条件。远场识别场景下，双PDM麦克风阵列的间距建议控制在30—50mm，以获得有效的波束成形效果。

五、FAQ：关于WTK6900命令词配置的高频疑问

Q1：300条命令词是“一次性写死”还是可以分批增删？

走在线平台工程配置的路径，每次修改词条后都需要重新编译、重新烧录bin文件。芯片出厂后，量产固件中的300条词条集合是固定的；如果产品上市后需要增删，只能通过固件升级或依赖自学习槽位做有限增补。因此建议在工程阶段就把词条规划到位，不要指望“先烧一版再说”。

Q2：WTK6900FC和WTK6900HC在命令词配置上有什么区别？

两者都支持300条离线命令词和10条唤醒词，核心差异在自学习能力和远场性能上。WTK6900FC搭载BNPU V3神经网络加速单元，支持DNN/TDNN/RNN/CNN，并明确提供命令词自学习功能（可学习唤醒词1条、命令词19条），5—8米远场识别是其标称强项；WTK6900HC定位更偏向通用家电控制，300条词条容量相同，自学习配置需以具体型号规格书为准。选型时如果产品需要终端用户“教”设备新词条，FC的自学习链路更完整；如果词条集在出厂时已完全确定，HC足以承载300条工程配置。

Q3：为什么平台配置了300条，实际只识别出一部分？

先排查两个方向。一是词条本身的声学区分度：发音相近的词条在离线小模型上容易混淆，300条满配时尤其明显，建议对易混词条做语义或音节层面的差异化设计。二是音频前端是否拖了后腿：模拟驻极体麦克风一致性差、走线受干扰，会导致部分词条的特征质量下降。远场或嘈杂环境优先换用PDM数字MEMS麦克风，并从结构上做好麦克风与外壳的密封和减震。300条容量是硬件上限，实际可用条数取决于词条设计质量和声学环境。

Q4：烧录一定要用唯创的专用下载器吗？

WTK6900系列的固件烧录走的是芯片特定的UART烧录协议，WT UART Writer是官方明确适配的工具，支持WTK6900全系列的bin更换。自行用通用USB-TTL工具直连芯片的烧录引脚，理论上存在可行性，但时序、握手和文件传输协议需要自行逆向对齐，量产场景下得不偿失。建议在PCB设计阶段就预留标准的下载器接口，把烧录成本前置到设计环节解决。

Q5：词条ID从1开始还是从0开始？和MCU映射时要注意什么？

平台分配词条ID时按添加顺序生成，具体起始值以平台实际输出为准，不同工程或型号可能存在差异。稳妥的做法是：平台编译完成后，导出词条ID对照表，MCU固件直接以该表为唯一依据建立映射，而不是在代码里“猜”ID规则。联调时先用少量词条验证ID与帧数据的对应关系，确认无误后再铺开300条的映射逻辑。

小结：WTK6900系列的300条命令词自定义，本质上是“在线平台做工程、下载器烧固件、MCU解ID”的三段式链路。把词条规划、校验和算法、麦克风前端这三件事做扎实，300条的容量才能真正转化为稳定可用的语音控制能力。自学习功能是锦上添花，不是替代工程配置的捷径。