Merge "[docs] Add overview and compilation info."
diff --git a/README.md b/README.md
index 8b90b74..e990fe4 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,22 @@
-Fuchsia Open Source Template Repository
-=======================================
+# Zedmon Power Monitor
-This repository is a template that we will use when creating new open source
-repositories for Fuchsia.
+
+
+Zedmon is a device for measuring power consumption of electronics. It was
+created to assist the [Fuchsia](https://fuchsia.googlesource.com) power management
+efforts.
+
+## Features
+
+ * Can monitor up to 5A@28V (36V in upcoming rev 2).
+ * 0.25 mA resolution.
+ * Up to 3.5 KHz sample rate.
+ * Current sense circuitry isolated from USB interface.
+ * High and Low side sensing for detecting ground loops.
+ * Relay on power line for enabling/disabling power to the device under test.
+
+## More Infomation
+
+ * [Building the firmware and command line utility](docs/compilation.md)
+ * [USB Protocol](docs/usb_proto.md)
+ * [Schematic](pcb/zedmon.pdf)
diff --git a/docs/compilation.md b/docs/compilation.md
new file mode 100644
index 0000000..c76d564
--- /dev/null
+++ b/docs/compilation.md
@@ -0,0 +1,60 @@
+# Building and Installing Zedmon.
+
+## Firmware
+
+### Prereqs
+
+Make sure that you have an `arm-eabi-none` gcc toolchain and
+[`dfu-util`](http://dfu-util.sourceforge.net/) installed.
+
+### Building
+
+```bash
+> git clone https://fuchsia.googlesource.com/zedmon --recurse-submodules
+> cd zedmon/firmware
+> make
+```
+
+The builds output will end up in `./build-zedmon`.
+
+### Uploading
+
+To upload the firmware to zedmon, the device needs to be in DFU mode. To enter
+DFU mode:
+
+ 1. Hold down the `boot0` button.
+ 2. Press and release the `reset` button.
+ 3. Release the `boot0` button.
+
+ Once the device is in DFU mode, you can upload the firmware with `dfu-util`:
+
+ ```bash
+ > dfu-util -a 0 -s 0x08000000:leave -D build-zedmon/lk.bin -d 0483:df11
+ ```
+
+## `zedmon` Command Line Utility
+
+### Fetching Source
+
+The `zedmon` utility is written in Go. Because it is hosted on
+fuchsia.googlesource.com, it can not simply be fetched with `go get`. Instead
+you'll need to check it out manually:
+
+```bash
+> mkdir -p zedmonutil/src/fuchsia.googlesource.com
+> cd zedmonutil
+> export GOPATH=`pwd`
+> cd src/fuchsia.googlesource.com
+> git clone https://fuchsia.googlesource.com/zedmon
+> cd $GOPATH
+> go get fuchsia.googlesource.com/zedmon
+> go install fuchsia.googlesource.com/zedmon/cmd/zedmon
+```
+
+The output executable will be in `./bin/zedmon`.
+
+### Running
+
+Currently the `zedmon` utility simply gets the time delta between the local
+machine and the zedmon device then starts recording samples and saving them to
+`zedmon.csv` in the current directory.
diff --git a/docs/zedmon.jpg b/docs/zedmon.jpg
new file mode 100644
index 0000000..6ae08b1
--- /dev/null
+++ b/docs/zedmon.jpg
Binary files differ
