GPIO_GET_LINEINFO_WATCH_IOCTL

警告

此 ioctl 是GPIO 字元裝置使用者空間 API (v1)的一部分，已被GPIO_V2_GET_LINEINFO_WATCH_IOCTL廢棄。

名稱

GPIO_GET_LINEINFO_WATCH_IOCTL - 啟用監視線路，以瞭解其請求狀態和配置資訊的更改。

概要

GPIO_GET_LINEINFO_WATCH_IOCTL

int ioctl(int chip_fd, GPIO_GET_LINEINFO_WATCH_IOCTL, struct gpioline_info *info)

引數

chip_fd

由open()返回的 GPIO 字元裝置的檔案描述符。

info

要填充的line_info結構體，offset設定為指示要監視的線路

描述

啟用監視線路，以瞭解其請求狀態和配置資訊的更改。線路資訊的更改包括線路被請求、釋放或重新配置。

注意

通常不需要監視線路資訊，並且通常僅由系統監視元件使用。

線路資訊不包括線路值。

必須使用GPIO_GET_LINEHANDLE_IOCTL或GPIO_GET_LINEEVENT_IOCTL請求線路以訪問其值，並且線路事件可以使用GPIO_LINEEVENT_DATA_READ監視線路的事件。

預設情況下，開啟 GPIO 晶片時，所有線路都將取消監視。

可以透過為每個線路新增監視來同時監視多條線路。

設定監視後，對線路資訊的任何更改都將生成事件，可以從chip_fd中讀取事件，如GPIO_LINEINFO_CHANGED_READ中所述。

向已監視的線路新增監視是一個錯誤 (EBUSY)。

監視特定於chip_fd，並且獨立於透過單獨呼叫open()開啟的同一 GPIO 晶片上的監視。

首次新增到 5.7 版本。

返回值

成功時為 0，並且info填充了當前線路資訊。

出錯時為 -1，並且會適當地設定errno變數。常見錯誤程式碼在GPIO 錯誤程式碼中描述。