Draft:Porting to a new device/Upstreaming
Appearance
With the port complete, 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.
TODO: Depending on the outcome of wiki#184, we might encourage folks to create new device pages in the Draft namespace. |
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
pmaports
repository is hosted. - Once your account is created, follow the steps in Git workflow to prepare a MR (merge request) with your device port.