Merge branch 'main' into feature/cmake-configurator

Author: visrealm

README.md

@@ -2,7 +2,9 @@
 
 [![Build](https://github.com/visrealm/pico9918/actions/workflows/build.yml/badge.svg)](https://github.com/visrealm/pico9918/actions/workflows/build.yml)
 
-A drop-in replacement for a classic TMS9918A VDP using a Raspberry Pi Pico.
+A drop-in replacement for a classic TMS9918A VDP powered by the Raspberry Pi Pico RP2040 microcontroller.
+
+<p align="left"><a href="img/pico9918_v1_2_top_sm.jpg"><img src="img/pico9918_v1_2_top_sm.jpg" alt="PICO9918 v1.2 Top" width="400px"></a> <a href="img/pico9918_v1_2_bottom_sm.jpg"><img src="img/pico9918_v1_2_bottom_sm.jpg" alt="PICO9918 v1.2 Top" width="406px"></a></p>
 
 The TMS9918A emulation is handled by my [vrEmuTms9918 library](https://github.com/visrealm/vrEmuTms9918) which is included as a submodule here
 
@@ -55,11 +57,11 @@ So far, there aren't any.
 
 # F18A compatibility
 
-Work is being done to add F18A compatibility to the PICO9918. The video below was captured directly from the PICO9918 VGA output running various F18A demos on a TI-99/4A.
+The PICO9918 also includes F18A compatibility in firmware v1.0.0+. The video below was captured directly from the PICO9918 VGA output running various F18A demos on a TI-99/4A.
 
 [![PICO9918 F18A mode preview 1 demo](https://img.visualrealmsoftware.com/youtube/thumb/TabTIPL1xQY)](https://youtu.be/TabTIPL1xQY)
 
-Pre-release firmware for F18A compatibility mode is available in [Releases](https://github.com/visrealm/pico9918/releases/tag/v0.4.1-f18a-preview1).
+Pre-release firmware for F18A compatibility mode is available in [Releases](https://github.com/visrealm/pico9918/releases/tag/v1.0.1a).
 
 ## Purchasing options
 
@@ -80,7 +82,7 @@ There are two main variants of the hardware.
 
 PICO9918 v1.2 is the single board version which doesn't require a piggy-backed Pi Pico. This is the version you can currently buy pre-assembled from Tindie and ArcadeShopper.
 
-<p align="left"><a href="img/pico9918_v1_0_sm.png"><img src="img/pico9918_v1_0_sm.png" alt="PICO9918 v0.4" width="720px"></a></p>
+<p align="left"><a href="img/pico9918_v1_2_sm.jpg"><img src="img/pico9918_v1_2_sm.jpg" alt="PICO9918 v1.2" width="720px"></a></p>
 
 ### v0.3
 
@@ -90,6 +92,8 @@ v0.3 is relatively cheap and easy to build, schematic and gerbers are available.
 
 <p align="left"><a href="img/pico9918_v0_3_sm2.jpg"><img src="img/pico9918_v0_3_sm2.jpg" alt="PICO9918 v0.3" width="720px"></a></p>
 
+I also have the [v0.3 board as a PCBWay Project](https://www.pcbway.com/project/shareproject/PICO9918_Drop_in_replacement_for_the_classic_TMS9918A_family_of_VDPs_fc11359a.html) you can order there.
+
 ### Schematics
 
 Schematics and Gerbers are available in [/pcb](pcb)
@@ -114,6 +118,10 @@ Output in `build/dist/`: firmware `.uf2` file and configurator ROMs for all retr
 
 📖 **[Complete Build Instructions](BUILDING.md)** - includes development environment setup, configuration options, platform-specific builds, and troubleshooting.
 
+## Thanks
+
+Special thanks to [JasonACT (AtariAge)](https://forums.atariage.com/profile/82586-jasonact/) for hand-crafting the F18A mode's on-board TMS9900 "GPU" in ARM assembly and providing other valuable input to the project.
+
 ## Discussion
 
 For all the latest news and discussion on the PICO9918, you can follow [this AtariAge thread](https://forums.atariage.com/topic/367656-introducing-the-pico9918-a-tms9918a-drop-in-replacement-powered-by-a-pi-pico/)

img/pico9918_v1_2_bottom_sm.jpg

@@ -15,6 +15,7 @@ There is now a single PCB (v1.3) for both JST and FFC connector types.
 #### Configuration
 
 The 5P/6P jumper is used to connect the correct DIN pin to the ground plane of the no-cut PCB. For 5-pin DINs (most US models), place a jumper between the 5P and middle pin. For 6-pin DINs (most EU/AUS models), place a jumper between the 6P and middle pin.
+You can run the board with no jumper at all however the ground for the audio connectors will then be provided via the PICO9918 cable.
 
 See [ti99/pcb/](ti99/pcb/)
 

img/pico9918_v1_2_sm.jpg

@@ -10,7 +10,7 @@ This version is relatively cheap and easy to build and is powered by a piggyback
 
 See [PICO9918 v0.3](v0.3)
 
-### Fully integrated single board (v0.4 - v1.1+)
+### Fully integrated single board (v0.4 - v1.2+)
 
 From v0.4 the RP2040 has been integrated onto the PICO9918 PCB, making a much smaller small form factor. This revision has many small (0402) components and can be challenging (and more expensive) to build. They can be purchased too.
 
@@ -19,6 +19,13 @@ alt="PICO9918 v1.0" width="240px"></a></p>
 
 # Revision history
 
+## [v1.2 (2024-11-26)](v1.2)
+
+<p align="left"><a href="../img/pico9918_v1_2_sm.jpg"><img src="../img/pico9918_v1_2_sm.jpg" alt="PICO9918 v1.2" width="720px"></a></p>
+
+### Changelog
+- Added 12-pin FFC connector with separate VGA dongle PCB
+
 ## [v1.1 (2024-09-12)](v1.1)
 
 ### Changelog
@@ -80,4 +87,4 @@ I could reduce the VGA bit depth to 9-bit or 10-bit to allow the use of a genuin
 
 For the curious amongst you, v0.1 was the only version that wan't usable. The TMS9918A socket interface was 0.1" too narrow. Rookie error! Fortunately, I noticed within hours of ordering the PCBs, so ordered v0.2 long before v0.1 arrived.
 
-v0.2 was very usable and is the version used in the initial "It freaking works!" video. The only reason it isn't published is because it lacked the GROMCLK and CPUCLK signals required for many systems. In the video, you can see the GROMCLK signal is being provided by a second Pi Pico.
+v0.2 was very usable and is the version used in the initial "It freaking works!" video. The only reason it isn't published is because it lacked the GROMCLK and CPUCLK signals required for many systems. In the video, you can see the GROMCLK signal is being provided by a second Pi Pico.