> For the complete documentation index, see [llms.txt](https://book.bsdcn.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://book.bsdcn.org/man/man9/own.9.md).

# own.9

`own` — Dallas Semiconductor 1-Wire 网络和传输层接口

## 名称

`own`, `own_send_command`, `own_command_wait`, `own_self_command`, `own_acquire_bus`, `own`, `own_release_bus`, `OWN_ACQUIRE_BUS`, `OWN_CRC`, `OWN_RELEASE_BUS`, `OWN_SEND_COMMAND`

## 概要

```c
#include <sys/bus.h>
```

```c
#include <dev/ow/own.h>
```

```c
int
own_send_command(device_t pdev, struct ow_cmd *cmd)

int
own_command_wait(device_t pdev, struct ow_cmd *cmd)

int
own_self_command(device_t pdev, struct ow_cmd *cmd, uint8_t xpt_cmd)

int
own_acquire_bus(device_t pdev, int how)

int
own_release_bus(device_t pdev)

int
own_crc(device_t pdev, uint8_t *buffer, size_t len)

int
OWN_SEND_COMMAND(device_t ndev, device_t pdev, struct ow_cmd *cmd)

int
OWN_ACQUIRE_BUS(device_t ndev, device_t pdev, int how)

void
OWN_RELEASE_BUS(device_t ndev, device_t pdev)

uint8_t
OWN_CRC(device_t ndev, device_t pdev, uint8_t *buffer, size_t len)
```

## 描述

`OWN_SEND_COMMAND` 接口定义了三组用于与 1-Wire 设备交互的函数：发送命令、保留总线和确保数据完整性。为原始 `OWN` [kobj(9)](/man/man9/kobj.9.md) 接口提供了包装函数，出于改进安全性考虑应优先于 [kobj(9)](/man/man9/kobj.9.md) 接口使用。

### 总线命令

1-Wire 总线定义了对总线上设备的不同访问层。`OWN` 函数提供对网络层和传输层的访问。网络层将下一条命令指定为发送给总线上所有设备或特定设备。网络层还指定链路层使用的速度。

`struct ow_cmd` 封装了网络访问、速度和时序信息。它指定要发送的命令以及是否读取数据。其成员包括：

```c
#include <dev/ow/ow.h>
```

**OW\_FLAG\_OVERDRIVE** 以超速发送 `xpt_cmd` 字节并读取 `xpt_read` 字节。

**OW\_FLAG\_READ\_BIT** 将 `xpt_read_len` 解释为在 `xpt_cmd` 之后要读取的位数而非字节数。

**`flags`** 控制结构解释的标志。这些标志定义在

**`rom_cmd`** 要发送的 ROM 命令字节。

**`rom_len`** 要发送的 ROM 命令字节数。

**`rom_read_len`** 发送 ROM 命令后要读取的字节数。

**`rom_read`** 读取 ROM 命令后字节的缓冲区。

**`xpt_cmd`** 要发送的传输命令。

**`xpt_len`** 要发送的传输命令字节长度。指定为 0 表示无传输命令。

**`xpt_read_len`** 发送 `xpt_cmd` 字节后要读取的字节数。如果 `flags` 中设置了 `OW_FLAG_READ_BIT` 位，则为要读取的位数。读取的位被打包成字节。

**`xpt_read`** 读取数据的缓冲区。

`own_command_wait` 获取 1-Wire 总线（必要时等待），发送命令，然后释放总线。`own_send_command` 在不保留总线的情况下发送命令。`pdev` 是发送命令的客户端设备（表示层设备）。`cmd` 参数描述要发送到 1-Wire 总线的事务。

`own_self_command` 以便捷方式填写 `cmd`，使用 MATCH\_ROM ROM 命令、`pdev` 的 ROM 地址和 `xpt_cmd` 来创建定向命令。

### 总线保留

1-Wire 系统包含一个用于总线的咨询锁，表示层设备可使用它来协调访问。此时锁定纯粹是建议性的。

`own_acquire_bus` 保留总线。如果 `how` 参数为 `OWN_WAIT`，则无限期等待；如果传递 `OWN_DONTWAIT` 且总线由另一个客户端拥有，则返回错误 `EWOULDBLOCK`。

`own_release_bus` 释放总线。

### 数据完整性

`own_crc` 对通过 `buffer` 和 `len` 传递的数据计算 1-Wire 标准 CRC 函数，并返回结果。

### 注意事项

1-Wire 标准（Maxim AN937）定义了类似于 ISO 网络层的层。最低的相关层是链路层，定义了轮询窗口和不同模式的信号时序。网络层构建在链路层之上，用于以单播或多播方式寻址设备。传输层定义了来自设备的命令和响应。表示层由用于控制总线上特定 1-Wire 设备的设备特定命令和操作组成。

这些接口由 [ow(4)](/man/man4/ow.4.md) 设备实现。表示层设备（newbus [ow(4)](/man/man4/ow.4.md) 设备的子设备）应仅调用此处描述的函数。[owc(4)](/man/man4/owc.4.md) 设备提供的功能（特别是 [owll(9)](/man/man9/owll.9.md) 接口）应仅由 [ow(4)](/man/man4/ow.4.md) 驱动程序调用。

## 参见

[ow(4)](/man/man4/ow.4.md), [owc(4)](/man/man4/owc.4.md), [owll(9)](/man/man9/owll.9.md) **`https://pdfserv.maximintegrated.com/en/an/AN937.pdf`**

## 法律条款

1-Wire 是 Maxim Integrated Products, Inc. 的注册商标。

## 历史

`OWN` 驱动程序首次出现在 FreeBSD 11.0 中。

## 作者

`OWN` 设备驱动程序和本手册页由 Warner Losh 编写。


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://book.bsdcn.org/man/man9/own.9.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.