CommonPIC32

Changeset

155:05730ef435b1
2022-02-23 Paul Boddie raw files shortlog changelog graph Added programming and serial communication details. default tip
README.txt (file) docs/wiki/Examples--demo (file)
     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.