Troubleshooting

Content:

• Needed Support Information
• Which Serial Port
• OLED Solder Points
• 4-SPI Mode
• Installer Problems
• Re-Flash your tty2oled device

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.

Depeding on your hardware you have to make sure to use the right Interfaces for your Display
and other devices like TapTo.

TapTo Recommendation

If you use TapTo, I recommend to set the used ttyUSBx Interface
to a fixed value and disable the probing in the tapto.ini file.
reader="pn532_uart:/dev/ttyUSB1
probe_device=false
If you don't do this your tty2oled Display can be confused by the TapTo probing mechanism.

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.