summaryrefslogtreecommitdiff
path: root/doc/loader.txt
diff options
context:
space:
mode:
Diffstat (limited to 'doc/loader.txt')
-rw-r--r--doc/loader.txt57
1 files changed, 57 insertions, 0 deletions
diff --git a/doc/loader.txt b/doc/loader.txt
new file mode 100644
index 0000000..eab20bb
--- /dev/null
+++ b/doc/loader.txt
@@ -0,0 +1,57 @@
+RVController Loader Setup and Usage
+===================================
+
+The loader is used to load programs in Intel HEX format into RVController's memory.
+
+To use it, connect digilines as shown:
+
++---------------+ +---------------+
+| Luacontroller | |\ | | Luacontroller |
+| |============| >|============| |
+| (loader) | |/ | |(RVController) |
++---------------+ Diode +---------------+
+ || || +---------------+
+ || || | Digiterms |
+ || ||=========| CRT Monitor |
++---------------+ || | |
+| Advanced | || | Channel |
+| Touchscreen | || | "monitordisp" |
+| | || +---------------+
+| Channel | ||
+| "touchscreen" | || +---------------+
++---------------+ || | Digiterms |
+ ||=========| Keyboard |
+ || | |
+ || | Channel |
+ || | "monitorkb" |
+ || +---------------+
+ ||
+ || +---------------+ \
+ || | Digiterms | |
+ ||=========| CRT Monitor | |
+ || | | |
+ || | Channel | |
+ || | "stdout" | |
+ || +---------------+ |
+ || +-- Optional, only needed
+ || +---------------+ | for program I/O
+ || | Digiterms | |
+ ||=========| Keyboard | |
+ || | | |
+ || | Channel | |
+ || | "stdin" | |
+ || +---------------+ /
+ vv
+ To other
+ peripherals
+
+Note that the advanced touchscreen must be connected before the loader Luacontroller is programmed.
+If the Luacontroller was accidentally programmed first, program it again after connecting the touchscreen.
+
+The diode may be from either digiline_routing or digicontrol.
+
+Once the loader is set up and RVController is ready to receive a program:
+1. On the loader touchscreen, select or unselect the "Run after load" option, depending on the desired behavior.
+2. Paste the contents of an Intel HEX file into the loader touchscreen, then click "Load"
+3. RVController will automatically reset, then addresses will scroll across the monitor display as data is loaded.
+4. When loading is complete, the program will automatically start if "Run after load" was selected in step 1.