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

# imx\_spi.4

`imx_spi` — NXP i.MX 系列 SPI（Serial Peripheral Interface，串行外设接口）驱动

## 名称

`imx_spi`

## 概要

要将此驱动编译进内核，请在内核配置文件中加入以下行：

> device imx\_spi

或者，要在引导时以模块形式加载该驱动，请在 loader.conf(5) 中加入以下行：

```sh
imx_spi_load="YES"
```

## 描述

`imx_spi` 驱动为 NXP i.MX 系列处理器上存在的“ECSPI”（Enhanced Configurable SPI，增强型可配置 SPI）硬件提供支持。虽然 ECSPI 硬件同时支持主模式和从模式，但此驱动目前仅在主模式下运行。

由于硬件特性，`imx_spi` 驱动要求所有片选引脚均配置为 GPIO 引脚。使用 FDT 属性“cs-gpios”指定哪些引脚用作片选。可使用任意 GPIO 引脚，包括硬件通常用作 SPI 选择引脚的那些；只需在 [fdt\_pinctrl(4)](/man/man4/fdt_pinctrl.4.md) 数据中将它们配置为 GPIO 即可。

## SYSCTL 变量

以下变量可通过 [sysctl(8)](/man/man8/sysctl.8.md) 访问，并可作为 [loader(8)](/man/man8/loader.8.md) 可调参数：

**`dev.imx_spi.%d.debug`** 非零时输出调试信息。值为 1 时显示总线传输相关信息，值为 2 时增加总线时钟频率和片选活动信息，值为 3 时增加中断处理相关信息。

## 参见

[fdt(4)](/man/man4/fdt.4.md), [fdt\_pinctrl(4)](/man/man4/fdt_pinctrl.4.md), [sysctl(8)](/man/man8/sysctl.8.md)

## 历史

`imx_spi` 驱动首次出现于 FreeBSD 12.0。


---

# 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/imx_spi.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.