get ready for W release

rumbledethumps · rumbledethumps · commit c29b047e4371 · 2025-07-01T21:03:09.000-07:00
diff --git a/docs/source/api.rst b/docs/source/api.rst
@@ -156,9 +156,11 @@ phi2
 codepage
 --------
 
-.. c:function:: int codepage(void)
+.. c:function:: int codepage(int cp)
 
-   Retrieves the CP setting from the RIA. This is the encoding the filesystem is using and, if VGA is installed, the console and default font.
+   Temporarily overrides the code page if non zero. Returns to system setting when 6502 stops. This is the encoding the filesystem is using and, if VGA is installed, the console and default font. If zero, the system CP setting is selected and returned. If the requested code page is unavailable, a different code page will be selected and returned. For example: ``if (850!=codepage(850)) puts("error");``
+
+   :param cp: code page or 0 for system setting.
 
    :returns: The code page. One of: 437, 720, 737, 771, 775, 850, 852, 855, 857, 860, 861, 862, 863, 864, 865, 866, 869, 932, 936, 949, 950.
    :errno: will not fail
diff --git a/docs/source/index.rst b/docs/source/index.rst
@@ -10,38 +10,49 @@
 Picocomputer 6502
 =================
 
-The Picocomputer explores retro computing and game development by bridging the void between genuine 8-bit hardware and modern devices.
+The **Picocomputer 6502** is a platform for exploring retro computing and game development, bridging the gap between authentic 8-bit hardware and modern devices.
 
 .. image:: _static/founders.jpg
-  :width: 600
-  :alt: Alternative text
+   :width: 600
+   :alt: Picocomputer Photo
 
 Key Features
 ------------
-* 64KB of System RAM
-* 64KB of Extended RAM
-* VGA Graphics
-* 8-channel Stereo Sound Generator
-* USB for Keyboard, Mouse, and Gamepads
-* 100% through-hole
+
+- **64KB System RAM**
+- **64KB Extended RAM**
+- **VGA Graphics Output**
+- **8-Channel Stereo Sound Generator**
+- **USB Support** for Keyboard, Mouse, and Gamepads
+- **WiFi** for NTP and modem emulation
+- **100% Through-Hole Construction**
 
 Resources
 ---------
 
-Please use GitHub and the Forums for support, Discord for casual chat.
+For support and community interaction, please use the following channels:
+
+- **GitHub:** https://github.com/picocomputer
+- **Forums:** https://github.com/picocomputer/community/discussions
+- **Discord:** https://discord.gg/TC6X8kTr6d
+- **Wiki:** https://github.com/picocomputer/community/wiki
+- **YouTube:** https://youtube.com/playlist?list=PLvCRDUYedILfHDoD57Yj8BAXNmNJLVM2r
+
+Datasheets & Documentation
+--------------------------
+
+The RP6502 chipset consists of three main components:
 
-* GitHub: https://github.com/picocomputer
-* Forums: https://github.com/picocomputer/community/discussions
-* Discord: https://discord.gg/TC6X8kTr6d
-* Wiki: https://github.com/picocomputer/community/wiki
-* YouTube: https://youtube.com/playlist?list=PLvCRDUYedILfHDoD57Yj8BAXNmNJLVM2r
+- :doc:`RP6502-RIA<ria>`: An interface adapter for the 6502, similar to CIA, VIA, and ACIA devices.
+- :doc:`RP6502-RIA-W<ria_w>`: An alternative RIA with wireless radio technology.
+- :doc:`RP6502-VGA<vga>`: An optional video chip that connects to the RP6502-RIA.
 
-Datasheets
-----------
+All components are based on Raspberry Pi Pico 2 boards running RP6502 firmware.
 
-The RP6502 chipset comes in two parts. The RP6502-RIA is an interface adapter that connects to a 6502 much like CIA, VIA, and ACIA devices. The RP6502-VGA is an optional video chip that connects to the RP6502-RIA. Both of these are simply Raspberry Pi Picos with the RP6502 firmware.
+Further documentation:
 
-* :doc:`Schematic, PCB, and Parts <hardware>`
-* :doc:`RIA Interface Adapter <ria>`
-* :doc:`VGA Graphics Processing Unit <vga>`
-* :doc:`API for 6502 Programing <api>`
+- :doc:`Schematic, PCB, and Parts <hardware>`
+- :doc:`RIA Interface Adapter <ria>`
+- :doc:`RIA W Interface Adapter <ria_w>`
+- :doc:`VGA Graphics Processing Unit <vga>`
+- :doc:`API for 6502 Programming <api>`
diff --git a/docs/source/ria_w.rst b/docs/source/ria_w.rst
@@ -1,46 +1,86 @@
 RP6502-RIA-W
 ############
 
-Rumbledethumps Picocomputer 6502 Interface Adapter W.
+Rumbledethumps Picocomputer 6502 Interface Adapter W
 
 .. contents:: Table of Contents
    :local:
 
 1. Introduction
 ===============
 
-The RP6502 Interface Adapter W (RIA W) is a Raspberry Pi Pico 2 W with RP6502-RIA-W firmware. The RIA W provides everythiung the :doc:`ria` does along with the wireless services described in this document.
+The **RP6502 Interface Adapter W (RIA W)** is a Raspberry Pi Pico 2 W running the RP6502-RIA-W firmware. The RIA W provides all the features of the :doc:`ria` plus integrated wireless services, as described below.
 
 2. WiFi Setup
 =============
 
-The WiFi hardware is an Infineon CYW43439 supporting Wi-Fi 4 (802.11n). Configuration is done from the console.
+The RIA W uses an Infineon CYW43439 chip supporting Wi-Fi 4 (802.11n). Configuration is performed via the console interface.
 
-`SET RF (0|1)` is used to disable all radios without clearing any other settings. It defaults to 1 (enabled).
+- **Enable/Disable Radio:**
+  Use ``SET RF (0|1)`` to enable (1, default) or disable (0) all radios without affecting other settings.
 
-`SET RFCC (cc|-)` can be used to improve WiFi performance. `help set rfcc` will show the supported country codes. Clearing with "-" will use the Worldwide default.
+- **Set Country Code:**
+  ``SET RFCC (cc|-)`` sets the WiFi country code for optimal performance (e.g., ``US``, ``GB``). Use ``help set rfcc`` to list supported codes. Use ``-`` to reset to the worldwide default.
 
-`SET SSID (ssid|-)` sets the name of your WiFi network, also called the Service Set Identifier.
+- **Set Network Name (SSID):**
+  ``SET SSID (ssid|-)`` sets your WiFi network name (Service Set Identifier). Use ``-`` to clear.
 
-`SET PASS (pass|-)` sets the password for your WiFi network, if you have one.
+- **Set Network Password:**
+  ``SET PASS (pass|-)`` sets your WiFi password. Use ``-`` to clear.
 
-You can check WiFi status with the `status` command.
+- **Check WiFi Status:**
+  Use the ``status`` command to view current WiFi connection and settings.
 
-3. Network Time Protocol
-========================
+3. Network Time Protocol (NTP)
+==============================
 
-The real time clock will automatically update its time whenever connected to the internet.You can check NTP status with the `status` command.
+The real-time clock (RTC) automatically synchronizes with internet time servers when connected.
+Check NTP status with the `status` command.
 
-If you prefer local time instead of UTC, set the TZ. Always remember `help set tz` is there for you. Once set, it will adjust for daylight savings time if your locale uses it.
+- **Set Time Zone:**
+  To use local time instead of UTC, set your time zone with ``SET TZ``. Use ``help set tz`` for guidance. Daylight saving adjustments are automatic if your locale observes them.
 
-Once your Wifi and time zone are set, you can forget about time. Drift isn't a problem and there's no battery to replace.
+Once WiFi and time zone are configured, timekeeping is automatic—no battery required and no drift to worry about.
 
-4. Modem
-========
+4. Modem Emulation
+==================
 
-lorem ipsum
+The RIA W can emulate a Hayes modem for BBS access. Beware that raw TCP and telnet protocols are plain text in transit.
 
-3.1. AT Commands
-----------------
+- **AT Commands:**
+  The modem interface supports standard AT commands for dialing, answering, and configuration.
 
-dolar sit amet
+Example AT commands:
+
+- ``ATDexample.com:23`` — Dial a BBS
+- ``+++`` — Escape back to command mode
+- ``ATE1`` — Set echo
+- ``ATH`` — Hang up
+- ``ATO`` — Return to call
+- ``ATQ0`` — Set quieting
+- ``ATSxxx?`` — Query register number xxx
+- ``ATSxxx=yyy`` — Set register number xxx with value yyy
+- ``ATV1`` — Set verbosity
+- ``ATX0`` — Set progress messaging
+- ``ATZ`` — Load profile from NVRAM
+- ``AT&F`` — Load factory profile
+- ``AT&V`` — View profile
+- ``AT&W`` — Write profile to NVRAM
+- ``AT&Z0=example.com:23`` — Save "telephone number" to NVRAM
+- ``AT+RF=your_ssid`` and ``AT+RF?`` — Access RIA setting RF
+- ``AT+RFCC=your_ssid`` and ``AT+RFCC?`` — Access RIA setting RFCC
+- ``AT+SSID=your_ssid`` and ``AT+SSID?`` — Access RIA setting SSID
+- ``AT+PASSS=your_ssid`` and ``AT+PASS?`` — Access RIA setting PASS
+
+A full telnet stack has yet to be written so all connections are raw TCP.
+
+"Telephone Numbers" are saved immadiately and are not linked to profiles.
+
+`Please contribute to this documentation. <https://github.com/picocomputer/picocomputer.github.io>`_
+
+5. Additional Resources
+=======================
+
+- :doc:`RIA Interface Adapter <ria>`
+- :doc:`API for 6502 Programming <api>`
+- :doc:`Schematic, PCB, and Case Files <hardware>`
diff --git a/docs/source/vga.rst b/docs/source/vga.rst
@@ -487,7 +487,7 @@ C0 control codes
   :widths: 5 5 5 5 80
   :header-rows: 1
 
-  * - ^
+  * - \^
     - C0
     - Abbr
     - Name
@@ -554,6 +554,14 @@ Missing numbers are treated as 0. Some functions, like cursor movement, treat 0
     - Abbr
     - Name
     - Effect
+  * - CSI n A
+    - CUU
+    - Cursor Up
+    - Move the cursor n cells up.
+  * - CSI n B
+    - CUD
+    - Cursor Down
+    - Move the cursor n cells down.
   * - CSI n C
     - CUF
     - Cursor Forward
@@ -566,10 +574,38 @@ Missing numbers are treated as 0. Some functions, like cursor movement, treat 0
     - DCH
     - Delete Character
     - Delete n cells, move line left.
+  * - CSI n ; m H
+    - CUP
+    - Cursor Position
+    - Move the cursor to row n column m. 1-indexed.
+  * - CSI n J
+    - ED
+    - Erase in Display
+    - - 0: Erases from the cursor position to the end of the screen.
+      - 1: Erases from the beginning of the screen to the cursor position.
+      - 2, 3: Erases the entire screen.
+  * - CSI n K
+    - EL
+    - Erase in Line
+    - - 0: Erases from the cursor position to the end of the line.
+      - 1: Erases from the beginning of the line to the cursor position.
+      - 2: Erases the entire line.
   * - CSI n m
     - SGR
     - Select Graphic Rendition
     - Selects colors and styles.
+  * - CSI 6n
+    - DSR
+    - Device Status Report
+    - Responds with the cursor position (CPR) ESC\[n;mR, where n is the row and m is the column. 1-indexed.
+  * - CSI s
+    - SCP
+    - Save Current Cursor Position
+    - Save cursor row and col for retrieval with RCP.
+  * - CSI u
+    - RCP
+    - Restore Saved Cursor Position
+    - Moves cursor to position stored by SCP.
 
 
 SGR Parameters
