owcapi - 云端在线

程序：

您的姓名

乌卡皮 - 简单的 C 语言 1 线接口

概要

利波卡皮 库与您的程序链接

初始化
大小_t OW_init( 设备 姓名 or ， 参数 绳子 )
大小_t OW_init_args( INT argc， 坦克 ** ARGS )

全套初始化选项非常广泛。 它们大致对应于
的命令行选项 乌夫斯 (1) 网名 (1) 和 下载 (1)

积极 data
INT OW_现在（ 常量 坦克 * 径 )
INT OW_get( 常量 坦克 * 路径， 坦克 ** 缓冲区， 尺寸_t * 缓冲区长度 )
大小_t OW_lread( 常量 坦克 * 路径， 无符号 坦克 * 缓冲区， 常量 尺寸_t 尺寸， 常量
关闭_t 抵消 )

选择 data
大小_t OW_put( 常量 坦克 * 路径， 常量 坦克 * 缓冲区， 尺寸_t * 缓冲区长度 )
大小_t OW_lwrite( 常量 坦克 * 路径， 常量 无符号 坦克 * 缓冲区， 常量 尺寸_t 尺寸，
常量 关闭_t 抵消 )

调试
无效 OW_set_error_level( 常量 坦克 *参数 )
无效 OW_set_error_print( 常量 坦克 *参数 )

关闭
无效 OW_完成（ 无效 )

职能

OW_init
OW_init_string 提供了充分的灵活性 乌夫斯 (1) 和 网名 (1) 命令行。

参数
可以像设备名称一样简单，完整的参数说明。 一个或
更多设备名称（包括 tcp、serial、usb...）和命令行开关。 看
乌夫斯 (1) 完整的语法。

Returns & Exchanges
0 表示成功。 -1 错误和 埃尔诺 将被设定。 OW_完成 不需要是
调用 if OW_init 将失败。

序列
其中一个 初始化 必须在访问 1-wire 总线之前调用函数。
OW_完成 是可选的。

OW_init_args
OW_init_args 提供了充分的灵活性 乌夫斯 (1) 和 网名 (1) 命令行。

参数
一个或多个设备名称（包括 tcp、serial、usb...）和命令行开关。
参见 乌夫斯 (1) 完整的语法。 不像 OW_init_string 参数在 argv/argc 中
格式。

Returns & Exchanges
0 表示成功。 -1 错误和 埃尔诺 将被设定。 OW_完成 不需要是
调用 if OW_init 将失败。

序列
其中一个 初始化 必须在访问 1-wire 总线之前调用函数。
OW_完成 是可选的。

OW_现在
OW_现在 用于检查 1-wire 设备的存在。

参数
径 是目录或文件（属性）的路径。

Returns & Exchanges
0 成功。 -1 错误（和 埃尔诺 设置）。

序列
其中一个 初始化 必须在访问 1-wire 总线之前调用函数。
OW_完成 是可选的。

OW_get
OW_get 用于获取目录列表和文件内容。 结果放在一个
动态分配的缓冲区。

参数
径 是目录或文件（属性）的路径。 *缓冲 返回一个指向
包含目录（逗号分隔）或值的缓冲区。 缓冲区长度
返回值/字符串的长度 缓冲

Returns & Exchanges
成功时的字节数。 -1 错误（和 埃尔诺 设置）。

序列
其中一个 初始化 必须在访问 1-wire 总线之前调用函数。
OW_完成 是可选的。

重要提示 注意
缓冲 由（使用 malloc ）分配 OW_get 但必须在您的程序中释放。
参见 分配 (3) 和 免费 (3)

OW_lread
OW_lread 用于读取 1-wire 存储芯片。 把它想象成一个组合 寻求 和
读 它允许随机访问内存，指定位置和长度。 不像 OW_get
无法获取目录，必须预先分配缓冲区而不是分配缓冲区
按惯例。 缓冲 必须至少 尺寸 长度。

参数
径 是文件（属性）的路径。 缓冲 是（预分配的）内存区域
值将被放置的位置。 尺寸 是请求的字节长度。 抵消 is
文件中开始读取的位置。

Returns & Exchanges
成功时的字节数。 -1 错误（和 埃尔诺 设置）。

序列
其中一个 初始化 必须在访问 1-wire 总线之前调用函数。
OW_完成 是可选的。

OW_投入
OW_投入 是一种写入 1-wire 芯片的简单方法。

参数
径 是文件（属性）的路径。 缓冲 是要写入的值。
缓冲区长度 是值的长度 缓冲。 Returns & Exchanges 字节数
成功。 -1 错误（和 埃尔诺 设置）。

序列
其中一个 初始化 必须在访问 1-wire 总线之前调用函数。
OW_完成 是可选的。

OW_lwrite
OW_lwrite 是 OW_lread。 它允许写入任意位置
1 线存储器。 把它想象成一个组合 寻求 和 写。 缓冲 必须至少
尺寸 长度。

参数
径 是文件（属性）的路径。 缓冲 是要写入的数据。 尺寸
是要写入的字节长度。 抵消 是文件中开始的位置
写作。

Returns & Exchanges
成功时的字节数。 -1 错误（和 埃尔诺 设置）。

序列
其中一个 初始化 必须在访问 1-wire 总线之前调用函数。
OW_完成 是可选的。

OW_set_error_level
OW_set_error_level 将调试输出设置为某个级别。 0 是默认值，更高
值提供更多输出。
（0=默认，1=err_connect，2=err_call，3=err_data，4=err_detail，5=err_debug，
6=错误_超出)

参数
的params 是水平。 应该是整数。

Returns & Exchanges
没有

序列
其中一个 初始化 必须在设置级别之前调用函数，因为 初始化
默认为 0 级。

OW_set_error_print
OW_set_error_print 设置调试输出应指向的位置。 0=混合输出，
1=系统日志，2=控制台。

参数
的params 是水平。 应该是 0 到 2 之间的整数。

Returns & Exchanges
没有

序列
其中一个 初始化 必须在设置级别之前调用函数，因为 初始化
默认为 0（混合输出）。

OW_完成
OW_完成 清理 开放式文件系统 1-wire 例程，释放设备和内存。

参数
无。

Returns & Exchanges
没有

序列
OW_完成 是可选的，因为清理是在程序退出时自动进行的。

商品描述

1线
1线 是由达拉斯设计和制造的布线协议和一系列设备
Semiconductor, Inc. 总线是一种低功耗低速低连接器方案，其中数据
线也可以提供电源。

每个设备在制造过程中都有唯一且不可更改的编号。 有一个广
各种设备，包括内存、传感器（湿度、温度、电压、接触、
电流）、开关、定时器和数据记录器。 更复杂的设备（如热电偶
传感器）可以使用这些基本设备构建。 也有 1-wire 设备具有
包括加密。

1-wire 方案使用单个 总线 主 和多个 奴隶 在同一根电线上。 公交车
master 启动所有通信。 奴隶可以被单独发现和
使用其唯一 ID 寻址。

总线主机有多种配置，包括串行、并行、i2c、网络
或 USB 适配器。

开放式文件系统 设计
开放式文件系统 是一套程序，旨在使 1-wire 总线及其设备变得容易
无障碍。 底层原理是创建一个具有唯一ID的虚拟文件系统
作为目录，设备的各个属性表示为简单
可以读取和写入的文件。

单个从站或主站设计的细节隐藏在一致的界面后面。
目标是为软件设计人员提供一套简单的工具来创建监控
或控制应用程序。 在实现中有一些性能增强，
包括数据缓存、对总线主站的并行访问和设备聚合
沟通。 基本目标仍然是易用性、灵活性和
正确性而不是速度。

利波卡皮
利波卡皮 (1) 是完整的封装 自由 C 程序库。

利波卡皮 (1) 允许 C 程序使用 开放式文件系统 原则（一致的命名方案，
多个适配器、设备和兼容性）直接来自 C 程序。 有
其他编程语言的类似模块：

C 利波卡皮

perl的 楼主

PHP 文件

蟒蛇 蟒蛇

TCL 欧特克

例

/* 简单的目录列表——没有错误检查 */
＃包括
无符号字符 * buf;
大小 t s ;
OW_init("/dev/ttyS0");
OW_set_error_print("2");
OW_set_error_level("6");
OW_get("/",&buf,&s) ;
printf("目录 %s0,buf);
免费（缓冲）；
OW_finish() ;

使用 onworks.net 服务在线使用 owcapi