Help:Device Page

From postmarketOS Wiki

How to add a new device page to the wiki

Note To create a new wiki page, enter the name of the new page into the search field, press enter and you will be asked to create the new page.
  1. Paste the content from below into the new wiki page. For device-specific pages, we are using the naming convention "Manufacturer Device Name (codename)", so for example "HTC Desire (htc-bravo)"
  2. Adjust the template for your device (edit all CHANGE_MEs, fill out the blanks, etc.)
  3. Take a good photo of your phone and upload it, then put it into the infobox. Do not copy random pictures from the internet, those are copyrighted.
  4. You are done! You can now take a look at the devices page, your device should appear automatically.

Chipset names

In order to keep pages consistent, chipset names in device infoboxes should follow the following format (colors added for demonstration purposes):

  • <Manufacturer> <Series name> <Marketing name> <Optional suffix> (<Model name>), for chipsets with a marketing name (most Qualcomm Snapdragon chips - for example, Qualcomm Snapdragon 410 (MSM8916), as well as recent Mediatek chips - for example, MediaTek Helio P65 (MT6768))
  • <Manufacturer> <Series name> <Model name> <Optional suffix> or <Manufacturer> <Model name> <Optional suffix>, for chipsets with only a model name (Exynos chips, Broadcom chips etc. - for example, Samsung Exynos 4412 Quad, Broadcom BCM23550)

The <Optional suffix> field is used only for manufacturer-provided suffixes - for example, Exynos chips often have suffixes like "Dual", "Quad" or "Octa" after the model name (as seen in the Samsung Exynos 4412 Quad example above).

Notes

  • To figure out if an Exynos chip needs the Dual/Quad/Octa suffix, check if there is one listed on Samsung's website. If the chip in question is not on Samsung's website, see what other online sources say.
  • Exynos chips often have a market name like "Exynos 4", "Exynos 5" besides their model number; the number is omitted here in favor of the full model number.
  • In OMAP chips, the name of the manufacturer ("Texas Instruments") is shortened to TI.
  • The names are case-sensitive, so make sure to use the correct capitalization (e.g. MediaTek instead of Mediatek, Qualcomm Snapdragon instead of QualComm SnapDragon, MSM8916 instead of msm8916)

Template

Please take the time to fill out this template properly.

With good documentation, more contributors come, and they will be able to build upon your work.

It's worth it.

Thank you!

Note You can find information about CPU, GPU, Display on websites such as gsmarena.com . You can also enter your device name with the word "specs" into your favorite search engine and you should find the information as well.
{{Infobox device
| manufacturer = <!-- e.g. HTC -->
| name = CHANGE_ME <!-- e.g. Desire -->
| codename = CHANGE_ME <!-- e.g. htc-bravo -->
| model = CHANGE_ME <!-- Manufacturer's model/part number, e.g. SM-T330 -->
| image = File:CHANGE_ME_TO_DEVICE_CODENAME.jpg
| imagecaption = CHANGE_ME
| releaseyear = CHANGE_ME
| category = testing
| originalsoftware = CHANGE_ME <!-- e.g. Android -->
| originalversion = CHANGE_ME <!-- e.g. 11 for Android 11 -->
| pmoskernel = 6.x.x <!-- Version of the kernel that postmarketOS is running -->
| chipset = CHANGE_ME <!-- e.g. Qualcomm Snapdragon S1 (QSD8250) - see "Chipset names" section in Help:Device Page -->
| cpu = CHANGE_ME <!-- e.g. 1.0 GHz Scorpion -->
| gpu = CHANGE_ME <!-- e.g. Adreno 200 -->
| display = CHANGE_ME <!-- e.g. 480x800 AMOLED -->
| storage = CHANGE_ME <!-- e.g. 512 MB -->
| memory = CHANGE_ME <!-- e.g. 576 MB -->
| architecture = CHANGE_ME <!-- One of these: armhf, armv7, aarch64, riscv64, x86, x86_64 -->
| type = CHANGE_ME <!-- One of "desktop", "laptop", "convertible", "server", "tablet", "handset", "watch", and "embedded" -->
| whet_dhry = 0.0 <!-- see Unixbench page on wiki -->
<!-- Features -->
<!-- the following status_* questions should be answered with Y for yes, P for partial, N for no, - for N/A or unavailable, or left blank for untested or unknown -->
| status_usbnet = <!-- USB networking does work? then put Y here and delete this comment -->
| status_flashing = <!-- Flashing with "pmbootstrap flasher" works? Put Y here. It works the same for everything coming below. -->
| status_touch = <!-- Touch screen is working? You can also answer these questions with P for partially. -->
| status_screen = <!-- The display is working? -->
| status_3d = <!-- Hardware accelerated 3D graphics (e.g. with freedreno) -->
| status_fde = <!-- When installing with full disk encryption, can you type in the password with the on screen keyboard? -->
| status_emmc = <!-- Internal storage can be accessed? -->
| status_wifi = <!-- Wireless network works? -->
| status_mainline = <!-- Instead of a Linux kernel fork, it is possible to run mainline. -->
| status_battery = <!-- Charging the battery and getting the battery percentage is possible -->
| status_audio = <!-- Using the device's speakers/headphone jack works -->
| status_bluetooth = <!-- It's possible to pair and use other devices via the bluetooth protocol -->
| status_camera = <!-- Taking photos and videos works. -->
| status_gps = <!-- The Global Positioning System sensor works.  -->
| status_mobiledata = <!-- Connecting to the Internet via cellular network. -->
| status_sms = <!-- Sending and receiving short messages works as intended. -->
| status_calls = <!-- Talking to other people over the cellular network. -->
| status_otg = <!-- USB-OTG adapters work, e.g. to connect an USB flash drive to the device -->
| status_nfc = <!-- Near-Field Communication (NFC) works -->
<!-- Sensors -->
| status_accel = <!-- The sensor that measures proper acceleration works -->
| status_magnet = <!-- Magnetometer works -->
| status_light = <!-- Ambient light sensor works -->
| status_proximity = <!-- Proximity sensor works -->
| status_hall = <!-- Hall effect sensor works -->
| status_barometer = <!-- Barometer works -->
| status_powersensor = <!-- Power sensor works -->
<!-- Misc -->
| status_dvb = <!-- Built-in TV receiver works -->
| status_cameraflash = <!-- Camera flash/torch works -->
| status_keyboard = <!-- Keyboard works (Mark "-" if device doesn't have a keyboard) -->
| status_touchpad = <!-- Touchpad works (Usually applicable to laptops) -->
| status_usba = <!-- Full-sized USB-A port works (Usually applicable to SBCs and laptops) -->
| status_sdcard = <!-- SD/UFS card works -->
| status_hdmidp = <!-- Video and audio output with HDMI or DisplayPort works -->
| status_irtx = <!-- Infrared (IR) transmit works -->
| status_irrx = <!-- Infrared (IR) receive works -->
| status_stylus = <!--  -->
| status_haptics = <!--  -->
| status_ethernet = <!--  -->
| status_fossbootloader = <!-- Device has a free and open source bootloader -->

<!-- optional for devices running u-boot
| status_uboot =
| status_uboot_primary =
| status_uboot_secondary =
| status_uboot_mainline =
| status_uboot_internalstorage =
| status_uboot_sd =
| status_uboot_usbhost =
| status_uboot_usbperipheral =
| status_uboot_screen =
| status_uboot_keyboard =
| status_uboot_buttons =
-->

| booting = no <!-- The device is booting at all, can be yes/no *IMPORTANT* -->
| status = <!-- Text displayed in the "not booting" table on the Devices page , e.g "kernel compiles, doesn't boot" -->
}}

== Contributors ==
* CHANGE_ME (put your username here!)

== Users owning this device ==
{{Device owners}}
<!-- autogenerated, use {{Owns device|devicepage|notes}} on your profile page -->
<!-- use _ instead of spaces in device page name, e.g. {{Owns device|HTC_Desire_(htc-bravo)|custom notes}}-->
<!-- you may need to purge page cache to see changes (more->purge cache)-->
<!-- you can use {{My devices}} on your profile page to show table with all your devices -->

== How to enter flash mode ==

== Installation ==
Use [[pmbootstrap]] to build your own installation image.

<!-- Expand this with the commands needed for flashing, add --sdcard to install if it makes sense etc. -->
<source lang="shell-session">
$ pmbootstrap init
$ pmbootstrap install --fde
</source>

<!-- add more sections below as necessary, e.g. WiFi, photos, ... -->

== See also ==
<!--
Link to related GitLab issues or merge requests like the following (replace CHANGEME with the ID, e.g. 1234):
* {{MR|CHANGEME|pmaports}} Initial merge request
* {{issue|CHANGEME|pmaports}} Some related issue
You can also add normal web links:
* [https://redmine.replicant.us/projects/replicant/wiki/GalaxyS2I9100 Replicant wiki page]
-->
<!--
If you manage to get your device packages merged, uncomment links below and change DEVICE_CODENAME with the actual one.
* {{Device package|DEVICE_CODENAME}}
* {{Kernel package|DEVICE_CODENAME}}
-->


Almost done! Don't forget the photo and looking at the automatically generated devices page.