0.9.1: Minor update

thanks4opensource · Nov 8, 2020 · 8d90332 · 8d90332
1 parent 76542e0
commit 8d90332
Show file tree

Hide file tree

Showing 9 changed files with 100 additions and 54 deletions.
diff --git a/README.html b/README.html
@@ -20,9 +20,9 @@
 <li>Complex triggering via user-defined state machine supporting combinations of sequential (&#8220;A then B then C&#8221;) and logical-OR (&#8220;A or B or C&#8221;) conditionals</li>
 <li>Output to VCD and other file formats for export to waveform viewing software <a href="#footnote_1"><sup>1</sup></a></li>
 </ul></li>
-<li>Live monitoring and logging of digital, analog, USART (sync/async), SPI (MOSI/MISO), and I2C data</li>
+<li>Live monitoring and logging of digital, analog, USART (sync/async), SPI (MOSI/MISO), and I2C (master/slave/TX/RX) data</li>
 <li>Simple dual-channel approx. 1 MHz digital storage oscilloscope, approx. 5K sample buffer depth (10K if single channel)</li>
-<li>3 channel digital pulse train generator with user-defined frequency and per-channel duty cycle and polarity.</li>
+<li>3 channel digital pulse train generator with user-defined frequency and per-channel duty cycle and polarity</li>
 <li>Bidirectional bridge/converter from USART/UART (async/synchro), SPI (master/slave), or I2C &#8230; to USB &#8230; to host terminal, UNIX socket, or UNIX pty device file</li>
 <li>8-bit parallel output counter (binary or gray code)</li>
 <li>Host terminal ascii or binary input data to 8-bit parallel output</li>
@@ -360,7 +360,7 @@ <h3 id="nlewtrsbntmm“notlongenoughwanttoreadsomebutnottoomuchmore”">NLE;WTRS
 
 <p>A valid criticism &#8230; but there is hope. That&#8217;s why you, the sophisticated user, chose to read this section. ;) Remember all that stuff that got printed when the program started?</p>
 
-<pre><code>    buck50.py 0.9.0
+<pre><code>    buck50.py 0.9.1
     Copyright 2020 Mark R. Rubin aka &quot;thanks4opensource&quot;
     This is free software with ABSOLUTELY NO WARRANTY.
     For details type &quot;warranty&quot; or &quot;help warranty&quot;.
@@ -541,15 +541,15 @@ <h4 id="buck50.pystartupanddeviceconnection">buck50.py startup and device connec
 <p>Normal startup:</p>
 
 <pre><code>    $ buck50.py
-    buck50.py 0.9.0
+    buck50.py 0.9.1
     Copyright 2020 Mark R. Rubin aka &quot;thanks4opensource&quot;
     This is free software with ABSOLUTELY NO WARRANTY.
     For details type &quot;warranty&quot; or &quot;help warranty&quot;.
     Type &quot;using&quot; for program usage.
     Type &quot;help&quot; for commands, configurations, parameters, values.
     Connecting to buck50 device (press CTRL-C to abort ...  )
     Firmware identity match: 0xea017af5
-    Firmware version  match: 0.9.0
+    Firmware version  match: 0.9.1
     Device serial number:    123456789abcdef987654321
     Found /usr/bin/pulseview and /usr/bin/gnuplot. Have now set: 
     configure logic autodump=enabled oscope autodump=enabled dump output=file auto-digital=enabled auto-analog=enabled digital-frmt=csv viewer-csv=gnuplot viewer-vcd=pulseview
@@ -2382,11 +2382,13 @@ <h4 id="usartcommand"><code>usart</code> command</h4>
 
 <h5 id="usartconfiguration"><code>usart</code> configuration</h5>
 
-<pre><code>    $1.50: help usart usart 
+<pre><code>    $1.50: help usart usart
     Help for configuration &quot;usart&quot; (e.g. &quot;usart usart&quot;):
     Configuration for async/sync (UART/USART) serial peripheral on ports PA9(TX),
         PA10(RX) and PA8(clock) (if &quot;ports=pa8-10&quot;) or ports PA2(TX), PA3(RX),
         PA1(RTS) and PA0(CTS) (if &quot;ports=pa0-3&quot;)
+      - Note &quot;datalen=7bits&quot; with &quot;parity=none&quot;, or &quot;datalen=9bits&quot; with other than
+        &quot;parity=none,&quot; not supported.
     Command/configuration usage:
        usart [&lt;parameter&gt;=&lt;value&gt; ...] [&lt;action&gt;]
     Actions:
@@ -2398,15 +2400,15 @@ <h5 id="usartconfiguration"><code>usart</code> configuration</h5>
         recv=           Receive RX data on port PA10
         ports=          Select one of two hardware USARTs (by PAx-y port...
         baud=           Baud rate for both xmit and recv if &quot;synchro=ena...
-        datalen=        Number of data bits
+        datalen=        Number of data bits. See &quot;help usart usart&quot; for ...
         stoplen=        Number of stop bits
-        parity=         Generate parity bit
+        parity=         Parity. See &quot;help usart usart&quot; for restrictions ...
         synchro=        Async(UART)(no clock) or synchronous(USART) mode
-        idle=           Clock output level at idle in &quot;synchro=enabled&quot; m...
+        idle=           Clock output level at idle in &quot;synchro=enabled&quot; ...
         phase=          Clock edge to sample bit at in &quot;synchro=enabled&quot;...
         lastclok=       Last clock pulse in &quot;synchro=enabled&quot; mode
         gpio=           Ports output slew rate
-        rate=           Byte output data rateSee &quot;Time/Frequency Errors&quot;...
+        rate=           Byte output data rate. See &quot;Time/Frequency Error...
         tx-timeout=     Wait for hardware TX ready. See &quot;Time/Frequency ...
         rx-wait=        Wait for hardware RX ready. See &quot;Time/Frequency ...
         tx-data=        Byte to xmit in &quot;monitor&quot; command if &quot;synchro=en...
@@ -2484,9 +2486,9 @@ <h5 id="usartparametersandactions"><code>usart</code> parameters and actions</h5
 
     $1.50: help usart datalen=
     Help for parameter &quot;datalen=&quot; (e.g. &quot;usart usart datalen=&quot;):
-    - Number of data bits
+    - Number of data bits. See &quot;help usart usart&quot; for restrictions with &quot;parity=&quot;.
     Current value: 8bits
-    Valid values:  &quot;8bits&quot; or &quot;9bits&quot;
+    Valid values:  &quot;7bits&quot;, &quot;8bits&quot;, or &quot;9bits&quot;
     Type &quot;help usart usart&quot; for list of usart configuration parameters
     Type &quot;help usart&quot; for command description
 
@@ -2500,7 +2502,7 @@ <h5 id="usartparametersandactions"><code>usart</code> parameters and actions</h5
 
     $1.50: help usart parity=
     Help for parameter &quot;parity=&quot; (e.g. &quot;usart usart parity=&quot;):
-    - Generate parity bit
+    - Parity. See &quot;help usart usart&quot; for restrictions with &quot;datalen=&quot;.
     Current value: none
     Valid values:  &quot;none&quot;, &quot;even&quot;, or &quot;odd&quot;
     Type &quot;help usart usart&quot; for list of usart configuration parameters

diff --git a/README.md b/README.md
@@ -8,9 +8,9 @@ buck50: Test and measurement firmware for "Blue Pill" STM32F103
     * Units may be ganged for increased number of channels
     * Complex triggering via user-defined state machine supporting combinations of sequential ("A then B then C") and logical-OR ("A or B or C") conditionals
     * Output to VCD and other file formats for export to waveform viewing software [<sup>1</sup>](#footnote_1)
-* Live monitoring and logging of digital, analog, USART (sync/async), SPI (MOSI/MISO), and I2C data
+* Live monitoring and logging of digital, analog, USART (sync/async), SPI (MOSI/MISO), and I2C (master/slave/TX/RX) data
 * Simple dual-channel approx. 1 MHz digital storage oscilloscope, approx. 5K sample buffer depth (10K if single channel)
-* 3 channel digital pulse train generator with user-defined frequency and per-channel duty cycle and polarity.
+* 3 channel digital pulse train generator with user-defined frequency and per-channel duty cycle and polarity
 * Bidirectional bridge/converter from USART/UART (async/synchro), SPI (master/slave), or I2C ... to USB ... to host terminal, UNIX socket, or UNIX pty device file
 * 8-bit parallel output counter (binary or gray code)
 * Host terminal ascii or binary input data to 8-bit parallel output
@@ -326,7 +326,7 @@ After reading the above, an reasonable reaction might be: *You want me to type a
 
 A valid criticism ... but there is hope. That's why you, the sophisticated user, chose to read this section. ;) Remember all that stuff that got printed when the program started?
 
-        buck50.py 0.9.0
+        buck50.py 0.9.1
         Copyright 2020 Mark R. Rubin aka "thanks4opensource"
         This is free software with ABSOLUTELY NO WARRANTY.
         For details type "warranty" or "help warranty".
@@ -500,15 +500,15 @@ Commandline arguments:
 Normal startup:
 
         $ buck50.py
-        buck50.py 0.9.0
+        buck50.py 0.9.1
         Copyright 2020 Mark R. Rubin aka "thanks4opensource"
         This is free software with ABSOLUTELY NO WARRANTY.
         For details type "warranty" or "help warranty".
         Type "using" for program usage.
         Type "help" for commands, configurations, parameters, values.
         Connecting to buck50 device (press CTRL-C to abort ...  )
         Firmware identity match: 0xea017af5
-        Firmware version  match: 0.9.0
+        Firmware version  match: 0.9.1
         Device serial number:    123456789abcdef987654321
         Found /usr/bin/pulseview and /usr/bin/gnuplot. Have now set: 
         configure logic autodump=enabled oscope autodump=enabled dump output=file auto-digital=enabled auto-analog=enabled digital-frmt=csv viewer-csv=gnuplot viewer-vcd=pulseview
@@ -2294,11 +2294,13 @@ Note also that when used as a usart-to-USB-to-UNIX-pseudoterminal bridge (see [`
 
 ##### `usart` configuration
 
-        $1.50: help usart usart 
+        $1.50: help usart usart
         Help for configuration "usart" (e.g. "usart usart"):
         Configuration for async/sync (UART/USART) serial peripheral on ports PA9(TX),
             PA10(RX) and PA8(clock) (if "ports=pa8-10") or ports PA2(TX), PA3(RX),
             PA1(RTS) and PA0(CTS) (if "ports=pa0-3")
+          - Note "datalen=7bits" with "parity=none", or "datalen=9bits" with other than
+            "parity=none," not supported.
         Command/configuration usage:
            usart [<parameter>=<value> ...] [<action>]
         Actions:
@@ -2310,15 +2312,15 @@ Note also that when used as a usart-to-USB-to-UNIX-pseudoterminal bridge (see [`
             recv=           Receive RX data on port PA10
             ports=          Select one of two hardware USARTs (by PAx-y port...
             baud=           Baud rate for both xmit and recv if "synchro=ena...
-            datalen=        Number of data bits
+            datalen=        Number of data bits. See "help usart usart" for ...
             stoplen=        Number of stop bits
-            parity=         Generate parity bit
+            parity=         Parity. See "help usart usart" for restrictions ...
             synchro=        Async(UART)(no clock) or synchronous(USART) mode
-            idle=           Clock output level at idle in "synchro=enabled" m...
+            idle=           Clock output level at idle in "synchro=enabled" ...
             phase=          Clock edge to sample bit at in "synchro=enabled"...
             lastclok=       Last clock pulse in "synchro=enabled" mode
             gpio=           Ports output slew rate
-            rate=           Byte output data rateSee "Time/Frequency Errors"...
+            rate=           Byte output data rate. See "Time/Frequency Error...
             tx-timeout=     Wait for hardware TX ready. See "Time/Frequency ...
             rx-wait=        Wait for hardware RX ready. See "Time/Frequency ...
             tx-data=        Byte to xmit in "monitor" command if "synchro=en...
@@ -2395,9 +2397,9 @@ Note also that when used as a usart-to-USB-to-UNIX-pseudoterminal bridge (see [`
 
         $1.50: help usart datalen=
         Help for parameter "datalen=" (e.g. "usart usart datalen="):
-        - Number of data bits
+        - Number of data bits. See "help usart usart" for restrictions with "parity=".
         Current value: 8bits
-        Valid values:  "8bits" or "9bits"
+        Valid values:  "7bits", "8bits", or "9bits"
         Type "help usart usart" for list of usart configuration parameters
         Type "help usart" for command description
 
@@ -2411,7 +2413,7 @@ Note also that when used as a usart-to-USB-to-UNIX-pseudoterminal bridge (see [`
 
         $1.50: help usart parity=
         Help for parameter "parity=" (e.g. "usart usart parity="):
-        - Generate parity bit
+        - Parity. See "help usart usart" for restrictions with "datalen=".
         Current value: none
         Valid values:  "none", "even", or "odd"
         Type "help usart usart" for list of usart configuration parameters

diff --git a/RELEASE_NOTES.txt b/RELEASE_NOTES.txt
@@ -1,3 +1,12 @@
+0.9.1   2020 Nov 07
+-------------------
+* Fix potential problem if failed USB communications in buck50.py usb_bridge_usb()
+* Changed buck50.py usart config datalen and parity from ST peripheral specific to standard semantics
+* Belated bump of regbits.hxx micro version to 1.0.2
+* README.md update and minor changes
+
+
+
 0.9.0	2020 Nov 05
 -------------------
 * Initial GitHub release
diff --git a/build/buck50.bin b/build/buck50.bin
diff --git a/build/buck50.elf b/build/buck50.elf
diff --git a/build/buck50.hex b/build/buck50.hex
@@ -1319,7 +1319,7 @@
 :10525000A1FCD4F8842099E7FCF7F0FFD4F884206F
 :1052600094E7FDF7ADF9D4F884208FE7FCF726FC2E
 :10527000D4F884208AE7042A134628BF04234FF475
-:10528000106C0020194401F03F01D31AC4E9201327
+:10528000106C0120194401F03F01D31AC4E9201326
 :10529000DFF89890A4F800C0A07000E030BF0323AE
 :1052A000324601214846FFF713F80028F6D071E78F
 :1052B000042A134628BF0423D7F8E000194401F05C