代码拉取完成，页面将自动刷新
同步操作将从 OpenHarmony/docs 强制同步，此操作会覆盖自 Fork 仓库以来所做的任何修改，且无法恢复！！！
确定后同步将在后台操作，完成时将刷新页面，请耐心等待。
Declares standard APIs of basic secure digital input and output (SDIO) capabilities.
You can use this module to access the SDIO and enable the driver to operate an SDIO-compliant device. These capabilities include reading and writing data based on SDIO, setting the block size, applying for and releasing interrupts, enabling and disabling devices, and occupying and releasing the bus.
Since:
1.0
|
SdioIrqHandler(void *) |
|
SdioOpen (int16_t busNum) |
struct DevHandle * |
|
SdioReadBytes (struct DevHandle *handle, uint8_t *data, uint32_t addr, uint32_t size, uint32_t timeOut) |
Incrementally reads a given length of data from the specified SDIO address. |
|
SdioWriteBytes (struct DevHandle *handle, uint8_t *data, uint32_t addr, uint32_t size, uint32_t timeOut) |
Incrementally writes a given length of data into the specified SDIO address. |
|
SdioReadBytesFromFixedAddr (struct DevHandle *handle, uint8_t *data, uint32_t addr, uint32_t size, uint32_t timeOut) |
|
|
SdioWriteBytesToFixedAddr (struct DevHandle *handle, uint8_t *data, uint32_t addr, uint32_t size, uint32_t timeOut) |
|
|
SdioReadBytesFromFunc0 (struct DevHandle *handle, uint8_t *data, uint32_t addr, uint32_t size, uint32_t timeOut) |
Reads a given length of data from the address space of SDIO function 0. |
|
SdioWriteBytesToFunc0 (struct DevHandle *handle, uint8_t *data, uint32_t addr, uint32_t size, uint32_t timeOut) |
Writes a given length of data into the address space of SDIO function 0. |
|
SdioSetBlockSize (struct DevHandle *handle, uint32_t blockSize) |
|
|
SdioGetCommonInfo (struct DevHandle *handle, SdioCommonInfo *info, SdioCommonInfoType infoType) |
|
|
SdioSetCommonInfo (struct DevHandle *handle, SdioCommonInfo *info, SdioCommonInfoType infoType) |
|
|
SdioFlushData (struct DevHandle *handle) |
|
|
SdioClaimHost (struct DevHandle *handle) |
|
|
SdioReleaseHost (struct DevHandle *handle) |
|
|
SdioEnableFunc (struct DevHandle *handle) |
Enables the SDIO device so that its register can be accessed. |
|
SdioDisableFunc (struct DevHandle *handle) |
|
|
SdioClaimIrq (struct DevHandle *handle, SdioIrqHandler *irqHandler) |
|
|
SdioReleaseIrq (struct DevHandle *handle) |
typedef void SdioIrqHandler(void *)
Description:
Defines the function type of an SDIO IRQ.
This function is registered when you call SdioClaimIrq to request the SDIO IRQ.
Parameters:
| data | Indicates the private data passed to this IRQ (The data is specified when the IRQ is registered). |
enum [SdioCommonInfoType](SDIO.md#ga4037437ac001a9848dd242e8aa632678)
Description:
Enumerates SDIO common information types.
When obtaining SDIO common information by calling SdioGetCommonInfo or setting the information by calling SdioSetCommonInfo, you need to pass the information type.
| SDIO_FUNC_INFO | |
| SDIO_OTHER_INFO |
void SdioClaimHost (struct [DevHandle](DevHandle.md) * handle)
Description:
Claims a host exclusively.
You can call this function to enable the SDIO module to exclusively claim a host and then perform operations on the devices connected to the host. After performing required operations, release the host by calling SdioReleaseHost.
Parameters:
| handle | Indicates the pointer to the device handle of the SDIO controller obtained by SdioOpen. |
int32_t SdioClaimIrq (struct [DevHandle](DevHandle.md) * handle, [SdioIrqHandler](SDIO.md#ga858bec274683a4f50d53d1f9f43d204b) * irqHandler )
Description:
Claims an SDIO IRQ.
When there is data, commands, or events, the IRQ function is executed.
Parameters:
| handle | Indicates the pointer to the device handle of the SDIO controller obtained by SdioOpen. |
| irqHandler | Indicates the pointer to the SDIO IRQ function. For details, see SdioIrqHandler. |
Returns:
Returns 0 if the operation is successful; returns a negative value if the operation fails.
void SdioClose (struct [DevHandle](DevHandle.md) * handle)
Description:
Closes an SDIO controller.
After the SDIO interface is used, you can close the SDIO controller by calling SdioClose. This function is used in pair with SdioOpen.
Parameters:
| handle | Indicates the pointer to the device handle of the SDIO controller. |
int32_t SdioDisableFunc (struct [DevHandle](DevHandle.md) * handle)
Description:
Disables the SDIO device.
This function is used in pair with SdioEnableFunc.
Parameters:
| handle | Indicates the pointer to the device handle of the SDIO controller obtained by SdioOpen. |
Returns:
Returns 0 if the operation is successful; returns a negative value if the operation fails.
int32_t SdioEnableFunc (struct [DevHandle](DevHandle.md) * handle)
Description:
Enables the SDIO device so that its register can be accessed.
Parameters:
| handle | Indicates the pointer to the device handle of the SDIO controller obtained by SdioOpen. |
Returns:
Returns 0 if the operation is successful; returns a negative value if the operation fails.
int32_t SdioFlushData (struct [DevHandle](DevHandle.md) * handle)
Description:
Flushes data.
You can call this function when an SDIO needs to be reinitialized or an unexpected error occurs.
Parameters:
| handle | Indicates the pointer to the device handle of the SDIO controller obtained by SdioOpen. |
Returns:
Returns 0 if the operation is successful; returns a negative value if the operation fails.
int32_t SdioGetCommonInfo (struct [DevHandle](DevHandle.md) * handle, [SdioCommonInfo](SdioCommonInfo.md) * info, [SdioCommonInfoType](SDIO.md#ga4037437ac001a9848dd242e8aa632678) infoType )
Description:
Obtains common information.
You can call this function to obtain the capabilities and private data of the I/O function.
Parameters:
| handle | Indicates the pointer to the device handle of the SDIO controller obtained by SdioOpen. |
| info | Indicates the pointer to the common information to be obtained. For details, see SdioCommonInfo. |
| infoType | Indicates the type of the common information to be obtained. For details, see SdioCommonInfoType. |
Returns:
Returns 0 if the operation is successful; returns a negative value if the operation fails.
struct [DevHandle](DevHandle.md)* SdioOpen (int16_t busNum)
Description:
Opens an SDIO controller with a specified bus number.
Before using the SDIO interface, you can obtain the device handle of the SDIO controller by calling SdioOpen. This function is used in pair with SdioClose.
Parameters:
| busNum | Indicates the bus number. |
Returns:
Returns the device handle DevHandle of the SDIO controller if the operation is successful; returns NULL otherwise.
int32_t SdioReadBytes (struct [DevHandle](DevHandle.md) * handle, uint8_t * data, uint32_t addr, uint32_t size, uint32_t timeOut )
Description:
Incrementally reads a given length of data from the specified SDIO address.
If the length of the data to read is greater than the size of a block, the data is read by block, and the remaining data that is smaller than one block is read by byte. Otherwise, data is read by byte.
Parameters:
| handle | Indicates the pointer to the device handle of the SDIO controller obtained by SdioOpen. |
| data | Indicates the pointer to the data to read. |
| addr | Indicates the start address of the data to read. |
| size | Indicates the length of the data to read. |
| timeOut | Indicates the timeout duration for reading data, in milliseconds. If the value is 0,the default value is used. The default value varies according to the application. Generally, the default value is 1 second. |
Returns:
Returns 0 if the operation is successful; returns a negative value if the operation fails.
int32_t SdioReadBytesFromFixedAddr (struct [DevHandle](DevHandle.md) * handle, uint8_t * data, uint32_t addr, uint32_t size, uint32_t timeOut )
Description:
Reads a given length of data from the fixed SDIO address.
If the length of the data to read is greater than the size of a block, the data is read by block, and the remaining data that is smaller than one block is read by byte. Otherwise, data is read by byte.
Parameters:
| handle | Indicates the pointer to the device handle of the SDIO controller obtained by SdioOpen. |
| data | Indicates the pointer to the data to read. |
| addr | Indicates the fixed address of the data to read. |
| size | Indicates the length of the data to read. |
| timeOut | Indicates the timeout duration for reading data, in milliseconds. If the value is 0, the default value is used. The default value varies according to the application. Generally, the default value is 1 second. |
Returns:
Returns 0 if the operation is successful; returns a negative value if the operation fails.
int32_t SdioReadBytesFromFunc0 (struct [DevHandle](DevHandle.md) * handle, uint8_t * data, uint32_t addr, uint32_t size, uint32_t timeOut )
Description:
Reads a given length of data from the address space of SDIO function 0.
Currently, only one byte of data can be read.
Parameters:
| handle | Indicates the pointer to the device handle of the SDIO controller obtained by SdioOpen. |
| data | Indicates the pointer to the data to read. |
| addr | Indicates the start address of the data to read. |
| size | Indicates the length of the data to read. |
| timeOut | Indicates the timeout duration for reading data, in milliseconds. If the value is 0, the default value is used. The default value varies according to the application. Generally, the default value is 1 second. |
Returns:
Returns 0 if the operation is successful; returns a negative value if the operation fails.
void SdioReleaseHost (struct [DevHandle](DevHandle.md) * handle)
Description:
Releases the exclusively claimed host.
This function is used in pair with SdioClaimHost.
Parameters:
| handle | Indicates the pointer to the device handle of the SDIO controller obtained by SdioOpen. |
int32_t SdioReleaseIrq (struct [DevHandle](DevHandle.md) * handle)
Description:
Releases an SDIO IRQ.
This function is used in pair with SdioClaimIrq.
Parameters:
| handle | Indicates the pointer to the device handle of the SDIO controller obtained by SdioOpen. |
Returns:
Returns 0 if the operation is successful; returns a negative value if the operation fails.
int32_t SdioSetBlockSize (struct [DevHandle](DevHandle.md) * handle, uint32_t blockSize )
Description:
Sets the block size.
If data to read or write is performed, use this function to set the block size.
Parameters:
| handle | Indicates the pointer to the device handle of the SDIO controller obtained by SdioOpen. |
| blockSize | Indicates the block size to be set. If the value is 0, the default value is used. The value ranges from 1 to 2048 bytes. |
Returns:
Returns 0 if the operation is successful; returns a negative value if the operation fails.
int32_t SdioSetCommonInfo (struct [DevHandle](DevHandle.md) * handle, [SdioCommonInfo](SdioCommonInfo.md) * info, [SdioCommonInfoType](SDIO.md#ga4037437ac001a9848dd242e8aa632678) infoType )
Description:
Sets common information.
You can call this function to set the maximum timeout duration and private data.
Parameters:
| handle | Indicates the pointer to the device handle of the SDIO controller obtained by SdioOpen. |
| info | Indicates the pointer to the common information to be set. For details, see SdioCommonInfo. |
| infoType | Indicates the type of the common information to be set. For details, see SdioCommonInfoType. |
Returns:
Returns 0 if the operation is successful; returns a negative value if the operation fails.
int32_t SdioWriteBytes (struct [DevHandle](DevHandle.md) * handle, uint8_t * data, uint32_t addr, uint32_t size, uint32_t timeOut )
Description:
Incrementally writes a given length of data into the specified SDIO address.
If the length of the data to write is greater than the size of a block, the data is written by block first, and the remaining data that is smaller than one block is written by byte. Otherwise, data is written by byte.
Parameters:
| handle | Indicates the pointer to the device handle of the SDIO controller obtained by SdioOpen. |
| data | Indicates the pointer to the data to write. |
| addr | Indicates the start address of the data to write. |
| size | Indicates the length of the data to write. |
| timeOut | Indicates the timeout duration for writing data, in milliseconds. If the value is 0, the default value is used. The default value varies according to the application. Generally, the default value is 1 second. |
Returns:
Returns 0 if the operation is successful; returns a negative value if the operation fails.
int32_t SdioWriteBytesToFixedAddr (struct [DevHandle](DevHandle.md) * handle, uint8_t * data, uint32_t addr, uint32_t size, uint32_t timeOut )
Description:
Writes a given length of data into the fixed SDIO address.
If the length of the data to write is greater than the size of a block, the data is written by block first, and the remaining data that is smaller than one block is written by byte. Otherwise, data is written by byte.
Parameters:
| handle | Indicates the pointer to the device handle of the SDIO controller obtained by SdioOpen. |
| data | Indicates the pointer to the data to write. |
| addr | Indicates the fixed address of the data to write. |
| size | Indicates the length of the data to write. |
| timeOut | Indicates the timeout duration for writing data, in milliseconds. If the value is 0, the default value is used. The default value varies according to the application. Generally, the default value is 1 second. |
Returns:
Returns 0 if the operation is successful; returns a negative value if the operation fails.
int32_t SdioWriteBytesToFunc0 (struct [DevHandle](DevHandle.md) * handle, uint8_t * data, uint32_t addr, uint32_t size, uint32_t timeOut )
Description:
Writes a given length of data into the address space of SDIO function 0.
Currently, only one byte of data can be written.
Parameters:
| handle | Indicates the pointer to the device handle of the SDIO controller obtained by SdioOpen. |
| data | Indicates the pointer to the data to write. |
| addr | Indicates the start address of the data to write. |
| size | Indicates the length of the data to write. |
| timeOut | Indicates the timeout duration for writing data, in milliseconds. If the value is 0, the default value is used. The default value varies according to the application. Generally, the default value is 1 second. |
Returns:
Returns 0 if the operation is successful; returns a negative value if the operation fails.
此处可能存在不合适展示的内容，页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容，可点击提交进行申诉，我们将尽快为您处理。