sd2iec with LCD and OLED display support

sd2iec firmware with support for parallel HD44780 and ST7036 character LCDs and WS0010 OLED displays. The default branch lcd combines these repositories:

• thierer/sd2iec: current unofficial sd2iec firmware, the base of this branch (master follows it)
• SvOlli/sd2iec-lcd: LCD support, last updated in 2023 on an older sd2iec
• sd2iec.de: the original sd2iec by Ingo Korb, git clone http://www.sd2iec.de/sd2iec.git. Newer changes from its master are added to this branch

LCD code copied from SvOlli/sd2iec-lcd and adapted to current thierer/sd2iec, with small improvements and cleanup.

What is added

• Support for WS0010 OLED displays: config larsp-oled (MMC2IEC with a module such as the Winstar WEH001602A), dimming after inactivity
• Scrolling of names longer than the display, the long file name of a mounted image

Display

Line 1 shows the directory or the mounted image, line 2 the loaded or saved file, the error message or READY: with the device address. Names longer than 14 characters scroll, a mounted image shows its long file name.

	LCD (HD44780, ST7036)	OLED (WS0010)
Configs	larsp-lcd, evo2-lcd	larsp-oled
Scroll step	700 ms	300 ms
Dimming	no	after 45 seconds without a change

A dimmed OLED lights up on a change of content. The first press of Next, Prev or Home only wakes it, the next press acts. Pins: doc/lcd-pinout.txt.

Programming

ATmega1284P with a USBasp programmer, larsp-oled as the example. Fuses (from scripts/avr/variables.mk): efuse 0xFD, hfuse 0xD2, lfuse 0xE7. Check them with:

avrdude -c usbasp -P usb -p m1284p \
  -U lfuse:r:-:h \
  -U hfuse:r:-:h \
  -U efuse:r:-:h

Standalone firmware

Every update needs the programmer. avrdude erases the whole chip.

avrdude -c usbasp -P usb -p m1284p \
  -U flash:w:dist/sd2iec-1.186.4-jpu-m1284p-larsp-oled.bin:r \
  -U efuse:w:0xFD:m \
  -U hfuse:w:0xD2:m \
  -U lfuse:w:0xE7:m

Fuses already set, firmware only:

avrdude -c usbasp -P usb -p m1284p \
  -U flash:w:dist/sd2iec-1.186.4-jpu-m1284p-larsp-oled.bin:r

With bootloader

1. Program the bootloader once, together with the fuses. make dist-bootloader downloads it from sd2iec.de into dist/. It exists for larsp, sw1 and sw2.

avrdude -c usbasp -P usb -p m1284p \
  -U flash:w:dist/newboot-0.4.1-larsp-m1284p.hex:i \
  -U efuse:w:0xFD:m \
  -U hfuse:w:0xD2:m \
  -U lfuse:w:0xE7:m

2. Copy the .bin to the root of the SD card and power on. The file name does not matter. Builds of this fork are development versions, the bootloader flashes them whenever the file differs from the chip.
3. Updates: copy the new .bin to the card.

To write the firmware with the programmer and keep the bootloader, add -D:

avrdude -c usbasp -P usb -p m1284p -D \
  -U flash:w:dist/sd2iec-1.186.4-jpu-m1284p-larsp-oled.bin:r

Build

Needs avr-gcc and avr-libc. One config:

make CONFIG=configs/config-larsp-oled

The binary is obj-m1284p-larsp-oled/sd2iec.bin. All configs, into dist/ as sd2iec-<version>-<mcu>-<config>.bin, for example sd2iec-1.186.4-jpu-m1284p-larsp-oled.bin:

make dist

DISTCONFIGS="larsp-lcd evo2-lcd" builds only some configs.

Version

The version format is <major>.<build>[.<revision>]-JPU[+LCD|+OLED], for example 1.186.4-JPU, 1.186.4-JPU+LCD and 1.186.4-JPU+OLED.

Part	Meaning
<major>	1
<build>	build number of the upstream tag, v1.0.0atentdead0-186-g069555f1 gives 186
<revision>	revision, left out when there is none
-JPU	this fork
+LCD	builds with LCD support
+OLED	builds with WS0010 OLED support

Where	Example
Error channel (UI)	SD2IEC V1.186.4-JPU+OLED
LCD line 1	SD2IEC 1.186.4
File name	sd2iec-1.186.4-jpu-m1284p-larsp-oled.bin

The version is set in version.mk. The boot loader flashes every build.

X-commands

Sent on the command channel, for example @"XT1HELLO" with JiffyDOS (the quotes are required) or OPEN15,8,15,"XT1HELLO":CLOSE15.

Command	Action
XT1text, XT2text	show text on line 1 or 2
XA	show the version and the author of the LCD code
XG	show the credits
XCnn	set the contrast 0 to 63, ST7036 only

Credits

LCD code by Draco, Seanser, Sascha Bader, andi6510, CapFuture1975 and Sven Oliver Moll, based on the LCD library by Peter Fleury. sd2iec by Ingo Korb and contributors, see README.

Free software under GPL version 2 only, see COPYING.