Draft:Porting to a new device/Upstreaming
Appearance
With the port in a working state, the final step is to upstream it so that other people can use it. After this step, the device will be selectable in pmbootstrap.
Creating a wiki page for the device
Every supported device needs to have a page on the postmarketOS wiki describing its status and installation/flashing steps.
- To be able to create and edit pages, request an account on the postmarketOS wiki. Accounts are typically approved within a day of their request; if not, feel free to ping a wiki admin in the #postmarketOS-wiki Matrix/IRC channel.
- Once your account is created, create a wiki page for your device using the template from Help:Device page.
Upstreaming the device port
Once your port is booting, upstream the device and kernel package to pmaports. With this, your port will become a part of postmarketOS and will be selectable for all users in pmbootstrap init.
- Create an account on the postmarketOS GitLab instance; this is where postmarketOS development happens, and where the
pmaportsrepository is hosted. - Once your account is created, follow the steps in Git workflow to prepare a MR (merge request) with your device port.
Learn how to work with
git to prepare your port for submission, and how to create a merge request on postmarketOS's GitLab instance.Next steps
Maintaining the device
| TODO: Device maintainer docs are currently being drafted, see pmaports!7413 |
Getting more features working
After submitting your port, you can keep working on it to enable more features! You can find more information on component-specific pages - see Getting individual components working.