= TOPPERS/SSP Kernel用 Ruby版コンフィギュレータ向け追加ファイル = == これは何か TOPPERS/SSPカーネル1.3.0でRuby版コンフィギュレータを使用するために必要な追加ファイルです．[[BR]] Mac版 Docker を使用して Ubuntu 16.04 LTS (Xenial Xerus) コンテナでの動作を確認しています． 利用方法については [https://www.docker.com/ Docker] を用いた動作確認手順を示しますので，参考にしてください．[[BR]] == 動作確認に必要なもの * Docker : Docker上のコンテナ（仮想環境）を動かすために使います． * Git : Dockerのスクリプトを取得するのに使います． * コマンドライン環境：コマンドの実行にbashシェルを使います．Mac ならターミナルアプリ，Windowsなら MinGW など． == Dockerを用いた動作確認手順 以下ではMacOSのターミナルアプリで実行した際の様子を示します．他のホストOSで使用する場合もほぼ同様と思います． {{{ # Dockerスクリプトの取得(カレントディレクトリに docker-toppers というディレクトリが作成されます) $ git clone https://github.com/nmiri-nagoya-nsaito/docker-toppers.git Cloning into 'docker-toppers'... remote: Counting objects: 85, done. remote: Compressing objects: 100% (55/55), done. remote: Total 85 (delta 36), reused 70 (delta 27), pack-reused 0 Unpacking objects: 100% (85/85), done. # スクリプトのディレクトリへ移動し，コンテナのシェルを起動する（詳細はスクリプト参照） $ cd docker-toppers $ ./start_shell.sh Building cli Step 1/16 : FROM ubuntu:xenial ---> 0ef2e08ed3fa Step 2/16 : MAINTAINER Naoki Saito ---> Using cache ---> 1bec673845d0 Step 3/16 : RUN apt-get update ---> Using cache ---> 2dd9e0f61959 (中略) Step 16/16 : RUN chmod -R +x ./scripts && sync && ./scripts/setup_user.sh ---> Running in d9b928e37d60 Removing intermediate container d9b928e37d60 ---> f77b5e071680 Successfully built f77b5e071680 Successfully tagged docker-toppers_cli:latest Creating docker-toppers_cli_1 ... done To run a command as administrator (user "root"), use "sudo ". See "man sudo_root" for details. saito@3da8e259676b:~$ }}} この時点で Linux コンテナ内のシェルが起動していますので，次は Ruby版コンフィギュレータを使用してSSPカーネルをビルドします． {{{ # 適当な作業ディレクトリへ移動(dockerの設定でコンテナの ~/workdir ディレクトリをホストと共有する設定にしている) saito@3da8e259676b:~$ cd workdir # 本パッケージをダウンロード saito@3da8e259676b:~$ svn co http://dev.toppers.jp/svn_user/contrib/rubycfg_ssp/trunk rubycfg_ssp A rubycfg_ssp/syssvc_sym.def A rubycfg_ssp/install.sh A rubycfg_ssp/alarm.trb （略） A rubycfg_ssp/target_check.trb A rubycfg_ssp/prc_kernel.trb A rubycfg_ssp/target_kernel.trb リビジョン 357 をチェックアウトしました。 # SSPカーネルコードのセットアップ及びビルド saito@3da8e259676b:~/workdir$ rubycfg_ssp/build_ssp_ruby.sh ヒット:1 http://archive.ubuntu.com/ubuntu xenial InRelease 取得:2 http://archive.ubuntu.com/ubuntu xenial-updates InRelease [109 kB] 取得:3 http://archive.ubuntu.com/ubuntu xenial-security InRelease [107 kB] 216 kB を 2秒 で取得しました (92.3 kB/s) パッケージリストを読み込んでいます... 完了 パッケージリストを読み込んでいます... 完了 依存関係ツリーを作成しています 状態情報を読み取っています... 完了 以下の追加パッケージがインストールされます: binutils-arm-none-eabi libnewlib-arm-none-eabi libnewlib-dev libstdc++-arm-none-eabi-newlib 提案パッケージ: libnewlib-doc 以下のパッケージが新たにインストールされます: binutils-arm-none-eabi gcc-arm-none-eabi libnewlib-arm-none-eabi libnewlib-dev libstdc++-arm-none-eabi-newlib アップグレード: 0 個、新規インストール: 5 個、削除: 0 個、保留: 1 個。 65.1 MB のアーカイブを取得する必要があります。 この操作後に追加で 610 MB のディスク容量が消費されます。 取得:1 http://archive.ubuntu.com/ubuntu xenial/universe amd64 binutils-arm-none-eabi amd64 2.26-4ubuntu1+8 [2,083 kB] 取得:2 http://archive.ubuntu.com/ubuntu xenial/universe amd64 gcc-arm-none-eabi amd64 15:4.9.3+svn231177-1 [17.3 MB] 取得:3 http://archive.ubuntu.com/ubuntu xenial/universe amd64 libnewlib-dev all 2.2.0+git20150830.5a3d536-1 [105 kB] （略） libnewlib-arm-none-eabi (2.2.0+git20150830.5a3d536-1) を設定しています ... libstdc++-arm-none-eabi-newlib (15:4.9.3+svn227297-1+8) を設定しています ... libc-bin (2.23-0ubuntu10) のトリガを処理しています ... % Total % Received % Xferd Average Speed Time Time Time Current Dload Upload Total Spent Left Speed 100 579k 100 579k 0 0 1066k 0 --:--:-- --:--:-- --:--:-- 1064k ./asp3/configure.rb ./asp3/MANIFEST ./asp3/README.txt ./asp3/doc/asp_spec.txt （略） ./asp3/target/dummy_gcc/target_timer.cfg ./asp3/target/dummy_gcc/target_timer.h ./asp3/target/dummy_gcc/target_unrename.h % Total % Received % Xferd Average Speed Time Time Time Current Dload Upload Total Spent Left Speed 100 161k 100 161k 0 0 581k 0 --:--:-- --:--:-- --:--:-- 582k ./ssp/configure ./ssp/MANIFEST ./ssp/doc/ssp_spec.txt ./ssp/doc/extension.txt ./ssp/doc/porting.txt （略） ./ssp/extension/dataqueue.c ./ssp/extension/eventflag.h ./ssp/extension/eventflag.c patching file arch/arm_m_gcc/Makefile.prc patching file sample/Makefile patching file sample/sample1.cfg patching file target/cq_frk_fm3_gcc/Makefile.target Generating Makefile from ../sample/Makefile. ruby ../cfg/cfg.rb --pass 1 --kernel ssp -I. -I../include -I../arch -I../target/cq_frk_fm3_gcc -I../arch/arm_m_gcc/ -I.. -I../sample -I./gen -I../tecs_kernel --api-table ../kernel/kernel_api.def --symval-table ../kernel/kernel_sym.def --symval-table ../syssvc/syssvc_sym.def --symval-table ../arch/arm_m_gcc/prc_sym.def \ -M deps/cfg1_out_c.d ../target/cq_frk_fm3_gcc/target_kernel.cfg ../sample/sample1.cfg [cfg.rb] Generated cfg1_out.c arm-none-eabi-gcc -c -MD -MP -MF deps/cfg1_out.d -O2 -Wall -g -mcpu=cortex-m3 -mthumb -mthumb -DTOPPERS_OMIT_TECS -DROM_BOOT -DTOPPERS_LABEL_ASM -I. -I../include -I../arch -I../target/cq_frk_fm3_gcc -I../arch/arm_m_gcc/ -I.. -I../sample -I./gen -I../tecs_kernel -DTOPPERS_CB_TYPE_ONLY -mcpu=cortex-m3 -mthumb -DALLFUNC -fno-strict-aliasing -mcpu=cortex-m3 -mthumb -I../kernel -I ../extension cfg1_out.c arm-none-eabi-gcc -c -O2 -Wall -g -mcpu=cortex-m3 -mthumb -mthumb -DTOPPERS_OMIT_TECS -DROM_BOOT -DTOPPERS_LABEL_ASM -I. -I../include -I../arch -I../target/cq_frk_fm3_gcc -I../arch/arm_m_gcc/ -I.. -I../sample -I./gen -I../tecs_kernel -DALLFUNC -fno-strict-aliasing -mcpu=cortex-m3 -mthumb -I../kernel -I ../extension ../arch/arm_m_gcc/start.S arm-none-eabi-gcc -O2 -Wall -g -mcpu=cortex-m3 -mthumb -mthumb -DTOPPERS_OMIT_TECS -DROM_BOOT -DTOPPERS_LABEL_ASM -I. -I../include -I../arch -I../target/cq_frk_fm3_gcc -I../arch/arm_m_gcc/ -I.. -I../sample -I./gen -I../tecs_kernel -nostdlib -nostdlib --entry _start -T ../target/cq_frk_fm3_gcc/cq_frm_fm3_rom.ld -o cfg1_out \ cfg1_out.o arm-none-eabi-nm -n cfg1_out > cfg1_out.syms arm-none-eabi-objcopy -O srec -S cfg1_out cfg1_out.srec ruby ../cfg/cfg.rb --pass 2 --kernel ssp -I. -I../include -I../arch -I../target/cq_frk_fm3_gcc -I../arch/arm_m_gcc/ -I.. -I../sample -I./gen -I../tecs_kernel -T ../target/cq_frk_fm3_gcc/target_kernel.trb ===================================== Task priority configuration result: INIT_TASK: IPRI = 1, EXEPRI = 1 LOGTASK: IPRI = 2, EXEPRI = 2 MAIN_TASK: IPRI = 3, EXEPRI = 3 TASK1: IPRI = 4, EXEPRI = 4 TASK2: IPRI = 5, EXEPRI = 5 TASK3: IPRI = 6, EXEPRI = 5 ===================================== ===================================== Stack size configuration result: Estimated task stack size = 768 Specified interrupt stack size = INTERRUPT_STACKSIZE(value=1024) Allocated total stack size = ALL_STACKSIZE(value=2048) ===================================== [cfg.rb] Generated kernel_cfg.h [cfg.rb] Generated kernel_cfg.c arm-none-eabi-gcc -c -MD -MP -MF deps/sample1.d -O2 -Wall -g -mcpu=cortex-m3 -mthumb -mthumb -DTOPPERS_OMIT_TECS -DROM_BOOT -DTOPPERS_LABEL_ASM -I. -I../include -I../arch -I../target/cq_frk_fm3_gcc -I../arch/arm_m_gcc/ -I.. -I../sample -I./gen -I../tecs_kernel ../sample/sample1.c （略） arm-none-eabi-gcc -c -MD -MP -MF deps/dataqueue.d -O2 -Wall -g -mcpu=cortex-m3 -mthumb -mthumb -DTOPPERS_OMIT_TECS -DROM_BOOT -DTOPPERS_LABEL_ASM -I. -I../include -I../arch -I../target/cq_frk_fm3_gcc -I../arch/arm_m_gcc/ -I.. -I../sample -I./gen -I../tecs_kernel -DALLFUNC -fno-strict-aliasing -mcpu=cortex-m3 -mthumb -I../kernel -I ../extension ../extension/dataqueue.c rm -f libkernel.a arm-none-eabi-ar -rcs libkernel.a target_support.o prc_support.o target_config.o target_serial.o prc_config.o prc_timer.o startup.o task.o task_manage.o interrupt.o exception.o sys_manage.o cyclic.o alarm.o time_manage.o time_event.o eventflag.o dataqueue.o arm-none-eabi-ranlib libkernel.a arm-none-eabi-gcc -O2 -Wall -g -mcpu=cortex-m3 -mthumb -mthumb -DTOPPERS_OMIT_TECS -DROM_BOOT -DTOPPERS_LABEL_ASM -I. -I../include -I../arch -I../target/cq_frk_fm3_gcc -I../arch/arm_m_gcc/ -I.. -I../sample -I./gen -I../tecs_kernel -nostdlib -nostdlib --entry _start -T ../target/cq_frk_fm3_gcc/cq_frm_fm3_rom.ld -L. -o ssp \ sample1.o log_output.o vasyslog.o banner.o serial.o syslog.o logtask.o kernel_cfg.o \ -lkernel -lc -lgcc arm-none-eabi-nm -n ssp > ssp.syms arm-none-eabi-objcopy -O srec -S ssp ssp.srec ruby ../cfg/cfg.rb --pass 3 --kernel ssp -O -I. -I../include -I../arch -I../target/cq_frk_fm3_gcc -I../arch/arm_m_gcc/ -I.. -I../sample -I./gen -I../tecs_kernel -T ../target/cq_frk_fm3_gcc/target_check.trb \ --rom-symbol ssp.syms --rom-image ssp.srec configuration check passed saito@3da8e259676b:~/workdir$ }}} 以上で，<カレントディレクトリ>/ssp/build/ に実行プログラムファイル(ssp)が生成されます． == 注意事項 * SSP-1.3.0 のパッケージに含まれるファイルの文字コードは EUC-JP でしたが，Ruby版コンフィギュレータを使用するために UTF-8 に変換しています．したがってファイルを追加，編集する場合は UTF-8 を使用してください． * Windows版のgitで core.autocrlf が true に設定されている場合，シェルスクリプトの実行に失敗することがあるようです．その場合は `git config` コマンドで `core.autocrlf` を `false` に設定してみてください．