diff --git a/README.md b/README.md index 7789fff..d085015 100644 --- a/README.md +++ b/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 diff --git a/test-setup.jpg b/test-setup.jpg new file mode 100644 index 0000000..54cb26e Binary files /dev/null and b/test-setup.jpg differ