USBD_BulkTx

Description

Sends data on bulk IN endpoint.

Files

usbd_core.h/usbd_ep.c

Prototype

CPU_INT32U  USBD_BulkTx (CPU_INT08U    dev_nbr,
                         CPU_INT08U    ep_addr,
                         void         *p_buf,
                         CPU_INT32U    buf_len,
                         CPU_INT16U    timeout_ms,
                         CPU_BOOLEAN   end,
                         USBD_ERR     *p_err);

Arguments

dev_nbr

Device number.

ep_addr

Endpoint address.

p_buf

Pointer to buffer of data that will be transmitted.

buf_len

Number of octets to transmit.

timeout_ms

Timeout in milliseconds.

end

End-of-transfer flag (see Note #2).

p_err

Pointer to variable that will receive the return error code from this function.

USBD_ERR_NONE

USBD_ERR_DEV_INVALID_NBR

USBD_ERR_DEV_INVALID_STATE

USBD_ERR_EP_INVALID_ADDR

USBD_ERR_EP_INVALID_STATE

USBD_ERR_EP_INVALID_TYPE

USBD_ERR_OS_TIMEOUT

USBD_ERR_OS_ABORT

USBD_ERR_OS_FAIL

Returned Value

Number of octets transmitted, If no error(s).

0, otherwise.

Callers

Classes.

Notes / Warnings

This function blocks until:
1. All data is transmitted, or
2. An error occurred.
3. Transfer does not complete in the period specified by timeout_ms.
If end-of-transfer is set and transfer length is multiple of maximum packet size, a zero-length packet is transferred to indicate a short transfer to the host.