docs

docs/index.rst

@@ -1,10 +1,36 @@
-EFM8 Bootloader
-===============
+efm8
+====
 
-Talks to the factory Bootloader on EFM8 to flash firmware.
-The protocol is documented in AN945_.
+Flash via AN945: EFM8 Factory Bootloader HID.
+
+Usage
+-----
+
+Communication is over USB-HID. This is implemented via the `hidapi <https://github.com/trezor/cython-hidapi>`__ pthon wrapper for the `hidapi <https://github.com/signal11/hidapi>`__ native library.
+
+On linux you can use udev to grant access:
+
+::
+
+    echo 'SUBSYSTEM=="usb", ATTRS{idVendor}=="10c4", MODE="0666"' | sudo tee /etc/udev/rules.d/70-silabs.rules
+    udevadm trigger
+
+::
+
+    efm8 firmware.hex
+
+Also includes an example that resets a https://u2fzero.com/ into the bootloader and flashes in one command.
+
+::
+
+    u2fzero firmware.hex
+
+And a way to (slowly) read the firmware back
+
+::
+
+    efm8_read firmware.hex
 
-.. _AN945: https://www.silabs.com/documents/public/application-notes/AN945.pdf
 
 .. toctree::
    :maxdepth: 2