firebreak 0.2.0__tar.gz → 0.3.0__tar.gz

{firebreak-0.2.0 → firebreak-0.3.0}/CHANGELOG.md

@@ -2,6 +2,34 @@
 
 This project adheres to [Semantic Versioning](https://semver.org).
 
+## 0.3.0 - 2026-10-13
+
+### Added
+
+- A run names the device before it starts, and refuses a target made for
+  another device before it downloads anything. In fastboot it asks the
+  device's product; elsewhere it reads the USB product string, which needs no
+  adb authorization.
+- `--report` names the device and lists its USB devices, with the first 4
+  characters of each serial number. In fastboot it also prints the
+  anti-rollback versions.
+- `--report` gives the eMMC chip's manufacture date and the sizes of its two
+  boot areas, which differ between the chips Dots ship with.
+
+### Fixed
+
+- `--short` and a resumed run check that the Dot's bootloader names it an
+  Echo Dot (2nd Generation) before the bootrom writes. An Echo (2nd
+  Generation) that showed no light would have been given the Dot's preloader
+  and bootloader.
+- A run no longer erases boot0 when amonet's fastboot is not a Dot's. An
+  unlocked Echo (2nd Generation) in amonet's fastboot read as an unlocked
+  Dot, and the run would have written the Dot's preloader and bootloader to
+  it.
+- `stock` works on a Dot whose boot0 is larger than the stock preloader. It
+  stopped with `preloader.img is not the size of boot0` on a Dot with a 4 MiB
+  boot0.
+
 ## 0.2.0 - 2026-10-12
 
 ### Added

{firebreak-0.2.0 → firebreak-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: firebreak
-Version: 0.2.0
+Version: 0.3.0
 Summary: Root an Echo Dot (2nd Generation), move it between amonet targets, or return it to stock
 Project-URL: Changelog, https://github.com/bboe/firebreak/blob/main/CHANGELOG.md
 Project-URL: Source, https://github.com/bboe/firebreak
@@ -84,6 +84,8 @@ It has x86 and x64 builds only, so Windows on ARM cannot run the bootrom step.
 ## Notes
 
 - From stock, the script asks for the fastboot gesture.
+- A ring that stays solid blue at the fastboot gesture can mean a bad USB
+  connection. Unplug, then try again or try another port.
 - Do not set up a stock Dot in the Alexa app before you unlock it. On Wi-Fi it
   can update to a build the script does not support.
 - [docs/rooting.md][rooting] says why each step is there.
@@ -134,11 +136,15 @@ driver](#windows).
 
 When a run fails, run it again with `--report`, then please stop by
 `#support-device-unlocking` in the
-[EchoMuse Discord](https://discord.gg/vq3pub8Kp) and paste what it prints. It
+[EchoMuse Discord](https://discord.gg/vAPHMDvREG) and paste what it prints. It
 starts the Dot's recovery, prints what the Dot, its eMMC and this computer are,
 and the Dot's partition table, and writes no partition. A Dot already in a
 recovery stays there, and the Dot is left in its recovery afterwards.
 
+`--report` also names the device and lists its USB devices. firebreak supports
+only the Echo Dot (2nd Generation), but the report is the same on other Echo
+devices, such as the Echo (2nd Generation), and helps add them.
+
 `--write-test` then tells a failing eMMC from a failing cable. It pushes a
 pattern into the Dot's RAM, then has the Dot write it over its own `cache`
 partition and read it back, so nothing crosses USB. It erases `cache`, which

{firebreak-0.2.0 → firebreak-0.3.0}/README.md

@@ -71,6 +71,8 @@ It has x86 and x64 builds only, so Windows on ARM cannot run the bootrom step.
 ## Notes
 
 - From stock, the script asks for the fastboot gesture.
+- A ring that stays solid blue at the fastboot gesture can mean a bad USB
+  connection. Unplug, then try again or try another port.
 - Do not set up a stock Dot in the Alexa app before you unlock it. On Wi-Fi it
   can update to a build the script does not support.
 - [docs/rooting.md][rooting] says why each step is there.
@@ -121,11 +123,15 @@ driver](#windows).
 
 When a run fails, run it again with `--report`, then please stop by
 `#support-device-unlocking` in the
-[EchoMuse Discord](https://discord.gg/vq3pub8Kp) and paste what it prints. It
+[EchoMuse Discord](https://discord.gg/vAPHMDvREG) and paste what it prints. It
 starts the Dot's recovery, prints what the Dot, its eMMC and this computer are,
 and the Dot's partition table, and writes no partition. A Dot already in a
 recovery stays there, and the Dot is left in its recovery afterwards.
 
+`--report` also names the device and lists its USB devices. firebreak supports
+only the Echo Dot (2nd Generation), but the report is the same on other Echo
+devices, such as the Echo (2nd Generation), and helps add them.
+
 `--write-test` then tells a failing eMMC from a failing cable. It pushes a
 pattern into the Dot's RAM, then has the Dot write it over its own `cache`
 partition and read it back, so nothing crosses USB. It erases `cache`, which

firebreak-0.3.0/docs/biscuit-partitions.csv

@@ -0,0 +1,216 @@
+build,partition,bytes,sha256
+Fire OS 5.5.0.3,boot,7733248,397cf3c47d9bf40560dde0dce17a6186833953a273c7f176251074c3a541ff1a
+Fire OS 5.5.0.3,system,805306368,97b3d39c430247ededa091cc3efb47509c0b589c5cf7b7ab8cfe1707e3d613c6
+Fire OS 5.5.0.3,lk,360684,5f342ec40e85e4acc828a166c2277caac4467231b393e2b3f5c3567b795a3630
+Fire OS 5.5.0.3,tee,2625536,855f06bf48bacd1e96424307b3a5e343c7865d917de88b4fd839123c9f419797
+Fire OS 5.5.0.3,preloader,1048576,c8596cbcdab07a4885d8ad32208e806867e18b9aef7a5723e8f61b527c45e827
+Fire OS 5.5.3.1,boot,7757824,0ee7a8bbd23912c7c14c61ac1f219fe8ee7e29ab2b8b2407c0ce29a60c9323f5
+Fire OS 5.5.3.1,system,805306368,bd928aa5087b8d8c40095c784dfc159cc2555ed4130d617b258bfd0a06659f7c
+Fire OS 5.5.3.1,lk,359204,c5245300bf0258ddf626607f2d308d05364c55aeff31012391fe3b15726d2887
+Fire OS 5.5.3.1,tee,2625536,855f06bf48bacd1e96424307b3a5e343c7865d917de88b4fd839123c9f419797
+Fire OS 5.5.3.1,preloader,1048576,75189cf0391c8a9d51427b924aa087f8edb5cb4c17d26970ee852fdcb8097483
+Fire OS 5.5.4.6,boot,7714816,5cb9628a0098b9acd168e2ee94472ccb5d7db07202cdd7a71af7a015f8325f4f
+Fire OS 5.5.4.6,system,805257216,0b1dcc2e9f01b7eb0f4e8ee3ecb448b112e2dfe399fbd69e5fb024b01de45ae0
+Fire OS 5.5.4.6,lk,359204,c5245300bf0258ddf626607f2d308d05364c55aeff31012391fe3b15726d2887
+Fire OS 5.5.4.6,tee,2625536,855f06bf48bacd1e96424307b3a5e343c7865d917de88b4fd839123c9f419797
+Fire OS 5.5.4.6,preloader,1048576,2609d8f972922eee7f7fed58d712d8a365a0ac3f2ee14266b86f1159735b20c6
+Fire OS 5.5.4.9,boot,7718912,0ad9d0fa8c7c753f4ed9d5a469b5a80854f034a135306ef03affdbf712e401d4
+Fire OS 5.5.4.9,system,805257216,38539a309817b02006fb15042186ff479028196e08fb6e12006e8298d6c0c7f4
+Fire OS 5.5.4.9,lk,359744,1ebc445c4f4e0c973b94e1d2bcf037cd4e9ad4f1e91511b673b06711f6921da1
+Fire OS 5.5.4.9,tee,2625536,855f06bf48bacd1e96424307b3a5e343c7865d917de88b4fd839123c9f419797
+Fire OS 5.5.4.9,preloader,1048576,9fe9a9d8a2ad8e0017e4ffb4d69e44632f41a329a30527fde245749414f8ee07
+Fire OS 5.5.5.0,boot,7718912,d35e10d8296d5c9feb20647ddda104382b50253248c4fcc622c797e273d5b5f0
+Fire OS 5.5.5.0,system,805257216,c2a988977400925e82088d817e58537012b327ca2a2cbb297c532cffe27d561a
+Fire OS 5.5.5.0,lk,359744,1ebc445c4f4e0c973b94e1d2bcf037cd4e9ad4f1e91511b673b06711f6921da1
+Fire OS 5.5.5.0,tee,2625536,855f06bf48bacd1e96424307b3a5e343c7865d917de88b4fd839123c9f419797
+Fire OS 5.5.5.0,preloader,1048576,96595ba2415e4e2b443dc85cc69cfe1cd32a1670b6d05b7b5494b783a21d971d
+Fire OS 5.5.5.4,boot,7720960,ea2bf4643d4d75d6b560dd35aeb27fae042d732f6c13bfabbe15cfaba9f952ed
+Fire OS 5.5.5.4,system,805257216,5d84a9be45cc37b3c44b6213a58703308d1f906da8f8e9e57c768cc42cb34a49
+Fire OS 5.5.5.4,lk,359744,c8a0b1f234647d9899a3975c08045903a9ac595c1f2cbab7c040e09bcd20668e
+Fire OS 5.5.5.4,tee,2641920,fe1de9f18aa0f82a308f0c08da3be1f7c7ac2fd65832e26a3a6bdeb0e6e10136
+Fire OS 5.5.5.4,preloader,1048576,49193a8c06f3ac4c70691cb8bcaa3e2ddcefbd36d54b8d425a014aa2318846ff
+Fire OS 6 4310,boot,9656320,2d1313aee5663fd2f0186f9712daee7aa4e428c17b2c90a68ac2b5c9c9d5c242
+Fire OS 6 4310,system,805306368,0bf8fe43c6cb430226c25d978ad4fe63e29ae8ec945d0cadb592d95c393697d0
+Fire OS 6 4310,lk,241448,466e3e5447a522069263de2d90657acb69688081d74ac84fd8b944e9637c2588
+Fire OS 6 4310,tee,2812928,f4ec7c909c610f1b915c5bc3e9e995b97d554b9ac99018818a0055a19cdd326e
+Fire OS 6 4310,preloader,1048576,55250d512ffc48dd42167d13d2f48e1b5abc46d9a4b7ab3d95cbb83b80f64edc
+Fire OS 6 4313,boot,9656320,d175ea0f64c477620fc8eed050f6780e9af6745024c96415c13c4cf4fe365e61
+Fire OS 6 4313,system,805306368,b3cb58e4ee0280ae7bf801ef8625e355bc77ddb573af9604417db6e09255e58e
+Fire OS 6 4313,lk,241448,466e3e5447a522069263de2d90657acb69688081d74ac84fd8b944e9637c2588
+Fire OS 6 4313,tee,2812928,f4ec7c909c610f1b915c5bc3e9e995b97d554b9ac99018818a0055a19cdd326e
+Fire OS 6 4313,preloader,1048576,4aea4ae273a46a730e04716bdbc0b1d7f5c7d10a2241a4ca39402d3b1b337c5d
+Fire OS 6 4315,boot,9656320,650753e70fd67bbc3be7004b1b64a9350823e912a7c6a1fb23f0e9cae220b61f
+Fire OS 6 4315,system,805306368,5d056802f120a90c2428b7e80968ca5bbf120a03f718ce7cdcddf38e2a41cf80
+Fire OS 6 4315,lk,241448,466e3e5447a522069263de2d90657acb69688081d74ac84fd8b944e9637c2588
+Fire OS 6 4315,tee,2812928,f4ec7c909c610f1b915c5bc3e9e995b97d554b9ac99018818a0055a19cdd326e
+Fire OS 6 4315,preloader,1048576,39cbb9439799ae1a0e3b5ab7e2a1e659e953259256e1ae2f9bcf4d9db5164b73
+Fire OS 6 4405,boot,9658368,0edec3d8276b2a5fd67b55a1d55cd9e27e0fb4b162277f786891acba338cb8bc
+Fire OS 6 4405,system,805306368,1238588d1b3ce992d018e0f813150700e258063edd96eb19c6dee21e6c9f5ff6
+Fire OS 6 4405,lk,245760,a993322de3c26b709f3b13fb0ab58c106649136acf8dc7ba571e60fcc94b6d86
+Fire OS 6 4405,tee,2813952,8f2f5ca4862088a849d8cae90e6647d1f022214f4b4e5cce80cc8faa52cab526
+Fire OS 6 4405,preloader,1048576,8035e369dbd5ed0076676dc3f664378f41b0591f75ea1a1b6c8ca257ee69f422
+Fire OS 6 4521,boot,9658368,245251293b14df1d985ba8d14fb2b390a70ed1d3f778ca26a4807d956d698102
+Fire OS 6 4521,system,805306368,a9d7d0ee8bd1abf597607bb29978e595412bec3674decd037dc3b96ae8596a89
+Fire OS 6 4521,lk,245760,a993322de3c26b709f3b13fb0ab58c106649136acf8dc7ba571e60fcc94b6d86
+Fire OS 6 4521,tee,2813952,8f2f5ca4862088a849d8cae90e6647d1f022214f4b4e5cce80cc8faa52cab526
+Fire OS 6 4521,preloader,1048576,70df704a61cde29a1a643b0a72adb73b7f619c1406d60fad437c9be076d10978
+Fire OS 6 4657,boot,9658368,d88f806b010aa21c92ad2207a00e71e3acfa945755fa1cd768dd191330c9f2f8
+Fire OS 6 4657,system,805306368,c40601525f3e94344cc0d2f8f4e31dd6ab9430797cabc155edddb28bf9781584
+Fire OS 6 4657,lk,245760,a993322de3c26b709f3b13fb0ab58c106649136acf8dc7ba571e60fcc94b6d86
+Fire OS 6 4657,tee,2813952,8f2f5ca4862088a849d8cae90e6647d1f022214f4b4e5cce80cc8faa52cab526
+Fire OS 6 4657,preloader,1048576,fd223968939fad93e6c0f27115657ead91481bf8211a7ca3ed5a90dfae026d26
+Fire OS 6 4660,boot,9658368,e09fad5e2ec00bd6bbb02e60f8f20a7b76a413e8184e0b1cb02fac37c5ff8a0e
+Fire OS 6 4660,system,805306368,b9731f85ec8d2ac6df9ddaf133a1e138847d6835e9c0ce5448460c0e15497f15
+Fire OS 6 4660,lk,245760,a993322de3c26b709f3b13fb0ab58c106649136acf8dc7ba571e60fcc94b6d86
+Fire OS 6 4660,tee,2813952,8f2f5ca4862088a849d8cae90e6647d1f022214f4b4e5cce80cc8faa52cab526
+Fire OS 6 4660,preloader,1048576,d3f6696d52db6aa7f11be1f38a6b779fe0853d67e29781b0a9c0a93e8606faf5
+Fire OS 6 4774,boot,9662464,885ce35b2f28ec01f1b71d91d3719d76c399961e2c3a83c44f1adba5369310bc
+Fire OS 6 4774,system,805306368,90477197e2e856b0fd14a26eaad0feb395e4f9341ad915518c729cae75df53d8
+Fire OS 6 4774,lk,245760,a993322de3c26b709f3b13fb0ab58c106649136acf8dc7ba571e60fcc94b6d86
+Fire OS 6 4774,tee,2813952,8f2f5ca4862088a849d8cae90e6647d1f022214f4b4e5cce80cc8faa52cab526
+Fire OS 6 4774,preloader,1048576,ab570a88a5bb20901afcd683a8efc79515292d8c446c8128e81a3b62813e6ca6
+Fire OS 6 4779,boot,9662464,412d38c34458194ce41b0633729b09c4f10ee962da3a428ebbfd4a6d442545ca
+Fire OS 6 4779,system,805306368,802cd5b938b3ad5b4a3c8846994dc5d47f79e5eec6686417cfce2880e9804d58
+Fire OS 6 4779,lk,245760,a993322de3c26b709f3b13fb0ab58c106649136acf8dc7ba571e60fcc94b6d86
+Fire OS 6 4779,tee,2813952,8f2f5ca4862088a849d8cae90e6647d1f022214f4b4e5cce80cc8faa52cab526
+Fire OS 6 4779,preloader,1048576,c549aee85ed19bab576da2df0edf19bacf484564385bd97db16fb1ce8fe4d196
+Fire OS 6 4781,boot,9662464,92ef9ec8da1c7407ff5589b1c74bc9d7cbd6b6296572a5c30abd5f4b3ff9951b
+Fire OS 6 4781,system,805306368,4c75fbd29361cb5e15ffdfcd599ac171d98e56f066a484fb6495ad5b3eb3c13c
+Fire OS 6 4781,lk,245760,a993322de3c26b709f3b13fb0ab58c106649136acf8dc7ba571e60fcc94b6d86
+Fire OS 6 4781,tee,2813952,8f2f5ca4862088a849d8cae90e6647d1f022214f4b4e5cce80cc8faa52cab526
+Fire OS 6 4781,preloader,1048576,332638615a90bc81199ffea5cd46245222c08f818fa733e1718c4075cd4ca998
+Fire OS 6 4929,boot,9666560,56b713505b2e0a69f3d49027a15babba65190f3ff761e8a2456ebaa9852fabd8
+Fire OS 6 4929,system,805306368,ad00c0265040e3cf549ad9b5cae8601f3f881ad2824b1f2434214fc0a3bdb63b
+Fire OS 6 4929,lk,245760,a993322de3c26b709f3b13fb0ab58c106649136acf8dc7ba571e60fcc94b6d86
+Fire OS 6 4929,tee,1781760,d363175c9f2a4f1dad5fb317303d12758f0c5617848dc3564b6f574581a86a71
+Fire OS 6 4929,preloader,1048576,270f9b76bca64bb21aba8a4dab944feae17359419e22ab245b429c9f2af8c58d
+Fire OS 6 4936,boot,9666560,abe62d14e97f0eeb848feff4ecb926ab3fdf38a9daf2fcba33deaffd6301e5ba
+Fire OS 6 4936,system,805306368,d713d6b1707507857ff65c84cf3e212af05fa3ab31510727665c359e66e65dd4
+Fire OS 6 4936,lk,245760,a993322de3c26b709f3b13fb0ab58c106649136acf8dc7ba571e60fcc94b6d86
+Fire OS 6 4936,tee,1781760,d363175c9f2a4f1dad5fb317303d12758f0c5617848dc3564b6f574581a86a71
+Fire OS 6 4936,preloader,1048576,0581f2209ab2c815c6c4e0b8ee7fa082839663e9d63b831e32504e25b40762ad
+Fire OS 6 5041,boot,9658368,80d6e629cd092149f5ceb7dae105131622ddd42ab20321f10258df0a1496e1a1
+Fire OS 6 5041,system,805306368,50b06cef6c07e1cb42eb4028a348d8ce7bfb10a9e09979d347e06f1dcd3bdf9d
+Fire OS 6 5041,lk,245760,a993322de3c26b709f3b13fb0ab58c106649136acf8dc7ba571e60fcc94b6d86
+Fire OS 6 5041,tee,2813952,8f2f5ca4862088a849d8cae90e6647d1f022214f4b4e5cce80cc8faa52cab526
+Fire OS 6 5041,preloader,1048576,e89e640fd94fca2677fbc1848eaddecb494df90fe9f06dd227b34d836dbfc13b
+Fire OS 6 5160,boot,9666560,a7e88dc2cc4258d3db7e30248b0c3e579f996697ee2f837163f83c0bc6af1201
+Fire OS 6 5160,system,805306368,c0f04ceb3e36a96b6422d634f719b2173379de12f9e68fdb743f99c0397c96d7
+Fire OS 6 5160,lk,245760,a993322de3c26b709f3b13fb0ab58c106649136acf8dc7ba571e60fcc94b6d86
+Fire OS 6 5160,tee,1781760,d363175c9f2a4f1dad5fb317303d12758f0c5617848dc3564b6f574581a86a71
+Fire OS 6 5160,preloader,1048576,7dd4122695bb5be298064ca899016fe0a38b5210a61f9c5e8c626586b3dc9701
+Fire OS 6 5295,boot,9674752,055eb74d00fa657dcf24d6070a7b81dabcbc3d66164eed45d39ee303bbf40f19
+Fire OS 6 5295,system,805306368,8f36fbd8b5a363d56c326a7f92c8e670b68954eaa21987590fd7125e586339f3
+Fire OS 6 5295,lk,245760,a993322de3c26b709f3b13fb0ab58c106649136acf8dc7ba571e60fcc94b6d86
+Fire OS 6 5295,tee,1781760,d363175c9f2a4f1dad5fb317303d12758f0c5617848dc3564b6f574581a86a71
+Fire OS 6 5295,preloader,1048576,b386187b9936f09a5621fd1b5e0606da5b40dc8553e7f29737c5a10d0c49b5af
+Fire OS 6 5403,boot,9674752,01592125ec9f0080683e0dae7147f94a0c4b63ff9653b57a8e6c8a986181d841
+Fire OS 6 5403,system,805306368,2263a692fa189059996b1573e531ac21fccdfb454989c605714e5564a3faf49a
+Fire OS 6 5403,lk,245760,a993322de3c26b709f3b13fb0ab58c106649136acf8dc7ba571e60fcc94b6d86
+Fire OS 6 5403,tee,1781760,d363175c9f2a4f1dad5fb317303d12758f0c5617848dc3564b6f574581a86a71
+Fire OS 6 5403,preloader,1048576,03d5079bf979ef48d9b4a16509a4d7c1cc3c2c5f371c19419fa73e02d2bacdf5
+Fire OS 6 5531,boot,9674752,bfd26f91260f5f02535ece3579a452f5cc001bb08ad9262f4552ec7cc44fcbaf
+Fire OS 6 5531,system,805306368,cf58abccd49c2958a583f93cc96f4b439ee68fa8296231565cd31ad699d8a705
+Fire OS 6 5531,lk,245760,a993322de3c26b709f3b13fb0ab58c106649136acf8dc7ba571e60fcc94b6d86
+Fire OS 6 5531,tee,1781760,d363175c9f2a4f1dad5fb317303d12758f0c5617848dc3564b6f574581a86a71
+Fire OS 6 5531,preloader,1048576,8a27ebc6335e1b82ee649c482ef675f7fb0072162ec1e392078ef644f0150394
+Fire OS 6 5555,boot,9674752,d89b1513802a2f30601d980617451fcf54c2c9cf98d2287060b5b24323471bb6
+Fire OS 6 5555,system,805306368,5fac302e5aad27a0f193029fd9092fbcad2ad082bb86d7c5c12c4229f0baae53
+Fire OS 6 5555,lk,245760,a993322de3c26b709f3b13fb0ab58c106649136acf8dc7ba571e60fcc94b6d86
+Fire OS 6 5555,tee,1781760,d363175c9f2a4f1dad5fb317303d12758f0c5617848dc3564b6f574581a86a71
+Fire OS 6 5555,preloader,1048576,09ab5181729834d8cd4bfb002aa797ed0e642b2f67036baaeb5499e93c407908
+Fire OS 6 6009,boot,9674752,ab562def25e1a9e1761760cfa50ac57ea393115b20fe2fa4bf2e501b1a893a4d
+Fire OS 6 6009,system,805306368,b7ad77dd0354b46a08914a2aee44789f5a906034725c969e27e6c454ab7e779e
+Fire OS 6 6009,lk,245760,a993322de3c26b709f3b13fb0ab58c106649136acf8dc7ba571e60fcc94b6d86
+Fire OS 6 6009,tee,1781760,d363175c9f2a4f1dad5fb317303d12758f0c5617848dc3564b6f574581a86a71
+Fire OS 6 6009,preloader,1048576,8f49de9f0df8c0e2f31acb4f461a814be68eec24a3a037e908e346f4d3ea0822
+Fire OS 6 6077,boot,9674752,2d559f6e3bc7175c327a9b5129eeca582aafe6747cc38e21030c8902cd6c6f0e
+Fire OS 6 6077,system,805306368,3d1115231276526a0699de94da76d2b628cb0bf2200945161f3f181f9eed2b62
+Fire OS 6 6077,lk,245760,a993322de3c26b709f3b13fb0ab58c106649136acf8dc7ba571e60fcc94b6d86
+Fire OS 6 6077,tee,1781760,d363175c9f2a4f1dad5fb317303d12758f0c5617848dc3564b6f574581a86a71
+Fire OS 6 6077,preloader,1048576,333af4f4e59d811a8fcbbd5c598b8c5d072ed5c9f8163694d3a48dfbe7cfe581
+Fire OS 6 6086,boot,9674752,887c7ae326ce47fdceb5dcd2cdc900a702e14331d3bdb6c95fa13e37885f7aea
+Fire OS 6 6086,system,805306368,27962f3dc37022f426dd5b32fb9894c6a3ffffdc3dec119dfe191ec577d2f579
+Fire OS 6 6086,lk,245760,a993322de3c26b709f3b13fb0ab58c106649136acf8dc7ba571e60fcc94b6d86
+Fire OS 6 6086,tee,1781760,d363175c9f2a4f1dad5fb317303d12758f0c5617848dc3564b6f574581a86a71
+Fire OS 6 6086,preloader,1048576,93c31cde70eeea8b0ade4a3594f600e404befe7dbc381f19e99e7b5bf27eaa1d
+Fire OS 6 6176,boot,9678848,cd2638f0bc05f49f340d002a52b9e5239ebdc02befde721eb5fe7145a33b3220
+Fire OS 6 6176,system,805306368,6d58a3775a1b39e4dbf1fff94abf984ae88acad392232ba81a77b3a3e5e253ee
+Fire OS 6 6176,lk,245760,a993322de3c26b709f3b13fb0ab58c106649136acf8dc7ba571e60fcc94b6d86
+Fire OS 6 6176,tee,1781760,d363175c9f2a4f1dad5fb317303d12758f0c5617848dc3564b6f574581a86a71
+Fire OS 6 6176,preloader,1048576,2c45ea10880e7405aabea445fc21082f9ec9ef4923a2c5b83f6b70bd30367fda
+Fire OS 6 6193,boot,9674752,8bc8464ba8c321da7ee74229cc03167c9fbd48c2e7c631e65ee4f61bdc10b014
+Fire OS 6 6193,system,805306368,168be5603759e6be610a783defc10ecd30c69a716399a1a10101fb6b07dcc76f
+Fire OS 6 6193,lk,245760,a993322de3c26b709f3b13fb0ab58c106649136acf8dc7ba571e60fcc94b6d86
+Fire OS 6 6193,tee,1781760,d363175c9f2a4f1dad5fb317303d12758f0c5617848dc3564b6f574581a86a71
+Fire OS 6 6193,preloader,1048576,817cdb50ff88dad781ae2fcf5f5818184b49e3fa229d117a6f260462b4dec457
+Fire OS 6 6199,boot,9674752,1081a2fb46183ad7a74902d5b460b75e6c890584293b85e4b6606339fc33e5b6
+Fire OS 6 6199,system,805306368,81d94db62690845b7e904f9084a5cc9f75b421b12115977fe0450beb6af4d16a
+Fire OS 6 6199,lk,245760,a993322de3c26b709f3b13fb0ab58c106649136acf8dc7ba571e60fcc94b6d86
+Fire OS 6 6199,tee,1781760,d363175c9f2a4f1dad5fb317303d12758f0c5617848dc3564b6f574581a86a71
+Fire OS 6 6199,preloader,1048576,1c09c3f8a87ae2ac06b7361806cd4e5fdcef196186d2df53992b43a727c7edbc
+Fire OS 6 6208,boot,9674752,5e1b5810f3668a0b4bb250e3520a7857121c7622c4362f77d3874f846f04062a
+Fire OS 6 6208,system,805306368,6b8a97e699bd66e563dfd2ba3112bcaa5b0796ac4e5c7daf7b3f95fc7d2b6ab8
+Fire OS 6 6208,lk,245760,a993322de3c26b709f3b13fb0ab58c106649136acf8dc7ba571e60fcc94b6d86
+Fire OS 6 6208,tee,1781760,d363175c9f2a4f1dad5fb317303d12758f0c5617848dc3564b6f574581a86a71
+Fire OS 6 6208,preloader,1048576,6a16907ab1e24fe5d08ba4c6eadba451911e5af44c63679c160e04d39284373c
+Fire OS 6 6220,boot,9674752,5186ba149d6c11f7f7a9bcd122d7cae462702e330ea627b2edfb1418c5d05b71
+Fire OS 6 6220,system,805306368,9286ec33509d7e4e2a1ca0d92ecb8334708d3d6d06bf1e52fa057144f43bbc3f
+Fire OS 6 6220,lk,245760,a993322de3c26b709f3b13fb0ab58c106649136acf8dc7ba571e60fcc94b6d86
+Fire OS 6 6220,tee,1781760,d363175c9f2a4f1dad5fb317303d12758f0c5617848dc3564b6f574581a86a71
+Fire OS 6 6220,preloader,1048576,7e5e1f4f44b6ae2b5b7c744bac8a99fc93c56174ee707a583cd9c5f275fe1eca
+Fire OS 6 6302,boot,9674752,f1b4a4d4fea1e33458ed53eef53f618d80a04f90b3fa542d369a1eae54e1cfcd
+Fire OS 6 6302,system,805306368,8f067a747bced9c8bc54dfd2f7bd8f875fd1a794183c51b0ba95f0c4d0d105b5
+Fire OS 6 6302,lk,245760,a993322de3c26b709f3b13fb0ab58c106649136acf8dc7ba571e60fcc94b6d86
+Fire OS 6 6302,tee,1781760,d363175c9f2a4f1dad5fb317303d12758f0c5617848dc3564b6f574581a86a71
+Fire OS 6 6302,preloader,1048576,62c43bb4ae787ad5123a90057f5e7a54d1110a2607ff09c0ad3538eb164d2b5f
+Fire OS 6 6448,boot,9678848,1f607e64659afb18ad299abadbe034625de63e28f1427629352958b0ebb0115e
+Fire OS 6 6448,system,805306368,320919d8b7fbcb6aa39f041555ac91a23fbf138a4050f345e30125cacb4dee0e
+Fire OS 6 6448,lk,245760,a993322de3c26b709f3b13fb0ab58c106649136acf8dc7ba571e60fcc94b6d86
+Fire OS 6 6448,tee,1781760,d363175c9f2a4f1dad5fb317303d12758f0c5617848dc3564b6f574581a86a71
+Fire OS 6 6448,preloader,1048576,5d74977c104ccecefa2382946657aab9d01465345c15cc3fd67dd6d7d805cdf8
+Fire OS 6 6562,boot,9678848,1f10c18b0854450ce259670a8b8c879f0b520662cfe7ccb7c76e8c1f935d9a99
+Fire OS 6 6562,system,805306368,03b25ed72d6e7e7ca677805cf7c63edd95298bea45194bee34f46212b839bd0e
+Fire OS 6 6562,lk,245760,a993322de3c26b709f3b13fb0ab58c106649136acf8dc7ba571e60fcc94b6d86
+Fire OS 6 6562,tee,1781760,d363175c9f2a4f1dad5fb317303d12758f0c5617848dc3564b6f574581a86a71
+Fire OS 6 6562,preloader,1048576,ed2ab80ae12bed21c9fc203270872b82742cafa4b87ecebce6aedfd786c1dddc
+Fire OS 6 6813,boot,9674752,27c960116a7b52ca2cd7efd45f1631eaa429ef76564c2d58347f5fb34f957d50
+Fire OS 6 6813,system,805306368,a0f341071b046dc0bad38e5ef595efd6c75d56d5aa88390c9d5bc4cc63d9c029
+Fire OS 6 6813,lk,245760,a993322de3c26b709f3b13fb0ab58c106649136acf8dc7ba571e60fcc94b6d86
+Fire OS 6 6813,tee,1781760,d363175c9f2a4f1dad5fb317303d12758f0c5617848dc3564b6f574581a86a71
+Fire OS 6 6813,preloader,1048576,3f857714a83796df84a4a2402b3841d8ec94eb6d29996570658bdd745d2a0199
+Fire OS 6 7577,boot,9678848,333f6270e1c5a74d736f81f027459347f30af794de06ae8d7bdf44f01ae5bf1b
+Fire OS 6 7577,system,805306368,a6380c2047e3c34c8bea283f6498e65336ca12e23071e45983d2ecd3a1ee21e8
+Fire OS 6 7577,lk,245760,a993322de3c26b709f3b13fb0ab58c106649136acf8dc7ba571e60fcc94b6d86
+Fire OS 6 7577,tee,1781760,d363175c9f2a4f1dad5fb317303d12758f0c5617848dc3564b6f574581a86a71
+Fire OS 6 7577,preloader,1048576,182c90c6e8acb5f5375b9043c4c37e3d78dde3a2f82c0c263fd113e6b6564be6
+Fire OS 6 7595,boot,9678848,8f47ceb4e38bf66f79dc0305979bb2c3a52c3a5e8c8b9bbc1321dcc31a92c307
+Fire OS 6 7595,system,805306368,c1030bcf60b4475b2ef746d3b65f6a013da592dcdbb57f82f063817a9cb199de
+Fire OS 6 7595,lk,245760,a993322de3c26b709f3b13fb0ab58c106649136acf8dc7ba571e60fcc94b6d86
+Fire OS 6 7595,tee,1781760,d363175c9f2a4f1dad5fb317303d12758f0c5617848dc3564b6f574581a86a71
+Fire OS 6 7595,preloader,1048576,027818ae60e0dca247cc0099e9d8dad6f89ede4a6a2bab101ca139110e9f9a8d
+Fire OS 6 7623,boot,9678848,5a1b9f5e9b1d201fa48fb64401e5ffacaf2f3f28048519e72ac89c0149436312
+Fire OS 6 7623,system,805306368,eccfa850c3009d5454f69a411c0b757be642059b3224cae8fc941fa0dd22c570
+Fire OS 6 7623,lk,245760,a993322de3c26b709f3b13fb0ab58c106649136acf8dc7ba571e60fcc94b6d86
+Fire OS 6 7623,tee,1781760,d363175c9f2a4f1dad5fb317303d12758f0c5617848dc3564b6f574581a86a71
+Fire OS 6 7623,preloader,1048576,08f61f2da348c9e26031a272455979496f4ac7e9792189bdcad089a487b3d6db
+Fire OS 6 8138,boot,9678848,a354f5641606210cea9e3f2ff3df18c7219968c759cb524f42433546fc003c2f
+Fire OS 6 8138,system,805306368,014da6fd722fdecf4d9f3ba86ab2e579a622e6fec380df92a404e79ace1e1f97
+Fire OS 6 8138,lk,245760,a993322de3c26b709f3b13fb0ab58c106649136acf8dc7ba571e60fcc94b6d86
+Fire OS 6 8138,tee,1781760,d363175c9f2a4f1dad5fb317303d12758f0c5617848dc3564b6f574581a86a71
+Fire OS 6 8138,preloader,1048576,b8e72a5093704a41bb6b9554c5aa9de1f55dab910af75a41bb87695546a57743
+Fire OS 6 8142,boot,9678848,68ad3d3a6000ec1aa37bcb41c2b9e8a301016b3c6588da8c53ebb16ac887b484
+Fire OS 6 8142,system,805306368,1f02da45a70eeed3095149b82e4202c2729bcf340abe1856ee0f6b6efb698a4c
+Fire OS 6 8142,lk,245760,a993322de3c26b709f3b13fb0ab58c106649136acf8dc7ba571e60fcc94b6d86
+Fire OS 6 8142,tee,1781760,d363175c9f2a4f1dad5fb317303d12758f0c5617848dc3564b6f574581a86a71
+Fire OS 6 8142,preloader,1048576,ecc70921fcff78761dc52b64419a0add19e93aa6f98d0768a02f94d6109715cc
+Fire OS 6 8146,boot,9678848,1f20dd939ecbe9ce0a55655e8569ff909ddc8afade297c3464b0957097c0316a
+Fire OS 6 8146,system,805306368,03167999b5b95a4e972be23b7bba19fd14444aa8e9bb341df6ce16c50ec5107c
+Fire OS 6 8146,lk,245760,a993322de3c26b709f3b13fb0ab58c106649136acf8dc7ba571e60fcc94b6d86
+Fire OS 6 8146,tee,1781760,d363175c9f2a4f1dad5fb317303d12758f0c5617848dc3564b6f574581a86a71
+Fire OS 6 8146,preloader,1048576,364a40bdf4535dcce974d9a806e1e98327392171ab4cdbdcc9bc4abbfba94631
+Fire OS 6 8149,boot,9678848,28cea065a4ba36d3e7a57fde1d1270b90680ef44a48dd1dd48b4f5d00d15c508
+Fire OS 6 8149,system,805306368,54b466923d5eab496c71ce01d377572235c03787dfe9497a8dbc447f660dd2c8
+Fire OS 6 8149,lk,245760,a993322de3c26b709f3b13fb0ab58c106649136acf8dc7ba571e60fcc94b6d86
+Fire OS 6 8149,tee,1781760,d363175c9f2a4f1dad5fb317303d12758f0c5617848dc3564b6f574581a86a71
+Fire OS 6 8149,preloader,1048576,6ca1e642926a9e26540132cbcdf9eb137cf83aea9fdc00c7a607e0e7402c4b08

firebreak-0.3.0/docs/devices.md

@@ -0,0 +1,168 @@
+# Devices
+
+The firmware each supported device's OTAs ship, and radar's, which firebreak
+does not support yet.
+
+## biscuit
+
+The Echo Dot (2nd Generation). Read in October 2026 from 37 Fire OS 6 OTAs on
+ftvdb, 4310 to 8149, and from the Fire OS 5.5.0.3, 5.5.3.1, 5.5.4.6, 5.5.4.9,
+5.5.5.0 and 5.5.5.4 OTAs.
+
+### Builds
+
+| ships in | `lk_build_desc` | `pl_build_desc` | TEE | anti-rollback PL, TEE, LK | fastbrick image |
+| --- | --- | --- | --- | --- | --- |
+| Fire OS 6 4929 to 8149, except 5041 | `63cb91b-20221007_072309` | `bd7ae89-20221003_215949` | [5](#tee-images) | 0x0005, 0x0102, 0x0001 | `fastbrick-20221007.img` |
+| Fire OS 6 4405 to 4781, and 5041 | `63cb91b-20221007_072309` | `bd7ae89-20221003_215949` | [4](#tee-images) | 0x0005, 0x0102, 0x0001 | `fastbrick-20221007.img` |
+| Fire OS 6 4310, 4313, 4315 | `41fb3ce-20221007_151724` | `919cae9-20221006_203733` | [3](#tee-images) | 0x0005, 0x0102, 0x0001 | `fastbrick-20221007.img` |
+| Fire OS 5.5.5.4 | `beb022a-20211202_231918` | `ed021f9-20211202_231918` | [2](#tee-images) | 0x0005, 0x0102, 0x0001 | `fastbrick.img` |
+| Fire OS 5.5.4.9, 5.5.5.0 | `a828f29-20210822_210511` | `531fa14-20170929_175429` | [1](#tee-images) | 0x0005, 0x0102, 0x0001 | `fastbrick.img` |
+| Fire OS 5.5.3.1 to 5.5.4.6 | `f379dba-20170906_000423` | `531fa14-20170929_175429` | [1](#tee-images) | 0x0005, 0x0102, 0x0001 | `fastbrick.img` |
+| Fire OS 5.5.0.3 | `0e1d0d9-20161018_220224` | `292ae9d-20160915_232723` | [1](#tee-images) | 0x0003, 0x0102, 0x0001 | `fastbrick.img` |
+
+- Only the LK chooses the fastbrick image. [rooting.md](rooting.md#unlock-amonet-v200)
+  says how.
+- The preloaders of one row differ between builds only in boot0's GPT, whose
+  partition GUIDs are random.
+
+### TEE images
+
+| TEE | bytes | md5 | sha256 |
+| --- | --- | --- | --- |
+| 5 | 1781760 | `196a1873db19a1e862a4f07057e57482` | `d363175c9f2a4f1dad5fb317303d12758f0c5617848dc3564b6f574581a86a71` |
+| 4 | 2813952 | `52e8575f206c927239fafc995533a30e` | `8f2f5ca4862088a849d8cae90e6647d1f022214f4b4e5cce80cc8faa52cab526` |
+| 3 | 2812928 | `78f671ba4540a70e760459ce54a1a5fa` | `f4ec7c909c610f1b915c5bc3e9e995b97d554b9ac99018818a0055a19cdd326e` |
+| 2 | 2641920 | `8ef5717ad9b232403bb2447918e0cdcd` | `fe1de9f18aa0f82a308f0c08da3be1f7c7ac2fd65832e26a3a6bdeb0e6e10136` |
+| 1 | 2625536 | `dbb59ab6087405f9a26dd827ef54fda8` | `855f06bf48bacd1e96424307b3a5e343c7865d917de88b4fd839123c9f419797` |
+
+- Each hash covers the image only. To match a Dot's `tee1` or `tee2`, hash
+  its first N bytes, where N is the bytes column.
+- The ATF and TEE inside each image are encrypted. The preloader unwraps
+  their key with the SoC's hidden key, so no OTA shows a TEE build string.
+
+### Anti-rollback
+
+The preloader compares three versions with the ones in RPMB, and fastboot
+reports them as `antirback_pl_version`, `antirback_tee_version` and
+`antirback_lk_version`.
+
+- PL: a constant in the preloader's code. After the check loads the string
+  `[ANTI-ROLLBACK] Updating PL version`, its second `bl` calls a Thumb-2
+  function that is `movs r0, #N` and `bx lr`. N is the version.
+- TEE: the 16 bits at offsets 0xf and 0x10 of the TEE's plaintext
+  `EET KTM` header, high byte first.
+- LK: the 16 bits after `LK` in the LK's signature trailer, high byte first.
+- A stock 8146 Dot read `0x0005`, `0x0102` and `0x0001`.
+- PL rose from 3 to 5 after 5.5.0.3. TEE and LK are the same in every OTA.
+- A version in RPMB that is higher than the preloader's stops the boot at
+  `version mismatch!`, in a loop that only the eMMC short gets out of. The
+  short reaches the bootrom, not a boot: the Dot boots again only once its
+  RPMB is zeroed or a preloader at least as high is written. A lower version
+  is raised to the preloader's. This is read from the 8146 preloader's code,
+  not seen on a Dot.
+
+### Partition hashes
+
+[biscuit-partitions.csv](biscuit-partitions.csv) has the sha256 of the 5
+partitions each OTA writes, for every build above: boot, `/system`, lk, tee
+and the preloader.
+
+- A hash covers the image's own length, in `bytes`, and the partition is
+  larger. Hash that many bytes from the partition's start, on the active slot
+  (`ro.boot.slot_suffix`). The preloader is the first 1 MiB of boot0.
+- An A/B OTA's hashes are the ones in its `payload.bin` manifest. Every
+  payload is a full image. `/system` rebuilt from 8146's payload matched its
+  manifest.
+- A block OTA's hashes are of the files in its zip, and of `/system` rebuilt
+  from `system.new.dat` with the blocks it does not write as zeros. That is
+  Fire OS 5, and Fire OS 6 4310 to 4315.
+- Those `/system` hashes match a Dot that firebreak restored, because it
+  writes the zeros too. Amazon's updater erases those blocks and does not
+  write them: 20,458 of them on 5.5.5.4 and 79,822 on 4315. An erased block
+  reads as whatever the eMMC chip returns, so a Dot that Amazon's updater
+  installed matches only if its chip returns zeros.
+- Every build has its own boot, `/system` and preloader hash. The preloaders
+  differ only in boot0's GPT.
+- A rooted Dot matches no row. Fire OS 6 keeps its root filesystem in
+  `/system`, and amonet v2.0.0's `boot-root.zip` changes 6 files there:
+  `default.prop`, `fstab.mt8163`, `init.fosflags.sh`, `sbin/adbd`, `sepolicy`
+  and `system/build.prop`, whose `ro.build.version.number` becomes
+  `4503599628407428`. A v2 Dot on 8146's `/system` filesystem differed from
+  8146's in those files only.
+- `boot-root.zip` also writes outside those files, on both slots. It writes
+  `VOFF` over the verity metadata's magic, `01b001b0`, after `system_X`'s hash
+  tree. It sets `buildvariant=userdebug` on `boot_X`'s command line. So a
+  rooted Dot's boot and `/system` hashes both differ from every row.
+- `boot-root.zip` patches what it finds and does not carry biscuit's files. It
+  finds adbd's autoroot by a byte pattern. It patches the sepolicy with
+  `magiskpolicy32`, and falls back to a policy it bundles, chosen by the
+  stock policy's md5.
+
+### eMMC chips
+
+Read as root from `/sys/block/mmcblk0/device/` (`name`, `manfid`, `date`)
+and from each boot area's `size`, in 512-byte sectors.
+
+| chip | maker | date | boot0, boot1 | Dots |
+| --- | --- | --- | --- | --- |
+| `P1J94M` | Micron (`0xfe`) | 08/2016 | 1 MiB each | 2 |
+| `FJ25AB` | Samsung (`0x15`) | 03/2017 | 4 MiB each | 1 |
+
+- Every stock `preloader.img` is 1 MiB, so boot0 can be larger than it. The
+  stock restore pads the preloader with zeros to boot0's size.
+- The same `/system` write took 79 s on `P1J94M` and 41 s on `FJ25AB`.
+
+## radar
+
+The Echo (2nd Generation), model XC56PY. Read in October 2026 from the 10 OTAs
+on ftvdb: Fire OS 5.5.5.4 and Fire OS 6 4305, 4929, 6199, 6208, 6220, 6302,
+6425, 6436 and 6813. ftvdb has no other radar OTA.
+
+### Builds
+
+| ships in | `lk_build_desc` | `pl_build_desc` | TEE | anti-rollback PL, TEE, LK | fastbrick image |
+| --- | --- | --- | --- | --- | --- |
+| Fire OS 6 4929 to 6813 | `63cb91b-20221007_073612` | `bd7ae89-20221003_221237` | [2](#tee-images-1) | 0x0005, 0x0102, 0x0001 | `fastbrick.img` |
+| Fire OS 6 4305 | `41fb3ce-20221007_153017` | `919cae9-20221006_205014` | biscuit's [3](#tee-images) | 0x0005, 0x0102, 0x0001 | `fastbrick.img` |
+| Fire OS 5.5.5.4 | `59779ca-20220524_183401` | `642551b-20211203_021230` | [1](#tee-images-1) | 0x0005, 0x0102, 0x0001 | `fastbrick-20220524.img` |
+
+- amonet-radar v1.0.0's `profile.sh` chooses the fastbrick image by the LK,
+  as biscuit's does. Only 5.5.5.4's LK gets its own image. Both Fire OS 6 LKs
+  get the default, `fastbrick.img`.
+- No one has unlocked a radar on 4305 here. Its LK is `41fb3ce`, the same
+  commit as biscuit's 4310 to 4315 LK. On biscuit, that LK is unlocked by the
+  image its `63cb91b` LK gets, which amonet's own map does not give it. On
+  radar, amonet's map does give it that image, the default `fastbrick.img`.
+  Whether that unlocks radar 4305 is not known.
+- The preloaders of one row differ between builds only in boot0's GPT, as on
+  biscuit.
+- No OTA raises an anti-rollback version, and none is higher than biscuit's.
+  Each is read as biscuit's are, in [Anti-rollback](#anti-rollback).
+
+### TEE images
+
+| TEE | bytes | md5 | sha256 |
+| --- | --- | --- | --- |
+| 2 | 1781760 | `13a2f357ddf719afccfb707a7f1668d2` | `15cd40caafa6cd8bb8c4e4ed173c973569a8a2b026235d81776ec888f1522c72` |
+| 1 | 2641920 | `2ce20a3462ab227aa750c0f9c026d6d3` | `80e54029f5defc087ff14e5da27dd9739cbf9f684b2ed8bdc3803fd1b77db856` |
+
+### Partition hashes
+
+[radar-partitions.csv](radar-partitions.csv) has the sha256 of the 5
+partitions each OTA writes, for every build above, read as biscuit's are.
+
+- 5.5.5.4 and 4305 are block OTAs. As on biscuit, a radar that Amazon's
+  updater installed matches their `/system` only if its eMMC reads erased
+  blocks as zeros.
+- Every radar Fire OS 6 build has what biscuit's `boot-root.zip` changes:
+  each file, one autoroot site in `sbin/adbd`, a `veritykeyid` boot command
+  line, and verity metadata at the offset the zip computes.
+- `boot-root.zip` patches the sepolicy with `magiskpolicy32`. If that fails,
+  it falls back to a bundled policy, and only radar 6302's and 6813's stock
+  policy, `8f6dd232a590337314bb372e84b84e77`, has one. Nothing here has run
+  it on a radar.
+- The stock sepolicy md5 of each radar build: 4305 `d88b3344`, 4929
+  `88d5111f`, 6199 to 6220 `59fb0d21`, 6302 and 6813 `8f6dd232`, 6425 and
+  6436 `ac9825e8`. Build numbers do not follow release order: 6302 is Fire
+  OS 6.4.6.6, and 6813 is 6.5.6.6.

{firebreak-0.2.0 → firebreak-0.3.0}/docs/plugins.md

@@ -17,17 +17,37 @@ it out.
 ## Devices and unlocks
 
 `firebreak/devices.py` gives biscuit's name and its features: A/B
-slots, a boot0 and an RPMB. An unlock lists the features it requires, and
-resolution refuses a pairing that lacks one before anything is written.
+slots, a boot0 and an RPMB. radar, the Echo (2nd Generation), has the same
+features. An unlock lists the features it requires, and resolution refuses a
+pairing that lacks one before anything is written.
 
-A device also lists the partition table layouts a Dot may carry: for biscuit,
-boot moved, the table amonet v1.1.0 makes, and stock. An unlock names the
-layout it needs: boot moved for v1.1.0 and its bboe variant, stock for v2.0.0.
+A device has a title for messages, such as `Echo Dot (2nd Generation)`, and
+the USB product strings its builds report, its models: `AEOBC` and its TWRPs'
+model names for biscuit. `firebreak/identify.py` names the connected device
+from them, or from the product in fastboot. A target names its device too,
+`stock` included, and a run refuses a target for another device.
+
+A device also gives its product, the name its LKs and its fastboot report:
+`BISCUIT` and `RADAR`. It is not always the codename in capitals:
+amonet-crown v1.1.1's LK names `CHECKERS`.
 
-`firebreak/unlocks/` holds amonet v1.1.0, its bboe variant, and amonet v2.0.0.
-Each plan is amonet's `modules/main.py` and then its `fastboot-step.sh`, step
-for step. The bboe variant swaps the recovery image for TWRP 3.7.0_9-bboe2, a
-download of its own, which is why an unlock carries `files` beside its archive.
+A device also lists the partition table layouts a Dot may carry: for biscuit,
+boot moved, the table amonet v1.1.0 makes, and stock. radar lists the same
+two. Its stock table is biscuit's except where `userdata` ends, and its amonet
+has biscuit's `gpt.py`. An unlock names the layout it needs: boot moved for
+v1.1.0 and its bboe variant, stock for v2.0.0.
+
+`firebreak/unlocks/` holds amonet v1.1.0, its bboe variant, and amonet v2.0.0,
+for biscuit, and amonet-radar v1.0.0. Each plan is amonet's `modules/main.py`
+and then its `fastboot-step.sh`, step for step. The bboe variant swaps the
+recovery image for TWRP 3.7.0_9-bboe2, a download of its own, which is why an
+unlock carries `files` beside its archive.
+
+amonet-radar v1.0.0 runs biscuit v2.0.0's scripts and payload byte for byte,
+and its `main.py` differs only in file names and one log line. So its plan is
+v2.0.0's, with `radar-kaeru.bin` in `expdb`, and its module builds it from
+v2.0.0's. No target uses it yet: the probe, the routes and the gesture are
+biscuit's.
 
 A **target** is what a run ends on: its goal state, the OS it installs, and its
 unlock, which stock has none of. A Fire OS 6 target names a build from Amazon's
@@ -188,7 +208,13 @@ offers `firebreak/emmc.py`'s operations.
 ## The guardrail
 
 `tests/test_plan.py` resolves every unlock against biscuit's geometry, from a
-stock table and from a shuffled one. Every write must equal what amonet's
-scripts issue: kind, target, byte offset and length. Reverting the boot-moved
-layout after applying it, and v2.0.0's repartition of a v1.1.0 table, must
-each give back the stock table byte for byte.
+stock table and from a shuffled one. It resolves amonet-radar v1.0.0 from a
+radar stock table and one with boot moved too. Every write must equal what
+amonet's scripts issue: kind, target, byte offset and length. Reverting the
+boot-moved layout after applying it, and v2.0.0's repartition of a v1.1.0
+table, must each give back the stock table byte for byte.
+
+The tests use made-up images and a radar table copied by hand. Once, by hand
+and outside the tests, the plan was resolved against amonet-radar's own
+`gpt-radar.bin` and images, from that table and from it with boot moved. It
+fit every partition and gave back the stock table.

firebreak-0.3.0/docs/radar-partitions.csv

@@ -0,0 +1,51 @@
+build,partition,bytes,sha256
+Fire OS 5.5.5.4,boot,7723008,28ff94917e1fb32bb2c33317f7173a1e05f4ddcccb3c561c6c907afd4bb04ef8
+Fire OS 5.5.5.4,system,805257216,a06a187508638e02b33a1323dc09a9a5ca07cf436ab341c8bff651abc1928ed7
+Fire OS 5.5.5.4,lk,356856,5070e18839496f18ce8c7e4d3f07e27e3376b96f487ca9c63b081e35e2230db3
+Fire OS 5.5.5.4,tee,2641920,80e54029f5defc087ff14e5da27dd9739cbf9f684b2ed8bdc3803fd1b77db856
+Fire OS 5.5.5.4,preloader,1048576,4c7aac4efa7a1bce6922a355c3636e1da575f99bee960d6afd07e1ba107668f8
+Fire OS 6 4305,boot,9746432,dc0e240813ee136a1c09e6ce54e7c7423419a1c5f8dd850e32a38b454d3410f6
+Fire OS 6 4305,system,805306368,6511ab942190e7337044bc0cf8642ae058d2ec6cfc66d7f132c81f8809022040
+Fire OS 6 4305,lk,239356,cd84f39887a1d0b5d51912c184b2651c92904e9be59313017d571e2bea943b14
+Fire OS 6 4305,tee,2812928,f4ec7c909c610f1b915c5bc3e9e995b97d554b9ac99018818a0055a19cdd326e
+Fire OS 6 4305,preloader,1048576,1c733a560a9553f76374bd0ff8cfb578468875939fab812043cf041e5f7b2680
+Fire OS 6 4929,boot,9756672,1f09839eb7c3af12a58a0466869a025e9f9842e447f598d8b2dc4fd34e153170
+Fire OS 6 4929,system,805306368,6e3b9141eee076f3fdf738d61d8502bc2c9d1a97e8f57c31531cd1a0aeb9fa86
+Fire OS 6 4929,lk,241664,e0fa09cbc51649d7c30a8bb454b30980c671032bbe668c89ebac0c5b556dbd5d
+Fire OS 6 4929,tee,1781760,15cd40caafa6cd8bb8c4e4ed173c973569a8a2b026235d81776ec888f1522c72
+Fire OS 6 4929,preloader,1048576,dbdb13850389dcef695b7d613e6d729691e5e741cda2cafba87048b483a0e05d
+Fire OS 6 6199,boot,9760768,4d9446f452ef41cc9f6d803e591ecd2f43ea0e36d77bc68eb2292a4b745038dc
+Fire OS 6 6199,system,805306368,56540b3a9ac4437901a5510d9fb5e09b1a8d0cc229548f0b08bb5c22d78684fe
+Fire OS 6 6199,lk,241664,e0fa09cbc51649d7c30a8bb454b30980c671032bbe668c89ebac0c5b556dbd5d
+Fire OS 6 6199,tee,1781760,15cd40caafa6cd8bb8c4e4ed173c973569a8a2b026235d81776ec888f1522c72
+Fire OS 6 6199,preloader,1048576,32bffcf8a7019a1b0f518329a5a9ac94efbc0ba2ee64d1371b3d3b6a4244d10a
+Fire OS 6 6208,boot,9760768,bdaf7ba40247735e244bdb1d6e805eccf606aa11a8c8469a33d5db058078847c
+Fire OS 6 6208,system,805306368,cb8ec2cef37109fc2911c99665a2cf053f335810a2ed7cb66de98406241bcb9a
+Fire OS 6 6208,lk,241664,e0fa09cbc51649d7c30a8bb454b30980c671032bbe668c89ebac0c5b556dbd5d
+Fire OS 6 6208,tee,1781760,15cd40caafa6cd8bb8c4e4ed173c973569a8a2b026235d81776ec888f1522c72
+Fire OS 6 6208,preloader,1048576,478a72481c3fec61cd65a8b58a32977e4e8821b005d655b7f0741d8088cd0310
+Fire OS 6 6220,boot,9760768,cd07b92306cdf93dcfdd1e5747fbaf4283b8b58d43e5410595b46c35c4a405c5
+Fire OS 6 6220,system,805306368,cba5e6e5df9fbf26c325e3b4fd77a7ee806f5ed205b550e2285e148f9e632569
+Fire OS 6 6220,lk,241664,e0fa09cbc51649d7c30a8bb454b30980c671032bbe668c89ebac0c5b556dbd5d
+Fire OS 6 6220,tee,1781760,15cd40caafa6cd8bb8c4e4ed173c973569a8a2b026235d81776ec888f1522c72
+Fire OS 6 6220,preloader,1048576,930621d8bfef03aa31ebcd722d1863f280fc9d98d5663982ad29b757d59e36af
+Fire OS 6 6302,boot,9760768,7e61433c4716951a7d6aaf985a241b697b4e9c0b902fb75b3eeb9438fe0a2f6a
+Fire OS 6 6302,system,805306368,33dc2fb7b211958f813abf720ef58887742a8a75cc171420b71465b10e9632c9
+Fire OS 6 6302,lk,241664,e0fa09cbc51649d7c30a8bb454b30980c671032bbe668c89ebac0c5b556dbd5d
+Fire OS 6 6302,tee,1781760,15cd40caafa6cd8bb8c4e4ed173c973569a8a2b026235d81776ec888f1522c72
+Fire OS 6 6302,preloader,1048576,781c268124a4cec6c3f0a719a9c8e6ba6ce0c11513552690fcb78dc09f42c871
+Fire OS 6 6425,boot,9764864,25a4fbd517f5e5f2cf6a959758e243dd8dd4e9781af273b86561bc8df0d6b156
+Fire OS 6 6425,system,805306368,8dc8db93b8e6c57a539ab5d8a24f97c0044f719a648340da0d486335cbe30f8b
+Fire OS 6 6425,lk,241664,e0fa09cbc51649d7c30a8bb454b30980c671032bbe668c89ebac0c5b556dbd5d
+Fire OS 6 6425,tee,1781760,15cd40caafa6cd8bb8c4e4ed173c973569a8a2b026235d81776ec888f1522c72
+Fire OS 6 6425,preloader,1048576,ea01e6c0a566f73ab1747324f7ce345c37c38bc1791fda7100189abfe4086c95
+Fire OS 6 6436,boot,9764864,d7562a3f8aceffe6464b71465a4e37b63a7887be2d9044011dc462f732b8dca9
+Fire OS 6 6436,system,805306368,57231fda2a4066a3b916bb21951e23362edc25202dd7d74d89ad256b11d8ccb5
+Fire OS 6 6436,lk,241664,e0fa09cbc51649d7c30a8bb454b30980c671032bbe668c89ebac0c5b556dbd5d
+Fire OS 6 6436,tee,1781760,15cd40caafa6cd8bb8c4e4ed173c973569a8a2b026235d81776ec888f1522c72
+Fire OS 6 6436,preloader,1048576,129304857e6617ef1ea807fe32043c59352fc2b3ecefbd96d69e2c9850bcfb3f
+Fire OS 6 6813,boot,9760768,ac99094e48332f99c3f1be0562db8b9a9826e1999298b476b3645409fef23c97
+Fire OS 6 6813,system,805306368,fdb018fc996c6963cc2653a3974b21fd36bc58ab639bafc3a17f6b167c6bb3a2
+Fire OS 6 6813,lk,241664,e0fa09cbc51649d7c30a8bb454b30980c671032bbe668c89ebac0c5b556dbd5d
+Fire OS 6 6813,tee,1781760,15cd40caafa6cd8bb8c4e4ed173c973569a8a2b026235d81776ec888f1522c72
+Fire OS 6 6813,preloader,1048576,ccabe5e572b366de574fd11e8a47e7199040bb97376cda523212929f9dc7fde1