# HG changeset patch
# User Paul Boddie <paul@boddie.org.uk>
# Date 1645655537 -3600
# Node ID 05730ef435b1965a500ef3ed52d9d0b7f453ef68
# Parent  c8a37eb472113152a7cbb3e861ab92e19cc026ad
Added programming and serial communication details.

diff -r c8a37eb47211 -r 05730ef435b1 README.txt
--- a/README.txt	Tue Dec 14 01:06:53 2021 +0100
+++ b/README.txt	Wed Feb 23 23:32:17 2022 +0100
@@ -90,14 +90,39 @@
 https://wiki.kewl.org/dokuwiki/projects:nanu-nanu
 
 Nanu Nanu can be deployed in the 5V-16M configuration on an Arduino
-Duemilanove with an "open drain" or "sink" circuit as described above. Then,
-the pload program provided by Pickle can be used to write the appropriate .hex
-file as in the following example (probably as a privileged user):
+Duemilanove with an "open drain" or "sink" circuit as described above.
+Typically, the following commands can be used to build and deploy Nanu Nanu to
+the Arduino board:
+
+make
+make -f 5V-16M.mk 57600
+
+The 5V-16M.mk file may need adjusting to use the appropriate UART device. Note
+that the indicated baud rate of 57600 is specifically related to the default
+Arduino bootloader's capabilities.
+
+Pickle can be built using the familiar convention:
+
+make
+make install
+
+The Makefile may need adjusting to indicate alternative installation locations
+and file ownership, although it may also be possible to override the default
+settings on the command line.
+
+With both tools deployed, the pload program provided by Pickle can be used to
+write the appropriate .hex file as in the following example (either as a
+privileged user or with access to the serial device granted via the
+appropriate group membership):
 
 ./pload program /dev/ttyUSB0 examples/demo/demo.hex
 
 Note that the Pickle configuration file (~/.pickle or ~/.pickle/config) will
-need to have the port and baudrate settings defined.
+need to have the baud rate setting defined. For example:
+
+BAUDRATE=115200
+
+This indicates the rate used to transfer data to the PIC32.
 
 
 
diff -r c8a37eb47211 -r 05730ef435b1 docs/wiki/Examples--demo
--- a/docs/wiki/Examples--demo	Tue Dec 14 01:06:53 2021 +0100
+++ b/docs/wiki/Examples--demo	Wed Feb 23 23:32:17 2022 +0100
@@ -26,6 +26,20 @@
 Although such DMA channel interleaving is rather exotic, other techniques
 employed by the example are likely to be applicable elsewhere.
 
+To communicate with the PIC32, observe the wiring instructions and then
+establish a serial connection at 115200 baud. For example, using the `screen`
+program on a system exposing the serial connection through a device associated
+with a USB port:
+
+{{{
+screen /dev/ttyUSB0 115200
+}}}
+
+The precise device naming details will vary between systems and depend on the
+nature of the USB devices already connected. Where a programming device such
+as an Arduino board is in use, it may already be associated with `ttyUSB0`,
+thus exposing the PIC32 itself as `ttyUSB1`.
+
 == Hardware Details ==
 
 The pin usage of this solution is documented below.