DeviceDocumentationChecklist¶

Introduction¶

There is a lot of data and information on supported devices that is scattered around the Repicant wiki, git repositories and even Wikidata. So it's a good idea to have a checklist on what to add.

When we will have migrated to Mediawiki, we could automatically generate part of that list as we will be able to tag pages with Cathegories.

Checklist¶

Not everyone has all the Replicant supported devices, and at some point you might want to add support for a new device that no one else will have. In that case it's best to at least fill up the following pages as having the devices make it way easier to fill in the information:

• RecoveryInstallationWithHeimdall
• BackupTheEFS

In addition if you can send a patch for the data repository to add the PIT if your device has a PIT. Additionally you can just push the commit if you have push access. If your device (also) has more classical partition tables like GPT or MBR, it is also a good idea to send a patch adding them to this repository as well. With the PIT, GPT and/or MBR anyone can write documentation on the partition table of the device. In the future that documentation could even be generated from that data.

In addition it might be a good idea to boot that device under Replicant and publish the output of the mount command as root. This way we will know for sure which partitions are mounted, which is important for debugging boot issues and checking if there aren't obvious security like partitions that should not be mounted but are mounted.

If your device has a modem and has a modem data partition, it is also a good idea to add the list of files and their permissions to the wiki like in the GT-I9300EFSContent page. This enables to restore the file permissions. Note that while publishing the file names and permissions look safe, the file content might contain privacy or security sensitive information like the IMEI.

Additionally some projects

• tacdb.osmocom.org : This project collects the TAC (the first 8 digits of the IMEI) with an F-Droid application . The resulting data is under the CC-BY-SA v3.0 unported license.
• terminal-profile.osmocom.org : This projects collect information on what the modem allows the SIM card to do. For instance it might allow the SIM card to redirect calls. We use its data as part of our freedom privacy and security evaluations of specific devices. It is under the CC-BY-SA v3.0 unported license license. It requires special hardware (like simtrace or simtrace2) to trace the communication between the SIM card and the modem.