image of test setup and basic usage instructions

README.md

@@ -9,6 +9,8 @@ This is very much work in progress but does manage to demonstrate several things
 It's made up of two parts. `6502-contoller` is an Arduino firmware for interacting
 with the 6502 and `6502-loader` is a python script to interact with the Arduino.
 
+![test setup with Nucleo F401RE](test-setup.jpg "Test Setup")
+
 ## 6502-contoller
 This Arduino firmware started off fairly similarly to Ben's monitor firmware but I
 needed a couple additional things. As I didn't have the clock module it also provided
@@ -42,4 +44,17 @@ This part interacts with the Arduino firmware. In it's basic flow it handles sev
 At this point the script can be exited and the 6502 will continue to run. A normal terminal
 can be opened to stop the clock and use single stepping from the devboard.
 
+## Usage
+The Arduino firmware should be fairly straight forward. If you're using a similar Nucleo
+devboard you should be able to install the STM32 boards from the Board Manager. The `6502-loader`
+requires `python3`, `virtualenv` and `pip`. It can be setup and run as follows.
+
+```
+git clone https://gitlab.com/morganrallen/6502-hacking.git
+cd 6502-hacking
+virtualenv .
+. bin/activate
+./6502-loader --port /dev/ttyACM0 a.out --start
+```
+
 [Ben Eater's 6502]: https://eater.net/6502