RETRO TECH COMMUNITY
          GAT ADDON

          USER MANUAL
          VERSION 1

          CREATED 08-05-24
          UPDATED 08-09-24




YOU ARE THE PROUD OWNER OF A RETRO TECH
ADDON GAT!

HOORAY!




BASIC USAGE INSTRUCTIONS

THE ADDON HAS THREE OPERATING MODES:
  - PROGRAM RUN MODE
  - PROGRAM SELECTION MODE
  - PARAMETER EDIT MODE

RETRO TECH BOOTS UP INTO
PROGRAM RUN MODE.




PROGRAM RUN MODE:
  - PRESS THE TOP BUTTON TO CHANGE
      CURSOR COLOR
  - PRESS THE BOTTOM BUTTON TO CHANGE
      CURSOR FLASH RATE
  - ROTATE THE KNOB TO
      ADJUST BRIGHTNESS

THE CURSOR HAS FOUR MODES:
WHITE, GREEN, AMBER, OR OFF.

ANY ENABLED PROGRAMS WILL RUN WHILE IN
PROGRAM RUN MODE. EACH PROGRAM HAS ITS
OWN PARAMETERS. PROGRAMS ARE SELECTED
TO RUN RANDOMLY EVERY 15-120 SECONDS.

BY DEFAULT, NO PROGRAMS ARE SELECTED.




PROGRAM SELECTION MODE:

TO ENTER PROGRAM SELECTION MODE,
PRESS BOTH BUTTONS AT THE SAME TIME
FROM PROGRAM RUN MODE.
THERE MUST BE NO DELAY BETWEEN
PRESSING BOTH BUTTONS.

WHILE IN THIS MODE, THE "LED4" LED
WILL RAPIDLY FLASH.

  - PRESS THE TOP BUTTON TO SELECT
      OR DESELECT A PROGRAM
  - PRESS THE BOTTOM BUTTON TO MOVE
      TO THE NEXT PROGRAM
  - THE KNOB DOES NOTHING

THE CURSOR WILL INDICATE IF A PROGRAM
IS ENABLED BY LIGHTING.

EACH LETTER OF "RETRO" INDICATES A
UNIQUE PROGRAM. THE LETTER WILL
ILLUMINATE AS A PREVIEW OF THAT
PROGRAM.

HERE IS THE PROGRAM LIST:
  R = RAINBOW
  E = EXCITING FADES ACROSS AND DOWN
  T = TWINKLING
  R = REALLY OBNOXIOUS ALTERANTING
  O = OPERATING A KEYBOARD




PARAMETER EDIT MODE:

TO ENTER PARAMETER EDIT MODE, PRESS
BOTH BUTTONS AT THE SAME TIME
FROM PROGRAM SELECTION MODE.
THERE MUST BE NO DELAY BETWEEN
PRESSING BOTH BUTTONS.

THIS MODE WILL BE SKIPPED AND THE ADDON
WILL RETURN TO PROGRAM RUN MODE IF NO
PROGRAMS HAVE BEEN ENABLED.

WHILE IN THIS MODE, THE "LED4" LED
WILL SLOWLY FLASH.

THIS MODE HAS TWO SUBMODES:
  WHEN THE CURSOR IS NOT LIT:
    PROGRAM TO EDIT SELECTOR SUB-MODE
    - PRESS THE TOP BUTTON TO
        SELECT THE NEXT PROGRAM
    - PRESS THE BOTTOM BUTTON TO
        EDIT THE SELECTED PROGRAM        
    
  WHEN TEH CURSOR IS LIT:
    PROGRAM PARAMETER EDITOR SUB-MODE
    - PRESS THE TOP BUTTON TO ADJUST
        PARAMETER ONE. THE ADJUSTMENT
        WILL LOOP FROM 0-255. YOU CANNOT
        SEE THE ACTUAL VALUE, ONLY
        THE EFFECT.
    - ROTATE THE KNOB TO ADJUST
        PARAMETER TWO. THE KNOB'S
        POSITION INDICATES THE VALUE.
    - PRESS THE BOTTOM BUTTON TO EXIT
        PROGRAM PARAMETER EDIT SUB-MODE
        BACK TO PROGRAM TO EDIT MODE

TO RETURN TO PROGRAM RUN MODE, PRESS
BOTH BUTTONS QUICKLY. YOUR SETTINGS
WILL BE SAVED.




PARAMETER LIST:
  RAINBOW
    - BUTTON: ANGLE OF PUKE (8 ANGLES)
    - KNOB: RGB HUE WHEEL DISTANCE

  FADES
    - BUTTON: FADE RATE
    - KNOB: HUE

  TWINKLING:
    - BUTTON: SATURATION
    - KNOB: HOW MANY TWINKLES

  ALTERNATING:
    - BUTTON: DEGREES OF HUE WHEEL
    - KNOB: HUE

  PROGRAM 4, OPERATING A KEYBOARD,
  HAS NO USER EDITABLE PARAMETERS.
  HOWEVER, IT WILL TAKE ON THE COLOR
  OF THE CURSOR.




SETTINGS RESET

TO RESET ALL SETTINGS, PRESS AND HOLD
THE TOP BUTTON WHILE POWERING ON.

THIS RESET IS ONLY IN RAM. TO COMMIT
RESET SETTINGS TO NON-VOLATILE MEMORY,
ENTER PROGRAM SELECT MODE THEN LEAVE
PROGRAM SELECT MODE.




BOOTLOADER

THIS ADDON CONTAINS A UART BOOTLOADER.
TO ACTIVATE BOOTLOADER, PRESS AND HOLD
THE BOTTOM BUTTON WHILE POWERING ON.

BOOTLOADER MODE IS INDICATED BY
LED "LED4" RAPIDLY FLASHING WITH
NO OTHER DISPLAY ELEMENTS ACTIVE.

USE A TTL UART TO COMMUNICATE WITH
THE BOOTLOADER.

BOOTLOADER PINOUT, LOOKING FROM THE
BOTTOM OF THE GAT ADDON:

/-----|  |-----\
| URX  NC  +3V |
| UTX  NC  GND |
\--------------/

TX / RX ARE FROM THE VIEWPOINT OF
THE RETRO TECH GAT ADDON.