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. Supported devices

h3. Maintained devices

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

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

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

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

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

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

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

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

h3. Uncompleted devices

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

h3. Unmaintained devices

* [[GTA04|GTA04]]

* [[NexusSI902x|Nexus S (I902x)]]

* [[GalaxySI9000|Galaxy S (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]]: 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).

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.

* [[DonateDevices|Donate devices]] that are listed here so that we can use them for development.

* [[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]]

* [[GettingLogs|Getting logs]]

* [[UART|UART]]: Serial port hardware and software configuration for various devices

* [[GDBDebugging|GDB debugging]]

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

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

h3. Areas of work and documentation

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

h3. Replicant porting guides

* [[Replicant60PortingGuide|Replicant 6.0 porting guide]]

* [[Replicant40PortingGuide|Replicant 4.0 porting guide]]

h3. Hardware support

* Samsung IPC protocol support with [[Samsung-RIL]] and [[libsamsung-ipc]]

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

* "Security Analysis of Android Factory Resets":https://www.cl.cam.ac.uk/~rja14/Papers/fr_most15.pdf

* [[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

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

* [[BootloaderInterfaces]] Research on the interfaces of various bootloaders

* [[Bootloaders|Bootloaders]] Research on weather it's possible or not to run a free software bootloader on various devices

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

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 2 4G (N7105)]]: Work in progress page to add information on N7105.

* [[I9100G]]: A version of the Galaxy SII

* [[Librem5]]

* [[Necuno Mobile|NECUNOS NC_1]]

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

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

* [[Pinephone]]

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, and rebase over LineageOS 13

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

* [[Porting Replicant to Android 9]]: Tracks the progress of porting Replicant to Android 9

* [[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)

h3. Bug documentation research

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

h3. Other research

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

* [[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

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@lists.osuosl.org/info.html 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, reports on project decisions and fund usage

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

* [[PublicPositions]] public positions of Replicant

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