Egor Tsyganchuk
fdeb97ee3b
- Added bzip2 to the list of required tools for building. - Provided a command snippet for installing the necessary packages, enhancing clarity for users setting up the environment.
142 lines
5.8 KiB
Markdown
142 lines
5.8 KiB
Markdown
# Build Toolchain — кросс-компилятор для ARM uClinux FDPIC
|
||
|
||
Набор скриптов для сборки кросс-компилятора под целевую платформу **ARM uClinux FDPIC (Thumb, ARMv7-m)**.
|
||
|
||
Целевой триплет: `arm-uclinuxfdpiceabi`
|
||
|
||
## Состав тулчейна
|
||
|
||
| Компонент | Версия | Назначение |
|
||
|-----------------|----------|-------------------------------------|
|
||
| Binutils | 2.42 | Ассемблер, линковщик, утилиты |
|
||
| GCC | 13.4.0 | Компилятор C/C++ |
|
||
| Linux (headers) | 4.9.224 | Заголовочные файлы ядра |
|
||
| uClibc-ng | 1.0.55 | Стандартная библиотека C |
|
||
|
||
### Дополнительные библиотеки
|
||
|
||
| Библиотека | Версия | Назначение |
|
||
|--------------|--------|---------------------------|
|
||
| zlib | 1.2.13 | Сжатие данных |
|
||
| OpenSSL | 3.0.13 | Криптография |
|
||
| LibVNCServer | 0.9.14 | VNC-сервер |
|
||
| FreeType | 2.13.2 | Рендеринг шрифтов |
|
||
|
||
Все библиотеки собираются статически.
|
||
|
||
## Характеристики целевой платформы
|
||
|
||
- **Архитектура:** ARM 32-bit (ARMv7-m)
|
||
- **Набор инструкций:** Thumb
|
||
- **ABI:** EABI с поддержкой FDPIC
|
||
- **Плавающая точка:** программная (soft float)
|
||
- **Потоки:** отключены
|
||
- **TLS:** отключён
|
||
|
||
## Зависимости хостовой системы
|
||
|
||
- bash
|
||
- make
|
||
- gcc (или другой C-компилятор для хоста)
|
||
- cmake
|
||
- wget
|
||
- bzip2
|
||
- tar
|
||
- стандартные утилиты (grep, sed и т.д.)
|
||
|
||
Для Ubuntu/WSL можно установить минимальный набор так:
|
||
|
||
```bash
|
||
sudo apt update
|
||
sudo apt install -y make gcc g++ cmake wget bzip2 tar sed grep xz-utils
|
||
```
|
||
|
||
## Использование
|
||
|
||
### 1. Загрузка исходников
|
||
|
||
```bash
|
||
./download_prerequisites.sh
|
||
```
|
||
|
||
Скрипт загружает архивы исходного кода всех компонентов в каталоги `src/toolchain/` и `src/libs/`. Уже загруженные архивы пропускаются.
|
||
|
||
### 2. Сборка тулчейна
|
||
|
||
```bash
|
||
./build-toolchain.sh
|
||
```
|
||
|
||
Сборка выполняется поэтапно:
|
||
|
||
1. Распаковка архивов
|
||
2. Сборка Binutils
|
||
3. Сборка GCC (этап 1 — минимальный компилятор C без libc)
|
||
4. Установка заголовочных файлов ядра Linux
|
||
5. Сборка uClibc-ng
|
||
6. Сборка GCC (этап 2 — полный компилятор C/C++ с поддержкой FDPIC)
|
||
7. Сборка дополнительных библиотек
|
||
8. Упаковка результата в архив
|
||
|
||
На выходе создаётся архив `toolset-jlv-armv7-m-gcc13.4.0-uclibc1.0.55.tar.xz`.
|
||
|
||
### 3. Настройка окружения
|
||
|
||
Есть два режима работы `env.sh`.
|
||
|
||
Обычный режим:
|
||
|
||
```bash
|
||
source ./env.sh
|
||
```
|
||
|
||
Этот режим работает "как раньше":
|
||
- добавляет `${PWD}/arm-uclinuxfdpiceabi/bin` в `PATH`
|
||
- задаёт `CFLAGS`, `CFLAGS_FOR_TARGET`, `CXXFLAGS_FOR_TARGET`
|
||
- задаёт `SUBARCH=armv7-m` и `SUBMODE=thumb`
|
||
- не переопределяет `CC`/`CXX`, поэтому не мешает хостовой сборке под WSL
|
||
|
||
Режим полного toolchain-окружения:
|
||
|
||
```bash
|
||
source ./env.sh --toolchain /путь/к/install [arflags]
|
||
```
|
||
|
||
Этот режим используется сборочными скриптами и дополнительно устанавливает `CC`, `CXX`, `CPP`, `LD`, `AR`, `RANLIB`, `STRIP`, `OBJCOPY`, `OBJDUMP`, `SYSROOT`, `LDFLAGS` и добавляет путь к тулчейну в `PATH`.
|
||
|
||
Деактивация:
|
||
|
||
```bash
|
||
source ./env.sh --toolchain --unregister
|
||
```
|
||
|
||
## Флаги компиляции
|
||
|
||
| Переменная | Значение | Назначение |
|
||
|------------|----------|------------|
|
||
| `CFLAGS` | `-O2` | Флаги хостовой/toolset-сборки по умолчанию |
|
||
| `CFLAGS_FOR_TARGET` | `-Os -mthumb` | Оптимизация по размеру, Thumb-инструкции для target |
|
||
| `LDFLAGS` | `-Wl,--fdpic` | Линковка с поддержкой FDPIC |
|
||
|
||
## Структура каталогов
|
||
|
||
```
|
||
build-toolchain/
|
||
├── build-toolchain.sh # Основной скрипт сборки
|
||
├── build-libraries.sh # Сборка дополнительных библиотек
|
||
├── download_prerequisites.sh # Загрузка исходников
|
||
├── env.sh # Настройка окружения
|
||
├── config/ # Конфигурации uClibc
|
||
│ ├── config-uClibc-ng-1.0.34
|
||
│ └── config-uClibc-ng-1.0.55
|
||
├── src/ # Исходный код (после загрузки)
|
||
│ ├── toolchain/ # Архивы компонентов тулчейна
|
||
│ └── libs/ # Архивы библиотек
|
||
├── build/ # Каталог сборки (создаётся автоматически)
|
||
└── install/ # Каталог установки (создаётся автоматически)
|
||
```
|
||
|
||
## Лицензия
|
||
|
||
Компоненты тулчейна распространяются под собственными лицензиями (GPL, LGPL и др.).
|