Halium

Welcome to the Halium porting guide. Halium is a collaborative project to unify the Hardware Abstraction Layer for projects which run GNU/Linux on mobile devices with pre-installed Android.

What is porting about - in a nutshell

Think of your device as a car. You have got a petrol car (Android). You want to put in an electric driven engine (target OS). In the garage you are told you can put in a diesel engine (e.g. Lineage OS). Fine, so your car is capable of exchanging the engine. Now you need to get all parts for your new engine (kernel, firmware, …), assemble them and build them into your car (porting). And because every car’s chassis is different, you can not use the parts of a Ford to use with a Porsche. That’s why every type of car needs its own engine (port). Got it?

Contents

Porting Guide

• First steps
• Get Halium source
• Build Halium
• Install Halium
• Debug Halium

Distribution

• Distribution

Supplementary Information

• About this chapter
• Device Overview
• Hardware and kernel enablement
• How to contribute documentation

Project

• Scope of Halium
• Related projects
• Planning
• Development
• Documentation Todo