https://wiki.postmarketos.org/api.php?action=feedcontributions&user=Mpiatka&feedformat=atom
postmarketOS - User contributions [en]
2024-03-29T07:32:10Z
User contributions
MediaWiki 1.39.6
https://wiki.postmarketos.org/index.php?title=Deviceinfo_reference&diff=6812
Deviceinfo reference
2019-04-29T13:37:40Z
<p>Mpiatka: Add initfs_compression option</p>
<hr />
<div>Most of the variables in <code>deviceinfo</code> have self-explanatory names and are used both when you are building postmarketOS and during runtime (it is available at <code>/etc/deviceinfo</code>).<br />
<br />
All variables start with <code>deviceinfo_</code> in the file - this is omitted here to save space.<br />
<br />
== device ==<br />
<br />
{| class="wikitable sortable"<br />
!Variable<br />
!Description<br />
!Possibles values<br />
|-<br />
| <code>format_version</code><br />
| Used to distinguish between different versions of this file.<br />
| <code>0</code><br />
|-<br />
| <code>name</code><br />
| Device model (e.g. <code>Google Nexus 5</code>)<br />
|<br />
<br />
|-<br />
| <code>manufacturer</code><br />
| Device manufacturer (e.g. <code>LG</code>)<br />
|<br />
<br />
|-<br />
| <code>codename</code><br />
| Device codename (e.g. <code>lg-hammerhead</code>)<br />
|<br />
<br />
|-<br />
| <code>date</code><br />
| Release date of the device<br />
|<br />
<br />
|-<br />
| <code>keyboard</code><br />
| The device has a hardware keyboard.<br />
| <code>true</code>, <code>false</code><br />
|-<br />
| <code>nonfree</code><br />
| Components of the device, that only run with closed source firmware. We have to do more research on this topic and specify a list of possible values, for now all devices have <code>????</code> here.<br />
| <code>????</code><br />
|-<br />
| <code>dtb</code><br />
| Name of the [[Glossary#dtb|device tree blob]] file. This will be necessary for the [[Mainline kernel]]; see also [https://github.com/postmarketOS/pmbootstrap/issues/91 #91]. This can be left blank during initial porting.<br />
|<br />
<br />
|-<br />
| <code>modules_initfs</code><br />
| Kernel modules to include in the initramfs image. Note: modules to be loaded ''after'' the initramfs can be specified like in a <code>modules-load.conf</code> ([https://github.com/postmarketOS/pmbootstrap/tree/master/aports/device/device-samsung-i9070 example]).<br />
|<br />
<br />
|-<br />
| <code>external_storage</code><br />
| Does the device have an sdcard or other external storage medium?<br />
| <code>true</code>, <code>false</code><br />
|-<br />
| <code>flash_method</code><br />
| Method used to flash the device ([[deviceinfo_flash_methods |more info]])<br />
|<br />
|-<br />
| <code>arch</code><br />
| Device architecture, must be supported by Alpine Linux<br />
| <code>armhf</code>, <code>armv7</code>, <code>aarch64</code><br />
<br />
|-<br />
| <code>dev_touchscreen</code><br />
| Path to the touchscreen device (needed for initramfs on-screen-keyboard, [[deviceinfo_dev_touchscreen|more info]])<br />
| e.g. <code>/dev/input/event3</code><br />
|-<br />
| <code>dev_touchscreen_calibration</code><br />
| Touchscreen calibration values (only necessary for devices with resistive touchscreen, [[Screen_Calibration#weston-calibrator_.28needed_for_resistive_touch_screens.29|more info]])<br />
| e.g. <code>1.094563 -0.020949 -34.586121 0.009427 -1.148506 503.816956</code><br />
|-<br />
| <code>dev_keyboard</code><br />
| Path to the keyboard device, if your device has any (needed for initramfs password unlocking)<br />
| e.g. <code>/dev/input/event1</code> <br />
|-<br />
| <code>swap_size_recommended</code><br />
| Set recommended swap file size for device. If unset, no swap file will be created for the device.<br />
| Integer, in MB.<br />
|-<br />
| <code>disable_dhcpd</code><br />
| Do not set the static ip to the network interface and do not run the DHCP daemon on it. This makes sense for devices with an ethernet port, like the Raspberry Pi ({{github|1580}}).<br />
| <code>true</code>, <code>false</code><br />
|-<br />
| <code>no_framebuffer</code><br />
| Do not wait up to 10 seconds until a framebuffer device shows up and do not try to configure it ({{MR|44|pmaports}}).<br />
| <code>true</code>, <code>false</code><br />
|-<br />
| <code>initfs_compression</code><br />
| Command used to compress initramfs image<br />
| default: <code>'gzip -1'</code><br />
|}<br />
<br />
== flash ==<br />
<br />
These are used for flashing and booting the device, and most of them are fastboot specific. '''[[How to find device specific information|Here is a guide on how to get these values for a specific Android device (by extracting the <code>boot.img</code>)]]'''<br />
<br />
{| class="wikitable sortable"<br />
! Variable<br />
! Description<br />
! Possible values<br />
|-<br />
| <code>flash_offset_kernel</code><br />
| Kernel offset used for flashing<br />
|<br />
<br />
|-<br />
| <code>flash_offset_ramdisk</code><br />
| Ramdisk offset used for flashing<br />
|<br />
<br />
|-<br />
| <code>flash_offset_second</code><br />
| Used for flashing<br />
|<br />
<br />
|-<br />
| <code>flash_offset_tags</code><br />
| Used for flashing<br />
|<br />
<br />
|-<br />
| <code>flash_offset_base</code><br />
| Used for flashing<br />
| default: <code>0x10000000</code><br />
|-<br />
| <code>flash_pagesize</code><br />
| Page size<br />
| usually <code>2048</code><br />
|-<br />
| <code>flash_sparse</code><br />
| Set this to true if your device expects a [https://github.com/postmarketOS/pmbootstrap/wiki/Troubleshooting#invalid-sparse-file-format-at-header-magi sparse system image] flashed<br />
|<br />
|-<br />
| <code>flash_fastboot_vendor_id</code><br />
| Set this to your vendor id if fastboot requires the <code>-i</code> argument to work on your device<br />
|<br />
<br />
|-<br />
| <code>flash_fastboot_max_size</code><br />
| Set this if the fastboot required by your device has an upper limit to the size of system images it will flash.<br />
| Size, in MB<br />
|-<br />
| <code>kernel_cmdline</code><br />
| Kernel command line<br />
|<br />
<br />
|-<br />
| <code>bootimg_blobpack</code><br />
| Create a flashable blob for the ASUS TF101 from <code>boot.img</code> using [https://github.com/AndroidRoot/BlobTools BlobTools]<br />
| <code>true, false</code><br />
|-<br />
<br />
|-<br />
| <code>bootimg_mtk_mkimage</code><br />
| Prepend a header required for MediaTek MT6589 phones (such as the [[Fairphone_1_(fairphone-fp1)|Fairphone 1]], [http://rex-shen.net/customize-flash-mt6589-rom/ more info])<br />
| <code>true, false</code><br />
|-<br />
<br />
|-<br />
| <code>bootimg_qcdt</code><br />
| Append <code>dtb</code> file to <code>boot.img</code> ([[deviceinfo_bootimg_qcdt|more info]])<br />
| <code>true, false</code><br />
|-<br />
<br />
|-<br />
| <code>generate_bootimg</code><br />
| Set this to true for fastboot device, so the <code>mkinitfs</code> command will generate a <code>boot.img</code> file after creating the <code>initfs</code>. Add <code>mkbootimg</code> as dependency to your device's APKBUILD!<br />
| <code>true, false</code><br />
|-<br />
<br />
| <code>generate_legacy_uboot_initfs</code><br />
| For the [https://github.com/postmarketOS/pmbootstrap/wiki/nokia-rx51-%28Nokia-N900%29 N900], we use a legacy version of the [https://en.wikipedia.org/wiki/Das_U-Boot uboot] bootloader right now. When setting this variable to true, the initramfs will generate an uboot legacy compatible initramfs file. Modern versions of uboot can load regular initramfs files.<br />
| <code>true, false</code><br />
<br />
|-<br />
| <code>fastboot_partition_kernel</code><br />
| Only relevant for [[Deviceinfo_flash_methods|fastboot]] flash methods, the partition where the kernel or boot.img will be stored ({{MR|1741}}).<br />
| default: <code>"boot"</code><br />
|-<br />
| <code>fastboot_partition_system</code><br />
| Only relevant for [[Deviceinfo_flash_methods|fastboot]] flash methods, the partition where the system image will be stored (see also: [[partition-layout]]).<br />
| default: <code>"system"</code><br />
|-<br />
| <code>heimdall_partition_kernel</code><br />
| Only relevant for [[Deviceinfo_flash_methods|heimdall]] flash methods, the partition where the kernel or boot.img will be stored.<br />
| default: <code>"KERNEL"</code><br />
|-<br />
| <code>heimdall_partition_initfs</code><br />
| Only relevant for the [[Deviceinfo_flash_methods#heimdall-isorec|heimdall-isorec]] flash method, the partition where the initramfs will be stored.<br />
| default: <code>"RECOVERY"</code><br />
|-<br />
| <code>heimdall_partition_system</code><br />
| Only relevant for [[Deviceinfo_flash_methods|heimdall]] flash methods, the partition where the system image will be stored (see also: [[partition-layout]]).<br />
| default: <code>"SYSTEM"</code><br />
|-<br />
| <code>boot_filesystem</code><br />
| Sets the filesystem used for the /boot partition containing initramfs-extra<br />
| default: <code>"ext4"</code>, <code>"fat16"</code><br />
|-<br />
| <code>rootfs_image_sector_size</code><br />
| Some devices made after 2016 with UFS storage use 4096 byte sectors and therefore need this option to boot. Read {{MR|1725}} for details.<br />
| default: <code>512</code><br />
|-<br />
| <code>sd_embed_firmware</code><br />
| A comma-separated list of binary:offset (where binary is under /usr/share) ({{MR|1739}})<br />
| e.g. <code>firmware/librem5dev/u-boot.bin:33,firmware/librem5dev/m4.bin:2</code><br />
|-<br />
| <code>sd_embed_firmware_step_size</code><br />
| The number of bytes for each increment of the offset specified in the <code>sd_embed_firmware</code> <br />
| default: <code>1024</code><br />
|-<br />
| <code>partition_blacklist</code><br />
| A comma-separated list of partitions that should not be flashed, because they brick the device. There are only very few devices where it is necessary (e.g. [[Ouya_(ouya-ouya)|Ouya]]). {{MR|1759}}<br />
| e.g. <code>boot,recovery</code><br />
|}<br />
<br />
== splash ==<br />
<br />
{| class="wikitable sortable"<br />
! Variable<br />
! Description<br />
! Possibles values<br />
|-<br />
| <code>screen_width</code><br />
| The width of the display<br />
| 800, 720, 1440... anything really<br />
|-<br />
| <code>screen_height</code><br />
| The height of the display<br />
| 1280, 2560... other<br />
|}<br />
<br />
== Obsolete options ==<br />
<br />
=== weston ===<br />
* <code>weston_pixman_type</code>: used to be a Weston specific workaround for the "red screen bug" ({{github|54}}): we patched Weston to accept a <code>--pixman-type</code> argument to override the framebuffer mode that the kernel driver reports. However, this patch was quickly incompatible with future changes in Weston, and it is not as good as [[Troubleshooting:display#My_screen_is_red.21|patching the kernel to report the right framebuffer mode]], so it was removed ({{issue|136|pmaports}}).<br />
* Various options from [https://manpages.debian.org/unstable/weston/weston.ini.5.en.html weston.ini] used to be duplicated, but this was removed in {{github|739}}. If you need to set weston specific options from your device (such as the output backend or the keymap), please add a weston.ini file to your pmaport ([https://github.com/postmarketOS/pmbootstrap/blob/e7dfe9b9041f0c2ec94295df16afeeec1d9bafd8/aports/device/device-nokia-rx51/APKBUILD#L66-L70 example]).<br />
<br />
== See also ==<br />
* [[Device specific package]]<br />
<br />
[[Category:Technical Reference]]</div>
Mpiatka
https://wiki.postmarketos.org/index.php?title=HTC_Desire_HD_(htc-ace)&diff=6676
HTC Desire HD (htc-ace)
2019-04-08T14:12:01Z
<p>Mpiatka: </p>
<hr />
<div>{{Infobox device<br />
| manufacturer = HTC<br />
| name = Desire HD<br />
| codename = htc-ace<br />
| image = File:Pmos-ace.jpg<br />
| imagecaption = HTC Desire HD<br />
| releaseyear = 2011<br />
| originalsoftware = Android 2.2 on Linux 2.6.32<br />
| chipset = Qualcomm MSM8255 Snapdragon S2<br />
| cpu = 1.0 GHz Scorpion<br />
| gpu = Adreno 205<br />
| storage = 1.5 GB<br />
| display = 480x800 LCD<br />
| memory = 768 MB<br />
| architecture = armv7<br />
| status_usbnet = Y<br />
| status_flashing = <br />
| status_touch = Y<br />
| status_screen = Y<br />
| status_wifi = Y<br />
| status_xwayland = Y<br />
| status_fde = <br />
| status_mainline = <br />
| status_battery =<br />
| status_3d = <br />
| status_accel = <br />
| status_audio = <br />
| status_bluetooth =<br />
| status_camera =<br />
| status_gps = <br />
| status_mobiledata = <br />
| status_sms = <br />
| status_calls = <br />
| booting = yes<br />
}}<br />
== Contributors ==<br />
<br />
* Victor9<br />
* mpiatka<br />
<br />
<br />
== What works ==<br />
<br />
* Display (framebuffer), 16 bit color depth<br />
* Touchscreen<br />
* USB networking<br />
* vibrator<br />
* X11 (tested with xfce4)<br />
<br />
== Audio ==<br />
<br />
Using ucm configuration files from [https://github.com/w-flo/rootfs-modifier/tree/master/replacements/targz/usr/share/alsa/ucm/msm-audio] it is possible to turn on the speaker, which then produces a very faint noise. However, trying to play sound using aplay or speaker-test does not work.<br />
<br />
== Links ==<br />
<br />
* [https://github.com/OpenDesireProject/android_kernel_htc_msm7x30 OpenDesireProject Kernel]</div>
Mpiatka
https://wiki.postmarketos.org/index.php?title=HTC_Desire_HD_(htc-ace)&diff=6392
HTC Desire HD (htc-ace)
2019-03-10T11:37:18Z
<p>Mpiatka: </p>
<hr />
<div>{{Infobox device<br />
| manufacturer = HTC<br />
| name = Desire HD<br />
| codename = htc-ace<br />
| image = File:Pmos-ace.jpg<br />
| imagecaption = HTC Desire HD<br />
| releaseyear = 2011<br />
| originalsoftware = Android 2.2 on Linux 2.6.32<br />
| chipset = Qualcomm MSM8255 Snapdragon S2<br />
| cpu = 1.0 GHz Scorpion<br />
| gpu = Adreno 205<br />
| storage = 1.5 GB<br />
| display = 480x800 LCD<br />
| memory = 768 MB<br />
| architecture = armhf<br />
| status_usbnet = Y<br />
| status_flashing = <br />
| status_touch = Y<br />
| status_screen = Y<br />
| status_wifi = Y<br />
| status_xwayland = Y<br />
| status_fde = <br />
| status_mainline = <br />
| status_battery =<br />
| status_3d = <br />
| status_accel = <br />
| status_audio = <br />
| status_bluetooth =<br />
| status_camera =<br />
| status_gps = <br />
| status_mobiledata = <br />
| status_sms = <br />
| status_calls = <br />
| booting = yes<br />
}}<br />
== Contributors ==<br />
<br />
* Victor9<br />
* mpiatka<br />
<br />
<br />
== What works ==<br />
<br />
* Display (framebuffer), 16 bit color depth<br />
* Touchscreen<br />
* USB networking<br />
* vibrator<br />
* X11 (tested with xfce4)<br />
<br />
== Audio ==<br />
<br />
Using ucm configuration files from [https://github.com/w-flo/rootfs-modifier/tree/master/replacements/targz/usr/share/alsa/ucm/msm-audio] it is possible to turn on the speaker, which then produces a very faint noise. However, trying to play sound using aplay or speaker-test does not work.<br />
<br />
== Links ==<br />
<br />
* [https://github.com/VictorNine/pmbootstrap/tree/device-htc-ace Device branch]<br />
* [https://github.com/OpenDesireProject/android_kernel_htc_msm7x30 OpenDesireProject Kernel]</div>
Mpiatka
https://wiki.postmarketos.org/index.php?title=File:Pmos-ace.jpg&diff=6391
File:Pmos-ace.jpg
2019-03-10T11:31:42Z
<p>Mpiatka: </p>
<hr />
<div></div>
Mpiatka
https://wiki.postmarketos.org/index.php?title=HTC_Desire_HD_(htc-ace)&diff=6121
HTC Desire HD (htc-ace)
2019-02-14T17:16:28Z
<p>Mpiatka: </p>
<hr />
<div>{{Infobox device<br />
| manufacturer = HTC<br />
| name = Desire HD<br />
| codename = htc-ace<br />
| image = File:HTC Desire HD.jpg<br />
| imagecaption = HTC Desire HD<br />
| releaseyear = 2011<br />
| originalsoftware = Android 2.2 on Linux 2.6.32<br />
| chipset = Qualcomm MSM8255 Snapdragon S2<br />
| cpu = 1.0 GHz Scorpion<br />
| gpu = Adreno 205<br />
| storage = 1.5 GB<br />
| display = 480x800 LCD<br />
| memory = 768 MB<br />
| architecture = armhf<br />
| status_usbnet = Y<br />
| status_flashing = <br />
| status_touch = Y<br />
| status_screen = Y<br />
| status_wifi = Y<br />
| status_xwayland = Y<br />
| status_fde = <br />
| status_mainline = <br />
| status_battery =<br />
| status_3d = <br />
| status_accel = <br />
| status_audio = <br />
| status_bluetooth =<br />
| status_camera =<br />
| status_gps = <br />
| status_mobiledata = <br />
| status_sms = <br />
| status_calls = <br />
| booting = yes<br />
}}<br />
== Contributors ==<br />
<br />
* Victor9<br />
<br />
<br />
== What works ==<br />
<br />
* Display (framebuffer), 16 bit color depth<br />
* Touchscreen<br />
* USB networking<br />
* vibrator<br />
<br />
== Audio ==<br />
<br />
Using ucm configuration files from [https://github.com/w-flo/rootfs-modifier/tree/master/replacements/targz/usr/share/alsa/ucm/msm-audio] it is possible to turn on the speaker, which then produces a very faint noise. However, trying to play sound using aplay or speaker-test does not work.<br />
<br />
== Links ==<br />
<br />
* [https://github.com/VictorNine/pmbootstrap/tree/device-htc-ace Device branch]<br />
* [https://github.com/OpenDesireProject/android_kernel_htc_msm7x30 OpenDesireProject Kernel]</div>
Mpiatka
https://wiki.postmarketos.org/index.php?title=HTC_Desire_HD_(htc-ace)&diff=6120
HTC Desire HD (htc-ace)
2019-02-14T16:55:57Z
<p>Mpiatka: /* What works */</p>
<hr />
<div>{{Infobox device<br />
| manufacturer = HTC<br />
| name = Desire HD<br />
| codename = htc-ace<br />
| image = File:HTC Desire HD.jpg<br />
| imagecaption = HTC Desire HD<br />
| releaseyear = 2011<br />
| originalsoftware = Android 2.2 on Linux 2.6.32<br />
| chipset = Qualcomm MSM8255 Snapdragon S2<br />
| cpu = 1.0 GHz Scorpion<br />
| gpu = Adreno 205<br />
| storage = 1.5 GB<br />
| display = 480x800 LCD<br />
| memory = 768 MB<br />
| architecture = armhf<br />
| status_usbnet = Y<br />
| status_flashing = <br />
| status_touch = Y<br />
| status_screen = Y<br />
| status_wifi = Y<br />
| status_xwayland = Y<br />
| status_fde = <br />
| status_mainline = <br />
| status_battery =<br />
| status_3d = <br />
| status_accel = <br />
| status_audio = <br />
| status_bluetooth =<br />
| status_camera =<br />
| status_gps = <br />
| status_mobiledata = <br />
| status_sms = <br />
| status_calls = <br />
| booting = yes<br />
}}<br />
== Contributors ==<br />
<br />
* Victor9<br />
<br />
<br />
== What works ==<br />
<br />
* Display (framebuffer), 16 bit color depth<br />
* Touchscreen<br />
* USB networking<br />
* vibrator<br />
<br />
== Links ==<br />
<br />
* [https://github.com/VictorNine/pmbootstrap/tree/device-htc-ace Device branch]<br />
* [https://github.com/OpenDesireProject/android_kernel_htc_msm7x30 OpenDesireProject Kernel]</div>
Mpiatka
https://wiki.postmarketos.org/index.php?title=HTC_Desire_HD_(htc-ace)&diff=6119
HTC Desire HD (htc-ace)
2019-02-14T16:55:20Z
<p>Mpiatka: </p>
<hr />
<div>{{Infobox device<br />
| manufacturer = HTC<br />
| name = Desire HD<br />
| codename = htc-ace<br />
| image = File:HTC Desire HD.jpg<br />
| imagecaption = HTC Desire HD<br />
| releaseyear = 2011<br />
| originalsoftware = Android 2.2 on Linux 2.6.32<br />
| chipset = Qualcomm MSM8255 Snapdragon S2<br />
| cpu = 1.0 GHz Scorpion<br />
| gpu = Adreno 205<br />
| storage = 1.5 GB<br />
| display = 480x800 LCD<br />
| memory = 768 MB<br />
| architecture = armhf<br />
| status_usbnet = Y<br />
| status_flashing = <br />
| status_touch = Y<br />
| status_screen = Y<br />
| status_wifi = Y<br />
| status_xwayland = Y<br />
| status_fde = <br />
| status_mainline = <br />
| status_battery =<br />
| status_3d = <br />
| status_accel = <br />
| status_audio = <br />
| status_bluetooth =<br />
| status_camera =<br />
| status_gps = <br />
| status_mobiledata = <br />
| status_sms = <br />
| status_calls = <br />
| booting = yes<br />
}}<br />
== Contributors ==<br />
<br />
* Victor9<br />
<br />
<br />
== What works ==<br />
<br />
* Display (framebuffer), 16 bit color depth<br />
* Touchscreen<br />
* Keyboard<br />
* USB networking<br />
* vibrator<br />
<br />
<br />
<br />
== Links ==<br />
<br />
* [https://github.com/VictorNine/pmbootstrap/tree/device-htc-ace Device branch]<br />
* [https://github.com/OpenDesireProject/android_kernel_htc_msm7x30 OpenDesireProject Kernel]</div>
Mpiatka