Troubleshooting - venice1200/MiSTer_tty2oled GitHub Wiki

Content:

Needed Support Information

  • The used Serial Port (see below)!
  • ESP32 or ESP8266?
  • Build by yourself or bought?
  • If built, which Dev-Board did you use?
  • If you flashed it with the Arduino IDE, which device and settings are used?
  • If bought, we need technical information about the device, Internet Links etc.
  • Did you see the tty2oled Start-UP Screen?
  • Did you see one of the MENU Pictures after MiSTer's start?
  • If possible provide us witht the build-number from the start screen.
  • We need detailed informations about your MiSTer Hardware (Power Supply, used IO Board etc.)
  • Are you using third party tools which are using tty2oled like MiSTer SAM?
  • Make some good quality pictures or a video.

Serial Port

If you run dmesg | grep tty on the MiSTer's command line (cli, ssh) you should see output similar to the below:

[ 1.118601] usb 1-1.1: New USB device found, idVendor=10c4, idProduct=ea60, bcdDevice= 1.00
[ 1.118612] usb 1-1.1: New USB device strings: Mfr=1, Product=2, SerialNumber=3
[ 1.118619] usb 1-1.1: Product: CP2104 USB to UART Bridge Controller
[ 1.118626] usb 1-1.1: Manufacturer: Silicon Labs
[ 1.118632] usb 1-1.1: SerialNumber: 0212C4A8
[ 1.119909] cp210x 1-1.1:1.0: cp210x converter detected
[ 1.122272] usb 1-1.1: cp210x converter now attached to ttyUSB0

If you have only one Device connected to the MiSTer, which creates a tty Device,
the line containing now attached should show the Interface which is used by your tty2oled Device.

The CP2104 USB to UART Bridge is the USB-Serial Chip on the ESP (TTGO-T8 here).
Other UART Bridges, depending on your Hardware, could be FTDI232, CP2102 or CH340.
Another possibility for the device Name is ttyACMx.

OLED Solder Points

Make sure you solder OLED Pin 1 😉 to GND and Pins 7-13 as well.
See Electrical-Connection.

4SPI

Make sure your Display supports or is set to the 4-SPI Mode.
See Electrical-4SPI.

Installer Problems

If you run into Problems try to re-install from scratch.
Use the command
rm /etc/init.d/S60tty2oled; rm /usr/bin/tty2oled; rm -R /media/fat/tty2oledpics/; rm /media/fat/Scripts/update_tty2oled.sh; rm /media/fat/Scripts/tty2oled.ini; rm -R /media/fat/tty2oled/;
to remove any tty2oled related files and folders.

Re-Flash your tty2oled device

❗ Attention ❗
Login to your MiSTer System via SSH or CLI.
Jump into into the tty2oled folder: cd /media/fat/tty2oled
Download the installer: wget https://raw.githubusercontent.com/venice1200/MiSTer_tty2oled/main/installer.sh

If you want to Re-Flash/Update your Device with the same MCU-Type Firmware run: ./installer.sh FORCE

If you need to Re-Flash/Update your Device with another MCU-Type Firmware run: ./installer.sh FORCE [HWESP32DE|HWLOLIN32|HWESP8266]
Choose one of the MCU Types HWESP32DE (TTGO), HWLOLIN32 (Wemos Lolin32) or HWESP8266 (NodeMCU 8266) as second Parameter.