> 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/man4/smb.4.md).

# smb.4

`smb` — 系统管理总线（SMBus）通用 I/O 设备驱动

## 名称

`smb`

## 概要

`device smb`

## 描述

*smb* 字符设备驱动为任意 [smbus(4)](/man/man4/smbus.4.md) 实例提供通用 I/O。要控制 SMB 设备，请使用 **`/dev/smb?`** 配合下述 ioctl。这些 ioctl 命令中的任何一个都接受指向 `struct smbcmd` 的指针作为参数。

```sh
#include <sys/types.h>
struct smbcmd {
	u_char cmd;
	u_char reserved;
	u_short op;
	union {
		char    byte;
		char    buf[2];
		short   word;
	} wdata;
	union {
		char    byte;
		char    buf[2];
		short   word;
	} rdata;
	int  slave;
	char *wbuf;     /* 如果为 NULL 则使用 wdata */
	int  wcount;
	char *rbuf;     /* 如果为 NULL 则使用 rdata */
	int  rcount;
};
```

`slave` 字段始终使用，并提供 SMBus 从设备的地址。从设备地址在最高七位中指定（即"左对齐"）。从设备地址的最低位必须为零。

*QuickWrite* 不传输任何数据。它仅向总线发出带写入意图的设备地址。

*QuickRead* 不传输任何数据。它仅向总线发出带读取意图的设备地址。

*SendByte* 将 `cmd` 中提供的字节发送到设备。

*ReceiveByte* 从设备读取单个字节，返回到 `cmd` 中。

*WriteByte* 首先将 `cmd` 中的字节发送到设备，随后发送 `wdata.byte` 中给出的字节。

*WriteWord* 首先将 `cmd` 中的字节发送到设备，随后发送 `wdata.word` 中给出的字。注意，SMBus 字节序按定义为小端。

*ReadByte* 首先将 `cmd` 中的字节发送到设备，然后从设备读取一字节数据。返回数据存储在 `rdata.byte` 中。

*ReadWord* 首先将 `cmd` 中的字节发送到设备，然后从设备读取一字数据。返回数据存储在 `rdata.word` 中。

*ProcedureCall* 首先将 `cmd` 中的字节发送到设备，随后发送 `wdata.word` 中提供的字。然后从设备读取一字数据并返回到 `rdata.word` 中。

*BlockWrite* 首先将 `cmd` 中的字节发送到设备，然后发送 `wcount` 中的字节，随后是从 `wbuf` 指向的缓冲区取出的 `wcount` 字节数据。SMBus 规范要求单次块读取或写入命令传输的数据不超过 32 字节。此值可从常量 `SMB_MAXBLOCKSIZE` 读取。

*BlockRead* 首先将 `cmd` 中的字节发送到设备，然后读取设备将提供的数据字节计数，再读取那么多字节。计数返回到 `rcount` 中。数据返回到 `rbuf` 指向的缓冲区中。

| *Ioctl*           | *Description* |
| ----------------- | ------------- |
| `SMB_QUICK_WRITE` |               |
| `SMB_QUICK_READ`  |               |
| `SMB_SENDB`       |               |
| `SMB_RECVB`       |               |
| `SMB_WRITEB`      |               |
| `SMB_WRITEW`      |               |
| `SMB_READB`       |               |
| `SMB_READW`       |               |
| `SMB_PCALL`       |               |
| `SMB_BWRITE`      |               |
| `SMB_BREAD`       |               |

read(2) 和 write(2) 系统调用未由此驱动实现。

## 错误

ioctl(2) 命令可能引发以下驱动特定错误：

**\[ENXIO]** 设备未响应选择。

**\[EBUSY]** 设备仍在使用中。

**\[ENODEV]** 设备不支持此操作（不应发生）。

**\[EINVAL]** 一般参数错误。

**\[EWOULDBLOCK]** SMBus 事务超时。

## 参见

ioctl(2), [smbus(4)](/man/man4/smbus.4.md)

## 历史

`smb` 手册页最早出现于 FreeBSD 3.0。

## 作者

本手册页由 Nicolas Souchu 编写，并由 Michael Gmelin <freebsd@grem.de> 扩展。


---

# 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/man4/smb.4.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.