back to home

ETrobocon / etrobo

ETロボコンのシミュレータ/SPIKE/EV3/NXTに対応するRTOS開発環境です。

View on GitHub
54 stars
26 forks
0 issues
ShellPython

AI Architecture Analysis

This repository is indexed by RepoMind. By analyzing ETrobocon/etrobo in our AI interface, you can instantly generate complete architecture diagrams, visualize control flows, and perform automated security audits across the entire codebase.

Our Agentic Context Augmented Generation (Agentic CAG) engine loads full source files into context on-demand, avoiding the fragmentation of traditional RAG systems. Ask questions about the architecture, dependencies, or specific features to see it in action.

Source files are only loaded when you start an analysis to optimize performance.

Embed this Badge

Showcase RepoMind's analysis directly in your repository's README.

[![Analyzed by RepoMind](https://img.shields.io/badge/Analyzed%20by-RepoMind-4F46E5?style=for-the-badge)](https://repomind.in/repo/ETrobocon/etrobo)
Preview:Analyzed by RepoMind

Repository Overview (README excerpt)

Crawler view

etrobo all-in-one installer/builder/launcher environment 基本的には、ETロボコンのシミュレータ部門エントリークラスおよびフィジカル部門ベーシッククラス向けの開発環境です。アプライドクラス向けのRasPike-ARTは別途こちらからインストールしてください。 see INSTALL that is written by english language 注:ここでは、 によってインストールされるファイル群を「**etroboパッケージ**」、 によって起動する開発環境を「**etrobo環境**」と呼びます。 etrobo環境は、以下のソフトウェアおよび成果物の一部を利用し構成され、etroboパッケージはこれらを自動的に取得しインストールします。 • ETロボコンシミュレータ • SPIKE-RT ETロボコンバージョン • SPIKE-RT • TOPPERS/EV3RT for Athrill SPIKE APIバージョン • TOPPERS/EV3RT • TOPPERS/箱庭 • GNU Arm Embedded Toolchain インストール方法や環境の解説は**etroboパッケージのWiki**をご覧ください。 インストールがうまくいかなかった場合は、ターミナルのログを添えて 「やばい」ラベルで問題を報告してください。 特にMac版は環境による差が大きく、あまり広範なテストができていません。お気づきの点があればお気軽にIssueを立ててください。 主な特徴 • Visual Studio Code(VSCode)以外のインストールを完全自動化 • Windows/Mac/Linux/ChromeOSで同一の操作による開発を実現 • SPIKEモード(デフォルト)では、RasPike-ART向けETロボコンSPIKE APIのコードをETロボコンシミュレータ向けのAthrill/ASP3にビルド可能 • SPIKE-RTモードでは、SPIKE-RT向けETロボコンSPIKE APIのコードを実機向けにビルド可能 • EV3モードでは、Mindstorms EV3実機向けのEV3RT/HRP3と、ETロボコンシミュレータ向けのAthrill/ASP3が、単一のソースで一度にビルド可能 • NXTモードでは、Mindstorms NXT実機向けnxtOSEKアプリをビルド可能 • USB接続のSPIKE Primeハブ向けユーティリティ、EV3RT App Loader向けユーティリティおよびNXT拡張ファーム向けアップローダを搭載、ビルド時に自動でプロジェクト名をファイル名として転送可能 • ビルドからシミュレータの実行まで1コマンドで自動処理 • サンプルコースとサンプルコードを同梱 注:**ここに同梱されているシミュレータは、一般配布用の評価版です**。大会で実際に使用するコースデータやシミュレータには、参加者限定で配布されるものを使用し開発してください。シミュレータの性能や走行体の挙動が異なります。 同梱されている評価版シミュレータのご利用は、以下の用途に限らせていただきます。 • ETロボコンへの参加のため • ETロボコンへの参加を検討するため • ETロボコンの広報 • ETロボコンに参加、協力していることを広報するため (ご不明な点は、ETロボコン 本部事務局までお問合せください) Copyright(C) 2020-2026 ETロボコン実行委員会, All rights reserved. 動作環境 Windows • x86-64アーキテクチャのCPU • Windows 11 • version 25H2、またはOSビルド26100.2605(December 2024 Update)以降のversion 24H2。 • 2024年12月アップデートより前に手動インストールした24H2ではWSLが破壊され修復不可能であるとの報告もありますのでご注意ください。 • Windows 10 Enterprise LTSC 2021での動作確認も行なっていますが、サポート対象外です。 • インストールにWindowsの管理者権限が必要です。 • によりインストールされたUbuntuまたはUbuntu-24.04(WSL2) • Ubuntu-22.04・20.04・18.04・16.04、Debian(9/10/11/12/13)でも動作するようですが、サポート対象外です。なお、Debianにインストールする場合はまず してください。 • Ubuntu-26.04に対しては、リリースされ次第対応を実施します。 • WSL1での動作も引き続き問題ないと思われますが、サポート対象外です。 • Visual Studio Code(「WSL」拡張機能)のインストール Mac • Apple Silicon、またはx86-64アーキテクチャのCPU • 動作確認は、以下のMacで行っています: • MacBook Air (M1, 2020) 8GB-7GPU / macOS Tahoe 26.3.1(a) / Xcode CLT 26.3.0 • macOS Sonoma(14.0)以降 • HomeBrewの動作環境に準じます。これ以前のmacOSでも動作する可能性は高いですが、サポート対象外です。 • 環境のインストールに管理者権限が必要です。 • Apple Silicon機の場合、Rossetaのインストール • Xcode(Command Line Tools)のインストール • Visual Studio Codeのインストール Linux • x86-64アーキテクチャのCPU • Debian GNU/Linux 13 (trixie) または Ubuntu 24.04 • 環境のインストールにはsudoers権限の付与が必要です。 • Ubuntu-26.04に対しては、リリースされ次第対応を実施します。 • Debian 12/Ubuntu 22.04以前でも引き続き動作するものと考えていますが、サポート対象外です。 • Visual Studio Codeのインストール ChromeOS • x86-64アーキテクチャのCPU • Chrome OSでの動作確認は以下の環境で行っています: • ASUS Chromebook C223NA • Chrome OS 126.0.6478.222 (Official Build) • Debian GNU/Linux 13 (trixie) • ChromeOS 102以降 • 80以降のChromeOS/ChromiumOS/ChromeOS Flexでも動作するものと考えていますがサポート対象外です。 • 79でも、Debian 10にアップグレードすると動作する可能性はありますが、未検証です。 • 78以前では、localhostのポート制限により動作しない可能性が高いものと認識していますが、未確認です。 • 「Linux開発環境」のインストール • 教育委員会等によって無効化されている場合は素直に諦めてください。 • etroboパッケージのインストール手順等はLinux版をご覧ください。 • Visual Studio Codeのインストール • がエラーになる場合は、ダウンロードファイルをLinuxに移動し、 でインストールしてください。 • 制限事項:ChromeOS 101以前のDebian 10向けLinuxコンテナにて、 有効の状態ではETロボコンシミュレータが起動しません。 ChromeOS 102以降のDebian 11向けLinuxコンテナでは有効にできますが、それでも実用的なパフォーマンスは期待できません。 EV3実機向けの開発環境としては充分です。 • 制限事項:SPIKE-RTモードでのSPIKE Primeハブとの接続は、DFUモードおよびHubOSモードでのみUSBパススルーが可能なため、Pybiricksモードでの接続はできません。アプリのアップロードやダウンロードは問題ありません。 動作確認&主なコマンドの説明 etrobo環境が起動しましたら、ターミナルを開いて(Windows: + ・Mac/Linux: + + )、とりあえず と入力してENTERキーを押してください。各環境での動作確認ができます。SPIKEモードの場合、サンプルプログラムのビルドからシミュレータの起動まで自動で行います。SPIKE-RT/EV3/NXTモードの場合、サンプルプログラムのビルドから実機への転送まで行います。 etrobo環境は様々なコマンドを提供していますが、これらは原則としてetrobo環境の初期ディレクトリ( )上で発給してください。 もしも迷子になった場合は、 でどこからでも戻ることができます。 動作モードはデフォルトではSPIKE(RasPike)モードになります。環境が起動したら、 と入力して環境を再起動すると、以降SPIKE-RTモードに切り替わります。同様に、 と入力して環境を再起動するとEV3モードに、 と入力して環境を再起動するとNXTモードになります。 初期ディレクトリ直下の シンボリックリンクは、それぞれのモードに応じて適切なworkspaceにリンクを張ります。 Re-HackSまたはHackSPiの実機をお持ちの方は、Bluetoothボタンを押しながらUSBケーブルでPCに接続してDFUモードにし、 または と入力してください。これだけで の値をファイル名としたモジュールのビルドと転送ができます。この時、USB関係の操作にsudoers権限が必要であるため、たまにパスワードを聞かれます。その時はログインパスワードを入力してください。 同様に、HackEVの実機をお持ちの方は、USBポートにさして電源を入れ、 と入力してみてください。 一度 を指定してビルドすると、2回目以降はこれを省略し、 だけでビルドと転送が可能です。 • SPIKE Primeハブオートマウント機能は、複数接続されている場合にはOSが認識している一番最初のものを使用します。 • EV3オートマウント機能は、**EV3(SDカード)のボリューム名が「EV3RT」から始まるものでなければ動作しません**。 • Windows - エクスプローラの からドライブを選択し、ボリューム名部分をクリックして変更 • Mac - デスクトップのドライブアイコン下のボリューム名部分をクリックして変更 • Linux - コマンドで変更できますが、Windows/Mac上で行った方が速いと思われます • EV3に挿入されているSDカードに、EV3RTのアプリケーションローダがインストールされている必要があります。 Athrill/ASP3(シミュレータ環境)向けビルドは、同じく から動かず とすると、起動までしてくれます。これも2回目以降は だけで構いません。 Athrill/ASP3向けも、あえてEV3RT/HRP3向けのビルドも行っています。そもそも自分のソースに問題があるのか、シミュレーション環境が対応していないのか切り分けるためです。EV3RT/HRP3向けのビルドが失敗した場合、Athrill/ASP3向けビルドと実行は行いません。 シミュレータとアプリを別々に起動する場合、 でシミュレータのみ起動、 でビルド後にアプリの起動のみを行います。 このように、 から使用する コマンドには特殊な仕様が仕込まれていますが、それ以外のディレクトリで叩く は通常通り動作します。 とすると、nxtOSEK上でビルドを行い、Mindstorms NXTにバイナリを転送します。 etrobo環境の無効化/有効化 etrobo環境はログインシェルで起動すると自動的に読み込まれます。しかし、サンドボックスを組んでいるMac版は大丈夫ですが、Windows(WSL)/Linux版では他の用途で利用する時に不都合が生じる可能性も高いので、そのような場合には無効化してください。 $ETROBO_ROOT(通常 )内に という名前のファイルがあると、ログインシェル起動時にetrobo環境を読み込みません。 などで設定してください。ログインシェルを開きなおす必要があります。 再度有効化するには などしてファイルを削除してください。 の起動でも自動的に有効化されます。