JMB58x Reverse Engineering

The JMicron JMB582 and JMB585 are SATA 6Gb/s host controllers with PCIe Gen3 interfaces. The JMB582 has one PCIe Gen3 lane and two SATA ports, while the JMB585 has two PCIe Gen3 lanes and five SATA ports.

Quick start

Software dependencies

• Python 3
• Documentation generator:

• lxml

• Python-Markdown

• PyYAML

Procedure

• Install dependencies.
• Dump the flash from your JMB58x card.
• Parse and print the configuration flash with ./tools/parse.py ..., where

... is the name of the binary you got when you dumped your JMB58x card's flash.

• Run make doc to generate XHTML documentation in

doc/generated.

Obtaining a flash image

In addition to dumping the flash of a JMB58x device, a flash image and proprietary flash tool for JMB58x devices can be downloaded from here.

Reverse engineering notes

See doc/Notes.md for my reverse engineering notes.

Machine-readable register documentation can be found in data/regs-jmb58x.yaml. Run make doc in the root of this repository to generate XHTML documentation in doc/generated, or view an online preview of the register documentation here.

License

Except where otherwise stated:

• All software in this repository (e.g., tools for parsing and generating flash

images/configuration data, etc.) is made available under the Zero-Clause BSD (0BSD) license.

• All copyrightable content that is not software (e.g., reverse engineering

notes, this README file, etc.) is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License.