Skip to content

ma5ter/reccon

Repository files navigation

Creality K1C 2025 Recovery Console

Overview

The recovery console provides a pre-boot shell environment for the Creality K1C 2025 printer. When a USB keyboard is detected during boot, it launches a recovery shell that blocks further boot progression until exited.

Creality still hasn't given us a proper factory reset or any kind of real recovery image/rescue mode for K1C 2025. So this little recovery console is pretty much the only sane way to save your printer when it bricks itself or you yeet the system too hard.

Features

  • Early boot access before most services start
  • USB keyboard detection
  • Full terminal emulation with framebuffer support
  • PTY-based shell environment
  • Automatic boot continuation after shell exit
  • Statically linked binary - runs without dynamic linker/loader

Screenshot of running Far Manager

Screenshot of running Far Manager (small notes how to install it)

Installation

  1. Copy the reccon binary to /usr/apps/overlay/sbin/
  2. Create the init script at /usr/apps/etc/init.d/S39console with the following content:
#!/bin/sh

case "$1" in
    start)
        /usr/apps/overlay/sbin/reccon /bin/busybox sh >> /tmp/reccon.log 2>&1
    ;;
    *)
        exit 1
esac

exit 0
  1. Make the init script executable:
chmod +x /usr/apps/etc/init.d/S39console

Technical Details

  • Statically linked: No dependency on ld.so or shared libraries
  • Framebuffer device: /dev/fb1
  • Backlight control: /sys/class/backlight/backlight_pwm0
  • Keyboard detection: Scans /dev/input/event* devices
  • Terminal emulation: xterm-256color compatible
  • Logging: Output redirected to /tmp/reccon.log

Notes

  • The console runs before most services, providing low-level access
  • No keyboard detected = normal boot continues
  • Shell exit triggers continuation of boot process
  • All output is logged to /tmp/reccon.log for debugging
  • Unsupported terminal escape sequences are logged for diagnostic purposes

About

Creality K1C 2025 Recovery Console

Resources

License

Stars

Watchers

Forks

Packages

No packages published