rtltool.py

Tool for programming the Realtek RTL8762C SoC

Installation

To obtain this tool, clone this repository.

git clone https://github.com/cyber-murmel/rtltool.git

Download the RTL8762x MP Tool Kits(ZIP) from the vendor page and place it in the rtl8762c directory. This tool is compatible with the following versions of that zip:

• v1.0.5.8
• v1.0.6.2

Python modules

This tool depends on the python modules listed in the pyproject.toml. Run the following in the root of this repository to create a development environment and install the dependencies.

poetry shell
poetry install

To enter the environment again, just run poetry shell in the root of this repository.

Nix

Users of Nix or NixOS can simply run nix-shell to enter an environment with all necessary dependencies (except for vendor files).

Usage

To use this tool, activate the venv or enter the Nix shell as described in Installation.

usage: rtltool.py [-h] [-q | -v] [--port PORT] [--baud BAUD] [--retries RETRIES]
                  {read_mac,chip_id,read_flash,erase_flash,erase_region,write_flash,verify_flash} ...

rtltool.py - Tool for programming the Realtek RTL8762C SoC

positional arguments:
  {read_mac,chip_id,read_flash,erase_flash,erase_region,write_flash,verify_flash}
                        Run rtltool.py {command} -h for additional help
    read_mac            Read MAC address from OTP ROM
    chip_id             Read Chip ID from OTP ROM
    read_flash          Read flash content
    erase_flash         Perform Chip Erase on SPI flash
    erase_region        Erase a region of the flash
    write_flash         Write a binary blob to flash
    verify_flash        Verify a binary blob against flash

optional arguments:
  -h, --help            show this help message and exit
  -q, --quiet           turn off warnings
  -v, --verbose         set verbose loglevel
  --port PORT, -p PORT  Serial port device
  --baud BAUD, -b BAUD  Serial port baud rate used when flashing/reading
  --retries RETRIES, -r RETRIES
                        Number of retries before giving up