EC probing tool

(available since version 1.4.2)

NBFC comes with a EC probing tool: ec-probe.exe
It allows you to read from and write to the embedded controller's registers.
This tool might be useful if you try to create a new config for an yet unsupported notebook model.

Input values are interpreted as decimal numbers by default. Hexadecimal values may be entered by prefixing them with 0x.

Synopsis

usage: ec-probe.exe [--version] [--help] <command> [<args>]

Commands

dump
Dump all EC registers.

read <register>
Read a byte from a EC register.
Register range: 0-255

write <register> <value> [options]
Write a byte to a EC register.
Register range: 0-255
Value range: 0-255

options:

-v, --verbose                Be verbose

monitor [options]
Monitor all EC registers for changes (since 1.5.0).

options:

-t, --timespan <seconds>     Monitored timespan (default: infinite)
-i, --interval <seconds>     Set poll interval (default: 5)
-r, --report <path>          Create a report file at the specified path
-c, --clearly                Blanks out consecutive duplicate readings

Examples

Dump all EC registers into a file: ec-probe.exe dump > dump.txt

---

Write 0xFF to register 123: ec-probe.exe write 123 0xFF
123 is interpreted as decimal number. 0xFF is interpreted as hexadecimal number.

---

Read from register 123: ec-probe.exe read 123
Alternatively: ec-probe.exe read 0x7B

---

Monitor the EC registers and save a report: ec-probe.exe monitor -r report.txt
If no timespan is provided, ec-probe will run until you cancel it by pressing Ctrl + C.

---