Firmware Hero
0

HA Dashboard for Kindle (hadash.koplugin)

  • Add-on
  • Alpha
  • High brick risk
  • Reversible

Source code

This project hasn't been claimed by its maintainer yet, so its details come from the community. Is it yours? Claim it

Before you start

How hard is it?
EasyCopy a file or use a web page. No extra software.
What you need
  • Comfort with the command line
  • A computer
  • Another hack installed first
Can it break my device?
Could leave your device unusable.
Can I undo it?
Yes. You can go back to the official software.
Get itOpens github.com

Did it work for you?

Did HA Dashboard for Kindle (hadash.koplugin) work on your Amazon Kindle Paperwhite 3?

No reports yet.

One-tap reports from owners. Bricked reports are checked before they count.

Compatibility

Devices: Amazon Kindle Paperwhite 3.

No compatibility information yet.

Getting started

From the project's README ("Quick start"):

  1. Jailbreak, install KOReader, enable SSH.koplugin (port 2222, not 22).
  2. Clone this repo, copy the config template and fill it in: cp config.sample.lua hadashsettings.lua

    edit hadashsettings.lua: HA URL, token, entity IDs

  3. Deploy: ./deploy.sh <kindle-ip> scp -P 2222 hadashsettings.lua root@<kindle-ip>:/mnt/us/koreader/hadashsettings.lua
  4. In KOReader: Tools → HA Dashboard, or set autoopen = true in the settings file to launch straight into it.
  5. Optional: set up full boot-autostart/appliance mode (below).

Read the full instructions

Risk and recovery

Brick risk
High
Reversible
Yes
Requires opening the device
No

From the project's README ("Recovering a half-bricked Kindle (blank screen / boot loop)"):

If something goes wrong with the appliance-mode setup and the device won't boot past a blank screen or Amazon's bare fallback screen, in order of least to most destructive:

  1. UART console, to check whether the system is actually damaged. PW3's UART runs at 1.8V logic — bridge it with a 3.3V USB-serial adapter through a resistor voltage divider on the TX line, not a direct connection (don't risk the 1.8V-rated input). GND/RX/TX are small test pads, usually near a board edge; smallest pad is typically GND. 115200 8N1. Interrupt autoboot (any key during the countdown) to reach the diagnostic console, then run a partition checksum command if one's available (diag run mmccrc32 worked on this unit). If .kernel/.system/.userdata pass but only low-level partitions (.bootloader/.bist/.diags) fail, your actual OS and data are intact.
  2. Reinstall the firmware over USB. Download the official updatekindle.bin for the exact version already installed, drag it onto the root of the Kindle's USB drive, eject, restart normally. Amazon's updater reapplies it automatically — even the same version works, since it's a full image reinstall, not a diff, and it repairs whatever got corrupted. This alone resolved a boot loop during this project's development.
  3. Last resort: factory reset. An empty file named exactly DOFACTORYRESTORE (no extension) at the root of the USB-mounted drive, then restart. More destructive, but reliable.

Read the full instructions

Credits, license and support

License
MIT