10/31/2011

TX-50開発キットで遊ぶ その9

今日は、シリアルのドライバを作成するに先立って、ちょっとお勉強です。

まず、BLDKはEDKIIがベースになってます。以前に弄ってたEDKとはモジュールの扱いの流儀がちょっと違うようで、まだよくわかってません。なので、EDKIIのモジュール作成方法について調べてみます。

EDKIIのドキュメントは以下からゲットします。

http://sourceforge.net/projects/edk2/files/General%20Documentation/
http://sourceforge.net/projects/edk2/files/Specifications/

なんだか読み物がたくさんありますが、さしあたって、EDKII Module Writer_s Guide_0_7.pdfをざっくり眺めてみました。

まだ、完全に内容を理解できてないですが、まずドライバやアプリのモジュールを作成するにはxxxxPkgとかって名前でディレクトリを作って、複数のモジュールをまとめておくパッケージを作成することになってるようです。

んで、そのパッケージにはDECとDSCファイルというパッケージの定義やビルドの挙動を記述したファイルを作成することになってるっぽいです。あと、FDFファイルというのもあって、これは、フラッシュ(ROMイメージ)に何を含めるかということを記述するようです。これは全てのモジュールに必要ではなくて、最終成果物としてROMイメージを出力したいモジュールだけ必要になるようです。

そして、パッケージの中にドライバ等のモジュールを(必要なだけ複数でも)作成することになってて、DXEドライバならxxxxDxeとかっていうフォルダにするのがお勧めみたいです。このフォルダにソースコードやバイナリモジュールならバイナリを置くわけですが、それぞれのモジュールにINFファイルというのを作成する必要があるようです。


なんだか、DECやらDSCとかFDFとかINFとか複雑なことになってますが、ビルド時にこれらのメタデータを元にmakefileが自動生成されるようです。EDKIIでは以前のEDKと違い、ビルド環境が、クロスプラットフォームで、複数のコンパイラやビルドシステム、OSに対応しているため、こんなことになってるっぽいです。

あと、PCDなる機構があって、これをうまくつかうことで、メタデータから定数や機能のON/OFFをコントロールできる仕組みが用意されているようです。

で、これらメタデータの記述ルールに関しては別途Specificationのドキュメントが個々に用意されているのですが、まだ全部目を通せていません。

とはいえ、ドキュメント読んでばかりだと、つまらないので、とにかくなんか作ってみてみます。そのほうが理解も早いしね。

そんなわけで、今回は特に何もしてくれないテストドライバを適当に書いてみます。目的はどっちかというとビルドシステムに慣れることですね。とりあえず、BLDKにはいくつもドライバソースが含まれているので、それらを参考にします。8254TimerDxeあたりがシンプルな構造で参考になりました。

で、ごにょごにょ試行錯誤しつつ以下のコードを書いてみました。


//
// TestDriver.c
//

#include "TestDriver.h"

EFI_GUID gEfiTestDriverProtocolGuid = EFI_TEST_DRIVER_PROTOCOL_GUID;

EFI_HANDLE                mTestHandle = NULL;

//
// driver produces
//
EFI_TEST_DRIVER_PROTOCOL   mTest = {
  TestDriverFunction
};

EFI_STATUS
EFIAPI
TestDriverFunction (
)
{
  return EFI_SUCCESS;
}

EFI_STATUS
EFIAPI
TestDriverEntryPoint (
  IN EFI_HANDLE        ImageHandle,
  IN EFI_SYSTEM_TABLE  *SystemTable
  )
{
  //
  // Install the Test Driver Protocol onto a new handle
  //
  return gBS->InstallMultipleProtocolInterfaces (
                  &mTestHandle,
                  &gEfiTestDriverProtocolGuid,
                  &mTest,
                  NULL
                  );
}




//
// TestDriver.h
//

#ifndef __TEST_DRIVER_H__
#define __TEST_DRIVER_H__

#include <Library/UefiBootServicesTableLib.h>
#include "TestDriverProtocol.h"

EFI_STATUS
EFIAPI
TestDriverEntryPoint (
  IN EFI_HANDLE        ImageHandle,
  IN EFI_SYSTEM_TABLE  *SystemTable
  );

EFI_STATUS
EFIAPI
TestDriverFunction (
  );

#endif



//
// TestDriverProtocol.h
//

#ifndef __TEST_DRIVER_PROTOCOL_H__
#define __TEST_DRIVER_PROTOCOL_H__

#define EFI_TEST_DRIVER_PROTOCOL_GUID \
  { 0x8d37d58, 0x8c26, 0x4e39, { 0x92, 0xf3, 0x14, 0x97, 0x89, 0x5f, 0x60, 0x63 } }

typedef 
EFI_STATUS
(EFIAPI *EFI_TEST_DRIVER_FUNCTION)(
  );

typedef struct _EFI_TEST_DRIVER_PROTOCOL {
  EFI_TEST_DRIVER_FUNCTION          TestFunction;
}EFI_TEST_DRIVER_PROTOCOL;

extern EFI_GUID gEfiTestDriverProtocolGuid;

#endif





#
# TestDriver.inf
#

[Defines]
  INF_VERSION                    = 0x00010005
  BASE_NAME                      = TestDriver
  FILE_GUID                      = CD5E357E-94D9-484d-BA43-CB632FC50C03
  MODULE_TYPE                    = DXE_DRIVER
  VERSION_STRING                 = 0.1
  ENTRY_POINT                    = TestDriverEntryPoint

[Packages]
  MdePkg/MdePkg.dec
  IntelFrameworkModulePkg/IntelFrameworkModulePkg.dec

[LibraryClasses]
  UefiDriverEntryPoint
  UefiBootServicesTableLib
  UefiLib

[Sources]
  TestDriverProtocol.h
  TestDriver.h
  TestDriver.c

[Protocols]

[Depex]
  TRUE





で、DECやDSCも必要かと思いきや、どうやらパッケージ単体でビルドする場合は必要っぽいですが、この場合BLDKのROMイメージを作成するので、ビルド対象がCrownBayPlatformPkgになります。なので、このパッケージのDSCとFDFの適当な所にTestDriver.infへのパスを書いておけばビルドされるぽいです。ほんとはルールに則ってパッケージ毎にあったほうがいいんでしょうけどね。

で、ビルドは通ったものの、何もしないドライバなので、動かしても何も起きないです。ふんにゃかです。

でもまあ、パッケージ作成の理解は進んだし、概ね雰囲気も掴めてきたので、良しとします。来週はシリアルドライバ作成に着手したいところです。

週一の開発ペースだと、ボリュームの大きめな課題は中々進まないですねえ。ちまちまがんばります。


今週はここまでっす。

10/24/2011

TX-50開発キットで遊ぶ その8

そして、シリアルポートについて、考えます。

シリアルポートが使えるようにしたい理由は2つあって、一つは、シリアルコンソールを使えると、便利なのと、もう一つは、BLDKのドキュメントによれば、シリアルを使ってソースレベルデバッグができるっぽいのです。

で、BLDKには、この二つをサポートするためのコードが含まれているのですが、これが、残念ながら、SuperIOのレガシーシリアルポート向けのコードで、TX-50では使えません。しかしながらPCIシリアルでなんとかならんもんかと、考えてみます。

シリアルコンソールに関しては、恐らく、PCIシリアルのDXEドライバを書けば使える可能性が高いんじゃなかろうかと思います。とはいえ、ドライバ書くのは結構時間かかりそうですねえ。

デバッガに関しては、恐らく、BIOSのかなり前のほうでシリアルが初期化されてないと駄目っぽいですね。うーん。どちらにしても、とりあえず、TX-50のPCIバストポロジをもう少し、詳しく把握しておく必要がありそうです。というわけで、EFIShellのPCIコマンドでデバイス一覧をみてみます。

Shell>pci



   Seg  Bus  Dev  Func
   ---  ---  ---  ----
    00   00   00    00 ==> Bridge Device - Host/PCI bridge
             Vendor 8086 Device 4114 Prog Interface 0
    00   00   01    00 ==> Bridge Device - Host/PCI bridge
             Vendor 8086 Device 8183 Prog Interface 0
    00   00   02    00 ==> Display Controller - VGA/8514 controller
             Vendor 8086 Device 4108 Prog Interface 0
    00   00   03    00 ==> Multimedia Device - Video device
             Vendor 8086 Device 8182 Prog Interface 0
    00   00   17    00 ==> Bridge Device - PCI/PCI bridge
             Vendor 8086 Device 8184 Prog Interface 0
    00   00   18    00 ==> Bridge Device - PCI/PCI bridge
             Vendor 8086 Device 8185 Prog Interface 0
    00   00   1B    00 ==> Multimedia Device - UNDEFINED
             Vendor 8086 Device 811B Prog Interface 0
    00   00   1F    00 ==> Bridge Device - PCI/ISA bridge
             Vendor 8086 Device 8186 Prog Interface 0
    00   01   00    00 ==> Bridge Device - PCI/PCI bridge
             Vendor 8086 Device 8800 Prog Interface 0
    00   02   00    00 ==> Device does not fit in any defined classes - 
             Vendor 8086 Device 8801 Prog Interface 0
    00   02   00    01 ==> Network Controller - Ethernet controller
             Vendor 8086 Device 8802 Prog Interface 0
    00   02   00    02 ==> Device does not fit in any defined classes - 
             Vendor 8086 Device 8803 Prog Interface 0
    00   02   02    00 ==> Serial Bus Controllers - USB
             Vendor 8086 Device 8804 Prog Interface 10
    00   02   02    01 ==> Serial Bus Controllers - USB
             Vendor 8086 Device 8805 Prog Interface 10
    00   02   02    02 ==> Serial Bus Controllers - USB
             Vendor 8086 Device 8806 Prog Interface 10
    00   02   02    03 ==> Serial Bus Controllers - USB
             Vendor 8086 Device 8807 Prog Interface 20
    00   02   02    04 ==> Serial Bus Controllers - USB
             Vendor 8086 Device 8808 Prog Interface FE
    00   02   04    00 ==> Base System Peripherals - UNDEFINED
             Vendor 8086 Device 8809 Prog Interface 1
    00   02   04    01 ==> Base System Peripherals - UNDEFINED
             Vendor 8086 Device 880A Prog Interface 1
    00   02   06    00 ==> Mass Storage Controller - UNDEFINED
             Vendor 8086 Device 880B Prog Interface 1
    00   02   08    00 ==> Serial Bus Controllers - USB
             Vendor 8086 Device 880C Prog Interface 10
    00   02   08    01 ==> Serial Bus Controllers - USB
             Vendor 8086 Device 880D Prog Interface 10
    00   02   08    02 ==> Serial Bus Controllers - USB
             Vendor 8086 Device 880E Prog Interface 10
    00   02   08    03 ==> Serial Bus Controllers - USB
             Vendor 8086 Device 880F Prog Interface 20
    00   02   0A    00 ==> Device does not fit in any defined classes - 
             Vendor 8086 Device 8810 Prog Interface 0
    00   02   0A    01 ==> Simple Communications Controllers - Serial controller
             Vendor 8086 Device 8811 Prog Interface 2
    00   02   0A    02 ==> Simple Communications Controllers - Serial controller
             Vendor 8086 Device 8812 Prog Interface 2
    00   02   0A    03 ==> Simple Communications Controllers - Serial controller
             Vendor 8086 Device 8813 Prog Interface 2
    00   02   0A    04 ==> Simple Communications Controllers - Serial controller
             Vendor 8086 Device 8814 Prog Interface 2
    00   02   0C    00 ==> Device does not fit in any defined classes - 
             Vendor 8086 Device 8815 Prog Interface 0
    00   02   0C    01 ==> Serial Bus Controllers - Other bus type
             Vendor 8086 Device 8816 Prog Interface 0
    00   02   0C    02 ==> Serial Bus Controllers - Other bus type
             Vendor 8086 Device 8817 Prog Interface 0
    00   02   0C    03 ==> Serial Bus Controllers - UNDEFINED
             Vendor 8086 Device 8818 Prog Interface 0
    00   02   0C    04 ==> Device does not fit in any defined classes - 
             Vendor 8086 Device 8819 Prog Interface 0
    00   03   00    00 ==> Network Controller - Ethernet controller
             Vendor 8086 Device 10D3 Prog Interface 0


なにやら、デバイスてんこ盛りですな。これだと、ちょっとイメージ沸きづらいので、図にしてみました。デバイス名はデータシートと照らし合わせて調べました。

TX-50 BLDK Bus Topology

六角形のはブリッジです。データシートによればATOM側にはPCI Expressのルートポート(PCIバス上ではブリッジに見える)が4つあるはずですが、2つしか見えないので、残り2つは無効にされているっぽいです。(点線のやつ)

そして、問題のシリアルはBus 2/Device 0Ah/Function 1ですね。このデバイスとHostブリッジの間にはPCI Expressのブリッジが2つ入ることがわかりました。(ピンクのやつ)それは、すなわち、このデバイスにアクセスするには2つのブリッジのI/O(またはメモリ)ウィンドウを設定する必要があるということです。
これらのブリッジがサブトラクティブデコードに対応していれば、もう少し話しは簡単だったかもしれませんが、残念ながら、データシートにそのような記述はみあたりませんでした。

しかも、PCI Expressブリッジ2つをBIOSの頭で初期化するにしても、PCI Expressにはリンクトレーニングというものがありまして、いきなり使えるとは限らないですね。そもそも、チップセットの特殊な領域を設定しないとリンクトレーニングが始まらないという可能性もあるため、うまくいくとも限りませんし、うまくいってないときに何が起きているのかも知る術がないですねー。

ま、試しに、やってみっか。

今週はここまでにしときます。来週またがんばるっすー。

TX-50開発キットで遊ぶ 開発ツール編

今週から新しい開発ツールの仲間が増えました。

ROMライターのEZP2010さんです。

EZP2010


これで、動作中にホットスワップという危険な行為をせずとも、BIOS焼けます。今までだと、元のBIOSをうっかり壊して、起動するBIOSが一個も無くなってしまったら、打つ手無しという危険もありましたが、これで、心おきなく焼きまくりです。

このROMライター、ぐぐってて、たまたま、デジダイブさんという方のブログで、このROMライターについて取り上げておられたのを見つけて、私も買うことにしました。ヤフーチャイナモールで3000円程度という、ハードボイルドな価格設定でしたが、デジダイブさんの記事を事前に読ませて頂いたので、思い切って買うことができました。デジダイブさん、ありがとうございます。
http://www.ddive.net/2011/08/23/ezp2010/


で、これ、見かけは、もはや大人の科学の付録にしかみえませんが、結構、高速に焼けます。ソフトもわりと、必要十分な出来栄えで、対応SPIの量もなかなかのものです。

EZP2010 soft
惜しいのは、ROMイメージを読み込む際に、2MBのSPIに1MBのイメージを後半のアドレスを指定してロードできないので、ちょっと不便です。前もって、ROMイメージを加工すればいいんですけどね。



次に紹介するのは、A390というUSBデータリンクケーブルです。
A390
これ、やべえっす。以前に紹介記事をみつけて、ずっと気になってたんですが、土曜日(10/22)に別件で秋葉原行ってきたので、ついでに探してたら、あきばおーで見つけました。

これ、簡単に言うと、PC上のファイルをマスストレージに見せて、メディアプレイヤーで再生できるという主旨の製品なんですが、ISOもイケます。なので、OSのCDイメージファイルをいちいち、CDに焼いたり、USBメモリに書き込まなくても、ケーブルつないで、ファイル指定するだけで、もう一方のPCはそのイメージでブートできちゃいます。
(早速これを使って、ネットブックにUbuntu11.10をインストールしてみましたが、問題なくできました。)

あらゆる面でエコです。すばらしいです。そして、当然ファイルもいけるので、EFIShellやBIOSイメージや、SpiUpdate.efi等を突っ込んだ、バーチャルディスクを作れば、それで、起動してBIOS書き込んだりできます。もう、これは開発ツールとしても、すばらしいです。

ちょっと残念なのは、書き込みができないようです。書き込みできたら最強なのになー。


ツールの紹介は以上です。