OLIMEX AgonLight2, User Manual

Page: 22 / 32

Official AgonLight Firmware
The three modules of AgonLight official firmware, called Quark™, can be found here:
• Quark™ BBC BASIC – BBC Basic interpreter
• Quark™ MOS - command line machine operating system, similar to CP/M or DOS
•
Quark™ VDP - The VDP is a serial graphics terminal that takes a BBC Basic text output stream as
input. The output is via the VGA connector on the Agon.
Extra info about AgonLight2 firmware:
A properly operating AgonLight2 system has three software components Quark™ VDP + Quark™ MOS +
Quark™ BBC BASIC . By default each Olimex AgonLight2 board comes with VDP and MOS already
programmed. You only need to download the basic and the examples to an SD card to start using the
AgonLight2 board. For the BASIC, MOS updater, CP/M and other examples and test programs you need a
micro SD card in FAT or FAT32 format and a SD card writer. Micro SD cards are purchased separately.
Notice that certain combinations of versions of VDP, MOS and basic might be incompatible. Meaning that
you might need to upgrade or downgrade MOS, VDP, basic in order to run the board. If in doubt, use the
versions we provide.
It is always recommended to get the latest files and instructions from the official VDP, MOS, BASIC
locations listed below:
• Quark™ BBC BASIC – https://github.com/breakintoprogram/agon-bbc-basic/releases – BBC Basic
interpreter
• Quark™ MOS – https://github.com/breakintoprogram/agon-mos/releases – command line machine
operating system, similar to CP/M or DOS
• Quark™ VDP – https://github.com/breakintoprogram/agon-vdp/releases – the VDP is a serial graphics
terminal that takes a BBC basic text output stream as input. The output is via the VGA connector on the
Agon.
However, if you encounter problems use the versions we have provided at our GitHub, we have tested them
and confirmed them to work:
https://github.com/OLIMEX/AgonLight2/tree/main/SOFTWARE
The "1-SD-card-contents" folder contains sub-folders with files for the SD card, also mos files that can be
flashed via bootloader without programmer (if possible);
The "2-AgonLight2-VDP-XXX" folder contains VDP;
The "3-AgonLight2-MOS-XXX" folder contains MOS that can be flashed via programmer.
22