Merge branch 'main' into dev

Author: visrealm

README.md

@@ -104,8 +104,6 @@ v0.3 is relatively cheap and easy to build, schematic and gerbers are available.
 
 <p align="left"><a href="img/pico9918_v0_3_sm.jpg"><img src="img/pico9918_v0_3_sm.jpg" alt="PICO9918 v0.3" width="720px"></a></p>
 
-<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
@@ -118,6 +116,24 @@ If you're not interested in building the firmware yourself, you'll find the late
 
 To install, just hold the 'BOOTSEL' (or 'BOOT') button while plugging the Pico into a PC, then drag the pico9918.uf2 file on to the new USB drive which should have the volume label RPI-RP2. The Pico will restart (and disconnect) automatically.
 
+## Configurator
+
+The configurator is a software tool used to modify PICO9918 configuration options, including:
+
+* Clock rate
+* Scanline CRT effect
+* Scanline sprite limit
+* Default palette
+* Diagnostics overlays
+
+Additionally, firmware updates can be provided via the Configurator. The full configurator is available for the **TI-99/4A**, **ColecoVision** and **MSX**. With cut-down builds (without firmware updates) available for several other machines.
+
+See the configurator in action:
+
+[![PICO9918 Configurator - ColecoVision](https://img.visualrealmsoftware.com/youtube/thumb/PBArYupT9qM)](https://youtu.be/PBArYupT9qM?t=9)
+
+The configurator was written in a [custom fork of CVBasic](https://github.com/visrealm/CVBasic) with the full source available in [/configtool](configtool).
+
 ## Building
 
 Quick start - build both firmware and configurator ROMs:
@@ -181,3 +197,4 @@ The hardware design files in this repository are licensed under the CERN-OHL-S.
 ### Firmware
 The firmware code in this repository is licensed under the MIT License. See [LICENSE_FIRMWARE.md](LICENSE_FIRMWARE.md) for details.
 
+

configtool/CMAKE_BUILD.md renamed to configtool/README.md

@@ -1,34 +1,41 @@
-# CMake Build System for PICO9918 Configurator
+# PICO9918 Configurator
 
-This directory contains a CMake-based build system that replaces the Windows batch file (`build.bat`) with a cross-platform solution.
+The configurator is a software tool used to modify PICO9918 configuration options, including:
 
-## Features
+* Clock rate
+* Scanline CRT effect
+* Scanline sprite limit
+* Default palette
+* Diagnostics overlays
 
-- **Cross-platform**: Works on Windows, Linux, and macOS
-- **Parallel builds**: Multiple platform targets can build simultaneously  
-- **Better dependency tracking**: Only rebuilds what's changed
-- **IDE integration**: Works with VSCode CMake extensions
-- **Tool detection**: Automatically finds required compilers and tools
-- **Auto-build tools**: Can checkout and build CVBasic, gasm80, and XDT99 from source
+Additionally, firmware updates can be provided via the Configurator. The full configurator is available for the **TI-99/4A**, **ColecoVision** and **MSX**. With cut-down builds (without firmware updates) available for several other machines.
 
-## Prerequisites
+See the configurator in action:
 
-### Option 1: Use existing tools
+[![PICO9918 Configurator - ColecoVision](https://img.visualrealmsoftware.com/youtube/thumb/PBArYupT9qM)](https://youtu.be/PBArYupT9qM?t=9)
+
+The configurator was written in a [custom fork of CVBasic](https://github.com/visrealm/CVBasic).
+
+## Building
+
+### Prerequisites
+
+#### Option 1: Use existing tools
 - CMake 3.13 or later
 - Python 3 (accessible as `python3`)
 - CVBasic compiler (`cvbasic.exe`)
 - GASM80 assembler (`gasm80.exe`) 
 - XDT99 XAS99 assembler (for TI-99 builds)
 
-### Option 2: Auto-build tools (Linux/cross-platform)
+#### Option 2: Auto-build tools (Linux/cross-platform)
 - CMake 3.13 or later
 - Python 3 (accessible as `python3`)
 - Git (for checking out tool repositories)
 - C compiler (GCC or Clang for building tools)
 
-## Usage
+### Usage
 
-### Integrated Build (Recommended)
+#### Integrated Build (Recommended)
 The configurator is now integrated into the main PICO9918 build system:
 
 ```bash
@@ -43,27 +50,28 @@ All final artifacts will be in `build/dist/`:
 - **Firmware**: `pico9918-vga-build-v1-0-2.uf2`
 - **Configurator ROMs**: `pico9918_v1-0-2_*.rom` / `pico9918_v1-0-2_*.bin`
 
-### Standalone Build (Legacy)
+#### Standalone Build (Legacy)
 ```bash
 cd configtool
 mkdir build && cd build
 cmake .. [-DBUILD_TOOLS_FROM_SOURCE=ON]
 make configurator_all
 ```
 
-### Build Individual Platforms
+#### Build Individual Platforms
 ```bash
 make ti99              # TI-99/4A
 make ti99_f18a         # TI-99/4A F18A Testing  
 make coleco            # ColecoVision
 make msx_asc16         # MSX ASCII16 mapper
 make msx_konami        # MSX Konami mapper
+make sg1000            # SG1000/SC3000
 make nabu              # NABU
 make creativision      # CreatiVision
 make nabu_mame_package # NABU MAME (.npz)
 ```
 
-### Build with Ninja (faster)
+#### Build with Ninja (faster)
 ```bash
 cmake .. -G Ninja [-DBUILD_TOOLS_FROM_SOURCE=ON]
 ninja configurator_all
@@ -106,25 +114,3 @@ When enabled, CMake will:
 6. Use the locally-built tools for ROM generation
 
 This mode enables fully cross-platform builds without pre-installed tools.
-
-## Comparison with Batch Build
-
-| Aspect | Batch File | CMake |
-|--------|------------|-------|
-| Platform Support | Windows only | Cross-platform |
-| Parallel Builds | Sequential | Parallel |
-| Dependency Tracking | Manual | Automatic |
-| IDE Integration | None | Full |
-| Error Handling | Basic | Comprehensive |
-| Maintenance | Complex batch logic | Declarative CMake |
-
-## Backwards Compatibility
-
-The original `build.bat` remains unchanged and functional. This CMake system is an alternative build method, not a replacement.
-
-## Future Enhancements
-
-- [ ] Automatic firmware building if not found
-- [ ] CTest integration for ROM validation
-- [ ] CPack for distribution packaging
-- [ ] Cross-compilation support for ARM/embedded hosts