Project

General

Profile

DeviceDocumentationChecklist » History » Revision 9

Revision 8 (Denis 'GNUtoo' Carikli, 07/17/2020 10:22 PM) → Revision 9/13 (Denis 'GNUtoo' Carikli, 07/17/2020 10:25 PM)

h1. DeviceDocumentationChecklist 

 h2. 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. 

 h2. 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":https://git.replicant.us/replicant/data/ 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 issues that could happen if like partitions that should not be mounted are mounted in the wrong location. We can also find out that information by looking at various fstab files in the Replicant source code but as it is scattered around, it is faster and more reliable to just run the mount command as root to find out how partitions 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. 

 It might also be a good idea to contribute to [[ImagesIdentification]] page that explains how to identify various Replicant releases for specific devices. Earlier Replicant images don't have the Replicant stored anywhere. Because of that users might know they are running Replicant 6.0 but will not know if they run Replicant 6.0 0001, Replicant 6.0 0002 or Replicant 6.0 0003. However these older images export some information like the build date, so it's possible to correlate that information to the precise Replicant release. Helping filling the missing information for the Replicant 6.0 0003 release would help users understand if they are running the latest version or if they can/should upgrade. Older releases than that are less important. 

 Additionally some projects  
 * "tacdb.osmocom.org":https://tacdb.osmocom.org : This project collects the TAC (the first 8 digits of the IMEI) with an "F-Droid application":https://f-droid.org/repository/browse/?fdfilter=osmocom&fdid=org.osmocom.tacdatabaseclient . The resulting data is under the "CC-BY-SA v3.0 unported license":http://creativecommons.org/licenses/by-sa/3.0/. 
 * "terminal-profile.osmocom.org":https://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 (like [[GalaxyS3I9300PrivacySecurityEvaluation]]). It is under the "CC-BY-SA v3.0 unported license":http://creativecommons.org/licenses/by-sa/3.0/ license. It requires special hardware (like simtrace or simtrace2) to trace the communication between the SIM card and the modem.