Coder Social home page Coder Social logo

thebyteattic / agonlight Goto Github PK

View Code? Open in Web Editor NEW
217.0 22.0 12.0 297.83 MB

A stand-alone, BASIC-programmable microcontroller and microcomputer in one! The fastest, cheapest, most hackable 8-bit computer ever.

Home Page: https://www.thebyteattic.com/p/agon.html

License: Other

8-bit computers controllers microcomputers microcontrollers retrocomputers single-board-computers agon-light agonlight firmware

agonlight's Introduction

Agon light™ (new board revision is out, see announcement below)

IMPORTANT ANNOUNCEMENT (July 19, 2023): Agon light™ has a new and superior board revision, called the 'ORIGINS edition,' which supercedes this original version for all cases. Heber Ltd.'s Agon Console8 is already based on the improvements of that new revision. This repository is now maintained purely for legacy reasons. All makers and sellers should migrate to the ORIGINS edition promptly; it is 100% backward compatible with the original in this repository, but uses a couple of different parts. So be alert for the updates to the Bill of Materials!

AgonLight Tiny

Agon light™ is a unique combination of instant-on microcomputer and standalone microcontroller, which allows you to control your projects from the convenience and immediacy of a BASIC prompt, without the need for a host PC or sketch compilation. To find out more about what makes Agon light™ unique, useful and attractive, please visit the official website at: https://www.thebyteattic.com/p/agon.html.

The Hardware Manual should contain everything you need to know about the hardware.

The three modules of Agon light™'s official firmware, called Quark™, can be found here:

Quark™ MOS, running on the Zilog eZ80 CPU, can now be upgraded without the dedicated Zilog USB Smart Cable, by using this utility written by Jeroen Venema. The utility is clearly documented and has been exhaustively tested.


A complete Agon Quark™ BBC BASIC manual is available. Further firmware documentation is collected and maintained in the Agon light™ WiKi. Because the Wiki is now the reference documentation, the 'Firmware Installation Guide' and the 'Quick Start Guide' above are obsolete and kept here just for legacy reasons.


There is now an online, community-maintained resource listing many PS/2-compatible keyboards known to work with Agon light™. Anyone can edit this spreadsheet, so take it with a grain of salt. Nonetheless, it surely provides very useful indications.


AgonLight Case Montage


The directory structure above contains the following information:

  • /3D Model contains a, well, 3D model of Agon light™'s board and a 2D image specifying the PCB's key dimensions. These are meant for those interested in designing and building custom (3D-printed) cases for Agon light™.
  • /Design contains all design files, like schematics, EasyEDA source files and PCB layout.
  • /Manufacturing contains the files necessary to have an Agon light™ board manufactured, such as the Gerber file, Bill of Materials and Pick and Place file.
  • /Photos contains photos of a properly assembled Agon light™ unit, so to provide detailed references for those attempting to build one themselves. These photos can also be used by the media (feel free to do so if you are a journalist or tech writer).
  • /Third party documentation contains what the name suggests: useful datasheets, user manuals, guides and application/technical notes of parts and software used in/with Agon light™.
  • /uSD card files is now obsolete. The instructions in the Agon Wiki should be followed instead. Kept here for legacy purposes, this obsolete directory contains the files and folders that should be present in the micro SD card inserted in the Agon light™ unit when you follow the instructions in the equally obsolete Quick Start Guide.

AgonLight top small


All files in this repository, except for the third-party documentation,
Copyright © 2022-2023 by Bernardo Kastrup.
All rights are reserved.


CHANGE HISTORY:

  • 25 April 2023: 'Quick Start Guide', 'Firmware Installation Guide', and the README file in the /uSD card files directory have been updated to warn users that these documents are now obsolete and replaced by the Agon light™ Wiki.
  • 1 April 2023: A list of known-to-work PS/2 keyboards that can be used with Agon light™ has been added to this README (no April Fools joke).
  • 24 March 2023: The Hardware Manual has been updated with the new baud rate supported between CPU and video co-processor, namely 1,152,000 bits per second (three times faster than the previously recommended rate of 384,000 bps). All Agons, even the ones already in the field from day one, can be upgraded with this new baud rate with the next release of the Quark™ firmware. The hardware has had the capability built into it from the get-go; it was a question of firmware. So enjoy!
  • 27 February 2023: All documentation has been updated to take into account (a) the product number of the new Zilog USB Smart Cable (namely, ZUSBASC0200ZACG), since the previous version (namely, ZUSBSC00100ZACG) is now discontinued; and (b) the fact that Quark MOS™ firmware (for the eZ80 CPU) updates can be done without the Zilog cable, by using a software utility developed by Jeroen Venema; moreover, (c) the official Zilog manual for the new USB Smart Cable (ZUSBASC0200ZACG) has been added to the /Third party documentation folder for convenience.
  • 17 December 2022: Link to the Quark™ MOS cable-free upgrade utility added to this README file.
  • 16 December 2022: Small update to the Firmware Installation Guide. Namely, the description of steps 45 and 47 was improved for clarity.
  • 02 December 2022: Update to the Hardware Manual and schematics to correct an error: the positions of the control port pins ESPI36 to ESPI39 were documented in reverse order, but are now corrected. This update does not change the manufacturing files (Gerber, pick & place and bill of materials files).
  • 23 November 2022: Update to the uSD card files and the firmware installation guide to reflect release 1.02 of Quark MOS™, Quark VDP™, and Quark BBC BASIC™.
  • 24 October 2022: Quick Start Guide and Firmware Installation Guide updated to reflect the fact that Agon light™ requires a class-10, Fat32-formatted uSD-card with a partition of no more than 32GB.
  • 21 October 2022: Quick Start Guide, Firmware Installation Guide, and bbcbasic.bin (in the folder /uSD card files) updated.
  • 17 October 2022: All documentation updated to reflect the fact that the Zilog USB Smart Cable with product number ZUSBESC0200ZACG will NOT work with Agon light™. The only CORRECT cable has product number ZUSBSC00100ZACG.
  • 16 October 2022: Step-by-step firmware installation guide added to the repository.
  • 15 October 2022: Improvements to the Bill of Materials spreadsheets for more clarity regarding which components to source.
  • 11 October 2022: Update of the Quick Start Guide; The "/uSD card files" directory has been added.
  • 5 October 2022: Quick Start Guide uploaded.
  • 4 August 2022: Update of the Manual. The theory of operation (page 6) and the system diagram (page 7) now contain information about the two interrupt lines from the ESP32 available to the eZ80F92. A description of the control port signals (page 10) has also been added.
  • 26 July 2022: Various bits and pieces of previously missing information added to the manual. System diagram (page 7) updated.
  • 06 July 2022: Added power considerations to the manual (page 19). More photos (of the official case) added to the /Photos directory.
  • 30 June 2022: All files of Rev. 1.0 uploaded.

agonlight's People

Contributors

thebyteattic avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

agonlight's Issues

Lag on the keyboard

I find I need to press return twice on this board to input detail and the programs run really slowly. It's almost like the interrup / update is triggered by pressing return key on my Keyboard. Any ideas?

Agon is an Olimex Agon Light 2 version

UsingJUSTOP PS/2 Compatible keyboard. Lag is even worse if I use a plug in adapter. Connected to USB port on desktop / Mac is easier but the lag is still there.

Documentation for using SDCC instead of ZDC?

Since the documentation at https://github.com/breakintoprogram/agon-docs does not have an issue tracker, I'm posting this here: Currently ZDS C is the only option mentioned for programming in C. The free Small Device c compiler (SDCC) has the ez80_z80 backend (which uses the eZ80 in Z80 mode). IMO, it would make sense to mention it in the documentation, and maybe provide a simple "Hello, world!" or such example for the AgonLight.

Firmware installation guide errata

  • must install the Windows CP210x USB drivers (or there is no virtual COM port for Arduino to connect)
  • must select "ESP32 Dev Module" as board
  • must install the ESP32Time library
  • must not allow Arduino to update the FabGL library to version 1.0.9

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.