ownetlib - クラウドでオンライン

プログラム：

NAME

所有者 , （libownet） -owserverプロトコルへの簡単なC言語1-Wireインターフェース

SYNOPSIS

リボネット プログラムにリンクするライブラリ

Handle
OWNNET_HANDLE
各owserver接続へのハンドル

初期化
OWNNET_HANDLE OWNET_init（ 定数 チャリオット * owserver_tcp_address_and_port )
アソシエイト 監視サーバー (1) ハンドル付きのtcp/ipアドレス。

ディレクトリ リスト
int型 OWNET_dirlist（ OWNNET_HANDLE owserver_handle , 定数 チャリオット * onewire_path , チャリオット **
コンマ_separated_list )
ディレクトリ要素のコンマ区切りリストを作成します。

int型 OWNET_dirprocess（ OWNNET_HANDLE owserver_handle , 定数 チャリオット * onewire_path , ボイド (*
ディルファンク ) （空所 *, 定数 チャリオット *）、 ボイド * pass_on_value )
ボイド ディルファンク ( ボイド * pass_on_value , 定数 チャリオット * ディレクトリ要素 )
関数を適用する ディルファンク 任意のpassed_on_valueとともに、各ディレクトリ要素に。

以上 データ
int型 OWNET_read（ OWNNET_HANDLE owserver_handle , 定数 チャリオット * onewire_path , 定数 チャリオット **
戻り文字列 )
1線式デバイスから（指定されたサイズの）値を読み取ります。

int型 OWNET_lread（ OWNNET_HANDLE owserver_handle , 定数 チャリオット * onewire_path , 定数 チャリオット **
戻り文字列 , サイズ_t サイズ , オフト オフセット )
1線式デバイスから（指定されたサイズとオフセットの）値を読み取ります。

int型 OWNET_present（ OWNNET_HANDLE owserver_handle , 定数 チャリオット * onewire_path )
1線式デバイスが存在するかどうかを確認します。

作成セッションプロセスで データ
int型 OWNET_put（ OWNNET_HANDLE owserver_handle , 定数 チャリオット * onewire_path , 定数 チャリオット *
値の文字列 , サイズ_t サイズ )
（指定されたサイズの）値を1-Wireデバイスに書き込みます。

int型 OWNET_lwrite（ OWNNET_HANDLE owserver_handle , 定数 チャリオット * onewire_path , 定数 チャリオット *
値の文字列 , サイズ_t サイズ , オフト オフセット )
（指定されたサイズとオフセットの）値を1-Wireデバイスに書き込みます。

閉じる
ボイド OWNET_close（ OWNNET_HANDLE owserver_handle )
特定のowserverへの接続を閉じます。

ボイド OWNET_closeall（ ボイド )
開いているすべてのowserver接続を閉じます。

ボイド OWNET_finish（ ボイド )
開いているすべてのowserver接続を閉じ、すべてのメモリを解放します。

温度 階段
ボイド OWNET_set_temperature_scale（ チャリオット Temperature_scale )
チャリオット OWNET_get_temperature_scale（ ボイド )
すべての通信に使用される温度スケールを設定および取得します。

デバイス 形式でアーカイブしたプロジェクトを保存します．
ボイド OWNET_set_device_format（ 定数 チャリオット * デバイスフォーマット )
定数 チャリオット * OWNET_get_device_format（ ボイド )
すべての通信に使用される1線式デバイスのシリアル番号形式を設定および取得します。

関数

OW_init
OW_init_string の完全な柔軟性を提供します うふふ (1) および ああhttpd (1) コマンドライン。

Arguments
完全なパラメータ指定であるデバイス名と同じくらい単純にすることができます。 XNUMXつまたは
より多くのデバイス名（tcp、serial、usb ...を含む）およびコマンドラインスイッチ。 見る
うふふ (1) 完全な構文の場合。

返品
成功の場合は0。 -エラーの場合は-1 エラー 設定されます。 OW_フィニッシュ 必ずしもそうである必要はありません
呼び出された場合 OW_init 失敗します。

シーケンス
一つ INIT 1-Wireバスにアクセスする前に、関数を呼び出す必要があります。
OW_フィニッシュ オプションです。

OW_init_args
OW_init_args の完全な柔軟性を提供します うふふ (1) および ああhttpd (1) コマンドライン。

Arguments
XNUMXつ以上のデバイス名（tcp、serial、usb ...を含む）およびコマンドラインスイッチ。
見る うふふ (1) 完全な構文の場合。 ようではない OW_init_string 引数はargv/argcにあります
形式でダウンロードすることができます。

返品
成功の場合は0。 -エラーの場合は-1 エラー 設定されます。 OW_フィニッシュ 必ずしもそうである必要はありません
呼び出された場合 OW_init 失敗します。

シーケンス
一つ INIT 1-Wireバスにアクセスする前に、関数を呼び出す必要があります。
OW_フィニッシュ オプションです。

OW_get
OW_get ディレクトリリストとファイルの内容を取得するために使用されます。 結果は
動的に割り当てられたバッファ。

Arguments
path ディレクトリまたはファイル（プロパティ）へのパスです。 *バッファ へのポインタを返します
ディレクトリ（カンマ区切り）または値を含むバッファ。 バッファーの長さ
の値/文字列の長さを返します バッファ

返品
成功したバイト数。 エラーの場合は-1（および エラー が設定されています）。

シーケンス
一つ INIT 1-Wireバスにアクセスする前に、関数を呼び出す必要があります。
OW_フィニッシュ オプションです。

重要 注意
バッファ によって（mallocで）割り当てられます OW_get ただし、プログラムで解放する必要があります。
見る malloc関数 (3) および 無料です。 (3)

OW_lread
OW_lread 1-Wireメモリチップの読み取りに使用されます。 の組み合わせとして考えてください シーク および
read これにより、場所と長さを指定して、メモリへのランダムアクセスが可能になります。 ようではない OW_get
ディレクトリを取得できず、バッファを割り当てるのではなく、事前に割り当てる必要があります
ルーチンによって。 バッファ 少なくとも サイズ 長さ

Arguments
path ファイル（プロパティ）へのパスです。 バッファ （事前に割り当てられた）メモリ領域です
値が配置される場所。 サイズ 要求されたバイトの長さです。 オフセット is
読み取りを開始するファイル内の位置。

返品
成功したバイト数。 エラーの場合は-1（および エラー が設定されています）。

シーケンス
一つ INIT 1-Wireバスにアクセスする前に、関数を呼び出す必要があります。
OW_フィニッシュ オプションです。

OW_put
OW_put 1-Wireチップに書き込む簡単な方法です。

Arguments
path ファイル（プロパティ）へのパスです。 バッファ 書き込まれる値です。
バッファーの長さ 値の長さです バッファ。 返品 上のバイト数
成功。 エラーの場合は-1（および エラー が設定されています）。

シーケンス
一つ INIT 1-Wireバスにアクセスする前に、関数を呼び出す必要があります。
OW_フィニッシュ オプションです。

OW_lwrite
OW_lwrite の仲間です OW_lread。 の任意の位置に書き込むことができます
1線式メモリ。 の組み合わせとして考えてください シーク および 書きます。 バッファ 少なくとも
サイズ 長さ

Arguments
path ファイル（プロパティ）へのパスです。 バッファ 書き込むデータです。 サイズ
書き込まれるバイトの長さです。 オフセット 開始するファイル内の位置です
執筆。

返品
成功したバイト数。 エラーの場合は-1（および エラー が設定されています）。

シーケンス
一つ INIT 1-Wireバスにアクセスする前に、関数を呼び出す必要があります。
OW_フィニッシュ オプションです。

OW_フィニッシュ
OW_フィニッシュ クリーンアップ OWFS 1-Wireルーチン、デバイスとメモリを解放します。

Arguments
なし。

返品
なし

シーケンス
OW_フィニッシュ クリーンアップはプログラムの終了時に自動的に行われるため、オプションです。

DESCRIPTION

1ワイヤー
1ワイヤー ダラスによって設計および製造された配線プロトコルおよび一連のデバイスです
Semiconductor、Inc。バスは、データが
ラインも電力を供給することができます。

各デバイスには、製造時に一意で不変の番号が付けられます。 広いがあります
メモリ、センサー（湿度、温度、電圧、接点、
現在）、スイッチ、タイマー、データロガー。 より複雑なデバイス（熱電対など）
センサー）は、これらの基本的なデバイスで構築できます。 を持っている1-wireデバイスもあります
暗号化が含まれています。

1線式方式では、単一の バス マスター そして複数 奴隷 同じワイヤー上。 バス
マスターはすべての通信を開始します。 スレーブは個別に検出でき、
一意のIDを使用してアドレス指定されます。

バスマスターには、シリアル、パラレル、i2c、ネットワークなど、さまざまな構成があります。
またはUSBアダプタ。

OWFS デザイン
OWFS は、1-Wireバスとそのデバイスを簡単に作成できるように設計された一連のプログラムです。
アクセス可能。 基本的な原則は、一意のIDを使用して仮想ファイルシステムを作成することです
ディレクトリであり、デバイスの個々のプロパティは単純なものとして表されます
読み取りと書き込みが可能なファイル。

個々のスレーブまたはマスターの設計の詳細は、一貫したインターフェイスの背後に隠されています。
目標は、ソフトウェア設計者が監視を作成するための簡単なツールセットを提供することです。
またはアプリケーションを制御します。 実装にはいくつかのパフォーマンスの強化がありますが、
データキャッシング、バスマスターへの並列アクセス、デバイスの集約など
コミュニケーション。 それでも基本的な目標は、使いやすさ、柔軟性、そして
速度ではなく正確さ。

リボウカピ
リボウカピ (1) 完全なカプセル化です リボ Cプログラム用のライブラリ。

リボウカピ (1) Cプログラムが使用できるようにします OWFS 原則（一貫した命名スキーム、
複数のアダプター、デバイス、および互換性）をCプログラムから直接。 がある
他のプログラミング言語の類似モジュール：

C リボウカピ

パール 操作

PHP うわーphp

パイソン オウパイソン

TCL うわーtcl

実施例

/*単純なディレクトリリスト-エラーチェックなし*/
＃含む
char * buf;
size_t s;
OWNET_init（ "localhost：4304"）;
OWNET_dirlist（ "/"、＆buf、＆s）;
printf（ "ディレクトリ％s0、buf）;
free（buf）;
OWNET_finish（）;

onworks.net サービスを使用して ownetlib をオンラインで使用する