AliveVisionSoftwareK.K.

1章 クイックスタート
1.1. 手順の概要
必要な機材を確認します。必要環境は WindowsPC のみです。
オペレーティングシステム
対応プロセッサメモリ
HDD 空きVersion
その他

Windows10 64bit (Home/Pro)
仮想化支援機能「Intel VT／AMD-V」対応
プロセッサ
4GB 以上100GB 以上2004 以降
インターネット接続環境

まず、仮想化支援機能の有効化を確認します。
続いて、必要なツールをインストールを行います。
1)WSL2 の設定 (Windows Subsystem For Linux Version2）2)Docker Desktop for Windows のダウンロードとインストール
3)Visual Studio Code for Windows ダウンロードとインストール
さらに拡張機能のインストール
4)Git for Windows と TortoiseGit のダウンロードとインストール
ここまで行えば、あとは
5)ソースコードを github から Clone
6)Visual Studio Code でソースを開く
7)ビルドと実行になります。
1.2.仮想化支援機能の有効化
Intel VT AMD-V と呼ばれている機能です。通常は有効化されていますが、以下の方法で確認します。
デスクトップ画面下部にあるタスクバーの何もないところを右クリックして1

AliveVisionSoftwareK.K.

メニューを開き、「タスクマネージャー」をクリックして表示します。

タスクマネージャーを起動、「パフォーマンス」タブをクリック。メニューの「CPU」を選び、ボーグラフの下部の項目のうち「仮想化」が「有効」であれば有効化されています。

無効の場合は、有効化します。
有効化は、PC の BIOS 設定により設定します。Windows から操作できるマシン
ThinkPadX240 の例を以下に説明します。
2

AliveVisionSoftwareK.K.

（注意）マシンによっては、「詳細オプション」に「UEFI ファームウェアの設定」が現れないケースがあります。その場合は、お使いの PC のマニュアルに従ってBIOS にて「Virtualization」を有効化してください。
「スタートメニュー」「設定」「Windows の設定」ウィンドウ「更新とセキュリテ
ィ」をクリック左側メニューの「回復」クリック、「 PC の 起 動 を カ ス タ マ イ ズ す る 」「 今 す ぐ 再 起 動 」 を ク リ ッ ク 。

「オプションの選択」画面が表示されるので、「トラブルシューティング」をクリックします。

3

AliveVisionSoftwareK.K.

「詳細オプション」の項目一覧が表示されたら、「UEFI ファームウェアの設定」をクリックします。
続いて「再起動」をクリックすることでパソコンの再起動が行われます。
再起動によって PC の BIOS 画面が表示されます。
以下 ThinkPadX240 BIOS 画面 起動時の画面からSecurity 画面に行き、Virtualization を選びます。

4

AliveVisionSoftwareK.K.

いずれも Enable にします。ここではすでに設定済みのものを確認しました。

セーブして再起動します。

以上で、仮想化支援機能が設定されているはずです。最初に確認した「タスクマネージャー」で仮想化が有効になっていることを確認します。

5

AliveVisionSoftwareK.K.

1.3.開発環境のセットアップ
1)WSL2 のセットアップ
管理者モードで Windowsします。

Powershell を起動し。以下

コマンドを実行> wsl --install

再起動が要求されるので、PC を再起動します。
再起動すると自動的に ubuntu のコマンドが実行状態になります。

プロンプトでユーザーネームとパスワードが求められるので入力します。
このユーザー名パスワードが WSL ubuntsu のユーザー名パスワードなので忘れずに覚えておいてください。例では ユーザーネーム user1 で設定しています。
終わると ubuntu のシェルの状態になります。
6

AliveVisionSoftwareK.K.

2) WSL のその後の設定
linux のパッケージのアップデートをします。
$ sudo apt update -y && sudo apt upgrade -y

パスワードが要求されるので先ほど設定したパスワードを入力します。
しばらく待ちます。

上記のように終了します。

7

AliveVisionSoftwareK.K.

Linux ディストリビューションの WSL のバージョンの規定をセットします。
また WSL2 を規定のバージョンを２に設定します。
$wsl --set-version Ubuntu 2$wsl --set-default-version 2

3)Docker のインストール
以下のサイトから Docker Desktop Windows 64bit 版をダウンロードします。
https://www.docker.com/
右上の「Get Started」をクリック、その後画面中央の Docker Desktop の「Download for Windows」をクリックしてダウンロードします。

8

AliveVisionSoftwareK.K.

ダウンロードしたインストーラを起動します。

上記の確認画面が表示されます。 両方チェックを確認して、「Ok」をクリックします。
終了すると以下のようになり、「Close and logout」をクリックします。

9

AliveVisionSoftwareK.K.

一旦 Windows からログオフになります。
再度 Windows ログオンすると DockerDesktop が立ち上がり、条件に関してのアグリーメントがでてきますので、確認し「Accept」をクリックします。

しばらくして、以下のように RUN 状態になれば OK です。

最小化しておきましょう。

10

AliveVisionSoftwareK.K.

4) Visual Studio Code のインストール
以下のサイトから Visual Studio Code Windows 64bit をダウンロードします。
https://azure.microsoft.com/ja-jp/products/visual-studio-code/「今すぐダウンロード」をクリックしてダウンロードします。

Windows インストーラ

64bit をクリックします。

ダウンロードが終了したら、そのインストーラを起動します。
11

AliveVisionSoftwareK.K.

使用許諾に同意するなど、そのまま進めてインストールします。
特に必須ではありませんが、「VSCODE で開く」などをエキスプローラから指定できるようにするのがお勧めです。

インストールが終わるとすぐ実行するボタンのダイアログがでます。
インストールに引き続き、VSCODE の初期設定に続きます。

12

AliveVisionSoftwareK.K.

5)Visual Studio Code の初期設定
設定と拡張プラグインのインストールになります。
まず、日本語プラグインのインストールが求められるので、インストールします。
設定系のウイザードがでますが、デフォルトのままでよければ 「完了のマーク」をクリックします。

必須の拡張プラグイン Remote Development をインストールします。
拡張ボタンをクリック 、検索「Remode Development」を入れて Remote
Development をクリックします。

あとはお好みで拡張プラグインを入れてみます。

13

AliveVisionSoftwareK.K.

お勧めは、
C/C++ Extension Pack
Git Extension Pack
Git Blame
環境設定は以上になります。
1.4. 実行してみます。
1)何を実行するのか？
PC のシミュレーションで Raspberry-pi2 を動作させます。
シミュレーションは QEMU というエミュレータを利用します。
環境は、DockerHUB にある ubuntu イメージをダウンロードして実行することになります。
実行は Visual studio code で実行されます。実行時に dbg というデバッグインターフェースを使ってソースレベルデバッグ状態にてソースステップ実行を確認できます。
2)実行の大まかな手順①Github からソースコード一式を Clone します。
②Visual Studio Code から、Clone したソースコードを load します。
③実行手順に従って実行します。
実行手順は追って説明します。
3)実施手順①ubuntu シェルを起動し、以下のコマンドで Github から Clone します。
$ git clone -b forRPI3-JTAG https://github.com/alvstakahashi/RPISHRINK-SSP-FULL.git--14

AliveVisionSoftwareK.K.

②VSCode から、Clone したソースコードを load します。
そのまま読み込んでも可能なのですが、データ量が大きいので失敗するケースがあるので docker イメージをあらかじめローカル PC に取り込んでおきます。
$ docker pull alvstakahashi/stm32toolchain:1

15

AliveVisionSoftwareK.K.

次に Visual Studio Code で Load します。
Visual Studio Code を起動後 左下の緑の部分をクリック プルダウンが出てくるので、「Open Folder in Container... 」を選びます。

ファイラーがポップアップするので 先ほど Clone した一つ下のフォルダ{Timer_IRQ}を選ぶ

16AliveVisionSoftwareK.K.

以下のような読み込み状態になります。

③実行手順に従って実行します。
メニュー「ターミナル」「新しいターミナル」をクリックし、ターミナルからmake コマンドでビルドします。
# make17

AliveVisionSoftwareK.K.

ビルドが完了します。

コンソールで実行してみましょう。
# make runq
2 つのタスクが交互に動作している様子が確認できます。

CTRL-C で停止できます。

18

AliveVisionSoftwareK.K.

ソースレベルデバッグを行います。まずデーモンを起動します。

#make runqd

メニュー「実行」「デバッグ開始」で、setup()まで実行してブレークポイントで停止します。

「例外が発生しました」と表示されますが、問題ないです。
その後、GDB の操作で、実行が可能です。
ステップ実行 [F10] ステップイン[F11]など
またブレークポイントを設定して、実行[F5] などで動作確認できます。
カーネルの動きを確認可能です。

19

AliveVisionSoftwareK.K.

task2 のループにブレークポイントを置いて、続行すると以下のようになります。

停止方法
メニュー 「実行」「デバッグ停止」
その後 デバッグデーモンのターミナルが実行状態となっています。これを停止するには CTRL-A と X を入力します。
お疲れ様でした。

以上で動作確認できました。

20