最新無料組み込みツールチェーンと環境構築ガイド

2026年6月9日

もっとスキルを活かしたいエンジニアへ

スポンサードリンク

働き方から選べる

無料で使えて良質な案件の情報収集ができるサービス

エンジニアの世界では、「いつでも動ける状態を作っておけ」とよく言われます。
技術やポートフォリオがあっても、自分に合う案件情報を日常的に見れていないと、いざ動こうと思った時に比較や判断が難しくなってしまいます。
普段から案件情報が集まる環境を作っておくと、良い案件が出た時にすぐ動きやすくなりますよ。
筆者自身も、メガベンチャー勤務時代に年収1,500万円を超えた経験があります。振り返ると、技術だけでなく「どんな案件や働き方があるか」を日頃から見ていたことが、キャリアの選択肢を広げるきっかけになりました。
このブログを読んでくれた方に感謝を込めて、実際に使っている情報収集サービスを紹介します。

フルリモート・週3日・高単価、どんな条件も妥協したくないなら

フリーランスボードに無料会員登録する

利用者10万人以上。業界最大規模45万件の案件。AIマッチ機能や無料の相場情報が人気。

年収800万円以上のキャリアアップ・ハイクラス正社員を視野に入れているなら

Beyond Careerに無料相談する

内定獲得率90%以上。紹介先企業とは役員クラスのコネクションがある安心と信頼できるエージェント。

Contents

1 最新無料ツールチェーンの概要と取得方法
2 各 OS でのインストール手順と環境変数永続化
3 推奨 IDE と拡張機能のセットアップ
4 デバッグ環境構築とサンプルプロジェクトビルド
5 トラブルシューティングとリモート開発オプション
6 終わりに

スポンサードリンク

各 OS でのインストール手順と環境変数永続化

組み込み開発は Windows・macOS・Linux のいずれでも同じツールチェーンを利用できますが、アーカイブ展開 と PATH への登録 が OS 毎に異なります。本節では共通の概念と OS 別の具体手順を示します。環境変数は一度設定すれば全てのシェル／ターミナルで有効になるよう、永続化方法をまとめました。

環境変数の永続化（共通）

ツールチェーンの実行ファイルディレクトリを ARM_NONE_EABI_TOOLCHAIN という環境変数に格納し、PATH に追加します。これにより arm-none-eabi-gcc 系コマンドがどこからでも呼び出せます。

ARM_NONE_EABI_TOOLCHAIN = &lt;ツールチェーン展開先&gt;/bin
PATH = $PATH:$ARM_NONE_EABI_TOOLCHAIN   (Linux/macOS)
PATH = %Path%;%ARM_NONE_EABI_TOOLCHAIN% (Windows)

ARM_NONE_EABI_TOOLCHAIN = <ツールチェーン展開先>/bin

PATH = $PATH:$ARM_NONE_EABI_TOOLCHAIN (Linux/macOS)

PATH = %Path%;%ARM_NONE_EABI_TOOLCHAIN% (Windows)

以下の OS 別手順では、この変数と PATH の設定をそれぞれの方法で永続化します。

Windows へのインストール手順

Windows 環境では PowerShell を管理者権限で起動し、公式アーカイブを C:\Toolchains\GNUArm に展開します。環境変数はレジストリの Machine スコープに書き込むことで全ユーザーに適用できます。

# 1. アーカイブ展開
Expand-Archive -Path .\gnu-arm-embedded-13.2-2024-01-win64.zip `
               -DestinationPath C:\Toolchains\GNUArm

# 2. 環境変数の永続化 (Machine スコープ)
[Environment]::SetEnvironmentVariable('ARM_NONE_EABI_TOOLCHAIN',
    'C:\Toolchains\GNUArm\bin', 'Machine')
$oldPath = [Environment]::GetEnvironmentVariable('Path','Machine')
$newPath = &quot;$oldPath;C:\Toolchains\GNUArm\bin&quot;
[Environment]::SetEnvironmentVariable('Path',$newPath,'Machine')

# 1. アーカイブ展開

Expand-Archive -Path .\gnu-arm-embedded-13.2-2024-01-win64.zip `

-DestinationPath C:\Toolchains\GNUArm

# 2. 環境変数の永続化 (Machine スコープ)

[Environment]::SetEnvironmentVariable('ARM_NONE_EABI_TOOLCHAIN',

'C:\Toolchains\GNUArm\bin', 'Machine')

$oldPath = [Environment]::GetEnvironmentVariable('Path','Machine')

$newPath = "$oldPath;C:\Toolchains\GNUArm\bin"

[Environment]::SetEnvironmentVariable('Path',$newPath,'Machine')

設定後、PowerShell を再起動して arm-none-eabi-gcc --version が表示されれば完了です。

macOS へのインストール手順

macOS では Homebrew による補助ツール（OpenOCD 等）の導入と、アーカイブの /usr/local/opt/gnu-arm-embedded 配下への展開を行います。シェル設定は ~/.zshrc（デフォルトシェルが Zsh の場合）に追記します。

# 1. アーカイブ展開
sudo mkdir -p /usr/local/opt/gnu-arm-embedded
sudo tar -xzf gnu-arm-embedded-13.2-2024-01-mac.tar.xz \
    -C /usr/local/opt/gnu-arm-embedded --strip-components=1

# 2. 環境変数の永続化 (Zsh)
cat &lt;&lt;'EOF' &gt;&gt; ~/.zshrc
export ARM_NONE_EABI_TOOLCHAIN=/usr/local/opt/gnu-arm-embedded/bin
export PATH=$PATH:$ARM_NONE_EABI_TOOLCHAIN
EOF
source ~/.zshrc

# 3. Homebrew 経由で OpenOCD をインストール (オプション)
brew install openocd

# 1. アーカイブ展開

sudo mkdir -p /usr/local/opt/gnu-arm-embedded

sudo tar -xzf gnu-arm-embedded-13.2-2024-01-mac.tar.xz \

-C /usr/local/opt/gnu-arm-embedded --strip-components=1

# 2. 環境変数の永続化 (Zsh)

cat <<'EOF' >> ~/.zshrc

export ARM_NONE_EABI_TOOLCHAIN=/usr/local/opt/gnu-arm-embedded/bin

export PATH=$PATH:$ARM_NONE_EABI_TOOLCHAIN

EOF

source ~/.zshrc

# 3. Homebrew 経由で OpenOCD をインストール (オプション)

brew install openocd

Linux へのインストール手順

Linux 系ディストリビューションでは sudo 権限が必要です。ここでは Ubuntu/Debian 系を例に、アーカイブ展開先は /opt/gnu-arm-embedded とし、.bashrc に環境変数を書き込みます。

# 1. 必要パッケージのインストール
sudo apt update &amp;&amp; sudo apt install -y build-essential libncurses5-dev python3-pip

# 2. アーカイブ展開
sudo mkdir -p /opt/gnu-arm-embedded
sudo tar -xzf gnu-arm-embedded-13.2-2024-01-x86_64-linux.tar.xz \
    -C /opt/gnu-arm-embedded --strip-components=1

# 3. 環境変数の永続化 (Bash)
cat &lt;&lt;'EOF' &gt;&gt; ~/.bashrc
export ARM_NONE_EABI_TOOLCHAIN=/opt/gnu-arm-embedded/bin
export PATH=$PATH:$ARM_NONE_EABI_TOOLCHAIN
EOF
source ~/.bashrc

# 4. OpenOCD のインストール (Ubuntu 系例)
sudo apt install -y openocd

# 1. 必要パッケージのインストール

sudo apt update && sudo apt install -y build-essential libncurses5-dev python3-pip

# 2. アーカイブ展開

sudo mkdir -p /opt/gnu-arm-embedded

sudo tar -xzf gnu-arm-embedded-13.2-2024-01-x86_64-linux.tar.xz \

-C /opt/gnu-arm-embedded --strip-components=1

# 3. 環境変数の永続化 (Bash)

cat <<'EOF' >> ~/.bashrc

export ARM_NONE_EABI_TOOLCHAIN=/opt/gnu-arm-embedded/bin

export PATH=$PATH:$ARM_NONE_EABI_TOOLCHAIN

EOF

source ~/.bashrc

# 4. OpenOCD のインストール (Ubuntu 系例)

sudo apt install -y openocd

まとめ
各 OS 共通で重要なのは ツールチェーンのパスを永続化し、システム全体から呼び出せるようにすること です。上記手順で環境変数が正しく設定されていれば、次章以降の IDE 設定やデバッグ構築へスムーズに移行できます。

推奨 IDE と拡張機能のセットアップ

開発効率を最大化するためには、コード補完・静的解析・デバッガ統合が標準装備された IDE が不可欠です。本節では VS Code、Eclipse CDT、PlatformIO の 3 つの主流環境について、ツールチェーン自動検出と共通設定ポイントを解説します。

VS Code と主要拡張機能

VS Code は軽量かつ拡張性が高く、組み込み開発者に最も支持されています。以下の拡張機能をインストールすると、C/C++ の IntelliSense、OpenOCD/J‑Link デバッグ、CMSIS‑Pack 管理がすべて利用可能になります。

C/C++ (Microsoft) – 高速なコード補完とデバッグ情報提供
Cortex‑Debug – OpenOCD・J‑Link とのブリッジ機能
ARM CMSIS Pack Installer（任意） – パックの取得・管理

拡張インストール後、settings.json にツールチェーンパスを明示します。環境変数 ARM_NONE_EABI_TOOLCHAIN が設定されていれば ${env:...} で参照できます。

{
    &quot;C_Cpp.default.compilerPath&quot;: &quot;${env:ARM_NONE_EABI_TOOLCHAIN}/arm-none-eabi-gcc&quot;,
    &quot;cortex-debug.openocdPath&quot;: &quot;/usr/local/bin/openocd&quot;,   // macOS/Linux の例
    &quot;cortex-debug.armToolchainPath&quot;: &quot;${env:ARM_NONE_EABI_TOOLCHAIN}&quot;
}

{

"C_Cpp.default.compilerPath": "${env:ARM_NONE_EABI_TOOLCHAIN}/arm-none-eabi-gcc",

"cortex-debug.openocdPath": "/usr/local/bin/openocd", // macOS/Linux の例

"cortex-debug.armToolchainPath": "${env:ARM_NONE_EABI_TOOLCHAIN}"

}

Eclipse CDT と GNU MCU Eclipse プラグイン

Eclipse は大規模プロジェクト向けのフル機能 IDE です。GNU MCU Eclipse（現 Eclipse Embedded） 系プラグインを導入すれば、ツールチェーン検出・OpenOCD 設定ウィザードが自動化されます。

1. Eclipse IDE for C/C++ Developers を公式サイトから取得し起動  
2. Help → Eclipse Marketplace で &quot;GNU MCU Eclipse&quot; 系列プラグインを検索・インストール  
3. New Project → C Project → Executable → Hello World を選択、Toolchains の欄で &quot;Cross GCC&quot; を指定

1. Eclipse IDE for C/C++ Developers を公式サイトから取得し起動

2. Help → Eclipse Marketplace で "GNU MCU Eclipse" 系列プラグインを検索・インストール

3. New Project → C Project → Executable → Hello World を選択、Toolchains の欄で "Cross GCC" を指定

プロジェクト作成時に ARM_NONE_EABI_TOOLCHAIN が自動的に参照されるため、手動パス入力のミスを防げます。

PlatformIO の導入とテンプレート設定

PlatformIO は VS Code 内蔵型の統合ビルドシステムで、依存関係管理が非常に楽です。以下コマンドで拡張機能をインストールし、プロジェクト作成時にツールチェーンを明示します。

code --install-extension platformio.platformio-ide   # VS Code から直接実行可能

1 2	code --install-extension platformio.platformio-ide # VS Code から直接実行可能

platformio.ini に GNU Arm Embedded を優先させる設定例は次の通りです。

[env:stm32f401re]
platform = ststm32
board = nucleo_f401re
framework = arduino
toolchain = gccarmnoneeabi
build_flags = -I${PROJECT_DIR}/include

[env:stm32f401re]

platform = ststm32

board = nucleo_f401re

framework = arduino

toolchain = gccarmnoneeabi

build_flags = -I${PROJECT_DIR}/include

まとめ
VS Code は軽快さ、Eclipse は大規模開発向け機能、PlatformIO は依存管理とマルチボード対応というそれぞれの強みがあります。共通点は 環境変数にツールチェーンパスを委譲 することで、設定ミスを根本的に防げる点です。

デバッグ環境構築とサンプルプロジェクトビルド

デバッグができなければ開発は前進しません。本章では OpenOCD の正しいインストール手順 → VS Code 用の launch.json 設定 → GitHub テンプレートから取得した LED 点滅サンプルのビルド を順に解説します。

OpenOCD のインストールと基本設定

OpenOCD は JTAG/SWD デバッグ用サーバとして広く利用されています。OS 別の正しいインストールコマンドは以下です（openodc という誤字は削除しました）。

OS	コマンド例
Windows	`choco install openocd` （Chocolatey が必要）
macOS	`brew install openocd`
Linux	`sudo apt-get install -y openocd`

インストール後、デバイス固有の設定ファイルを作成します。以下は STM32F4 系列 を ST‑LINK で接続する例です。

# interface/stlink.cfg
interface stlink
transport select swd

# target/stm32f4x.cfg
source [find target/stm32f4x.cfg]

# interface/stlink.cfg

interface stlink

transport select swd

# target/stm32f4x.cfg

source [find target/stm32f4x.cfg]

設定ファイルを保存したディレクトリで次のコマンドを実行し、エラーが出なければサーバは待機状態です。

openocd -f interface/stlink.cfg -f target/stm32f4x.cfg

1 2	openocd -f interface/stlink.cfg -f target/stm32f4x.cfg

VS Code でのデバッグ構成例

launch.json に OpenOCD 経由のデバッグ設定を記述します。以下は Windows 環境ですが、パスだけ macOS/Linux 用に置き換えれば同一です。

{
    &quot;version&quot;: &quot;0.2.0&quot;,
    &quot;configurations&quot;: [
        {
            &quot;name&quot;: &quot;Debug STM32 (OpenOCD)&quot;,
            &quot;type&quot;: &quot;cortex-debug&quot;,
            &quot;request&quot;: &quot;launch&quot;,
            &quot;executable&quot;: &quot;${workspaceFolder}/build/firmware.elf&quot;,
            &quot;cwd&quot;: &quot;${workspaceFolder}&quot;,
            &quot;servertype&quot;: &quot;openocd&quot;,
            &quot;device&quot;: &quot;STM32F401RE&quot;,
            &quot;configFiles&quot;: [
                &quot;interface/stlink.cfg&quot;,
                &quot;target/stm32f4x.cfg&quot;
            ],
            &quot;runToMain&quot;: true
        }
    ]
}

{

"version": "0.2.0",

"configurations": [

{

"name": "Debug STM32 (OpenOCD)",

"type": "cortex-debug",

"request": "launch",

"executable": "${workspaceFolder}/build/firmware.elf",

"cwd": "${workspaceFolder}",

"servertype": "openocd",

"device": "STM32F401RE",

"configFiles": [

"interface/stlink.cfg",

"target/stm32f4x.cfg"

"runToMain": true

}

]

}

J‑Link を使用する場合は servertype を "jlink" に変更し、toolchainPath で J‑Link のインストールディレクトリを指定してください。

GitHub テンプレートからのサンプル取得・ビルド

公式に公開されている LED ブリンク サンプルは以下のリポジトリにあります。クローンして Makefile でビルドすれば、すぐにハードウェア上で動作確認が可能です。

git clone https://github.com/ARMmbed/embedded-c-sample-blinky.git
cd embedded-c-sample-blinky

# GNU Arm Embedded Toolchain を使用してビルド
make TOOLCHAIN=arm-none-eabi-

git clone https://github.com/ARMmbed/embedded-c-sample-blinky.git

cd embedded-c-sample-blinky

# GNU Arm Embedded Toolchain を使用してビルド

make TOOLCHAIN=arm-none-eabi-

生成された firmware.elf を先ほど作成した launch.json に指定し、VS Code で F5 キーを押すだけでデバッグが開始します。ボード上の LED が 1 秒間隔で点滅すれば成功です。

まとめ
OpenOCD のインストール → VS Code デバッグ設定 → GitHub テンプレートから取得したサンプルビルドという流れを一度確立すれば、以降はボードやデバッガを差し替えても同じ launch.json が使えるため、開発効率が大幅に向上します。

トラブルシューティングとリモート開発オプション

実務で遭遇しやすいエラーは「パス未設定」「ライブラリ欠如」「デバッグ接続失敗」の 3 種類です。本節では代表的なエラーメッセージと対策を表にまとめ、さらに VS Code Remote‑SSH と Dev Containers を活用したリモート／コンテナ開発の手順をご紹介します。

よくあるエラーと対処法（表形式）

エラーメッセージ	主な原因	推奨対策
`arm-none-eabi-gcc: command not found`	PATH にツールチェーンが未登録、またはシェルが再読み込みされていない	環境変数設定行を `.bashrc` / `.zshrc` に追記し、ターミナルを再起動
`cannot find -lcmsis_dsp`	CMSIS‑DSP ライブラリ未インストール	`pip install cmsis-pack-manager && mbedcmsis pack import ARM::CMSIS-DSP` で取得し、CMake にリンク追加
`openocd: error: cannot find board configuration file`	OpenOCD の config パスが間違っている	フルパスで `-f /full/path/interface/stlink.cfg -f /full/path/target/...cfg` を指定
`Failed to connect to target` (J‑Link)	USB 権限不足（Linux）	`/etc/udev/rules.d/99-jlink.rules` に `ATTR{idVendor}=="1366", MODE="0666"` を追加し、`sudo udevadm control --reload-rules && sudo udevadm trigger`
`segmentation fault (core dumped)` during build	ビルドオプションがデバイスと不一致（例: -mcpu が違う）	`-mcpu=cortex-m4 -mthumb` を明示し、使用ボードに合わせる

エラーメッセージを確認したらまずこの表を参照し、原因の切り分けを行ってください。

Remote‑SSH のセットアップ手順

VS Code → Extensions で Remote - SSH をインストール
~/.ssh/config に接続先情報を記述（例）
text Host devboard HostName 192.168.0.10 User pi IdentityFile ~/.ssh/id_rsa
コマンドパレットで Remote-SSH: Connect to Host → devboard を選択
接続後はサーバ上にインストール済みの GNU Arm Embedded / OpenOCD がそのまま利用可能。ローカルと同様に make や platformio run が実行できる。

Dev Containers で統一開発環境を構築する手順

Docker が導入されたマシンで、以下のファイルをプロジェクト直下に配置します。これだけで全員が同一バージョンのツールチェーンとデバッグサーバを持つコンテナが起動します。

# Dockerfile (devcontainer)
FROM ubuntu:22.04

RUN apt-get update &amp;&amp; DEBIAN_FRONTEND=noninteractive apt-get install -y \
    build-essential git curl wget \
    gcc-arm-none-eabi gdb-multiarch openocd \
    python3-pip &amp;&amp; \
    pip3 install --no-cache-dir cmsis-pack-manager

ENV ARM_NONE_EABI_TOOLCHAIN=/usr/bin

# Dockerfile (devcontainer)

FROM ubuntu:22.04

RUN apt-get update && DEBIAN_FRONTEND=noninteractive apt-get install -y \

build-essential git curl wget \

gcc-arm-none-eabi gdb-multiarch openocd \

python3-pip && \

pip3 install --no-cache-dir cmsis-pack-manager

ENV ARM_NONE_EABI_TOOLCHAIN=/usr/bin

// devcontainer.json
{
    &quot;name&quot;: &quot;Embedded C DevContainer&quot;,
    &quot;dockerFile&quot;: &quot;Dockerfile&quot;,
    &quot;settings&quot;: {
        &quot;terminal.integrated.shell.linux&quot;: &quot;/bin/bash&quot;
    },
    &quot;extensions&quot;: [
        &quot;ms-vscode.cmake-tools&quot;,
        &quot;marus25.cortex-debug&quot;,
        &quot;ms-vscode.cpptools&quot;
    ],
    &quot;postCreateCommand&quot;: &quot;git submodule update --init || true&quot;
}

// devcontainer.json

{

"name": "Embedded C DevContainer",

"dockerFile": "Dockerfile",

"settings": {

"terminal.integrated.shell.linux": "/bin/bash"

"extensions": [

"ms-vscode.cmake-tools",

"marus25.cortex-debug",

"ms-vscode.cpptools"

"postCreateCommand": "git submodule update --init || true"

}

VS Code で Remote - Containers: Open Folder in Container を選択すると、上記イメージが自動ビルドされ、コンテナ内のシェルが開きます。以後は make, openocd, platformio がすべて利用可能です。

まとめ
エラーは パス・権限・設定不一致 が根本原因になることが多いです。表形式で対策を整理し、Remote‑SSH や Dev Containers を活用すれば「開発環境の差異」自体を排除できます。統一されたコンテナは CI/CD パイプラインにもそのまま流用でき、チーム全体の品質向上に寄与します。

終わりに

本稿では GNU Arm Embedded Toolchain と LLVM‑Mbed の最新取得方法、OS 別インストール手順と環境変数永続化、主要 IDE の設定例、OpenOCD を用いたデバッグフロー、そして実務で頻出するトラブルへの対処法を網羅的に解説しました。

正しいバージョン情報と公式リンクを必ず確認し、SHA256 検証で安全性を担保してください。
環境変数は一箇所で永続化すれば、どの OS でも同じ手順で利用できます。
VS Code・Eclipse・PlatformIO のいずれかを選び、ARM_NONE_EABI_TOOLCHAIN に委譲すれば設定ミスが激減します。
デバッグは OpenOCD と IDE の連携だけで完結し、GitHub テンプレートから取得したサンプルで即時確認できます。

これらの手順をベースに、自身のプロジェクトやチームに合わせたカスタマイズを加えていくことで、組み込み開発のスピードと信頼性が飛躍的に向上します。 Happy coding!

スポンサードリンク

もっとスキルを活かしたいエンジニアへ

スポンサードリンク

働き方から選べる

無料で使えて良質な案件の情報収集ができるサービス

フルリモート・週3日・高単価、どんな条件も妥協したくないなら

フリーランスボードに無料会員登録する

利用者10万人以上。業界最大規模45万件の案件。AIマッチ機能や無料の相場情報が人気。

年収800万円以上のキャリアアップ・ハイクラス正社員を視野に入れているなら

Beyond Careerに無料相談する

内定獲得率90%以上。紹介先企業とは役員クラスのコネクションがある安心と信頼できるエージェント。

-C言語

comment コメントをキャンセル

: C言語

2026年版 C言語入門教材比較とおすすめ3選 – 組込み開発者必見

組み込みシステム開発で最適なC言語教材を選ぶための比較基準と、最新リニューアル版『Cの絵本』を含む3冊の詳細レビューを掲載しています。

: C言語

C言語学習開始前の準備と7日間ロードマップ - IDE・コンパイラ・Git導入手順

C言語を実務で使えるようになるためのIDE・コンパイラ・Git環境のインストール方法と、1週間で習得できる学習プランをご紹介します。

: C言語

組込みシステムのC言語開発環境比較と選定ガイド（2026）

AI支援やDocker化、拡張エコシステムを踏まえた組込みC開発環境の2026年版比較と導入・移行ガイド。

: C言語

C言語で学ぶ組込み開発入門と最新開発環境構築ガイド

C言語の基礎と組込み概念、WSL2上のUbuntu環境構築、PlatformIOやGNU Arm Toolchainによるクロスコンパイル・デバッグ方法をまとめた実践ガイドです。

: C言語

C言語演算子優先順位完全ガイド【2024年版C23】

C言語で複雑な式を書く際に必須の演算子優先順位を、2024年版C23標準と実務サンプルで徹底解説します。

2026年のtl;dvの実用性と機能評価｜会議効率化ツール比較

Python 3.12 新機能: 型ヒント・キャッシュ・パフォーマンス改善

最新無料組み込みツールチェーンと環境構築ガイド

最新無料ツールチェーンの概要と取得方法

各 OS でのインストール手順と環境変数永続化

環境変数の永続化（共通）

Windows へのインストール手順

macOS へのインストール手順

Linux へのインストール手順

推奨 IDE と拡張機能のセットアップ

VS Code と主要拡張機能

Eclipse CDT と GNU MCU Eclipse プラグイン

PlatformIO の導入とテンプレート設定

デバッグ環境構築とサンプルプロジェクトビルド

OpenOCD のインストールと基本設定

VS Code でのデバッグ構成例

GitHub テンプレートからのサンプル取得・ビルド

トラブルシューティングとリモート開発オプション

よくあるエラーと対処法（表形式）

Remote‑SSH のセットアップ手順

Dev Containers で統一開発環境を構築する手順

終わりに

VS Code と主要拡張機能

VS Code でのデバッグ構成例