Troubleshooting - venice1200/MiSTer_tty2oled GitHub Wiki
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
.
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.