This is a private project, no guarantees or liabilities apply.
The author and this site are not affiliated to Sovol in any kind.
The information provided here has been gathered from the web and by analyzing Sovol’s KlipperScreen.

Sovol KlipperScreen (Makerbase MKS KLIPAD50)

Hardware

• Hardware description of the MKS Klipad50
• GPIO naming
• Replaced WiFi antenna

Firmware

Custom firmware options

• Current: Armbian standard v25.2.3 (MKS-Klipad50)
  • Rebuilding (MKS-Klipad50 standard v25.2.3)
  • Sovolized Armbian Klipper Image (MKS-Klipad50 standard v25.2.3)
• Archive
  • Armbian community v25.5 (MKS-Klipad50)
    • THIS VERSION IS OLDER THAN ARMBIAN STANDARD V25.2.3 !
    • Rebuilding (MKS-Klipad50 community v25.5)
    • Sovolized Armbian Klipper Image (MKS-Klipad50 community v25.5)
  • Armbian mainline v25.2 (MKS-PI)
    • Rebuilding (MKS-PI v25.2)
    • Sovolized Armbian Klipper Image (MKS-PI v25.2)
  • Armbian v24.2
    • Rebuilding (MKS-PI v24.2)
    • Sovolized Armbian Klipper Image (MKS-PI v24.2)

Original firmware (by Sovol)

• Where to download
• Update problems
  • System / Kernel (black screen)
  • Klipper-0.12.80+ (secondary mcu update)
  • Armbian Buster: End Of Life
  • KlipperScreen / Python 3.8
  • Moonraker Timelapse

Modifications by Sovol

• Files in /root
• Services:
  • makerbase-auto-fresh.service
  • makerbase-automount@.service
  • makerbase-beep.service
  • makerbase-byid.service
  • makerbase-net-mods.service
  • makerbase-soft-shutdown.md.service
  • makerbase-timezone-monitor.service
  • makerbase-wlan0.service
• reverting
  • power loss recovery (plr)

Updating Klipper

• SD-card not accepted

Configuring

• Orca profiles
  • joescalon SV06+ profile+buildplate
    • my (based on joescalon)
    • Modified buildplate texture
  • joescalon SV07+ profile+buildplate
  • Christian Vicks profiles
  • Automatic z-offset adjustment per filament
• Beeper macro (for use inKlipper)
• Extending storage space for gcode files
• Screen rotation for KlipperScreen/Xorg
• Status LEDs customization
• Timezone configuration
  • Timezone updates spamming syslog

Troubleshooting

Boot loops / Black screen (“unbricking”)

• Boot loops / Black screen
  • Some causes for the looping boot animation
  • Typical causes for the damaged files
  • Some causes for a black screen
  • Fixes
    • Cleaning up “saved_variables.cfg”
    • Factory reset using Sovol’s “armbian-update.deb”
    • Full reflash of the eMMC using Sovol’s KLIPAD50_IMAGE

Getting access / Log in

• Serial (over USB)
• USB-Keyboard
• SSH (or putty)

Booting

• Booting from external device
  • Boot the same image from an USB-stick
  • Boot image from USB-stick via serial console
  • Boot from USB-stick with unbootable eMMC

Klipper Shutdown

• Scripts to safely shutdown.md klipper and power off using HS110 wifi.md power plug
  • Windows version
  • Linux version