From d7ecdb93fdb7939be9d31e8cbd889993c5b4027d Mon Sep 17 00:00:00 2001
From: Tim Crawford <tcrawford@system76.com>
Date: Thu, 6 Feb 2020 10:48:05 -0700
Subject: [PATCH] Add basic instructions for flashing

---
 README.md | 34 ++++++++++++++++++++++++++++++++++
 1 file changed, 34 insertions(+)

diff --git a/README.md b/README.md
index dff2a21..6fc58a6 100644
--- a/README.md
+++ b/README.md
@@ -37,3 +37,37 @@ Features specific to Atmel embedded controllers:
 Acronym | Feature                      | Description
 ------- | ---------------------------- | -----------
 USB     | Universal serial bus         | Can be used to provide access to EC functions either to the host or to a remote machine
+
+## Flashing
+
+Requirements:
+
+- [sdcc](http://sdcc.sourceforge.net/)
+- [Rust](https://www.rust-lang.org/)
+
+### Internal programmer
+
+Use this method for flashing a system already running System76 EC.
+
+```
+make BOARD=<vendor>/<model> flash
+```
+
+### External programmer
+
+Use this method for first-time flashing or flashing a bricked controller.
+
+**The system must not have any power!**
+
+1. Turn off the computer
+2. Unplug the AC adapter
+3. Remove the bottom panel
+4. Disconnect the battery
+5. Ground the laptop to the programmer
+6. Disconnect the keyboard from its port
+7. Attach the programmer to the keyboard port
+8. Flash the firmware
+
+```
+make BOARD=<vendor>/<model> isp
+```