guide​/ASKA のバックアップソース(No.1) :: OSASK計画

• 差分^[1] を表示
• 現在との差分^[2] を表示
• guide/ASKA^[3] へ行く。

* ASKAでOSASKアプリを作ってみよう、のページ
-(by [[K]], 2004.12.12)
-前半はnask編とほとんど同じです。
--nask編はこちら → [[guide/nask]]

*** まずは開発環境の入手
-この記述は数ヶ月以内に更新されそうですが、とりあえず現状重視で。
-[[downloads/dev]]のページへ行って、''最新版''のところの、「osa_dir2」というやつをダウンロードしてください。
--2MB強ありますが、これはCコンパイラとかテストラン用のOSASKやエミュレータなどが入っているせいです。すみません。
-これをどこでもいいですので、適当なところに解凍します。

*** プロジェクト作成
-次に、新規にアプリを作りますので、z_new_oというディレクトリを探してください。これをコピーして、同じディレクトリにペーストします。すると、「コピー ～ z_new_o」とかいう名前のフォルダができます。これを「askahelo」にリネームしてください。
--もちろん他の好きな名前でもいいですよ。
-改名が済んだら、askaheloの中に入って、Makefileを探し、これをテキストエディタで開きます。とりあえずはメモ帳で十分です。
-そして一番上の行のTARGETの記述を以下のように直します。
 TARGET     = askahelo
-最後にnaskheloの中で 右クリック→新規作成→テキストドキュメント とやって、新規テキストドキュメントを作ります。そしてこれを、「askahelo.ask」に改名します。拡張子を変更するとどうたらこーたらとかいいますが、無視してOKしてください。

*** ソース作成
-さて、それではaskahelo.askを開いて、以下のソースをがしがしと入力してください。
--ニーモニックやレジスタ名が大文字になっていますが、もちろん小文字でも構いません。
 segment CODE(USE32, PARA); /* おまじない */
 default(code == CODE); /* おまじない */

 asmout("[FILE 'askahelo.ask']"); /* nask編参照 */
 asmout("GLOBAL _OsaskMain");

 /* 最初の[section .text]は省略可能なので省略 */

 void _OsaskMain()
 {
     asmout("MOV EBX,data.func_init"); /* ASKAはラベルへのgoto以外はうまくできないので、やむなくasmout。 */
     CALL(0xc7, 0);

     asmout("MOV EBX,data.func_openwin");  CALL(0xc7, 0);
     asmout("MOV EBX,data.func_titlebox"); CALL(0xc7, 0);
     asmout("MOV EBX,data.func_settitle"); CALL(0xc7, 0);
     asmout("MOV EBX,data.func_sleep");    CALL(0xc7, 0);
     /* 永久スリープなので帰ってこない */
 }

 asmout("[section .data]");

 void data()
 {
     ALIGNB(4);
 func_init:
     asmout("DD 0x0004, data.work, 0x0000");
     /* ファンクション番号0x04（API初期化）, ワークエリアのポインタ, 終了ファンクション番号0x00 */

 func_openwin:
     asmout("DD 0x0020, data.window, 0x0200, 18 * 3, 3 * 16, 0x0000");
     /* ファンクション番号0x20（ウィンドウオープン）, window構造体のポインタ, スロット番号0x200,
         xサイズ（ドット単位）, yサイズ（ドット単位）, 終了ファンクション番号0x00 */




 func_titlebox:
     DD 0x0028, 0x1000, wintitle, 0, 8, 1, 0, 0, window, 0x00c0, 0, 0x0000
 ;   ファンクション番号0x28（テキストボックスオープン）, オプション0x1000（ウィンドウタイトルモード）, textbox構造体のポインタ, 背景色0,
 ;       xサイズ（キャラクタ単位）, yサイズ（キャラクタ単位）, 表示x位置0, 表示y位置0, window構造体のポインタ,
 ;       標準キャラクタセット使用（0x00c0）, リザーブ0, 終了ファンクション番号0x00

 func_settitle:
     DD 0x0040, 0x1000, 0, 0, wintitle, 0, 0, 0, 8, "naskhelo", 0x0000
 ;   ファクション番号0x40（テキスト表示）, オプション0x1000（8bitキャラクタモード）,   表示x位置0, 表示y位置0, textbox構造体のポインタ,
 ;      文字色0, 背景色0, キャラクタコードオフセット0, 文字数8, 文字列"naskhelo", 終了ファンクション番号0x00

 func_sleep:
     DD 0x0018, 0x0001, 0, 0, 0x0000
 ;   ファンクション番号0x0018（シグナル関係の処理）, オプション1（スリープ）, パラメータ0, パラメータ0, 終了ファンクション番号0x00

     ALIGNB 16
 work:
     RESB 256 ; func_initに必要な256バイトのワークエリア
 window:
     RESB 128 ; ウィンドウ構造体
 wintitle:
     RESB  64 ; テキストボックス構造体
     RESB  8 * 1 * 8 ; 8文字分

*** どうやってアセンブルするの？
-まず、コンソールを開きます。開き方は使っているOSによって違います。
--Win2000, WinXPなどのNT系： !cons_nt.batをダブルクリック
--Win95, Win98などの9X系： !cons_9x.batをダブルクリック
-コンソールが出てきたら、makeとだけうってEnterを押してください。
-これだけでリンクまで全自動でやってくれます。
-できたアプリは、naskhelo.binです。
--osa_dir2で作った場合は多分161バイトです。

*** どうやってテスト実行するの？
-同じくコンソールから、make runとだけうってEnterを押してください。
-しばらく待っていると、勝手にOSASKがエミュレータ環境で起動します。
-で、pokonの一番上の、 !BUILT.BIN を実行してください。
-うまくいけばウィンドウが表示されます。

*** ほかのアセンブラになれている人へ
-naskはMASMとかとは少し文法が違います。NASMの文法とほとんど同じです。
-GLOBAL文はいわゆるPUBLIC文です。
-ラベルの扱いですが、何も書かないとみんなOFFSET指定とみなされます。というかOFFSETを書いたらエラーです。したがって
     MOV EBX,func_init
-は、EBXに4が入るわけではなく、アドレスが入ります。メモリを参照させたいときは、[]でくくります。
     MOV EBX,[func_init]
-こうすればEBXには4が入ります。
-[section .bss]を使えばBSSも使えるはずなのですが、osa_dir2のnaskは古いので、うまくいきません。全部.dataセクションにいれちゃってください。大丈夫です、オールゼロのデータは適当に圧縮されるのでほとんど問題ありません。
--.bssが使えるバージョンをパッケージしたらここの記述は直しますね。
-RESB文は何かと言うと、DB dupみたいなものです。 RESB 256 は DB 256 dup (0) に相当します。
--NASMもnaskでも、DBなどでdup構文を使うことはできません。

*** ほかのOSのAPIになれている人へ
-OSASKではAPI呼び出しはメモリを経由したポインタ渡しです。メモリにファンクション番号とパラメータを並べて、その先頭アドレスをEBXにいれて、CALL 0xc7:0をするだけです。正常終了する限りにおいて、EBX以外のレジスタは保存されます（ファンクション0x04を除く）。フラグは保存されません。
-毎回.dataセクションにパラメータをだらだら書かないといけないのか、という誤解をする人がいますが、そんなことはありません。スタック渡しっぽいことも簡単にできます。たとえばfunc_initの呼び出しは、以下のようにやってもいいのです。
     PUSH 0
     PUSH work
     PUSH 4
     MOV  EBX,ESP
     CALL 0xc7:0
     ADD  ESP,12
-OSASKアプリのメモリモデルは、DS == ES == SS != CS です。つまり.textセクション内のデータにアクセスするにはCS:プリフィクスが必須です。また、PUSH(CS); POP(ES);などをやってESにCSのセレクタを代入しても、.textセクションの内容を書き換えることはできません。リードオンリーです。無理やり書き換えようとすれば、一般保護例外になるだけです。
--ということが面倒極まりないので、普通は全部のデータを.dataセクションにおきます。リードオンリーのデータも.dataセクションに置いちゃいます。そうすればややこしいセグメントに悩まされずに済みますからね。

*** 雑な説明
-結局のところ、これはAPI呼び出しCALLを5回やって、5つのAPIを実行しているだけです。
-OSASKのAPIでは、必ず最後に終了ファンクション0x0000があります。これを書かないと、その次も通常ファンクションだとみなされます。逆にこの例の場合、5つのファンクションをつなげることもできるわけです。そうすればCALLは1回で済みます。
-ファンクション0x0004は、[[gg00man/others]]の''lib_init''に相当します。
--naskでの呼び出しでは、0を指定したら自動malloc、というサービスはありません。
-ファンクション0x0020は、[[gg00man/window]]の''lib_openwindow''に相当します。
--naskでの呼び出しでは、0を指定したら自動malloc、というサービスはありません。
-ファンクション0x0028は、[[gg00man/text]]の''lib_opentextbox''に相当します。
--naskでの呼び出しでは、0を指定したら自動malloc、というサービスはありません。
-ファンクション0x0040は、[[gg00man/text]]の''lib_putstring1''に相当します。
--optのbit14が0になっているところが違いますが。
-ファンクション0x0018は、[[gg00man/signal]]の''lib_waitsignal''に相当します。
-それぞれについてパラメータの意味などは上記の説明を参考にしてください。

*** もっと詳しく説明してくれー
-そのうちやるかもしれません。このページは長くなったので別のページで。
-ほかのAPIとかも。
~
~
-待てない人のための参考資料：
--I.Tak.さんのAPI資料： http://user.ecc.u-tokyo.ac.jp/~t40370/osask/p0cref.html
--[[GUIGUI00_man]]

* こめんと欄
-直ってしまったので、勝手に修正してしまいました。コメントアウトしてあります。 -- ''Zakky'' SIZE(10){2004-12-11 (土) 20:23:30}
-どうもありがとう。助かりました。 -- [[K]] SIZE(10){2004-12-11 (土) 20:52:16}
-とりあえずこんなものでどうでしょうか？＞nikaさん　　リクエストがなければこの先は書かないでおきます。 -- [[K]] SIZE(10){2004-12-12 (日) 00:06:53}
-ありがとうございます。とりあえずいい感じです。 -- ''nika'' SIZE(10){2004-12-12 (日) 08:27:30}

#comment

• guide/ASKA のバックアップ一覧^[5]
• guide/ASKA のバックアップソース(No. All)
  • 1: 2004-12-12 (日) 18:54:44
  • 2: 2004-12-12 (日) 20:09:04^[6]
  • 3: 2004-12-12 (日) 20:09:04^[7]
  • 4: 2005-01-28 (金) 22:58:09^[8]
  • 5: 2009-11-17 (火) 12:08:14^[9]
  • 6: 2009-12-01 (火) 19:52:18^[10] lina^[11]
  • 7: 2012-03-29 (木) 03:43:32^[12] ifearxbbu(ifearxbbu)[cFmxHuDkriw]
  • 現: 2024-01-08 (月) 12:58:56^[13] k-tan^[14]