sinowealth-kb-tool

这是一个小工具，用于读取和写入基于Sinowealth 8051的设备（键盘和鼠标）的闪存内容，因为它们似乎都有类似的ISP引导加载程序。

免责声明

这是一个实验性工具，因此请自行承担风险使用。

用法

读取

⚠️ 如果地址 <firmware_size-5> 上尚未设置LJMP（0x02）操作码，则读取操作将设置该操作码。当设置此操作码时，引导加载程序将认为主固件已启用，并在设备开机时跳转到它。大多数设备上已设置此操作码，因此读取操作 不应 导致任何问题。

⚠️ 在读取过程中，ISP引导加载程序将把 0x0001 - 0x0002 中的值重定向到 <firmware_size-4> - <firmware_size-3>。因此，生成的负载将与MCU闪存中实际布局的内存不同。

# reads firmware excluding isp bootloader 
sinowealth-kb-tool read -p nuphy-air60 foobar.hex

# reads only isp bootloader section
sinowealth-kb-tool read -p nuphy-air60 -b bootloader.hex

# full dump including firmware and bootloader
sinowealth-kb-tool read -p nuphy-air60 --full full.hex

# custom device
sinowealth-kb-tool read \
    --vendor_id 0x05ac \
    --product_id 0x024f \
    --firmware_size 61440 \
    --bootloader_size 4096 \ # optional
    --page_size 2048 \ # optional
    --isp_iface_num 1 \ # optional
    --isp_usage_page 0xff00 \ # optional
    --isp_usage 0x0001 \ # optional
    --isp_index 0 \ # optional
    --reboot false \ # optional
    foobar.hex

写入

⚠️ 与 读取 操作相同，ISP引导加载程序将把用于地址 0x0001-0x0002 的值写入到 <firmware_size-4> - <firmware_size-3>。

# overwrites firmware (does not touch the bootloader section)
sinowealth-kb-tool write -p nuphy-air60 foobar.hex

# custom device
sinowealth-kb-tool write \
    --vendor_id 0x05ac \
    --product_id 0x024f \
    --firmware_size 61440 \
    --bootloader_size 4096 \ # optional
    --page_size 2048 \ # optional
    --isp_iface_num 1 \ # optional
    --isp_usage_page 0xff00 \ # optional
    --isp_usage 0x0001 \ # optional
    --isp_index 0 \ # optional
    --reboot false \ # optional
    foobar.hex

# /etc/udev/rules.d/plugdev.rule
SUBSYSTEMS=="usb", ATTRS{idVendor}=="xxxx", ATTRS{idProduct}=="yyyy", MODE="0660", GROUP="plugdev"
SUBSYSTEMS=="usb", ATTRS{idVendor}=="0603", ATTRS{idProduct}=="1020", MODE="0660", GROUP="plugdev"

hid_open_path: failed to open IOHIDDevice from mach entry...