Go to file
Ivaylo Ivanov 3ab64bed39 lib: Introduce unic
unic is a small library of C functions that is currently written
in plain C. It's purpose isn't to be fast, but "universal" - as
in include as little architecture-specific code as possible.

The old neatlibc still resides, but isn't being built. There is
still more to do, including implementation of memory management,
so keep it there for now.

Signed-off-by: Ivaylo Ivanov <ivo.ivanov.ivanov1@gmail.com>
2024-09-23 20:17:44 +03:00
arch arch: aarch64: Set up Stack Pointer 2024-08-06 19:23:47 +03:00
blob EXPERIMENTAL: Partially implement NewLib 2023-07-19 19:37:17 +03:00
board board: Add support for gta4xl (Samsung Galaxy Tab S6 Lite) 2024-09-15 09:53:37 +03:00
configs board: Add support for gta4xl (Samsung Galaxy Tab S6 Lite) 2024-09-15 09:53:37 +03:00
Documentation/kbuild uniLoader: Migrate to kconfig based configurations 2022-06-14 18:02:47 +03:00
include soc: Add basic support for Exynos9610 2024-09-15 09:53:36 +03:00
lib lib: Introduce unic 2024-09-23 20:17:44 +03:00
main lib: simplefb: Add support for RGB888 24bpp (dependant on the stride) 2023-07-24 09:54:16 +03:00
scripts uniLoader: Migrate to kconfig based configurations 2022-06-14 18:02:47 +03:00
soc soc: Add basic support for Exynos9610 2024-09-15 09:53:36 +03:00
.gitignore main: Move assembly code into an individual arch-specific folder 2022-06-16 14:40:28 +03:00
.gitmodules lib: Replace the broken newlib implementation with neatlibc 2024-08-06 13:25:07 +03:00
Kconfig Makefile: Move Linux kernel and Device Tree paths to Kconfig 2022-06-14 21:50:15 +03:00
LICENSE .: Initiate the project 2022-06-12 17:09:32 +03:00
Makefile lib: Introduce unic 2024-09-23 20:17:44 +03:00
README.md README: Rework it according to the totally-recent build changes 2024-08-06 10:33:38 +03:00

uniLoader

A secondary bootloader that is capable of loading the upstream Linux kernel for Android and iOS-based devices.

The purpose behind it is to provide a small shim for avoiding vendor bootloader quirks.

(ex.: some newer Exynos phones leave decon framebuffer refreshing disabled right before jumping to kernel, which makes initial debugging efforts when bringing up the platform to upstream linux hard)
The currently supported architectures are ARMV7 and AARCH64.

Preparation

  1. Install a toolchain that matches your target architecture (ex. AArch64 cross-toolchain):
    sudo apt install aarch64-linux-gnu
    
  2. Clone the repository:
    git clone https://github.com/ivoszbg/uniLoader
    
  3. Navigate to the project directory:
    cd uniLoader
    
  4. Place your kernel and device tree blobs under the blob/ directory.

Make Syntax

make ARCH=<arch> CROSS_COMPILE=<toolchain>

Building Example

sudo apt install aarch64-linux-gnu
git clone https://github.com/ivoszbg/uniLoader
cd uniLoader
cp /home/user/linux/arch/arm64/boot/Image blob/Image
cp /home/user/linux/arch/arm64/boot/dts/exynos/exynos8895-dreamlte.dtb blob/dtb
make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- -j4 dreamlte_defconfig
make ARCH=arm64 CROSS_COMPILE=aarch64-linux-gnu- -j4

Usage

For Apple devices: Load the generated uniLoader binary via PongoOS.
For Android devices: Replace the Linux kernel in your boot.img with the uniLoader binary.

TODO LIST

  1. [C] Allow loading instead of PongoOS for Apple devices;
  2. [C] Fix/replace the libc implementation;
  3. [M] Implement a serial library and make the debug lib less hacky;
  4. [M] Implement more features:

    New devices
    Boot menu with countdown timer and selectable items via GPIO volume keys
    Threaded execution

[C] = Critical for overall ease of use and functionality
[M] = Nice to have :)

License

This project is licensed under GPL2.