Readme and keyboard help updates + temp LilyGo fix for hung display

Author: RetiredWizard

PyDOS.py

@@ -67,7 +67,7 @@ def PyDOS():
     global envVars
     if "envVars" not in globals().keys():
         envVars = {}
-    _VER = "1.37"
+    _VER = "1.38"
     prmpVals = ['>','(',')','&','|','\x1b','\b','<','=',' ',_VER,'\n','$','']
 
     print("Starting Py-DOS...")
@@ -139,6 +139,7 @@ def exCmd(cFile,passedIn):
                     exec(f"passedIn = '{passedIn}'\n{cf.read()}")
         except Exception as err:
             print_exception(err)
+            envVars['lasterror'] = err
         except KeyboardInterrupt:
             print("^C")
 

README.md

@@ -183,15 +183,16 @@ CircuitPython LCD libraries from https://github.com/dhylands/python_lcd
 
 **blink.py [led pin number]** - program to blink onboard LED
 
-**rgbset.py [rgb led pin number]** - program to set the rgb color of an onboard neopixel or dotstar  
-**rgbblink.py [rgb led pin number]** - program to blink an onboard neopixel or dotstar  
-**rgbrainbow.py [rgb led pin number]** - program to color cycle an onboard neopixel or dotstar  
+**rgbset.py [pin number,[size,[pixel]]]** - program to set the rgb color of an onboard neopixel or dotstar. The *size* and *pixel* arguments can be used to identify individual pixel in pixel array of more than 1 neopixel/dotstar.  
 
-**matrix.py** - program to initalize connected HUB75 RGB Matrix Panels as a CircuitPython display. The display object is stored as a PyDOS environment variable (_display)  
+**rgbblink.py [pin number]** - program to blink an onboard neopixel or dotstar  
+**rgbrainbow.py [pin number]** - program to color cycle an onboard neopixel or dotstar  
+
+**matrix.py [1|4]** - program to initalize connected HUB75 RGB Matrix Panels as a CircuitPython display. The display object is stored as a PyDOS environment variable (_display). If a 1 in passed as an argument, the matrix is configured as a single 64x32 panel, a 4 configures the matrix as a 2x2 matrix of 64x32 panels.  
 
 **reboot.py** - performs a soft reboot (Micropython requires a Ctrl-D to complete)
 
-**keys.bat** - (Keyboard Featherwing/BBQ Keyboard only) Displays keyboard mappings for hidden keys and functions  
+**keys.bat** - (Keyboard Featherwing/BBQ Keyboard/LilyGo T-Deck only) Displays keyboard mappings for hidden keys and functions  
 **ui.bat [u/k]** - (Keyboard Featherwing/BBQ Keyboard only) Switches between using the Keyboard Featherwing and USB Serial port for PyDOS I/O
 
 **fs.py [ro/rw]** - (Circuitpython only) By selecting the "RO" option the flash mode is set such that when the microcontroller

cpython/kbdFeatherWing/keys.bat

@@ -1,4 +1,23 @@
 @echo off
+pexec import board
+pexec envVars["_boardID"] = board.board_id
+if not "%_boardID%" == "lilygo_tdeck" goto kbdFeatherWing
+echo .
+echo     Entered Lilygo Keys    Results
+echo     -------------------    -------
+echo              _-               =
+echo              (+               [
+echo              +)               ]
+echo              (-               <
+echo              -)               >
+echo              _#               ^
+echo              _/               \
+echo              -/               %%
+echo Speaker Key (left of enter)   $
+echo .
+goto done
+
+:kbdFeatherWing
 echo Alt-$ (Speaker) returns an equal sign (=)
 echo Hold a key for 2 seconds SHIFT or ALT
 echo Alt-Enter will toggle between SHIFT and ALT
@@ -13,4 +32,6 @@ echo joystick up/down scrolls through entered lines
 echo The F3 key retrieves the last entered line
 echo F2 and then pressing a key will search
 echo    the last entered line for that character
+
+:done
 pause

cpython/lib/optional/pydos_ui_lilygokbd.py

@@ -56,7 +56,7 @@ def serial_bytes_available(self):
                 with self._i2c as i2c:
                     try:
                         i2c.readinto(self._key)
-                    except:
+                    except Exception as err:
                         self._key=bytearray(1)
                 if self._key[0] != 0:
                     retval = 1

matrix.py

@@ -15,13 +15,13 @@
 if passedIn == '1':
     base_width = 64
     base_height = 32
-    bit_depth = 1
+    bit_depth = 2
     chain_across = 1
     tile_down = 1
 elif passedIn == '4':
     base_width = 64
     base_height = 32
-    bit_depth = 1
+    bit_depth = 2
     chain_across = 2
     tile_down = 2
 else:
@@ -34,9 +34,9 @@
     except:
         base_height = 32
     try:
-        bit_depth = int(input('Bit Depth (1): '))
+        bit_depth = int(input('Bit Depth (2): '))
     except:
-        bit_depth = 1
+        bit_depth = 2
     try:
         chain_across = int(input('Number of panels across (1): '))
     except:

setup.bat

@@ -76,6 +76,8 @@ if not "%_boardID%" == "lilygo_tdeck" goto not_lilygo_tdeck
 rename /lib/pydos_ui.py /lib/pydos_ui_uart.py
 echo copy /cpython/lib/optional/pydos_ui_lilygokbd.py /lib/pydos_ui.py
 copy/y /cpython/lib/optional/pydos_ui_lilygokbd.py /lib/pydos_ui.py
+echo copy /cpython/kbdFeatherWing/keys.bat /keys.bat
+copy/y /cpython/kbdFeatherWing/keys.bat /keys.bat
 pexec f = open('/settings.toml','a')
 pexec f.write('\nPYDOS_DISPLAYIO_COLORSPACE="BGR565_SWAPPED"\n')
 pexec f.close()