1-Wireパブリック・ドメイン・キット

1. 1-Wireパブリック・ドメイン・キットを使用すると、スレーブ・デバイスを確認して通信を行うことのできる1-Wireマスタを、ソフトウェアで作成できます。1-Wireプロトコルは1本の信号線とグラウンドを使用するネットワークで、1つのマスタと1つまたは複数のスレーブ・デバイス（iButtonや1-Wireチップなど）で構成されます。このキットは、iButtonを含む任意の1-Wireデバイスとの通信用に、すべての1-Wireトランスポート層サービスとファイルレベル・サービスを提供します。
2. 開発者は、1-Wireプログラムを複数のPCやマイクロプロセッサ・プラットフォームへ容易に移植できます。特定プラットフォームに合わせて「TODO」テンプレート（リンク・ファイル）を完成させ、使用することもできます。キットには、いくつかのサンプル・プラットフォーム実装とそのソース・コードが含まれています。
3. キットには、様々な1-Wireセンサに使用できるReadAtoDResults()やReadTemperature()などのより高水準のAPI機能と、1-Wireメモリの書込みおよび読出し用のMemoryBank関数やFile関数が含まれています。

パブリック・ドメイン・キット内のすべてのプラットフォーム固有コードは、異なるプラットフォームへの移植を容易にするために、いくつかのファイル（TODOテンプレート）にまとめられています。これらのファイルは、ハードウェアに依存する最も低水準のAPIを構成しています。これらいくつかのファイルが正しくコードされている限り、残りのAPI（およびサンプル・アプリケーション）のコンパイルと実行も正常に行われるはずです。

これら最も低水準のAPIをコードする標準的な方法は3つあります。1つめの方法は「general」と呼ばれ、もう1つは「userial」と呼ばれます。generalビルドでは、プリミティブなリンクレベルの1-Wire通信機能を実装する必要があります（アプリケーション・ノート126を参照）。userialビルドではシリアルポート（RS-232）を使用できることが前提で、マキシムのユニバーサル・シリアル1-Wireライン・ドライバ・マスタDS2480Bを利用する必要があります。DS2480Bはシリアル・ポートを介してコマンドを受信し、1-Wire処理を行った後にシリル・ポートに結果を返します。このソース・コードは、行おうとする1-Wire処理をDS2480Bへのシリアル通信パケットに変換します。userialプラットフォームに不可欠な唯一のコンポーネントは、シリアル・ポートの読出し／書込み用プリミティブです（アプリケーション・ノート192を参照）。マキシムは、DS9097U-009、DS9097U-S09、DS9097U-E25、またはDS1411などのDS2480Bベースのシリアル・アダプタをいくつか販売しています。3つめの「other」実装カテゴリは標準的な1-Wireパブリック・ドメイン用の基本APIを提供しますが、特定のシステムまたはアダプタ機能を利用することによってAPI実装の範囲を広げることができます。

1-Wireパブリック・ドメインAPIのデモ用に、いくつかのサンプル・アプリケーションが用意されています。これらのアプリケーションについて以下に説明します。

1. シリアルおよびUSB（libusb）1-Wireアダプタ用のMacintosh OSXビルドを追加。
2. 16ビットDOS、16ビットWindows、Windows CE/PocketPCのビルドを廃止。
3. 変換エラーのフィックスを反映してhumutil.cをアップデート。
4. DS2413のサポート用にswtduoアプリケーションを、DS28E04-100のサポート用にswtmain1cアプリケーションを、DS2408のサポート用にswtmultiアプリケーションを追加。
5. DS28E04-100のシリアル番号変更に対応するために検索CRCの計算を変更。
6. multiportビルドとDS9490ビルドのowRelease()をフィックス。コードはアダプタを正しくリリースするようになっているはずです。

パブリック・ドメイン・キットは、これまで複数のプラットフォームに移植されています。これらは以下からダウンロードできます。各ビルドには、ソース・コード（メイク・ファイルまたはプロジェクト・ファイル）と実行型ファイルが含まれています。userial実装には、DS9097U-009、DS9097U-S09、DS9097U-E25、あるいはDS1411などのDS2480Bベースのシリアル・アダプタが必要です。

*Visor^®、Palm^®、DOS、Win16、Windows CE、その他のプラットフォーム・バイナリは、PDK 3.00ソース・コード・ダウンロードのリンク・ファイル（ZIP、1.3MB）からビルドできます。

以下のバイナリ・ビルドは先行バージョンの3.11ベータ2です。このアップデートではWinUSBがサポートされ、64ビットのWindowsオペレーティング・システム（Window Vista^® x64、Windows XP x64、およびWindows 2003 x64）が採用されています。

旧バージョンあるいは代替のパブリック・ドメイン・キットもまだ使用できます。

• 1-Wireパブリック・ドメイン・キット3.00b2（ZIP、1.3MB）
• 1-Wireパブリック・ドメイン・キット2.00（ZIP、432kB）
• 1-Wireパブリック・ドメイン・キットのPICポート（ZIP、86kB）

開発時にサポートについて不明な点がある場合、コード例が必要な場合、あるいは特定ハードウェアに関して疑問がある場合は、以下のリソースを利用できます。

1. 使用例検索エンジンを使って、1-Wireデバイス、プラットフォーム、API、プログラミング言語などに基づき、設計条件に合ったソフトウェア例を検索できます。
2. An iButton FAQページで、一般的な問題に対する答えを素早く見つけることができます。
3. 1-Wireパブリック・ドメイン・キットの白書："白書2：1-Wireパブリック・ドメイン・キットの使用」
4. 以上のリソースで問題を解決できない場合は、アプリケーション・エンジニアにお尋ねください。