1.1 --- a/README.txt Tue Dec 14 01:06:53 2021 +0100
1.2 +++ b/README.txt Wed Feb 23 23:32:17 2022 +0100
1.3 @@ -90,14 +90,39 @@
1.4 https://wiki.kewl.org/dokuwiki/projects:nanu-nanu
1.5
1.6 Nanu Nanu can be deployed in the 5V-16M configuration on an Arduino
1.7 -Duemilanove with an "open drain" or "sink" circuit as described above. Then,
1.8 -the pload program provided by Pickle can be used to write the appropriate .hex
1.9 -file as in the following example (probably as a privileged user):
1.10 +Duemilanove with an "open drain" or "sink" circuit as described above.
1.11 +Typically, the following commands can be used to build and deploy Nanu Nanu to
1.12 +the Arduino board:
1.13 +
1.14 +make
1.15 +make -f 5V-16M.mk 57600
1.16 +
1.17 +The 5V-16M.mk file may need adjusting to use the appropriate UART device. Note
1.18 +that the indicated baud rate of 57600 is specifically related to the default
1.19 +Arduino bootloader's capabilities.
1.20 +
1.21 +Pickle can be built using the familiar convention:
1.22 +
1.23 +make
1.24 +make install
1.25 +
1.26 +The Makefile may need adjusting to indicate alternative installation locations
1.27 +and file ownership, although it may also be possible to override the default
1.28 +settings on the command line.
1.29 +
1.30 +With both tools deployed, the pload program provided by Pickle can be used to
1.31 +write the appropriate .hex file as in the following example (either as a
1.32 +privileged user or with access to the serial device granted via the
1.33 +appropriate group membership):
1.34
1.35 ./pload program /dev/ttyUSB0 examples/demo/demo.hex
1.36
1.37 Note that the Pickle configuration file (~/.pickle or ~/.pickle/config) will
1.38 -need to have the port and baudrate settings defined.
1.39 +need to have the baud rate setting defined. For example:
1.40 +
1.41 +BAUDRATE=115200
1.42 +
1.43 +This indicates the rate used to transfer data to the PIC32.
1.44
1.45
1.46
2.1 --- a/docs/wiki/Examples--demo Tue Dec 14 01:06:53 2021 +0100
2.2 +++ b/docs/wiki/Examples--demo Wed Feb 23 23:32:17 2022 +0100
2.3 @@ -26,6 +26,20 @@
2.4 Although such DMA channel interleaving is rather exotic, other techniques
2.5 employed by the example are likely to be applicable elsewhere.
2.6
2.7 +To communicate with the PIC32, observe the wiring instructions and then
2.8 +establish a serial connection at 115200 baud. For example, using the `screen`
2.9 +program on a system exposing the serial connection through a device associated
2.10 +with a USB port:
2.11 +
2.12 +{{{
2.13 +screen /dev/ttyUSB0 115200
2.14 +}}}
2.15 +
2.16 +The precise device naming details will vary between systems and depend on the
2.17 +nature of the USB devices already connected. Where a programming device such
2.18 +as an Arduino board is in use, it may already be associated with `ttyUSB0`,
2.19 +thus exposing the PIC32 itself as `ttyUSB1`.
2.20 +
2.21 == Hardware Details ==
2.22
2.23 The pin usage of this solution is documented below.