Skip to content

feat(display): auto-detect the reTerminal Sticky's SSD2677 panel - #180

Merged
jonasniesner merged 1 commit into
mainfrom
feat/sticky-panel-autodetect
Nov 8, 2026
Merged

jonasniesner merged 1 commit into
mainfrom
feat/sticky-panel-autodetect

Conversation

@jonasniesner

Copy link
Copy Markdown
Member

Seeed is replacing the reTerminal Sticky's SSD1677 panel with an SSD2677 of the same size and pixel count. This detects which one is fitted at boot, so panel_ic_type stays 69/70 and clients, presets and the config format don't change.

Detection: when the config has IC 69/70 and the Sticky's pins (13/14/15), the firmware reads register 0x70 twice over bit-banged SPI, because bb_epaper has no read line. 0x07 selects the SSD2677. Any other stable value, with BUSY idle low, keeps today's path. Inconsistent results stay unresolved and retry on the next cold start. The result is held in RAM and never written to the config.

SSD2677 drive path (src/panel_ssd2677.*, no bb_epaper change):

  • Seeed's init sequence and temperature-selected waveform, with PSR 0x27 (UD cleared) to match the Sticky's mounting.
  • 2 bpp image data on DTM1, preceded by 200 hidden rows: the controller addresses 680 gate lines and 480 are visible.
  • 4-gray holds the first plane in a 48 kB PSRAM buffer, because the planes arrive one after the other.
  • Full refresh only. Partial writes (0x76 and pipe) get OD_ERR_PARTIAL_UNSUPPORTED.

The new module uses extern for bbep and globalConfig, matching the other modules, since no getters exist.

Testing

Built esp32-s3-N32R8-extuart, esp32-s3-N32R8 and nrf52840custom. Tested on two Stickys:

New panel (SSD2677) Old panel (SSD1677)
Probe 0x07/0x07 -> SSD2677 0x00/0x00 -> legacy
Boot screen on the panel Correct Correct, refresh time unchanged
Mono upload Correct Not rechecked on this build
4-gray boot and upload Correct Not rechecked on this build

Not tested:

  • Deep-sleep wake on the new panel, which resolves the panel in the cold-acquire path rather than at boot.
  • Partial write rejection on the new panel.
  • Temperature waveform buckets other than room temperature.

A new-panel Sticky needs a release containing this change.

🤖 Generated with Claude Code

Seeed is replacing the Sticky's SSD1677 panel with an SSD2677 of the same
size and pixel count. Identify it at boot by reading register 0x70, so
configs keep panel_ic_type 69/70 and clients see no change.

The SSD2677 needs its own init, waveform latch and 2 bpp image stream. It
runs full refresh only, and partial writes are rejected as unsupported.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@jonasniesner
jonasniesner merged commit b21bd1f into main Nov 8, 2026
26 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant