TapuinoNext

Intro

Welcome to the TapuinoNext alpha.

Most of the code has been written and tested to a fair extent, but there are bound to be loads of bugs. Please report bugs as issues against the repo. If you have fixes, please submit these as a pull request. I could really use some help with documentation in markdown format if you would like to contribute in that way.

Using the TapuinoNext

Instructions on how to navigate the UI and detail on the TapuinoNext functionality can be found on this page: TapuinoNext UI. This is still very much a work in progress.

Hardware

• "instructions" to build a stripboard prototype are available at Prototype Build
• schematics and board designs for reference implementations are available in the Eagle folder.
• the mini board has been produced and tested successfully!
• NB: the micro board has not

The BOM for the TapuinoNext is:

• ESP32 Devkit equivalent: e.g. https://www.banggood.com/ESP32-WiFi-+-bluetooth-Development-Board-Ultra-Low-Power-Consumption-Dual-Core-ESP-32-ESP-32S-Similar-ESP8266-Geekcreit-for-Arduino-products-that-work-with-official-Arduino-boards-p-1175488.html

• resistors:
  • (voltage divider)
    • 1k5
    • 3k3
  • 100 Ohm (Recording LED current limiter)
• Rotary encoder KY-040: e.g. https://www.banggood.com/5Pcs-5V-KY-040-Rotary-Encoder-Module-AVR-PIC-p-951151.html

• LCD screen: SSD1306 OLED or HD44780 via I2C backpack
• SD Card breakout board / socket, no level shifter! Ones without resistors seem to work better. I used something like this: https://www.mischianti.org/2019/12/15/how-to-use-sd-card-with-esp8266-and-arduino/ This is the one I built:

• Bi-directional level shifter: e.g. https://www.banggood.com/10Pcs-Logic-Level-Converter-Bi-Directional-IIC-4-Way-Level-Conversion-Module-p-1033750.html

• C64 Datasette connector (use one off of a dead datasette or find one of these: https://www.thefuturewas8bit.com/cassette-port-connector-vic20-64-64c-128-128d-pet.html)

Wire this all up according to the schematic and flash the firmware.

Firmware

If you have already flashed a recent firmware, then firmware releases are available at: https://github.com/sweetlilmre/TapuinoNext/releases

As newer firmware can self update, all you need to do is drop the update.bin file onto the root of the SD Card and select the firmware update option from the options menu.

For a first time build:

There is now an alternative to building the code and flashing.

• Download the latest update.factory.bin from the TapuinoNext Releases Page
• Using Google Chrome, go to the Adafruit ESP Tool page.
• Connect your ESP32 to your machine and make sure the drivers are installed
• Click "Connect" on the Adafruit page and select the COM port of your ESP32
• If the connect succeeds, you should see several Choose a file... buttons
• Click the first one, navigate to and select the update.factory.bin file you downloaded
• Click Program
• A progress bar will appear, once this is complete you should be good to go

Probably the easiest way to handle this at the moment is to:

• install VS Code
• install Platformio on top of that
• install the Espressif 32 platform or start a new project and choose "Espressif ESP32 Dev Module" as the board, with "Arduino" as the framework
• clone the TapuinoNext repository
• you will need to create a config-user.h file in the include directory. This is currently used to specify which of the 2 supported displays you have and what the correct I2C address for the display is. A sample config-user.h.example has beem provided
• point VS code to the directory you cloned the repo into and upload to the board (I'm assuming that you know how to do all of this)

TODO / Roadmap

See TODO

Attribution

See Attribution