This script is designed to run on existing Raspbian images and enables them to boot on any Libre Computer board. It uses an upstream FOSS software stack developed by the community and Libre Computer to support booting Raspbian.
It is a proof-of-concept and there are no warranties implied or otherwise. We highly recommend backing up the image if it holds important data in case something unexpected occurs. While the image should still boot on the original device, this is not fully tested or guaranteed so continue at your own risk.
This script installs/configures/overwrites data on the device's MicroSD card. It is designed to run on Raspberry Pi®s and requires internet access to download additional necessary components. Once the script finishes, the card should still remain bootable on the original board.
- Raspberry Pi 2 Model B or higher
- Reliable MicroSD Card (Samsung/SanDisk recommended)
- MicroUSB Power Supply
- Internet Connection
- Any Libre Computer board (Amazon Link)
- Raspbian 10 Buster Lite and Desktop armhf
- Raspbian 11 Bullseye Lite and Desktop armhf
- Raspbian 11 Bullseye Lite and Desktop arm64
- NOOBS (New Out Of Box Software) installations are not supported.
- If you want to use Ubuntu, you can use these Ubuntu 22.04 images.
- If you want to use Raspbian, you can use these Raspbian 11 images.
- GPIOs and Device Tree Overlays (dtoverlay) for I2C, SPI, UART, PWM need to be mapped via libretech-wiring-tool.
- Software designed around specific Raspberry Pi® hardware such as MIPI cameras, DPI displays, DSI pannels are not supported.
YouTube Video RunThrough On your Raspberry Pi:registered:, run:
sudo apt install -y git
git clone https://github.com/libre-computer-project/libretech-raspbian-portability.git lrp
sudo lrp/oneshot.sh aml-s905x-ccReplace aml-s905x-cc with the appropriate board you want the image to run on and follow the instructions. For a list of boards, run sudo lrp/oneshot.sh
- Refactor to robust coding standards
- Device tree overlay translation via our wiring tool
- Firmware for specific boards
We provide commercial support for porting specific distros or images, please reach out to us.