Кошик

Ваш кошик порожній

Встановлення Toolchain для rosco_m68k

Тулчейн для rosco_m68k можна поставити як глобально, так і використовувати як Docker контейнер. Рекомендую використовувати як Docker контейнер, або поставити глобально на WSL віртуальну машину. На основну машину встановлювати не рекомендується, оскільки він заміняє компілятор C на версію для m68k та робить інші зміни, які потім важко повертати назад.

Використання Docker

Попередні вимоги

  • Встановлений Docker Desktop (для Windows/macOS) або Docker Engine (для Linux)

Запуск контейнера

Для роботи з проектом потрібно змонтувати вашу робочу директорію до Docker контейнера:

docker run -v "$(pwd)/rosco_m68k:/rosco_m68k" -it roscopeco/rosco_m68k

Пояснення параметрів:

  • $(pwd)/rosco_m68k - директорія на вашому ПК (хості)
  • /rosco_m68k - директорія, яка з'явиться в корені контейнера
  • -v - монтує директорію з хоста в контейнер
  • -it - інтерактивний режим з терміналом

Для Windows

Якщо ви використовуєте Windows PowerShell або Command Prompt, замініть $(pwd) на абсолютний шлях:

docker run -v "C:/Users/YourUsername/Projects/rosco_m68k:/rosco_m68k" -it roscopeco/rosco_m68k

Робота з проектом

Після запуску контейнера перейдіть до потрібної директорії проекту, скомпілюйте необхідні бібліотеки та саму програму. Всі зміни в контейнері автоматично відображаються на вашому хості.

Використання WSL або глобальне встановлення на Linux

Цей спосіб зручний для інтеграції з VS Code - IDE підтягне всі необхідні компоненти та буде коректно відображати підсказки коду.

Попередні вимоги

  • WSL 2 (для Windows) або Linux система
  • Доступ до інтернету для завантаження пакетів

Встановлення Homebrew

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Після встановлення слідуйте інструкціям у терміналі для додавання Homebrew до PATH.

Встановлення toolchain

Виконайте наступну команду для встановлення всіх необхідних компонентів:

brew install python && \
brew tap rosco-m68k/toolchain && \
brew install gcc-cross-m68k@13 vasm-all srecord && \
brew unlink binutils-cross-m68k && \
brew unlink gcc-cross-m68k@13 && \
brew unlink vasm-all && \
brew install rosco-m68k-toolchain@13 && \
brew link --overwrite binutils-cross-m68k && \
brew link --overwrite gcc-cross-m68k@13 && \
brew link --overwrite vasm-all

Перевірка встановлення

Перевірте, чи коректно встановлено toolchain:

m68k-elf-gcc --version

Ви повинні побачити інформацію про версію компілятора.

Налаштування VS Code для WSL

Встановіть розширення "WSL" у VS Code, відкрийте папку проекту через WSL: Ctrl+Shift+P → "WSL: Open Folder in WSL". VS Code автоматично підтягне налаштування з WSL середовища.

Компіляція проекту

Після встановлення toolchain будь-яким способом, ви можете компілювати проекти для rosco_m68k:

cd /path/to/your/project
make

Поради

  • Docker: Найпростіший спосіб, не потребує змін у системі
  • WSL/Linux: Краща інтеграція з IDE, швидша компіляція
  • Не встановлюйте глобально: Це може призвести до конфліктів з іншими інструментами розробки

Можливі проблеми

Docker: помилка монтування директорії

Переконайтеся, що шлях до директорії написаний правильно і директорія існує.

WSL/Linux: brew команда не знайдена

Після встановлення Homebrew додайте його до PATH згідно з інструкціями у терміналі.

Помилка компіляції: compiler not found

Переконайтеся, що toolchain встановлено коректно, виконавши m68k-elf-gcc --version.