https://github.com/t3gemstone/sdk
This project includes all the necessary work for compiling the operating system, kernel, and other tools found on T3 Gemstone boards, and is intended for developers who wish to prepare a customized GNU/Linux Distribution.
https://github.com/t3gemstone/sdk
gemstone t3-gemstone t3foundation t3gemstone
Last synced: about 2 months ago
JSON representation
This project includes all the necessary work for compiling the operating system, kernel, and other tools found on T3 Gemstone boards, and is intended for developers who wish to prepare a customized GNU/Linux Distribution.
- Host: GitHub
- URL: https://github.com/t3gemstone/sdk
- Owner: t3gemstone
- License: apache-2.0
- Created: 2025-03-03T09:30:20.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-03-24T13:03:50.000Z (2 months ago)
- Last Synced: 2026-03-25T16:56:29.497Z (2 months ago)
- Topics: gemstone, t3-gemstone, t3foundation, t3gemstone
- Language: CSS
- Homepage: https://t3gemstone.org
- Size: 25.3 MB
- Stars: 3
- Watchers: 2
- Forks: 5
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# T3 Gemstone SDK
[](https://www.t3vakfi.org/en) [](https://opensource.org/licenses/Apache-2.0) [](https://github.com/89luca89/distrobox) [](https://www.jetify.com/devbox/docs/contributor-quickstart/) [](https://docs.t3gemstone.org)
[](https://deepwiki.com/t3gemstone/sdk)
## What is it?
This project includes all the necessary work for compiling the operating system, kernel, and other tools found on T3 Gemstone boards, and is intended for developers who wish to prepare a customized GNU/Linux Distribution.
All details related to the project can be found at https://docs.t3gemstone.org/en/sdk. Below, only a summary of how to perform the installation is provided.
##### 1. Install Docker and jetify-devbox on the host computer.
```bash
user@host:$ ./setup.sh
```
##### 2. After the installation is successful, activate the jetify-devbox shell to automatically install tools such as Distrobox, taskfile, etc.
```bash
user@host:$ devbox shell
```
##### 3. Download the repositories, create a Docker image, and enter it.
```bash
📦 devbox:sdk> task fetch
📦 devbox:sdk> task permissions
📦 devbox:sdk> task box
```
##### 4. Build the Yocto recipes and Gemstone distro.
```bash
# Show all available tasks and environment variables
🚀 distrobox:workdir> task default
# Build kernel, bootloader, initrd
# Note: MACHINE can be 'intel-corei7-64', 't3-gem-o1', 'beagley-ai' or 'qemuarm64'
# Note: First build takes approximately 2 hours and you need at least 32GB empty disk space
🚀 distrobox:workdir> task yocto:build MACHINE=intel-corei7-64
# Pack Gemstone Distro
🚀 distrobox:workdir> task distro:build MACHINE=intel-corei7-64 DISTRO_TYPE=desktop DISTRO_BASE=ubuntu DISTRO_SUITE=jammy IMG_SIZE=16G
# After build images, run virtual machine
🚀 distrobox:workdir> task yocto:runqemu MACHINE=intel-corei7-64 DISTRO_TYPE=desktop DISTRO_BASE=ubuntu DISTRO_SUITE=jammy WORKDIR=$PWD
```
### Screencast
[](https://asciinema.org/a/KDwPPlCV2wxzpwDB4sLseW2X9)
# Configuration of Kernel and U-Boot
```bash
# Initialize bitbake
🚀 distrobox:workdir> source yocto/poky/oe-init-build-env build/intel-corei7-64
# Tune Linux Kernel
🚀 distrobox:intel-corei7-64> bitbake -c menuconfig virtual/kernel
# Tune U-Boot
🚀 distrobox:intel-corei7-64> bitbake -c menuconfig virtual/bootloader
```
# Troubleshooting
#### 1. First Installation of Docker
Docker is installed on your system via the `./setup.sh` command. If you are installing Docker for the first time, you must log out and log in again after the installation is complete.
#### 2. Debos Segmentation Fault Error
When you perform the compilation process with the task:distro command many times, debos may occasionally give a "Segmentation Fault" error.
Additionally, following error can occur while compiling the arm64 image for BeagleY-AI. This problem persists even after rebooting your system, so you may need to apply the solution after each reboot.
```sh
W: Failure trying to run: /sbin/ldconfig
qemu: uncaught target signal 11 (Segmentation fault) - core dumped
```
To solve these problems, first try running the following command inside [devbox shell](#section-ii)
```bash
📦 devbox:sdk> distrobox stop gemstone-sdk
```
if it does not work, run the destroy command.
```bash
📦 devbox:sdk> task destroy
```
#### 3. Yocto Issues
```bash
# Stop distrobox
📦 devbox:sdk> distrobox stop gemstone-sdk
# Start and Enter distrobox image
📦 devbox:sdk> task box
# Clean yocto image
🚀 distrobox:workdir> task yocto:build MACHINE=intel-corei7-64 TARGET='-c clean -c cleansstate gemstone-image-rd virtual/kernel'
# Rebuild
🚀 distrobox:workdir> task yocto:build MACHINE=intel-corei7-64
```
#### 4. Failed `task box` command
```sh
📦 devbox:sdk> task box
task: Failed to run task "box": exit status 1
Error: An error occurred
```
To figure out what exact problem is, run `distrobox-enter --additional-flags "--tty" --name gemstone-sdk --no-workdir --verbose`
```sh
*** update-locale: Error: invalid locale settings: LC_ALL=en_EN.UTF-8 LANG=en_EN.UTF-8
```
To solve this problem, try to update locales
```bash
📦 devbox:sdk> sudo dpkg-reconfigure locales
```