Getting Started with Agon Light 2 pre-built by Cartooning the Screen

1. Overview

Back Ports:
    VGA
    USB-C Power
    USB-A PS/2 Keyboard*  *(This is not a regular USB port!)
    3.5mm Audio
    Reset
    Micro SD Card
Front Ports:
    GPIO pins
    Olimex UEXT
    LiPo Battery
Board:
    EZ80 debugger pins
    Bus pins
    On-board audio buzzer
    Buzzer enable jumper
    ESP32 Serial UART jumper
    ESP32 debugging jumper


2. Power-on

Plug in the included VGA, keyboard, and audio cables.
Then plug in the USB-C power cable and the launcher program will boot.

3. Usage

The launcher is keyboard-operated. Press the up and down arrows and ENTER or Spacebar to select.
To explore command-line MOS, press Escape. Basic usage of MOS:

Command     .                           Result      List files and directories
Command     cd games                    Result      "Change directory" to "games"
Command     cd /                        Result      "Change directory" to the root directory
Command     mc                          Result      Open "mc" file browser (alternative to typing commands)
Command     ne mytext.txt               Result      Open "ne" text editor editing "mytext.txt"
Command     pcxview pcx/bna-2bpp.pcx    Result      View the PCX file "bna-2bpp.pcx"
Command     load games/rokky.bin        Result      Load the binary file "rokky.bin" into memory
Command     run                         Result      Run the binary file loaded from the load command
Command     bbcbasic                    Result      Start a "BBC Basic" session
Command     flash all                   Result      Update the firmware

4. Troubleshooting

a. My keyboard doesn't work.
    The Agon Light 2 board requires specifically a "PS/2" protocol board using a USB connector. This is a specific type
    of keyboard that isn't compatible with most USB keyboards, and is not guaranteed to work with adapters either.
    Included with the CTS pre-built is a Perixx PERIBOARD-409U which is tested to be compatible.
b. How do I enable/disable the on-board buzzer?
    Open the case and move the jumper to bridge the pins(on) or not (off).
c. How do I update the software?
    Updated versions of A-Nib distribution are available for download from:
        https://triplefox.github.io/cts-agon/
    Push on the included microSD card to release it.
    Then insert it into an SD card reader for your PC or mobile and copy the new files.
    Re-insert the microSD card into the Agon and power it on.
    If new firmware has been added, exit the launcher and run "flash all" to update it.
d. Where is the Agon community? How do I connect with other users?
    The hub of firmware development is currently with the Console8 team:
        https://agonplatform.github.io/agon-docs/
    They currently host the most links and resources for Agon users.
    
For additional support e-mail acubicfox@gmail.com
