Replicant

h1. Replicant Wiki

{{>toc}}

p=. !replicant_banner_alpha.png!

Welcome to the Replicant wiki, which provides information about Replicant, supported devices and research about other mobile devices and platforms.

For more information about Replicant, head over to the "Replicant website":https://www.replicant.us/.

You can help improving the wiki! Wiki editor privileges can be requested by [[Index#Contact|contacting the developers]]. A short description of the changes and additions you want to make is needed as part of the request. The [[DeveloperGuide#Wiki-guidelines|wiki guidelines]] should be followed.

*Unless specified otherwise, the information displayed in this wiki is only relevant to the latest Replicant version. Do not assume backwards compatibility of the instructions with old versions of Replicant.*

h2. Redmine registration issues

%{background:lightred} Redmine registration is currently not working due to mail configuration issue.%

To activate an account for people creating new accounts:

* Send a mail to the "Mailing list":https://lists.osuosl.org/mailman/listinfo/replicant (Registration required) or the [[PrivateContact]] address or the mailing list.

To activate an account for people that have admin access in the Redmine interface:

If you have the mail in Maildir format:

<pre>

$ cat ./the_mail_in_Maildir_format | dkimverify 

signature ok

</pre>

With claws mail, open the mail, then click "File->Save Email as", then you can verify it with dkimverify manually:

<pre>

$ cat saved_mail | dkimverify

signature ok

</pre>

h2. Supported devices

h3. Maintained devices

* [[GalaxySIIGTI9100|Galaxy S II (GT-I9100)]]

* [[GalaxySIIIGTI9300|Galaxy S III (GT-I9300)]]

* [[GalaxyNoteGTN7000|Galaxy Note (GT-N7000)]]

* [[GalaxyNote2N7100|Galaxy Note II (GT-N7100)]]

* [[GalaxyNexusGTI9250|Galaxy Nexus (GT-I9250)]]

* [[GalaxyTab270GTP31xx|Galaxy Tab 2 7.0 (GT-P31xx)]]

* [[GalaxyTab2101GTP51xx|Galaxy Tab 2 10.1 (GT-P51xx)]]

* [[GalaxyNote80GTN51xx|Galaxy Note 8.0 (GT-N51xx)]]

* [[WhatCanIDoIfMyDeviceIsNotSupported]]: This page explains what you can do if your device is not in the list above. 

h3. Uncompleted devices

* [[GalaxySIII4GGTI93005|Galaxy S III 4G (GT-I9305)]]

h3. Unmaintained devices

* [[GTA04AX|GTA04 AX]]

* [[NexusSGTI902x|Nexus S (GT-I902x)]]

* [[GalaxySGTI9000|Galaxy S (GT-I9000)]]

* [[NexusOne|Nexus One]]

* [[DreamMagic|Dream/Magic]]

h2. Replicant status

h3. Maintained versions

* [[ReplicantStatus#Replicant-60|Replicant 6.0 status]]

h3. Unmaintained versions

* [[ReplicantStatus#Replicant-42|Replicant 4.2 status]]

* [[ReplicantStatus#Replicant-40|Replicant 4.0 status]]

* [[ReplicantStatus#Replicant-23|Replicant 2.3 status]]

* [[ReplicantStatus#Replicant-22|Replicant 2.2 status]]

h2. Replicant installation and update

*Installation instructions:*

* [[ReplicantInstallation|ReplicantInstallation]]: How to install Replicant for the first time.

*Upgrade instructions:*

* [[MinorVersionUpgrade|Minor version upgrade]]: How to upgrade to a new release from the same Replicant version (like from 6.0 0003 to 6.0 0004).

*Other instructions:*

* [[ImagesIdentification]]: How to find out which Replicant version you are running

* [[BackupTheEFS]]: Instructions to backup the modem data partition on devices with such partition

* [[RecoveryInstallationWithHeimdall|Recovery installation with Heimdall]]: New 'generic' instructions to install (or upgrade) the recovery with Heimdall.

*Reference pages:*

* [[ReplicantImages|Replicant images files]]

* [[ReplicantSDK|Replicant SDK files]]

*Old installation instructions for uncompleted devices:*

* [[GTA04Installation|GTA04 installation]]

* [[GalaxyS3I9305Installation|Galaxy S 3 4G (I9305) installation]]

h2. Replicant usage

* [[FDroid]]: F-Droid

* [[SDK]]: Software Development Kit (SDK)

* [[WifiAdapter]]: Using WiFi with an USB WiFi adapter

* [[EthernetAdapter]]: Using Ethernet with an USB Ethernet adapter

* [[ReplicantUSBNetworking]]: Replicant USB Networking

* [[Graphics]]: Graphics rendering on Replicant

* [[Screenshots]]: Taking screenshots

* [[ADB]]: Android Debug Bridge (ADB)

* [[SSH]]: OpenSSH

* [[ModemDisable]]: Really deactivating the modem

* [[UsageNotes]]: General-purpose usage notes and tips

* [[Safe mode]]: How to enter Android's safe mode (useful for devices stuck in a boot loop).

* [[RestoreEfsNvDataBackupFile]]: Experimental instruction to fix a very 'light' corruption in the modem data partition.

See the [[Index#Supported-devices|device pages]] for device-specific usage information.

h2. Replicant build

Main build instructions for Replicant images:

* [[GenericReplicant60Build|Generic Replicant 6.0 Build]]: Instruction to build Replicant 6.0

* [[Replicant60BuildDependenciesInstallation|Replicant 6.0 build dependencies installation]]

* [[ReplicantSourceCode|Replicant source code]]

* [[UnsignedBuildsInstallation]]

Other build instructions:

* [[SDKBuild|SDK build]]

* [[GTA04Build|GTA04 build]]

* [[GalaxyS3I9305Build|Galaxy S 3 4G (I9305) build]]

* [[KernelBuild|Standalone Kernel build]]

h2. Contributing to Replicant

There are many different ways to contribute to Replicant depending on your skills and available time or other resources

* "Financial contributions":https://my.fsf.org/civicrm/contribute/transact?reset=1&id=19 can be made via our fiscal sponsor, The Free Software Foundation.

* [[DeviceDonnations]]: Which devices are needed for development and how to get devices

* [[Tasks]] to improve Replicant

* [[TasksToFund|Tasks to fund]]: draft on a new task page which includes tasks that can be funded

* [[DeveloperGuide|Developer guide]]

* [[ToolsInstallation|Tools installation]]

* [[Workshops|Workshops]]: How to organize a Replicant workshop

* [[DeviceDocumentationChecklist]]: Information on where to add information about a supported device.

Some [[Index#Supported-devices|device pages]] also have development sections.

h3. Portals

This section contains link to pages that organize the wiki in topics.

For instance the [[Debugging]] page has links to wiki pages topics related to debugging, like how to obtain logs, etc.

* [[Bootloaders]]: Portal about bootloaders topic

* [[CellularModem]]: Portal about the cellular modems

* [[Debugging]]: Portal about getting logs, and debugging

* [[Devices]]: Portal about the devices and their variants

h3. Replicant porting guides

* [[Replicant60PortingGuide|Replicant 6.0 porting guide]]

* [[Replicant40PortingGuide|Replicant 4.0 porting guide]]

h2. Research

h3. Freedom privacy and security research

* Details about the [[SamsungGalaxyBackdoor|Samsung Galaxy back-door]], that affects some Samsung Galaxy devices

* [[AntiFeatures]]: anti-features inherited by upstream.

* [[LocationTracking|Location Tracking]] Research on how to avoid location tracking

* [[TrustZoneResearch|Trust Zone]]: Research on TrustZone

* [[ModemIsolationResearch|Modem isolation research]]: Information on freedom, privacy and security issues on the topic, and research on how to mitigate the issues.

* The [[Index#Supported-devices|device pages]] also contain hardware-specific research and a freedom and privacy/security evaluation for the respective device.

* [[DevicesPictures]]: Pictures of devices and their internals

* [[AcademicPapers]]: Link to various academic papers, and their summaries

h3. Hardware components support research

Research on how to support specific hardware components (chips, various system on a chip, etc) in Replicant.

* [[BCM4751]] GPS protocol support

* [[GSD4t]] GPS protocol support

* [[AKM8976A]] support

* [[OMAP4DucatiCamera|OMAP4 Ducati camera]] support

* [[QMI-RIL]] QMI protocol support

* [[WiFi]] Research on how to get free software WiFi firmwares and USB OTG support

* [[DangerousBatteryChargerExperiments]]: Plan to upstream a way to disable the battery charging. Please really do read the warnings.

* [[Datasheets]]: List of public datasheets and reference manuals for the components used in smartphones Replicant wants to support or has to maintain in libsamsung-ipc.

h3. Device evaluations research

Device specific evaluation and research

* [[HardwareRequirements]] Documentation and research on Android hardware requirements

* [[TargetsEvaluation|TargetsEvaluation]]: Evaluation of various devices

More in depth evaluation of devices:

* [[Exynos4412Devices]]: Page about devices with an Exynos 4412 and their variants.

* [[GalaxyNote2N7105|Galaxy Note II 4G (GT-N7105)]]: Work in progress page to add information on GT-N7105.

* [[GalaxySIIGTI9100G|Galaxy S II (GT-I9100G)]]: A version of the Galaxy SII

* [[Librem5Phone]]: Work in progress page to add information on the Librem5 smartphone.

* [[NecunosNC1|NECUNOS NC_1]]

* [[ODROID-U3|Odroid U3]]: Work in progress page to add information on Odroid U3.

* [[OptimusBlackP970|Optimus Black (P970)]] including development notes

* [[PinePhonev1.x]]: Work in progress page to add information on the Pinephone smartphone.

h3. Software projects research (Upstream, dependencies, Replicant versions, etc)

* [[F-DroidAndApplications]] Research on how to get FSDG compliant package managers and applications

* [[Dependencies]] Development efforts to enable to build Replicant on various GNU/Linux distributions

* [[GraphicsResearch|Graphics Research]] Research on free software graphics driver implementations

* [[Replican6Changes]]: List of changes made for Replican 6.0, and rebase over LineageOS 13

* [[samsung-ipc]] : List of changes and rebase

* [[PortingToAndroid10]]: Tracks the progress of porting Replicant to Android 10

* [[Upstream|Upstream]] Research on approaches to use upstream Linux and generic HAL in Replicant

* [[Toolchain]] Development efforts to remove prebuilt binaries from the source tree

* [[BackupsResearch]]: Research on backups partitions for various purposes (Backuping your data, Replicant or to do some research)

* [[RootingDevices]]: Research on free software rooting

h3. Bug documentation research

* [[SIMnotRecognized|SIM not recognized with libsamsung-ipc and libsamsung-ril]]

h3. Other research

* [[TestingInfrastructure|Testing infrastructure]] How to create a test infrastructure for Replicant

* [[ReleasesKey]]: Research on schemes and good practices to sign Replicant release

* [[OutdatedPages]] Pages that are not used anymore. They are kept and linked from here for history purposes.

* [[GovernanceResearch]] Research on governance structures

* [[LegalResearch]] Research into various legal issues

* [[HardwareDocumentationResearch]]: Research to find hardware documentation

h2. Project history

* [[ReplicantVersions]]: List of known Replicant versions

h2. Fun

* [[Fun]]: Songs, and other fun creations

h2. Contact

If you have any questions or want to talk to the developers, you can use any of the following:

* "Forums":/projects/replicant/boards

* IRC: #replicant at "Freenode":https://freenode.net/

* "Mailing list":https://lists.osuosl.org/mailman/listinfo/replicant ("searchable archive":https://www.mail-archive.com/replicant@osuosl.org of the list)

For private, confidential or press-related inquiries:

* [[PrivateContact|Private contact]]

h2. Public

* [[ReplicantArtwork|Replicant artwork]] 

* [[People]]: People that are interested in contributing in Replicant, that are contributing to it, or that have been contributing to it.

* [[ReplicantInfrastructure]] Description of the network infrastructure of Replicant (Redmine, git, etc), and the other project resources

* [[Presentations]] Presentations made on behalf of the Replicant project

* [[EventsMeetings]] planning for meetings and events at conferences

* [[SteeringCommittee]]: Replicant steering committee

* [[Funds]]: Fund usage

* [[ReplicantDecisions]]: General Project decisions (Technical decisions, project direction, etc)

* [[PublicPositions]] public positions of Replicant

* [[TasksFunding|Tasks funding]]: Tasks that will be funded, are being funded or have been funded.

The wiki is available under the "Creative Commons BY-SA":https://creativecommons.org/licenses/by-sa/3.0/ license.