HiTool烧写工具安装、驱动配置与烧写失败排查指南

简介海思HiTool烧写工具是一套面向机顶盒、电视主板及海思芯片方案的硬件烧录与调试工具包适合嵌入式开发、维修调试与产线烧写人员排查镜像写入、寄存器读写、开机画面制作等问题。压缩包共1220个文件约166.47MB以jar程序组件、cfg配置、chip芯片参数、dll动态库、svf与xml描述文件、tcl脚本及exe工具为主并含gif、png界面素材和properties配置目录按工具与芯片型号组织便于按模块检索。工具集覆盖HiBurn镜像烧写与上载、HiDebugger调试信息抓取与码流录制、HiLoader升级包制作、HiReg图形化寄存器/内存读写、HiFastplay开机画面与瞬播镜像制作等功能可帮助读者快速了解烧录工具组成、熟悉调试流程并定位常见使用问题。目前已有3251人学习适合需要查阅海思烧录工具结构与调试思路的开发者参考。1. HiTool 烧写工具装完识别不到板子先查驱动和路径不是安装包第一次装 HiTool 烧写工具最容易翻车的不是安装包损坏而是驱动没注册、路径带中文、主程序没用管理员权限。某开发者把工具包解压到桌面“新建文件夹”接上板子点烧写状态栏一直停在握手换了三根线才怀疑环境。这个场景在板端调试、样机验证和量产前小批烧写里很常见装不好不会报大错只会让你在“设备无响应”和“烧写超时”之间来回猜。HiTool 烧写工具适合要反复烧镜像、看分区、抓串口日志的人。下面按环境、安装、参数、排错、验证走一遍新手能照着做熟手重点看版本对齐和避坑记录。2. 环境准备与版本对齐HiTool 工具包、USB 驱动和镜像包怎么配HiTool 不是源码软件那种./configure make的路子拿到手的通常是工具包、驱动目录、板级配置和一组镜像文件安装重点在“主机环境干净、驱动同源、目录可写”。我一般先把环境列成一张表再动手解压这样后面少一半返工。主机、USB 口、串口线、镜像校验和这四项里任何一项对不上烧写都会表现成“工具不认板子”。2.1 主机环境先列清Windows 位数、USB 口和串口线主机优先用 64 位 Windows 物理机如果是虚拟机USB 设备要直通不要把板子插在宿主机上却让虚拟机里的工具找设备。USB 口优先主板后置口少接无源 Hub尤其是板子靠 USB 供电或握手阶段电流波动时前置口和延长线很容易让烧写卡在下载 loader。串口线单独确认线序TX/RX/GND 该交叉的交叉GND 必须共地。# 查看系统版本和位数HiTool 一般跑在 64 位 Windows 主机上 Get-CimInstance Win32_OperatingSystem | Select-Object Caption, Version, OSArchitecture # 接板子前后各跑一次确认多出来的是哪个 COM 口 Get-CimInstance Win32_SerialPort | Select-Object DeviceID, Name, PNPDeviceID # 查看 USB 控制器状态排除外接 Hub 供电不足 Get-CimInstance Win32_USBController | Select-Object Name, Status这段命令做三件事Win32_OperatingSystem看系统位数OSArchitecture不是 64 位就别急着往下装Win32_SerialPort用来对比插拔板子前后的串口列表多出来的COMx才是目标口Win32_USBController只看状态Status为OK不代表供电一定够但出现异常项时先换口更省时间。参数里Select-Object只是裁字段不影响系统状态。项目建议做法检查点主机64 位 Windows物理机或 USB 直通虚拟机设备管理器能持续看到目标 COM 口USB 口主板后置 USB 2.0 口优先不经过无源 Hub 和长延长线串口线USB 转串口线加杜邦线TX/RX 交叉GND 共地工具目录英文短路径单独工作区路径无中文、无空格、可写镜像包与板级配置同批镜像哈希与清单一致提示工具包不要放在 OneDrive、网盘同步目录或桌面中文目录里烧写中途同步锁文件会让日志写入失败。2.2 版本选择不追新工具包、芯片列表、镜像包三者对齐HiTool 这类烧写工具的版本差异主要不在界面而在芯片列表、驱动签名和分区表格式。老工具包可能只认老板卡新工具包未必兼容旧驱动从别的项目随手拷一个驱动补进去表面能装握手阶段照样断。判断版本是否对路我一般看三处打开工具后芯片下拉列表里有没有目标板卡对应项驱动目录和主程序是不是同一批解压出来的镜像包里的清单文件能不能和分区表逐项对上。# 对比工具包和镜像包的 SHA256避免拷贝过程中截断 Get-FileHash .\images\boot.img -Algorithm SHA256 Get-FileHash .\images\rootfs.img -Algorithm SHA256Get-FileHash的-Algorithm SHA256用来生成校验值和资源目录里的清单逐项比对。镜像文件大拷贝到 U 盘、解压、再复制到工作区任何一步中断都可能得到一个“大小看着对、内容不完整”的文件。烧写工具通常只在校验阶段报错前面握手和擦除都正常容易误判成板子问题。对齐项看什么不对齐的表现工具包与芯片列表下拉列表是否有目标板卡工具能开选不到芯片或提示不支持工具包与驱动是否同一压缩包内设备管理器有感叹号握手超时镜像与分区表文件名、大小、偏移是否匹配烧写成功但启动无日志镜像与板级配置存储介质类型是否一致擦除失败或分区重叠注意工具包里的驱动和主程序尽量同源不要从别处随便补一个“看着能装”的驱动。2.3 目录与权限解压位置、杀毒白名单和编码工作目录我习惯固定成C:\HiToolWork下面分tool、driver、images、log四个子目录。工具、驱动、镜像、日志分开后面排错时能快速判断是工具缓存还是镜像问题。路径短还有一个好处某些老工具对长路径和中文路径处理不严日志文件写不进去时只给一个笼统失败提示。# 建一个短英文工作目录工具、驱动、镜像分开放 $root C:\HiToolWork New-Item -ItemType Directory -Force -Path $root\tool, $root\driver, $root\images, $root\log | Out-Null # 确认目录可写并查看当前路径 $root Test-Path $root\logNew-Item -ItemType Directory -Force会补建不存在的层级已存在时不报错Out-Null只是不把创建结果刷屏。Test-Path返回True只代表目录存在真正写入还要看权限。我一般会在log目录里手动新建一个空文本再删掉确认当前用户有写权限。杀毒软件如果会对 exe 和驱动做实时扫描把工作目录加进排除项比烧写中途被拦下来再找原因省事。3. 安装落地HiTool 解压、驱动注册和首次启动的具体步骤安装这一步不要按“下一步下一步”的思维走。工具包大多是绿色目录真正要落地的是解压位置、驱动注册和首次启动权限。顺序反过来先双击主程序再补驱动工具会把“设备未连接”写进配置缓存后面即使驱动装好也容易读到旧状态。我的顺序是先解压到固定目录再装驱动最后以管理员身份启动并指定工作区。3.1 解压与目录规范别在压缩包里直接双击压缩包直接双击打开时系统会解压到临时目录主程序能启动但驱动目录、配置文件和日志目录的相对路径容易断。正确做法是先完整解压到C:\HiToolWork\tool再看顶层目录结构确认主程序、驱动目录、配置文件都在。# 假设工具包已放到公共下载目录先解压到工作目录 $zip C:\Users\Public\Downloads\HiTool_Package.zip $dst C:\HiToolWork\tool Expand-Archive -Path $zip -DestinationPath $dst -Force # 列出顶层文件确认主程序、驱动目录和配置文件都在 Get-ChildItem $dst | Select-Object Name, Length, LastWriteTimeExpand-Archive的-Path指向压缩包-DestinationPath指向工作目录-Force覆盖同名文件。解压后不要只看有没有 exe还要看driver、config、image这类目录是否齐全。如果压缩包是 7z 或 rar 格式用对应的解压工具解到同一目录不要解压到一半就运行主程序。顶层文件列表里如果出现多层同名目录比如tool\tool\HiTool.exe把内层目录整体移到C:\HiToolWork\tool下保持路径短。3.2 驱动注册USB 烧写驱动和串口驱动分开装HiTool 连接板子通常涉及两类驱动USB 烧写驱动和 USB 转串口驱动。前者负责握手和下载后者负责看日志。两类驱动分开装装完分别插拔确认。驱动目录里如果有inf文件用管理员 PowerShell 注册如果驱动包自带安装脚本优先按包内说明走不要混用不同来源的驱动。# 以管理员身份打开 PowerShell 后执行安装驱动目录里的 inf $driverDir C:\HiToolWork\driver Get-ChildItem $driverDir -Filter *.inf -Recurse | ForEach-Object { pnputil /add-driver $_.FullName /install } # 查看已安装驱动包确认没有黄色感叹号对应项 pnputil /enum-drivers | Select-String -Pattern USB|Serial|HiToolGet-ChildItem -Filter *.inf -Recurse会递归找驱动目录里的安装信息文件pnputil /add-driver的/install表示加入驱动仓库后立即尝试安装。执行完不要马上点烧写先把板子拔掉再插上让系统重新枚举设备。pnputil /enum-drivers只是辅助确认驱动包存在真正要看的是设备管理器里对应设备有没有黄色感叹号。驱动签名报错时优先换同源签名驱动或更新系统证书不要长期靠关闭签名检查硬撑环境。注意驱动安装完必须重新插拔板子必要时重启一次只装驱动不重新枚举工具仍然会读旧设备状态。3.3 首次启动与工作区设置管理员运行、日志目录、语言和编码首次启动用管理员权限尤其是工具要注册驱动、访问 USB 设备、写系统临时目录时。启动后先设置工作区到C:\HiToolWork日志目录指向C:\HiToolWork\log不要用工具默认的安装目录。默认目录可能在Program Files下普通权限写日志会失败烧写失败时连日志都找不到。# 从命令行以管理员身份启动主程序便于复现启动参数 Start-Process -FilePath C:\HiToolWork\tool\HiTool.exe -Verb RunAs # 启动后确认日志目录可写 New-Item -ItemType Directory -Force -Path C:\HiToolWork\log | Out-Null Get-ChildItem C:\HiToolWork\logStart-Process的-Verb RunAs会弹管理员授权适合首次启动和驱动注册后的第一次运行。New-Item -Force保证日志目录存在Get-ChildItem看目录是否为空。工具界面里如果有语言、编码、日志级别选项日志级别先开到debug等烧写跑通再降回info。第一次启动如果系统防火墙弹窗只允许专用网络即可不要把所有网络都放开。4. 烧写参数配置HiTool 里芯片、介质、分区表和地址怎么填烧写参数错通常错在两处芯片和存储介质没对齐分区表和镜像地址没对齐。HiTool 的工作方式可以理解成“先握手再下载引导再按分区表擦除和写入最后回读校验”。握手靠驱动和启动模式写入靠分区表。前面环境没问题后面还失败就把注意力放到介质类型、分区偏移和擦除策略上。4.1 新建烧写任务芯片型号和烧写介质先对齐新建任务时先选芯片再选烧写介质最后选连接方式。芯片下拉列表里选目标板卡对应项不要选“相近型号”碰运气存储介质要看板子上实际焊接的是 eMMC、SPI NAND 还是 SPI NOR选错后擦除命令可能发得出去但写入地址全偏。连接方式上USB 适合调试阶段反复烧串口速度慢但线序简单网口要先确认工具和板子在同一网段。选项什么情况选常见误选芯片型号与板卡配置一致选相近型号握手能过但分区不认存储介质与焊接存储一致eMMC 选成 NAND擦除失败连接方式USB 优先调试串口备用网口未配 IP 就点烧写分区表从板级配置导入或手填沿用旧项目分区表镜像路径指向工作区images指向下载目录文件被移动新建任务后先保存一份配置到C:\HiToolWork\config不要直接覆盖工具自带模板。后面如果换镜像、换板子复制一份配置改文件名比在同一个任务上反复改参数更容易回退。4.2 分区表与镜像地址XML 配置逐项拆分区表是烧写配置里最不能拍脑袋的部分。offset是相对存储介质起始的偏移size是分区大小image是镜像文件。三项要同时满足地址不重叠、大小不小于镜像实际大小、镜像文件名和清单一致。下面是一份字段关系示例地址和大小必须按板级手册替换不能照抄。!-- 示例分区表offset 和 size 必须按板级配置替换 -- partitions partition nameboot offset0x00000000 size0x00100000 imageboot.img/image /partition partition namekernel offset0x00100000 size0x00400000 imagekernel.img/image /partition partition namerootfs offset0x00500000 size0x02000000 imagerootfs.img/image /partition /partitionsname要和镜像清单、启动参数里的分区名对得上offset从介质起始算前一个分区的offset size不能超过后一个分区的offsetsize要留余量镜像刚好等于分区大小时坏块管理和对齐可能让写入失败。image用相对工作区的路径不要写绝对路径换机器时少改一处。常见做法是先导出旧板子的分区表备份再在新配置上改不要从空表开始猜。字段含义检查方法name分区名与镜像清单、启动参数一致offset介质内偏移与上一分区结束地址不重叠size分区容量大于镜像实际大小并留余量image镜像文件文件存在且哈希匹配4.3 擦除策略与烧写选项全擦、按区擦和校验擦除策略决定风险。全擦适合换系统或分区表整体变更按区擦适合只更新rootfs或调试单个镜像。全擦前确认引导镜像可用否则擦完起不来只能重新找烧写模式。校验选项建议打开烧完回读比对比看到“成功”两个字更可靠。[burn] erase_modepartition # partition / full / none verify_after_burn1 # 烧完回读校验 reset_after_burn1 # 烧完复位 log_leveldebug # 首次调试开 debug跑通后改 infoerase_modepartition只擦目标分区适合日常更新full是全擦换分区表时用none只写不擦除非确认目标区域已经是空片。verify_after_burn1打开回读校验reset_after_burn1烧完自动复位方便看串口启动日志。log_level首次开debug日志会变大跑通后降级。注意全擦前把旧分区表和可用引导镜像备份到C:\HiToolWork\images\backup不要只留在工具缓存里。5. 避坑与排查HiTool 烧写失败的五个现场记录烧写失败不是玄学按连接、握手、镜像、掉线、启动五段查比反复重装工具有效。下面五条是我踩过的现场记录每条按现象、原因、解决写。工具界面给的提示通常很粗真正有用的信息在设备管理器、串口日志和烧写日志末尾。5.1 现象设备管理器没有 COM 口现象是插上板子后设备管理器端口列表没有新增HiTool 里也选不到串口。原因通常是 USB 转串口驱动没装、线序接错、板子没供电或者串口线只接了 TX/RX 没接 GND。解决时先换 USB 口再查驱动最后量线序。# 插拔板子前后各跑一次对比串口列表变化 Get-CimInstance Win32_PnPEntity | Where-Object { $_.Name -match COM\d } | Select-Object Name, DeviceID, StatusWin32_PnPEntity比Win32_SerialPort覆盖更全有些驱动不会把设备归到串口类但名称里仍带COMx。Where-Object用正则筛出带 COM 口名称的设备Status看是否OK。如果插拔前后列表没变化先查线和供电有变化但带感叹号回到第 3 章重新注册驱动。5.2 现象HiTool 一直停在握手或下载 loader现象是工具能选芯片点烧写后状态一直停在握手日志没有进度。原因多半是 USB 烧写驱动没生效、板子没进烧写模式、USB 口供电不足或者主程序不是管理员权限。解决顺序是确认板子启动模式换后置 USB 2.0 口以管理员身份重启工具再重新插拔板子。# 查看当前存在的 USB 和端口设备确认目标设备是否枚举 Get-PnpDevice -PresentOnly | Where-Object { $_.Class -in (USB,Ports) } | Select-Object Status, Class, FriendlyName, InstanceIdGet-PnpDevice -PresentOnly只看当前在线设备Class筛USB和PortsStatus为Error或Unknown的设备优先处理。InstanceId用来区分同一个口上插过不同设备的情况。如果列表里根本没有目标设备问题在连接和启动模式有设备但握手不过问题在驱动和权限。5.3 现象烧写成功但启动无日志现象是工具提示烧写完成串口却没有任何启动输出。原因可能是镜像不匹配、分区地址错、启动参数没更新或者串口波特率不对。解决时先校验镜像哈希再对照旧分区表检查偏移最后确认串口工具波特率和板子一致。# 校验镜像与清单确认文件没有截断 Get-FileHash .\images\*.img -Algorithm SHA256 | Format-Table -AutoSizeGet-FileHash对images下所有镜像生成 SHA256Format-Table -AutoSize让结果按列对齐。哈希对不上就重新拷贝镜像哈希对得上但启动无日志重点查分区表和启动参数不要继续反复烧同一组文件。串口工具先设 115200 或板级手册写的波特率再看有没有乱码。5.4 现象烧到一半断开或超时现象是进度条走到一半停住日志末尾出现 timeout 或设备断开。原因常见于 USB Hub 供电不足、线材接触不良、杀毒软件扫描大文件、日志盘空间不足。解决时直连主板后置口换短 USB 线把工作目录加进杀毒排除项清日志目录。# 查看工作盘剩余空间和最近日志 Get-PSDrive C | Select-Object Used, Free Get-ChildItem C:\HiToolWork\log -Filter *.log | Sort-Object LastWriteTime -Descending | Select-Object -First 3 Name, Length, LastWriteTimeGet-PSDrive C看Free剩余空间小于镜像总大小时先清理Get-ChildItem按最后写入时间取最近三个日志Length异常小可能说明日志写到一半被中断。timeout 出现后不要连续点重试先拔插板子、看设备管理器状态再重新进烧写模式。5.5 现象重复烧写后工具报分区重叠或地址非法现象是同一个工具换了镜像后提示分区重叠、地址非法或者烧写直接拒绝开始。原因通常是分区表没更新、旧配置缓存还在、镜像大小超过分区容量。解决时先备份旧配置再清理工具缓存重新导入分区表最后检查offset size是否越界。# 备份并清理旧配置缓存保留日志 Copy-Item C:\HiToolWork\tool\config C:\HiToolWork\config_bak -Recurse -Force Remove-Item C:\HiToolWork\tool\config\*.bak -Force -ErrorAction SilentlyContinueCopy-Item -Recurse -Force先把配置目录整体备份Remove-Item只清理.bak缓存文件不动主配置。清理后重新导入分区表不要直接在旧任务上改地址。分区重叠的本质是前一个分区结束地址大于后一个分区起始地址拿计算器加一遍比在界面里反复猜快。6. 装完验证HiTool 烧写跑通的三层检查装完不等于跑通我一般按连接层、烧写层、启动层做三层验证。连接层看设备枚举烧写层看日志和校验启动层看串口能不能到提示符。三层都过才算这套环境能复现。层级检查动作通过标准连接层插拔板子看设备管理器 COM 口和 USB 状态有新增设备无黄色感叹号烧写层看烧写日志末尾和镜像哈希无 timeout校验通过启动层串口工具看启动日志能到登录提示符或应用输出# 汇总验证串口、最近烧写日志、镜像哈希 Get-CimInstance Win32_SerialPort | Select-Object DeviceID, Name Get-Content C:\HiToolWork\log\burn_latest.log -Tail 30 Get-FileHash C:\HiToolWork\images\*.img -Algorithm SHA256Get-Content -Tail 30只看日志最后三十行重点找timeout、verify fail、reset这几个词Get-FileHash再对一遍镜像防止烧写后文件被替换。三层里任何一层不过都回到对应章节查不要直接重装工具。从那以后我每次换板子或换工具包都强制走一遍连接、烧写、启动三层检查再开始批量烧写。希望帮到你。本文还有配套的精品资源点击获取