[Devices] How to support a new device

Supporting a new device

This guide explains how to add support for a new device.

1. Collect the necessary information

To support a new device you must collect the following information:

• The device human readable name
• The device brand
• Device codename/s
• Device architecture
• The partitions path of your device (Something like /dev/block/platform/msm_sdcc.1/by-name)
• The two paths of your system, cache, data, boot and recovery partitions (The first looks like /dev/block/platform/msm_sdcc.1/by-name/system and the second like /dev/block/mmcblk0p23)
• Other partitions paths (optional)

2. Fork the repository

To do this click the "Fork" button on the top right of the page. This will copy the repository into your account (You need to be logged in to GitHub). Now we can start the work.

3. Add your device information

First open your forked repository and browse to /data/devices/. There you will find a lot of .yml files. Find the file of the device brand and open it for editing. Now you can add your device information following this template in the SAMPLE.yml file (Don't do the boot_ui section, it is for another function. Supporting it will be explained in another page). Don't forget to save and commit.

4. Do a pull request

Go to the original repository and click the "New pull request" button next to the branch selector at the top of the page. It will open the "Compare changes" page. Click in "Compare across forks" blue link and change the head fork to your-username/DualBootPatcher. Check you made all the needed changes and give a name and a description to your pull request. The name should be something like "Add support to the-device". Now click the "Create pull request" green button.

5. Wait for your changes to be verified and merged to the project

Now the developer recived your code and he will review, try and add it to the source code. You will be notified when your code merged. Now only wait for the next snapshot at snapshots.noobdev.io!