/** * @brief Standard requests handler. * @details This is the standard requests default handler, most standard * requests are handled here, the user can override the standard * handling using the @p requests_hook_cb hook in the * @p USBConfig structure. * * @param[in] usbp pointer to the @p USBDriver object * @return The request handling exit code. * @retval false Request not recognized by the handler or error. * @retval true Request handled. */ static bool default_handler(USBDriver *usbp) { const USBDescriptor *dp; /* Decoding the request.*/ switch ((((uint32_t)usbp->setup[0] & (USB_RTYPE_RECIPIENT_MASK | USB_RTYPE_TYPE_MASK)) | ((uint32_t)usbp->setup[1] << 8U))) { case (uint32_t)USB_RTYPE_RECIPIENT_DEVICE | ((uint32_t)USB_REQ_GET_STATUS << 8): /* Just returns the current status word.*/ usbSetupTransfer(usbp, (uint8_t *)&usbp->status, 2, NULL); return true; case (uint32_t)USB_RTYPE_RECIPIENT_DEVICE | ((uint32_t)USB_REQ_CLEAR_FEATURE << 8): /* Only the DEVICE_REMOTE_WAKEUP is handled here, any other feature number is handled as an error.*/ if (usbp->setup[2] == USB_FEATURE_DEVICE_REMOTE_WAKEUP) { usbp->status &= ~2U; usbSetupTransfer(usbp, NULL, 0, NULL); return true; } return false; case (uint32_t)USB_RTYPE_RECIPIENT_DEVICE | ((uint32_t)USB_REQ_SET_FEATURE << 8): /* Only the DEVICE_REMOTE_WAKEUP is handled here, any other feature number is handled as an error.*/ if (usbp->setup[2] == USB_FEATURE_DEVICE_REMOTE_WAKEUP) { usbp->status |= 2U; usbSetupTransfer(usbp, NULL, 0, NULL); return true; } return false; case (uint32_t)USB_RTYPE_RECIPIENT_DEVICE | ((uint32_t)USB_REQ_SET_ADDRESS << 8): /* The SET_ADDRESS handling can be performed here or postponed after the status packed depending on the USB_SET_ADDRESS_MODE low driver setting.*/ #if USB_SET_ADDRESS_MODE == USB_EARLY_SET_ADDRESS if ((usbp->setup[0] == USB_RTYPE_RECIPIENT_DEVICE) && (usbp->setup[1] == USB_REQ_SET_ADDRESS)) { set_address(usbp); } usbSetupTransfer(usbp, NULL, 0, NULL); #else usbSetupTransfer(usbp, NULL, 0, set_address); #endif return true; case (uint32_t)USB_RTYPE_RECIPIENT_DEVICE | ((uint32_t)USB_REQ_GET_DESCRIPTOR << 8): /* Handling descriptor requests from the host.*/ dp = usbp->config->get_descriptor_cb(usbp, usbp->setup[3], usbp->setup[2], get_hword(&usbp->setup[4])); if (dp == NULL) { return false; } /*lint -save -e9005 [11.8] Removing const is fine.*/ usbSetupTransfer(usbp, (uint8_t *)dp->ud_string, dp->ud_size, NULL); /*lint -restore*/ return true; case (uint32_t)USB_RTYPE_RECIPIENT_DEVICE | ((uint32_t)USB_REQ_GET_CONFIGURATION << 8): /* Returning the last selected configuration.*/ usbSetupTransfer(usbp, &usbp->configuration, 1, NULL); return true; case (uint32_t)USB_RTYPE_RECIPIENT_DEVICE | ((uint32_t)USB_REQ_SET_CONFIGURATION << 8): /* Handling configuration selection from the host only if it is different from the current configuration.*/ if (usbp->configuration != usbp->setup[2]) { /* If the USB device is already active then we have to perform the clear procedure on the current configuration.*/ if (usbp->state == USB_ACTIVE) { /* Current configuration cleared.*/ osalSysLockFromISR (); usbDisableEndpointsI(usbp); osalSysUnlockFromISR (); usbp->configuration = 0U; usbp->state = USB_SELECTED; _usb_isr_invoke_event_cb(usbp, USB_EVENT_UNCONFIGURED); } if (usbp->setup[2] != 0U) { /* New configuration.*/ usbp->configuration = usbp->setup[2]; usbp->state = USB_ACTIVE; _usb_isr_invoke_event_cb(usbp, USB_EVENT_CONFIGURED); } } usbSetupTransfer(usbp, NULL, 0, NULL); return true; case (uint32_t)USB_RTYPE_RECIPIENT_INTERFACE | ((uint32_t)USB_REQ_GET_STATUS << 8): case (uint32_t)USB_RTYPE_RECIPIENT_ENDPOINT | ((uint32_t)USB_REQ_SYNCH_FRAME << 8): /* Just sending two zero bytes, the application can change the behavior using a hook..*/ /*lint -save -e9005 [11.8] Removing const is fine.*/ usbSetupTransfer(usbp, (uint8_t *)zero_status, 2, NULL); /*lint -restore*/ return true; case (uint32_t)USB_RTYPE_RECIPIENT_ENDPOINT | ((uint32_t)USB_REQ_GET_STATUS << 8): /* Sending the EP status.*/ if ((usbp->setup[4] & 0x80U) != 0U) { switch (usb_lld_get_status_in(usbp, usbp->setup[4] & 0x0FU)) { case EP_STATUS_STALLED: /*lint -save -e9005 [11.8] Removing const is fine.*/ usbSetupTransfer(usbp, (uint8_t *)halted_status, 2, NULL); /*lint -restore*/ return true; case EP_STATUS_ACTIVE: /*lint -save -e9005 [11.8] Removing const is fine.*/ usbSetupTransfer(usbp, (uint8_t *)active_status, 2, NULL); /*lint -restore*/ return true; case EP_STATUS_DISABLED: default: return false; } } else { switch (usb_lld_get_status_out(usbp, usbp->setup[4] & 0x0FU)) { case EP_STATUS_STALLED: /*lint -save -e9005 [11.8] Removing const is fine.*/ usbSetupTransfer(usbp, (uint8_t *)halted_status, 2, NULL); /*lint -restore*/ return true; case EP_STATUS_ACTIVE: /*lint -save -e9005 [11.8] Removing const is fine.*/ usbSetupTransfer(usbp, (uint8_t *)active_status, 2, NULL); /*lint -restore*/ return true; case EP_STATUS_DISABLED: default: return false; } } case (uint32_t)USB_RTYPE_RECIPIENT_ENDPOINT | ((uint32_t)USB_REQ_CLEAR_FEATURE << 8): /* Only ENDPOINT_HALT is handled as feature.*/ if (usbp->setup[2] != USB_FEATURE_ENDPOINT_HALT) { return false; } /* Clearing the EP status, not valid for EP0, it is ignored in that case.*/ if ((usbp->setup[4] & 0x0FU) != 0U) { if ((usbp->setup[4] & 0x80U) != 0U) { usb_lld_clear_in(usbp, usbp->setup[4] & 0x0FU); } else { usb_lld_clear_out(usbp, usbp->setup[4] & 0x0FU); } } usbSetupTransfer(usbp, NULL, 0, NULL); return true; case (uint32_t)USB_RTYPE_RECIPIENT_ENDPOINT | ((uint32_t)USB_REQ_SET_FEATURE << 8): /* Only ENDPOINT_HALT is handled as feature.*/ if (usbp->setup[2] != USB_FEATURE_ENDPOINT_HALT) { return false; } /* Stalling the EP, not valid for EP0, it is ignored in that case.*/ if ((usbp->setup[4] & 0x0FU) != 0U) { if ((usbp->setup[4] & 0x80U) != 0U) { usb_lld_stall_in(usbp, usbp->setup[4] & 0x0FU); } else { usb_lld_stall_out(usbp, usbp->setup[4] & 0x0FU); } } usbSetupTransfer(usbp, NULL, 0, NULL); return true; case (uint32_t)USB_RTYPE_RECIPIENT_DEVICE | ((uint32_t)USB_REQ_SET_DESCRIPTOR << 8): case (uint32_t)USB_RTYPE_RECIPIENT_INTERFACE | ((uint32_t)USB_REQ_CLEAR_FEATURE << 8): case (uint32_t)USB_RTYPE_RECIPIENT_INTERFACE | ((uint32_t)USB_REQ_SET_FEATURE << 8): case (uint32_t)USB_RTYPE_RECIPIENT_INTERFACE | ((uint32_t)USB_REQ_GET_INTERFACE << 8): case (uint32_t)USB_RTYPE_RECIPIENT_INTERFACE | ((uint32_t)USB_REQ_SET_INTERFACE << 8): /* All the above requests are not handled here, if you need them then use the hook mechanism and provide handling.*/ default: return false; } }
/** * @brief Standard requests handler. * @details This is the standard requests default handler, most standard * requests are handled here, the user can override the standard * handling using the @p requests_hook_cb hook in the * @p USBConfig structure. * * @param[in] usbp pointer to the @p USBDriver object * @return The request handling exit code. * @retval false Request not recognized by the handler or error. * @retval true Request handled. */ static bool default_handler(USBDriver *usbp) { const USBDescriptor *dp; /* Decoding the request.*/ switch (((usbp->setup[0] & (USB_RTYPE_RECIPIENT_MASK | USB_RTYPE_TYPE_MASK)) | (usbp->setup[1] << 8))) { case USB_RTYPE_RECIPIENT_DEVICE | (USB_REQ_GET_STATUS << 8): /* Just returns the current status word.*/ usbSetupTransfer(usbp, (uint8_t *)&usbp->status, 2, NULL); return true; case USB_RTYPE_RECIPIENT_DEVICE | (USB_REQ_CLEAR_FEATURE << 8): /* Only the DEVICE_REMOTE_WAKEUP is handled here, any other feature number is handled as an error.*/ if (usbp->setup[2] == USB_FEATURE_DEVICE_REMOTE_WAKEUP) { usbp->status &= ~2; usbSetupTransfer(usbp, NULL, 0, NULL); return true; } return false; case USB_RTYPE_RECIPIENT_DEVICE | (USB_REQ_SET_FEATURE << 8): /* Only the DEVICE_REMOTE_WAKEUP is handled here, any other feature number is handled as an error.*/ if (usbp->setup[2] == USB_FEATURE_DEVICE_REMOTE_WAKEUP) { usbp->status |= 2; usbSetupTransfer(usbp, NULL, 0, NULL); return true; } return false; case USB_RTYPE_RECIPIENT_DEVICE | (USB_REQ_SET_ADDRESS << 8): /* The SET_ADDRESS handling can be performed here or postponed after the status packed depending on the USB_SET_ADDRESS_MODE low driver setting.*/ #if USB_SET_ADDRESS_MODE == USB_EARLY_SET_ADDRESS if ((usbp->setup[0] == USB_RTYPE_RECIPIENT_DEVICE) && (usbp->setup[1] == USB_REQ_SET_ADDRESS)) set_address(usbp); usbSetupTransfer(usbp, NULL, 0, NULL); #else usbSetupTransfer(usbp, NULL, 0, set_address); #endif return true; case USB_RTYPE_RECIPIENT_DEVICE | (USB_REQ_GET_DESCRIPTOR << 8): /* Handling descriptor requests from the host.*/ dp = usbp->config->get_descriptor_cb( usbp, usbp->setup[3], usbp->setup[2], usbFetchWord(&usbp->setup[4])); if (dp == NULL) return false; usbSetupTransfer(usbp, (uint8_t *)dp->ud_string, dp->ud_size, NULL); return true; case USB_RTYPE_RECIPIENT_DEVICE | (USB_REQ_GET_CONFIGURATION << 8): /* Returning the last selected configuration.*/ usbSetupTransfer(usbp, &usbp->configuration, 1, NULL); return true; case USB_RTYPE_RECIPIENT_DEVICE | (USB_REQ_SET_CONFIGURATION << 8): /* Handling configuration selection from the host.*/ usbp->configuration = usbp->setup[2]; if (usbp->configuration == 0) usbp->state = USB_SELECTED; else usbp->state = USB_ACTIVE; _usb_isr_invoke_event_cb(usbp, USB_EVENT_CONFIGURED); usbSetupTransfer(usbp, NULL, 0, NULL); return true; case USB_RTYPE_RECIPIENT_INTERFACE | (USB_REQ_GET_STATUS << 8): case USB_RTYPE_RECIPIENT_ENDPOINT | (USB_REQ_SYNCH_FRAME << 8): /* Just sending two zero bytes, the application can change the behavior using a hook..*/ usbSetupTransfer(usbp, (uint8_t *)zero_status, 2, NULL); return true; case USB_RTYPE_RECIPIENT_ENDPOINT | (USB_REQ_GET_STATUS << 8): /* Sending the EP status.*/ if (usbp->setup[4] & 0x80) { switch (usb_lld_get_status_in(usbp, usbp->setup[4] & 0x0F)) { case EP_STATUS_STALLED: usbSetupTransfer(usbp, (uint8_t *)halted_status, 2, NULL); return true; case EP_STATUS_ACTIVE: usbSetupTransfer(usbp, (uint8_t *)active_status, 2, NULL); return true; default: return false; } } else { switch (usb_lld_get_status_out(usbp, usbp->setup[4] & 0x0F)) { case EP_STATUS_STALLED: usbSetupTransfer(usbp, (uint8_t *)halted_status, 2, NULL); return true; case EP_STATUS_ACTIVE: usbSetupTransfer(usbp, (uint8_t *)active_status, 2, NULL); return true; default: return false; } } case USB_RTYPE_RECIPIENT_ENDPOINT | (USB_REQ_CLEAR_FEATURE << 8): /* Only ENDPOINT_HALT is handled as feature.*/ if (usbp->setup[2] != USB_FEATURE_ENDPOINT_HALT) return false; /* Clearing the EP status, not valid for EP0, it is ignored in that case.*/ if ((usbp->setup[4] & 0x0F) > 0) { if (usbp->setup[4] & 0x80) usb_lld_clear_in(usbp, usbp->setup[4] & 0x0F); else usb_lld_clear_out(usbp, usbp->setup[4] & 0x0F); } usbSetupTransfer(usbp, NULL, 0, NULL); return true; case USB_RTYPE_RECIPIENT_ENDPOINT | (USB_REQ_SET_FEATURE << 8): /* Only ENDPOINT_HALT is handled as feature.*/ if (usbp->setup[2] != USB_FEATURE_ENDPOINT_HALT) return false; /* Stalling the EP, not valid for EP0, it is ignored in that case.*/ if ((usbp->setup[4] & 0x0F) > 0) { if (usbp->setup[4] & 0x80) usb_lld_stall_in(usbp, usbp->setup[4] & 0x0F); else usb_lld_stall_out(usbp, usbp->setup[4] & 0x0F); } usbSetupTransfer(usbp, NULL, 0, NULL); return true; case USB_RTYPE_RECIPIENT_DEVICE | (USB_REQ_SET_DESCRIPTOR << 8): case USB_RTYPE_RECIPIENT_INTERFACE | (USB_REQ_CLEAR_FEATURE << 8): case USB_RTYPE_RECIPIENT_INTERFACE | (USB_REQ_SET_FEATURE << 8): case USB_RTYPE_RECIPIENT_INTERFACE | (USB_REQ_GET_INTERFACE << 8): case USB_RTYPE_RECIPIENT_INTERFACE | (USB_REQ_SET_INTERFACE << 8): /* All the above requests are not handled here, if you need them then use the hook mechanism and provide handling.*/ default: return false; } }
/** * @brief Returns the status of an IN endpoint. * * @param[in] usbp pointer to the @p USBDriver object * @param[in] ep endpoint number * @return The endpoint status. * @retval EP_STATUS_DISABLED The endpoint is not active. * @retval EP_STATUS_STALLED The endpoint is stalled. * @retval EP_STATUS_ACTIVE The endpoint is active. * * @notapi */ usbepstatus_t usb_lld_get_status_in(USBDriver *usbp, usbep_t ep) { return usb_lld_get_status_out(usbp, ep); }