|1. Choose a free sdcard you would like to install emteria.OS onto. Attention: Please use a card of at least speed class 10 or higher (UHS), since the read/write speed of the sdcard will heavily influence the system speed. Best results are achieved by using cards of type A1 (see public discussion). Some cards are known to not work correctly with the Raspberry Pi; this is a hardware issue we don’t control. Please check this comprehensive list for your specific SD card.|
|2. Use the emteria GUI installer for your operating system in order to flash your sdcard. Warning: all data on this sdcard will be lost!|
|3. When the installer finishes, take your micro SD-card out of your computer, insert it into your device and power it on. You should see a short text boot sequence followed by the emteria logo animation.|
All standard HDMI screens should be supported. Please see the section below for more information about the supported resolutions. The majority of USB-based touch controllers should also work out-of-the box. Following screens have been successfully tested by us with emteria.OS 0.5.x:
|52Pi 5″ touchscreen: The 800×480 capacitive HDMI touchscreen with USB controller for multi-touch.|
|Raspberry Pi 7″ touchscreen: The official Raspberry Pi 7″ touch screen display with 10 finger capacitive touch.|
|Waveshare 7″ touchscreen: A capacitive HDMI screen with an USB touch controller.|
|Waveshare 10.1″ touchscreen: A capacitive HDMI screen with an USB touch controller.|
The audio jack is used as the default audio out. If it doesn’t work in your setup, or if you wish to change the default behavior, please refer to HDMI_FORCE_EDID_AUDIO and HDMI_IGNORE_EDID_AUDIO options as specified by the official documentation. The emteria.OS also has built-in support for USB speaker and USB microphone without additional configuration.
Built-in support for the Official CSI Camera Module without additional configuration.
Accessing GPIO is possible just the same way you would do it in Linux (via sysfs). Eg.: https://www.ics.com/blog/gpio-programming-using-sysfs-interface or https://pimylifeup.com/raspberry-pi-gpio/
Built-in support for ODROID’s USB GPS Module without additional configuration.
Built-in support for NXP’s USB NFC Dongle without additional configuration.
The emteria.OS is running with many different screens. In the vast majority of cases, it correctly detects the resolution from the connected screen without any changes required (e.g. using the provided EDID information).
A custom resolution can be enforced by using use
vc4-fkms-v3d overlay (instead of
vc4-kms-v3d). For doing so, simply mount your sdcard and edit
- Choose the desired resolution in
- Replace the overlay name in
- Save your modifications and boot emteria.OS again.
Warning: Make sure that the
persist.rpi.use-fkms property in Android is set to
1, otherwise the device may not boot.
Some screen/graphics format combinations do not work with
vc4-fkms-v3d. In such cases you can change the used resolution manually, by editing two files (you need to mount both
system partitions first):
|/boot/config.txt||Old value||New value|
|hdmi_cvt=1280 720 60 6 0 0 0||hdmi_cvt=1024 600 60 6 0 0 0|
|/system/build.prop||Old value||New value|
Additional applications can be installed in same way as on standard Android devices (ADB, Download, F-Droid):
- Copy your application to a USB drive and connect it to your Pi. Open the File Manager application, navigate to the USB drive and install the application from there.
- Since Raspberry Pi has no USB OTG, “ADB over Ethernet” should be used instead of standard ADB. Please activate it first in the settings (Settings -> Emteria -> Enable ADB over Ethernet). An example can be found here. New applications can be installed directly from your PC using
- You can use preinstalled application market to install new applications. One example for using F-Droid can be found here.
- Common system freezes and crashes for high screen resolution: [forum discussion]
- Very rare hangs of the sdcard controller: [kernel issue 1] [kernel issue 2]
- Bluetooth doesn’t work on Raspberry Pi 3 Model B+ (but works on Raspberry Pi 3 Model B): [forum discussion]
- Bluetooth crashes on Raspberry Pi 3 Model B, especially with activated Wifi: [official discussion] [kernel issue 1] [kernel issue 3] [kernel issue 3]