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

1. 1-Wireパブリックドメインキットによって、開発者はスレーブデバイスの識別および通信が可能な1-Wireマスターをソフトウェアで作成することができます。1-Wireプロトコルは、1つのマスターと1つまたは複数のスレーブデバイス(iButtonや1-Wireチップなど)による単一ワイヤとグランドのネットワークです。このキットは、iButtonを含む任意の1-Wireデバイスと通信するための、1-Wireのトランスポートおよびファイルレベルの全サービスを提供します。
2. 開発者は1-Wireプログラムを複数のPCおよびマイクロプロセッサプラットフォームに容易に移植することができます。特定 プラットフォーム用に完成させる必要がある｢TODO｣テンプレート(リンクファイル)が用意されています。このキットは、数種類のプラットフォーム用の 実装例とそれらのソースコードを提供します。
3. このキットには、さまざまな1-Wireセンサー用のReadAtoDResults()およびReadTemperature()や、1-Wireメモリの読み書きのためのMemoryBankおよびFile関数などの、より高レベルのAPI関数が含まれています。

さまざまなプラットフォームへの移植を容易にするために、パブリックドメインキットに含まれるプラットフォーム固有の全コードは少数のファイル(TODO テンプレート)の形で構成されています。これらのファイルは、ハードウェアに依存するAPIの最低位レベルを表しています。これらの少数のファイルさえ正 しくコード化されていれば、残りのAPI (およびサンプルアプリケーション)は正常にコンパイルされ動作するはずです。

APIの最も低レベル部分をコード化するには、3つの標準的な方法があります。第1の方法は｢general｣と呼ばれ、第2の方法は｢userial｣と呼ばれます。generalの構築方法では、Linkレベルの1-Wireの基本通信関数を実装する必要があります(アプリケーションノート126を参照)。userialの構築方法は、シリアルポート(RS-232)の存在を前提として、マキシムのユニバーサルシリアル1-WireラインドライバマスターであるDS2480Bを使用します。DS2480Bはシリアルポートからコマンドを受信し、1-Wire操作を実行して、結果をシリアルポートに返信します。ソースコードは、目的の1-Wire操作をDS2480Bに対するシリアル通信パケットに変換します。userialプラットフォームの構築で使用する唯一のコンポーネントは、シリアルポートの基本読込み/書出しのみです(アプリケーションノート192を参照)。マキシムは、DS2480Bベースのいくつかのシリアルアダプタ(DS9097U-009、DS9097U-S09、DS9097U-E25、またはDS1411など)を販売しています。第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、DS28E04-100、およびDS2408に対応するために、それぞれswtduo、swtmain1c、およびswtmultiの各アプリケーションを追加。
5. DS28E04-100シリアルナンバーの変化に対応するために、検索CRCの計算を変更。
6. ｢multiport｣および｢DS9490｣ビルドのowRelease()を修正。新しいコードはアダプタを適切に解放するようになりました。

パブリックドメインキットは複数のプラットフォームに移植されており、下記のリンクからダウンロードすることができます。各ビルドには、ソースコード、makeファイルまたはプロジェクトファイル、および実行形式が含まれています。userialの実装はDS2480Bベースのシリアルアダプタ(DS9097U-009、DS9097U-S09、DS9097U-E25、またはDS1411など)を必要とすることに注意してください。

*Visor^®、Palm^®、DOS、Win16、Windows CE、およびその他のプラットフォーム用バイナリは、PDK 3.00ソースコードダウンロード(ZIP, 1.3MB)に含まれているリンクファイルから構築することができます。
*1-Wireパブリックドメインキット3.10に関する既知の問題の最新リストについては、正誤表のページを参照してください。

以下のバイナリビルドは、暫定のバージョン3.11ベータ2です。このアップデートには、WinUSBサポートおよび64ビットWindowsオペレーティングシステム(Windows 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. iButtonおよび1-Wireの広範囲のトピックについての白書およびアプリケーションノートをお読みください。
2. ソフトウェア検索エンジンをご利用ください。開発者は、1-Wireデバイス、プラットフォーム、API、およびプログラム言語に基づいて、設計要件にぴったりのソフトウェア例を検索することができます。
3. iButton FAQページでは一般的な質問に対する回答が得られます。
4. 1-Wireパブリックドメインキットの白書：｢白書2：1-Wireパブリックドメインキットの使用｣
5. 1-Wireデバイスのデータシート
6. iButtonのデータシート
7. サポートが必要な場合は、アプリケーションエンジニアにお尋ねください。