要約

マキシムが現在製造している1-Wire^®製品は、iButton^®デバイスを含めて30以上あります。これらの製品と通信を行うための利用可能なAPI、ソフトウェア例、およびその他のリソースを入手したり、ある特定のデバイス用に適当なリソースを見つけるのは大変な作業になることがあります。このアプリケーションノートは、入手可能なリソースと選択ガイドの概要を提供します。最新の1-Wire製品もまた、製品説明とファミリコード早見表のある便利な表で紹介されています。

入手可能なAPIには、TMEX (Microsoft Windows^®用API)、1-Wireパブリックドメインキット(クロスプラットフォームAPI)、およびJava^™ (OWAPI)用1-Wire APIやそのバリエーション.NET (OW.NET)用1-Wire API、および.NET Compact (OW.NET.Compact)用1-Wire APIなどがあります。このアプリケーションノートにあるAPIはすべて制限なく自由に使用することが可能で、多くの場合完全なソースコードが含まれています。

はじめに

マキシムが現在製造中の1-Wireデバイスは、iButtonデバイスなどを含めて30点を超えます。利用可能なアプリケーションプログラムインタフェース(API)、ソフトウェア事例、およびこの一連の素子と通信する他のリソース、あるいは単一のデバイスタイプ用の適切なリソースを突き止めるのは煩わしい場合があります。そこで、この解説書では、利用可能なリソースの概要と選択ガイドを提供します。この解説書に記載されたすべてのAPIは無制限に自由に利用することが可能で、ほとんどの場合ソースコード一式を備えています。

1-Wireの概要

1-Wireバスは、単一接続で1つのマスタと複数の周辺機器との双方向通信を実行するシンプルな信号方式です。全1-Wireバスデバイスが共有している高機能とは、チップやiButtonのどのデバイスも他のデバイスと重複しない、工場で設定された登録番号を備えていることです。つまり、どのデバイスも他と重複しません。このため、同一バスワイヤに接続できる多数のデバイスの中から、どのデバイスでも個別に選び出すことができます。また、通信用に1本のワイヤを1台、2台、または数十台の1-Wireデバイスでも共有することができるため、バイナリ検索アルゴリズムを使って各デバイスを順次検出することができます。一度各デバイスの登録番号が判明すると、そのデバイスにアドレスするために登録番号を使い、どのデバイスも通信用に一意に選択することができます。

どの通信でも、最初はバス全体を同期させる｢リセット｣を送出するバスマスタが必要です。次にスレーブデバイスが以降の通信用に選択されます。これは、全スレーブを選択するか、特定のスレーブを選択するか(デバイスの登録番号によって)、またはバイナリ検索アルゴリズムを使用してバス上の次のスレーブを検出することによって実行することができます。こうしたコマンドは、｢ネットワーク｣機能または読取り専用メモリ(ROM)コマンドと総称されています。特定のデバイスが選択されると、その他のすべてのデバイスは脱落し、次のリセットが送出されるまで以降の通信を無視します。

また、あるデバイスがバス通信のために分離されると、マスタはそのデバイスに固有のコマンドを出したり、データを送信したり、またはそのデバイスからデータを読み込んだりすることができます。それぞれのデバイスタイプは、各種の機能を実行し各種の目的を果たすため、各デバイスタイプがいったん選択されるとそれぞれ固有のプロトコルを確保します。たとえ個々のデバイスタイプが異なったプロトコルと機能を備えていても、すべて同じ選択プロセスになり、図1のようなコマンドフローにしたがいます。

各スレーブにおける固有の登録番号の絶対必要な部分は、8ビットのファミリコードです。このコードは、各デバイスモデルに固有のコードです。各デバイスモデルは各種機能を実行しますので、デバイスの制御と信号を送るのに使用するプロトコルを選択するためにこのコードを使用します。マキシム1-Wire製品に対するファミリコードの割当てについては、表1を参照してください。

*このリストには、マキシムの1-Wireデバイスの全タイプ(ファミリ)が含まれているわけではなく、Automatic Information Business Unit (BU)のソフトウェアライブラリがサポートしている一つのディレクトリに過ぎません。
¹これらのデバイスは新規設計用に推奨されていません。

APIの基礎

1-Wireデバイスとの通信用の各種アプリケーションプログラムインタフェース(API)は、プロトコルに起因する基礎的な通信課題に対応する共通の機能を備えています。図2は、各種APIの機能を共通グループ化したものを概説しています。ほとんどの1-Wireデバイスはメモリを装備しているため、メモリI/O機能は全デバイスに該当しなくても、共通APIグループとして取り扱われます。すべてのメモリ以外のその他の特殊機能は、デバイス固有のデバイスグループに一括されます。

これらの機能を使用するための標準的な手順は、図3に概説されています。｢セッション｣機能はデバイスへの通信呼び出しを包括し、これは通常、メモリまたは｢デバイス｣固有の操作の前に来る｢ネットワーク｣機能を利用することになります。

iButton通信の特質は、本質的に｢接触｣です。これは、デバイスとの接触が常に信頼性があるとは限らないことを意味します。iButtonはリーダに挿入され、読取り時に断続的な接触が生じることがあります。したがって、エラーリカバリに関して一貫した方式を厳格に守る必要があります。これは通常、データ通信でスプリアスエラーが検出されたときに再試行を行うこと、およびCRCチェックを利用することを必要とします。APIのファイルI/O機能は、アプリケーションノート114 「1-Wire File Structure (1-Wireファイル構造)」の箇所に詳述されている標準ファイル構造を使用します。この構造は、読取り中のデータの妥当性を迅速に検証するために、データの全ページでCRC16を使用します。たいていの1-Wire API機能には、自動再試行機能が全くないか少ししかありません。再試行は、アプリケーションが制御します。1-Wire通信実行時のエラー回復とリスク評価の方法については、アプリケーションノート159 「iButton^®アプリケーションで堅牢な1-Wire^®通信を実現するためのソフトウェア手法」を参照してください。

APIの選択

このアプリケーションノートでは、主として5種類のAPIを取り上げています。これらのAPIは各種プラットフォームで動作し、各種言語を使用し、また各種機能を備えています。表2は5種類のAPIを簡単な説明付きで紹介しており、また表3は、言語で分類された利用可能なAPIをオペレーティングシステムに割り当てています。

*MxTNI^™は、マキシムが開発したJavaベースのOSを備えた組み込みプラットフォームです。
¹サポートされていませんが、旧ドライバのダウンロードはマキシムのウェブサイトから入手可能です。

各デバイスファミリのサポートは、APIによっても異なります。表4は、各APIで利用可能なサポートを示すフラグとともに、現在利用可能な1-Wireデバイスをすべて紹介しています。表4のフラグに対する「要点」は、表の下部にあります。濃淡の影がないデバイス欄は、APIによって完全サポートされることに留意してください。淡い影付きの欄は部分的サポートで、濃い影付きの欄は最小限のサポートを示しています。

¹これらの製品は新規設計用に推奨されていません。

1-Wireパブリックドメイン(PD)の概要

1-Wire PD APIで提供される機能は｢C｣で完全記述され、TMEX APIでサポートされていないプラットフォームでの使用を目的としています。｢1-Wireネット｣(またはMicroLAN™)は、1つのマスタと1つ以上のスレーブデバイスを備える一本の配線とグランドのネットワークです。このAPIはスレーブデバイスを識別し、スレーブデバイスと通信することが可能な1-Wireマスタを創造します。また、iButtonを含めたすべての1-Wireデバイスと通信するように、あらゆる1-Wire、転送、およびファイルレベルサービスを提供します。このAPIキットおよびプラットフォームの構築(ビルド)例は、iButtonのウェブサイトにあります。

このAPIの｢C｣ソースコードは、移植することができるように設計されています。特定プラットフォームを完成するための｢TODO (要実行事項)｣テンプレートが提供されています。Windows 64ビット、Windows 32ビット、およびLinuxなどを含めた複数のプラットフォームの実装例が提供されています。また、こうしたプラットフォーム実装を使用する複数のアプリケーション例もあります。

｢general｣、｢userial｣、および｢other｣などの3つの移植可能なソースファイルのセットがあります。1つ目のセットは汎用的なもので、基本的なリンクの1-Wire通信機能(general)をすでに備えているプラットフォームを対象にしています。これは、ハードウェアに依存する最小レベルのセットです。移植可能なソースファイルの2つ目のセットは、ユーザがシリアルポート(RS232)を備え、｢Universal Serial 1-Wire Line Driver Master: DS2480B｣ (userial)の利用を望んでいるものと想定しています。このチップはシリアルポートに対するコマンドを受け、1-Wireオペレーションを実行し、その結果をシリアルポートに返送します。ソースコードは、目的の1-Wire操作をDS2480Bへのシリアル通信パケットに変換します。プラットフォームに提供する必要があるモジュールは、シリアルポートの読取り/書込みの基本モジュールだけです。DS2480Bは、すべてのDS9097Uシリーズのシリアルアダプタに使用されているインタフェースチップです。最後に、移植可能なソースファイルの3つ目のセットは、特定の1-Wireアダプタ機能および又は、先の2つのカテゴリにはまったく入らないもの(other)を取り扱っています。この一例として、USBポートを取り扱う例があり、具体的には、USBと1-Wire間のブリッジチップDS2490を利用します。多くの面で、これはgeneralのビルドと似ていますが、DS2490の特異性に合わせて修正されています。いずれのファイルセット(general、userial、またはother)を使用する場合でも、最終的には、同じAPIが実際にソフトウェア開発者に対して公開されます。

特に、このアプリケーションノートでは、1-Wireパブリックドメインキット(｢other｣ビルドに分類される)の、オープンソース型クロスプラットフォームのlibusbビルドについても取り上げています。libusbは、多くの種類のOSに移植されているオープンソースのUSBライブラリです。この特別な1-Wire PD APIのビルドは、その後1-Wire PD APIを構築するのに必要となるlibusb関数にコンパイルされます。

利用可能なさまざまなファイルセットについては、以下の表を参照してください。これはすでに表に示した各プラットフォーム用にビルドされたものであり、ダウンロードして入手可能です。

注：最新のプラットフォームのビルドについては、1-Wireパブリックドメインキットのウェブサイトを参照してください。
¹DS1410Eパラレルポートアダプタは新規設計用に推奨されていません。

移植可能なソースコードファイルのこれらのセットは、同じ1-Wire API機能を実装し、また互換性を持っています。図4は、1-Wire PDコードベースのバージョン3.xx用の利用可能なAPIを紹介しています。非メモリデバイス固有の機能は多数存在するため、詳述していないことに注意してください。図4は、機能を提供するソースファイルと新規プラットフォームに必要なモジュールを対応付けています。

ダウンロードしたPDキット内の移植可能な｢C｣モジュールだけでなく、1-Wire通信を実行するための限定されたマイクロプロセッサ(µP)のアセンブリ例もあります。

このAPIのファイル機能は、アプリケーションノート114 「1-Wire File Structure (1-Wireファイル構造)」の規定にある1-Wireファイル構造タイプ｢AA｣を実装しています。

このAPIの名前が示すように、提供されるソースコードは、できるだけパブリックドメインに近いライセンスを所持しています。開発者は、制限なく自由にこのコードを使用し、自らのアプリケーションに組み込むことができます。

例1は、図3で概説したAPIの使用法フローにしたがったPDコード部分を紹介しています。簡単にするために、ワークループを通過するごとに1-Wireネットワーク上の各デバイスを検出しています。より高度なアプリケーションであれば、1つのデバイスタイプだけを検出したり、以前の検索で検出されたデバイスを選択したりすることができます。

int rslt, portnum=0, doing_work=1;
char portString[50]; // set to platform appropriate port string

// work loop 
while (doing_work)
{
  // acquire the 1-Wire Net (SESSION)
  if (owAcquire(portnum, portString))
  {
   // find all devices (NETWORK)
   rslt = owFirst(portnum, TRUE, FALSE);
   while (rslt)
   {
     // do SOMETHING with device found (TRANSPORT/FILE/DEVICE)
     // . . .

     // find the next device (NETWORK)
     rslt = owNext(portnum, TRUE, FALSE);
   }

   // release the 1-Wire Net (SESSION)
   owRelease(portnum);
  }
  else
  {
   // Could not acquire 1-Wire network 
   // . . . 
  }

  // do other application work 
  // . . .
}

図5aと図5bは、2組の1-Wire PDライブラリで各々構成されるC言語モジュールを列記しています。また、新規プラットフォームへのライブラリ移植のために提供すべき｢TODO｣機能も紹介しています。｢TODO｣機能を実装するプラットフォームリンクファイルの数例がキットで提供されています。

インストール

1-WireのPD APIはCモジュールのセットであるため、正式なインストールがありません。｢構築(ビルド)｣例で紹介されているように、必要なモジュールはアプリケーションに直接コンパイルされます。これは、開発者がWindows DLLなどのロード可能なライブラリにモジュールを統合することを阻むことはありません。

一部のビルドは、ネイティブの1-Wireアダプタドライバまたはこれに相当するものを必要とすることに留意してください。たいていのOSプラットフォームは組み込まれたシリアルポートドライバを持っているため、1-Wire PD APIのuserialビルドは、他のいずれのドライバも必要としません。ただし、USBとパラレルポートの1-Wireアダプタのサポートについては、ネイティブまたはクロスプラットフォームのドライバをインストールすることが必要となります。適切なドライバのダウンロードについては、オンラインで実際に利用可能な1-Wire PDキットのビルドの資料を参照してください。

Java用1-Wire API (OWAPI)の概要

Java用1-Wire APIは、Javaでの1-Wireアプリケーションの構築を目的として、最初から極めて堅牢で高度なオブジェクト指向の基盤となるように設計されています。このAPIは、移植したりクロスプラットフォームのソフトウェア開発をしたりするプログラマの能力を拡大し、1-Wireが使用された製品の製品化までの時間を短縮します。

このAPIは、多数のJavaクラスとインタフェースから構成されています。1-Wire APIのJavaクラスのひとつの特別なグループがコンテナ(クラスOneWireContainer)です。iButton を含めて特定の1-Wireデバイス用のサポートは、コンテナを通じて提供されています。このAPIは、大部分の1-Wireデバイスを代表する30を超える各種コンテナタイプを備えています。各コンテナは個々のデバイスの機能を要約し、実装します。

｢コンテナ｣は、物理的な1-Wireアダプタ(クラスDSPortAdapter)である1-Wireアダプタクラスを通じて1-Wireデバイスとやりとりします。アダプタのインスタンス(要求)は、プロバイダのクラス(クラスOneWireAccessProvider)から作成されます。1-Wireアダプタの実際の実装はプラットフォームによって変わりますが、すべて同じインタフェースを持っています。一部のプラットフォームではネイティブなドライバを使用していますが、大部分のプラットフォームは、少なくとも、RXTX (クロスプラットフォームのシリアルCOMポートAPI)を使用してDS9097U-XXXシリアルアダプタをサポートしています。このAPIは、RXTXのウェブサイトから入手することができます。

Java用1-Wire APIソフトウェア開発キットは、iButtonのウェブサイトで入手することができます。1-Wire PDキットのように、OWAPIのJavaソース一式はパブリックドメイン形式のライセンスに基づいて提供されます。

図6は、このAPIの標準的なオブジェクト生成手順を紹介しています。｢プロバイダ｣は、デバイスの｢コンテナ｣のインスタンス(要求)を順次作成可能な｢アダプタ｣のインスタンス(またはエニュメレーション(列挙))を作成します。これによってデバイスとの通信は、ほぼ例外なく｢コンテナ｣を通じて行われます。

図7は、｢コンテナ｣の一般的な機能を紹介しています。メモリ搭載のデバイスは、各メモリバンク用にメモリバンクインスタンスを作成します。メモリは、バンクの機能セットに応じて、各バンクに分類されます。たとえば、揮発性バンクもあれば、不揮発性バンクもあります。または、バンクは汎用メモリもあれば、デバイスの機能を変更するメモリ割当ての場合もあります。

図8は、基本OWAPIクラスで提供されたメソッドを紹介しています。クラスまたはパッケージは太字で表示しています。各コンテナは個々のデバイスタイプを操作するハイレベルなメソッドを備えているため、アダプタのLINKレベルメソッドは通常直接呼び出されないことに注意してください。

下記の例2は、図3で概説したAPIの使用法フローにしたがったOWAPIコード部分を紹介しています。例1のPDコード例と同様、ワークループを通過するごとに1-Wireネットワーク上の各デバイスが検出され、より高度なアプリケーションであれば、1つのデバイスタイプだけ、あるいは以前の検索で発見されたデバイスを検出することができます。

boolean doing_work=true;

// get the default adapter from the service provider
DSPortAdapter adapter = OneWireAccessProvider.getDefaultAdapter();

// work loop
while (doing_work)
{
  // get exclusive use of adapter (SESSION)
  adapter.beginExclusive(true);

  // clear any previous search restrictions (NETWORK)
  adapter.setSearchAllDevices();
  adapter.targetAllFamilies();
  adapter.setSpeed(adapter.SPEED_REGULAR);

  // enumerate through all the 1-Wire devices found (NETWORK)
  for (Enumeration owd_enum = adapter.getAllDeviceContainers();
    owd_enum.hasMoreElements(); )
  {
   // get a 'container' for each device 
   OneWireContainer owd = ( OneWireContainer ) owd_enum.nextElement();

   // do SOMETHING with device found (TRANSPORT/FILE/DEVICE)
   // . . . 
  }

  // end exclusive use of adapter (SESSION)
  adapter.endExclusive();

  // do other application work 
  // . . .
}

1-Wireのタグ付け

1-Wireセンサが増加して多種多様になるにつれて、1-Wireネットワークの管理が次第に困難になります。たとえば、ADCのようなセンサは各種数値を測定することができるため、センサの機能を規定するためにセンサにタグ付けできることが重要になります。XMLによる1-Wireのタグ付け機構が作成され、Java用の1-Wire APIに実装されています。これらのタグは、アプリケーションが動的にロードし、センサを環境に適合させることができるようにします。詳細については、アプリケーションノート158 「1-Wire Tagging with XML (XMLによる1-Wireのタグ付け)」を参照してください。

インストール

図8に記載されているAPI呼び出しを構成する必須モジュールのすべては、単一のjarファイルであるOneWireAPI.jarにあります。この単一のモジュールを適切な場所またはクラスパスに配置すると、API全体が提供されます。ただし、以下のようなよく知られた2つの例外があります。すなわち、特定のプラットフォームにインストールされる必要があるネイティブまたは通信APIがあるということ、あるいはプラットフォームにはサイズ制限があるため、API全体を有効にすることは好ましくないということです。こうした2つの例外は、OWAPIキットで詳細に考察されます。

1-Wire .NET (OW.NET)の概要

あらゆる目的や用途に応えるため、ここで提供する.NETサポートは、MicrosoftのJ#言語だけでコンパイルされるJava用1-Wire APIです。すべての.NET 1-Wireアプリケーションは、OneWire.NET.dllへの参照のみを必要とします。これは、C#、J#、およびVB.NETなどのような最新の.NET言語のサポートも含んでいます。1-Wire .NETの例については、iButtonのウェブサイトで該当するソフトウェア開発キット(SDK)をダウンロードして参照してください。

1-Wireアプリケーションが正しく動作するためには、OneWire.NET.dllは、次の再配布可能なモジュールもPCにインストールされている必要があることを忘れないでください。

1. ネイティブな1-Wireポートアダプタのデバイスドライバ。これらは1-Wireドライバと呼ばれ、iButtonのウェブサイトからダウンロードすることができます。
2. Microsoft .NET 2.0のフレームワーク
3. Visual J# .NET 2.0再配布可能モジュール

OW.NET APIはTMEX APIも備えた1-Wireドライバパッケージで提供されています。1-Wireドライバのカスタムインストールの作成方法の詳細についてはアプリケーションノート1740 「White Paper 6: 1-Wire Drivers Installation Guide for Windows (白書6：Windows用1-Wireドライバインストールガイド)」を参照してください。

1-Wire .NET Compact (OW.NET Compact)の概要

このオブジェクトのインタフェースは1-Wire .NET (OW.NET)と同一ですが、セッション、リンクおよびネットワーク層のみが実装されています。オブジェクトは公式な頒布インストールを備えていませんが、その代わりにシングルDLL (OneWireLinkLayer.dll)です。このオブジェクトは32および64ビットWindowsプラットフォームでTMEX APIと直接通信します。DLLファイルは2.0 .NETアプリケーションとともに付属可能で低レベル1-Wireサポートを実現します。このオブジェクトはC#で書かれたもので、J# 2.0 .NET再頒布パッケージが不要です。

TMEX API (TMEX)の概要

TMEX APIは、メモリデバイスの限定された1-Wire File Structureサポートを含めて、全1-Wireデバイスに基本機能を提供する言語非依存のWindows 32ビットDLLセットです。このAPIは、同じ1-Wireポートまたは異なる1-Wireポートで全面的に競合する多重プロセスのマルチスレッドアプリケーションで機能するように設計されています。このAPIは、それぞれ16個の別個のポートとともに、最大16種類の1-Wireアダプタをサポートすることができます。これはマキシム製のすべての1-Wireアダプタをサポートします。

このAPIの最低レベル(最低レベルのデバイス-ドライバ層)は、Windowsプラットフォーム上でJava用1-Wire API用の｢ネイティブ｣ドライバとして使用します(1-Wireドライバ)。1-Wire .NET APIは、Java用の1-Wire APIにも基づいているため、Windowsプラットフォーム上でも使用することができます。図9は、TMEX APIが提供するネイティブサポートの利点をその他のAPIが利用する方法を図示しています。実ドライバファイル名およびその階層化方法がこの図に紹介されています。

1-Wireドライバのインストールパッケージ(TMEX APIおよびOW.NETライブラリを含む)、およびTMEX (および付随するAPI)にリンクされた多くのプログラム例を含むソフトウェア開発者キットのどちらも、マキシムのウェブサイトで入手可能です。

TMEX SDKで提供されているすべての例はソースコードを備えていますが、ローレベルのドライバのソースコードは現在提供されていません。ただし、こうしたドライバは無制限に再配布可能です。

表6は、各アダプタの機能とともに、現在サポート中の1-Wireアダプタを紹介しています。

¹これらのアダプタは新規設計用に推奨されていません。

TMEXによってサポートされているWindowsプラットフォーム

これらのMicrosoft WindowsプラットフォームはTMEXによってサポートされています：Windows 2008、Windows 2003、Windows Vista、およびWindows XP SP2。これにはx86 (32ビット)およびx64 (64ビット)両方のオペレーティングシステムバージョンが含まれています。Windowsの初期オペレーティングシステムバージョンのドライバが必要な場合は旧バージョンのTMEXが、積極的にサポートされていませんが、マキシムのウェブサイトで入手可能であることに注意してください。(TMEX APIライブラリをインストールする) 1-Wireドライバの4.00以下のバージョンをダウンロードしてください。1-Wireドライバのインストールパッケージはここから：iButton：Windows用1-Wireドライバ

図10は、TMEX API提供の機能を紹介しています。このAPIは非メモリデバイス固有の機能を提供していないことに注意してください。

例4は、図3で概説したAPIの使用法フローにしたがったTMEXコード部分を紹介しています。先の3つの例と同様、簡単なプロセスはワークループを通過するごとに1-Wireネットワーク上の各デバイスを検出するようにしており、より高度なアプリケーションであれば、1つのデバイスタイプだけを検出したり、以前の検索で検出されたデバイスを選択したりすることができます。

int PortNum, PortType; // port number and type set for adapter present
long session_handle; // session handle
unsigned char state_buffer[5120];
int doing_work=1, did_setup=0;
short rslt;

// work loop 
while (doing_work)
{
  // aquire the 1-Wire Net (SESSION)
  session_handle = TMExtendedStartSession(PortNum,PortType,NULL);
  if (session_handle > 0)
  {
   // check to see if TMSetup has been done once
   if (!did_setup)
   {
     if (TMSetup(session_handle) == 1)
      did_setup = 1;
     else
     {
      // error setting up port, adapter may not be present
      // . . . 
     }
   }
   else
   {
     // find all devices (NETWORK)
     rslt = TMFirst(session_handle, state_buf);
     while (rslt > 0)
     {
      // do SOMETHING with device found (TRANSPORT/FILE/DEVICE)
      // . . .

      // find the next device (NETWORK)
      rslt = TMNext(session_handle, state_buf);
     }
   }

   // release the 1-Wire Net (SESSION)
   TMEndSession(session_handle);
  }
  else
  {
   // Could not acquire 1-Wire network 
   // . . . 
  }
  
  // do other application work 
  // . . .
}

インストール

TMEX APIは、前述の1-Wireドライバのインストールパッケージ(OW.NET APIライブラリもインストール)でインストールすることができます。これはMicrosoftのインストーラパッケージであり、サポート対象のあらゆる1-WireアダプタについてWindowsのドライバとレジストリキーのすべてをロードします。ドライバとAPIファイル(インストールなし)は、カスタムインストール用に自由にオンラインで入手することが可能です。OneWireViewerは、ほとんどの1-WireデバイスとiButtonデバイスを実行し1-Wireドライバでインストールされるデモプログラムです。

1-WireドライバとOneWireViewerデモの追加情報については、iButtonのウェブサイトの｢ソフトウェアリソース｣下にあります。

その他ツール

このドキュメントで取り上げたAPIは、1-Wireデバイスとの通信に利用可能なリソースの大部分を説明していますが、決して唯一のリソースではありません。このセクションでは、その他の利用可能なリソースを概説しています。

ソフトウェア認可API

ソフトウェア認可とは、ハードウェアトークンの存在を必要とするソフトウェアアプリケーションの単なるロックです。この場合のトークンは、ユーザのワークステーションに接続されたiButtonです。アプリケーションは、その実行前にiButtonの存在と妥当性を照会します。これは、アプリケーションの実行中にも連続して問い合わせることができます。実際には、このドキュメントで概説されるどのAPIもこうしたアプリケーション用に使用することができますが、考慮すべき特定の問題があります。ユーザがドライバを交換し、ロックを無効にすることができるため、外部ドライバのセキュリティが脅かされます。1-Wire PDキット上で構築されたソフトウェア認可APIは、特にこうしたアプリケーション用に開発され、外部ドライバの代わりにリンク可能なモジュールを備えています。

ソフトウェア認可APIの設計は、最も簡単に使用することができるという点に重点を置いており、ソフトウェアプログラマの既存のコードに簡単に統合することができるようにしています。次の3つの主要なサービスがAPIによって提供されています。

• 1-Wireデバイスの初期化
• デバイスの認証
• デバイスの消去(これによってシステムの有効な要素ではなくなる)

1-Wireソフトウェア認可キットの情報は、iButtonのウェブサイトにあります。

検索エンジンのソフトウェア例

マキシムは、この解説書で述べたAPIを実証する1-Wireのソフトウェアアプリケーション例を継続的に開発しています。SDKに含まれていない例は、オンラインのソフトウェア例の検索エンジンを利用して見つけることができます。これらの例の多くは (ソースコードを含めて) 、関連するSDKに追加されるまえに最初に検索エンジンに(個別のダウンロードとして)追加されます。検索エンジンは、以下の項目別にソフトウェア例を検索することができます。

• 1-Wireデバイス(Thermochron、SHA iButtonなど)
• プラットフォーム(Win32、Linux、MxTNIなど)
• API (TMEX、1-Wireパブリックドメイン、1-Wire .NETなど)
• プログラミング言語(C、Java、C#、Visual Basic、Delphiなど)

検索結果の内容は、プログラムの説明と該当するダウンロードのリンクです。

サードパーティ

多くのサードパーティ製のソフトウェアは1-Wireデバイス用に利用することができます。その一部は、ソリューションとともに購入可能な、マキシム認定のソリューション開発者(ASD)が作成したアプリケーションです。SourceForge.netなどのパブリックフォーラムに関するオープンソースプロジェクトはもちろんのこと、ASDおよびソリューションロケータのリスト一式は、iButtonのサイトにあります。

終わりに

この解説書は、すべての1-Wire APIの特徴に関する概要を紹介してきました。また、サポートプラットフォームやプログラミング言語などを含めて、数種類のAPIについても詳述してきました。各デバイスタイプのAPIの適用範囲を紹介する早見表によって、使用するAPIの選択が容易になりました。適切なAPIを入手すると、1-Wire利用のアプリケーションを容易に設計することができます。