This extension makes it easy to develop embedded-board such as PERIDOT and GR-CITRUS from VSCode.
To start development with Rubic, open the work folder in VSCode, press F1 to open command palette and type "rubic". Find "Show Rubic board catalog" in command pallete and select it. See Quick Start for detail.
- Open a folder to place files in VSCode
- Press F1 and type "Rubic"
- Select "Show Rubic board catalog"
- Select the board which you want to use
- Select the firmware which has features what you want to use
- Select the release. Normally, you can use the newest one which is located at the top of the release list.
- Select the variation if the chosen firmware has multiple varations.
- Save your board configuration
- Write your code in main.rb (for mruby engine) or main.js (for Duktape engine)
- Press F5 and select "Rubic Debugger" to create debug configuration.
- Press F5 again to launch your program on the board!
- Compiling Ruby source (*.rb) into mruby binary (*.mrb)
- Communicate with boards via VCP (Serial port)
- Reading and writing files on internal storage of the board
- Updating firmware of the board
- Launching program on the board
-
Supported embedded-boards
-
Supported programming language:
- Ruby (mruby engine)
- JavaScript (Duktape engine)
Because this extension includes executable binary of mruby compiler (mrbc.exe on Windows, mrbc on mac/Linux), some anti-virus software may detect it as a suspicious program. Please configure that binary is safe.
- rubic.catalog.showPreview (Default value: false)
- If true, preview versions will be listed in Rubic board catalog.
- This is for Rubic maintainers and firmware developers.
- Preview version firmwares may not be well-tested.
- File a bug in GitHub issues
- Tweet me with other feedback
MIT
この拡張機能は、PERIDOTやGR-CITRUSなどの組み込みボードをVSCode上で開発するためのものです。
Rubicを使った開発を始めるには、作業用のフォルダをVSCodeで開き、F1でコマンドパレットを開いて「rubic」と入力します。そして「Rubicのボードカタログを開く」を選択してください。詳しい手順についてはクイックスタートをご覧下さい。
- VSCodeで、作業するフォルダを開きます。
- F1を押し、「Rubic」と入力します。
- 「Rubicのボードカタログを開く」を選びます。
- 使用したいボードをカタログ内のリストから選択してください。
- 使用したい機能を持つファームウェアをカタログ内のリストから選択してください。
- リリースを選択してください。通常はリストの一番上にある最新版を使うとよいでしょう。
- 選んだファームウェアが複数のバリエーションを持つ場合、使用するバリエーションを選んでください。
- ボード設定を保存してください。
- 実行したいコードを、main.rb(mrubyの場合)/main.js(Duktapeの場合)に記述してください。
- F5を押し、「Rubicデバッガ」を選ぶと、デバッグ設定が作成されます。
(このとき「launch.json」が自動的に開かれますが、編集する必要はありませんので閉じて下さい。) - もう一度F5を押すと、あなたの書いたプログラムがボードに転送され、実行されます。
- Rubyソースコード(*.rb)をmrubyバイナリ(*.mrb)に変換する機能
- シリアルポート(VCP)経由でボードと通信する機能
- ボード内のストレージにファイルを読み書きする機能
- ボードのファームウェアを書き換える機能
- ボード上でプログラムを実行する機能
-
組み込みボード
-
プログラミング言語 (ボードにより対応言語は異なります)
- Ruby (mruby engine)
- JavaScript (Duktape engine)
この拡張機能はmrubyコンパイラのバイナリファイル(Windowsの場合mrbc.exe、mac/Linuxの場合mrbc)を含んでいるため、一部のアンチウイルスソフトウェアが疑わしいプログラムとして検出する場合があります。その場合、これらのバイナリファイルは安全であると例外設定してください。
- rubic.catalog.showPreview (デフォルト値: false)
- プレビュー版を表示するか否か。trueにすると、一般向け公開していないファームウェアがカタログに列挙されます。
- Rubic自体の開発者ならびにファームウェア開発者向けの機能です。
- プレビュー版のファームウェアは十分なテストがされてない場合があります。
- 不具合報告はGitHub issuesまでお願いします。
- その他の報告は作者のTwitterまでどうぞ。
MIT