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 Nura wiki describing its status and installation/flashing steps.
- To be able to create and edit pages, request an account on the Nura wiki. Accounts are typically approved within a day of their request; if not, feel free to ping a wiki admin in the #Nura-wiki Matrix/IRC channel.
- Familiarize yourself with the wiki editor's guide and wiki rules.
- 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 Nura and will be selectable for all users in pmbootstrap init.
- Create an account on the Nura GitLab instance; this is where Nura 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 Nura's GitLab instance.Next steps
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.