mbed official / USBHost

USBHost library. NOTE: This library is only officially supported on the LPC1768 platform. For more information, please see the handbook page.

Dependencies:   FATFileSystem mbed-rtos

Dependents:   BTstack WallbotWii SD to Flash Data Transfer USBHost-MSD_HelloWorld ... more

Legacy Warning

This is an mbed 2 library. To learn more about mbed OS 5, visit the docs.

Pull requests against this repository are no longer supported. Please raise against mbed OS 5 as documented above.

USBHost/TARGET_STM/USBEndpoint_STM.cpp@37:f1e388e7b752, 2017-07-20 (annotated)

Committer:
Kojto
Date:
Thu Jul 20 10:13:56 2017 +0100
Revision:
37:f1e388e7b752
Update libraries (ed9d1da)

Who changed what in which revision?

UserRevisionLine numberNew contents of line
Kojto 37:f1e388e7b752 1 /* mbed USBHost Library
Kojto 37:f1e388e7b752 2 * Copyright (c) 2006-2013 ARM Limited
Kojto 37:f1e388e7b752 3 *
Kojto 37:f1e388e7b752 4 * Licensed under the Apache License, Version 2.0 (the "License");
Kojto 37:f1e388e7b752 5 * you may not use this file except in compliance with the License.
Kojto 37:f1e388e7b752 6 * You may obtain a copy of the License at
Kojto 37:f1e388e7b752 7 *
Kojto 37:f1e388e7b752 8 * http://www.apache.org/licenses/LICENSE-2.0
Kojto 37:f1e388e7b752 9 *
Kojto 37:f1e388e7b752 10 * Unless required by applicable law or agreed to in writing, software
Kojto 37:f1e388e7b752 11 * distributed under the License is distributed on an "AS IS" BASIS,
Kojto 37:f1e388e7b752 12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
Kojto 37:f1e388e7b752 13 * See the License for the specific language governing permissions and
Kojto 37:f1e388e7b752 14 * limitations under the License.
Kojto 37:f1e388e7b752 15 */
Kojto 37:f1e388e7b752 16 #if defined(TARGET_STM) && defined(USBHOST_OTHER)
Kojto 37:f1e388e7b752 17
Kojto 37:f1e388e7b752 18 #include "dbg.h"
Kojto 37:f1e388e7b752 19 #include "USBEndpoint.h"
Kojto 37:f1e388e7b752 20 extern uint32_t HAL_HCD_HC_GetMaxPacket(HCD_HandleTypeDef *hhcd, uint8_t chn_num);
Kojto 37:f1e388e7b752 21 extern uint32_t HAL_HCD_HC_GetType(HCD_HandleTypeDef *hhcd, uint8_t chn_num);
Kojto 37:f1e388e7b752 22 extern void HAL_HCD_DisableInt(HCD_HandleTypeDef* hhcd, uint8_t chn_num);
Kojto 37:f1e388e7b752 23 extern void HAL_HCD_EnableInt(HCD_HandleTypeDef* hhcd, uint8_t chn_num);
Kojto 37:f1e388e7b752 24
Kojto 37:f1e388e7b752 25
Kojto 37:f1e388e7b752 26
Kojto 37:f1e388e7b752 27
Kojto 37:f1e388e7b752 28 void USBEndpoint::init(HCED * hced_, ENDPOINT_TYPE type_, ENDPOINT_DIRECTION dir_, uint32_t size, uint8_t ep_number, HCTD* td_list_[2])
Kojto 37:f1e388e7b752 29 {
Kojto 37:f1e388e7b752 30 HCD_HandleTypeDef *hhcd;
Kojto 37:f1e388e7b752 31 uint32_t *addr;
Kojto 37:f1e388e7b752 32
Kojto 37:f1e388e7b752 33 hced = hced_;
Kojto 37:f1e388e7b752 34 type = type_;
Kojto 37:f1e388e7b752 35 dir = dir_;
Kojto 37:f1e388e7b752 36 setup = (type == CONTROL_ENDPOINT) ? true : false;
Kojto 37:f1e388e7b752 37
Kojto 37:f1e388e7b752 38 //TDs have been allocated by the host
Kojto 37:f1e388e7b752 39 memcpy((HCTD**)td_list, td_list_, sizeof(HCTD*)*2); //TODO: Maybe should add a param for td_list size... at least a define
Kojto 37:f1e388e7b752 40 memset(td_list_[0], 0, sizeof(HCTD));
Kojto 37:f1e388e7b752 41 memset(td_list_[1], 0, sizeof(HCTD));
Kojto 37:f1e388e7b752 42
Kojto 37:f1e388e7b752 43 td_list[0]->ep = this;
Kojto 37:f1e388e7b752 44 td_list[1]->ep = this;
Kojto 37:f1e388e7b752 45
Kojto 37:f1e388e7b752 46 address = (ep_number & 0x7F) | ((dir - 1) << 7);
Kojto 37:f1e388e7b752 47 this->size = size;
Kojto 37:f1e388e7b752 48 this->ep_number = ep_number;
Kojto 37:f1e388e7b752 49 transfer_len = 0;
Kojto 37:f1e388e7b752 50 transferred = 0;
Kojto 37:f1e388e7b752 51 buf_start = 0;
Kojto 37:f1e388e7b752 52 nextEp = NULL;
Kojto 37:f1e388e7b752 53
Kojto 37:f1e388e7b752 54 td_current = td_list[0];
Kojto 37:f1e388e7b752 55 td_next = td_list[1];
Kojto 37:f1e388e7b752 56 /* remove potential post pending from previous endpoint */
Kojto 37:f1e388e7b752 57 ep_queue.get(0);
Kojto 37:f1e388e7b752 58 intf_nb = 0;
Kojto 37:f1e388e7b752 59 hhcd = (HCD_HandleTypeDef*)hced->hhcd;
Kojto 37:f1e388e7b752 60 addr = &((uint32_t *)hhcd->pData)[hced->ch_num];
Kojto 37:f1e388e7b752 61 *addr = 0;
Kojto 37:f1e388e7b752 62 state = USB_TYPE_IDLE;
Kojto 37:f1e388e7b752 63 speed =false;
Kojto 37:f1e388e7b752 64 }
Kojto 37:f1e388e7b752 65 void USBEndpoint::setSize(uint32_t size)
Kojto 37:f1e388e7b752 66 {
Kojto 37:f1e388e7b752 67 this->size = size;
Kojto 37:f1e388e7b752 68 }
Kojto 37:f1e388e7b752 69
Kojto 37:f1e388e7b752 70
Kojto 37:f1e388e7b752 71 void USBEndpoint::setDeviceAddress(uint8_t addr)
Kojto 37:f1e388e7b752 72 {
Kojto 37:f1e388e7b752 73 HCD_HandleTypeDef *hhcd;
Kojto 37:f1e388e7b752 74 uint8_t hcd_speed = HCD_SPEED_FULL;
Kojto 37:f1e388e7b752 75 /* fix me : small speed device with hub not supported
Kojto 37:f1e388e7b752 76 if (this->speed) hcd_speed = HCD_SPEED_LOW; */
Kojto 37:f1e388e7b752 77 if (this->speed) {
Kojto 37:f1e388e7b752 78 USB_WARN("small speed device on hub not supported");
Kojto 37:f1e388e7b752 79 }
Kojto 37:f1e388e7b752 80 MBED_ASSERT(HAL_HCD_HC_Init((HCD_HandleTypeDef*)hced->hhcd,hced->ch_num, address, addr, hcd_speed, type, size)!=HAL_BUSY);
Kojto 37:f1e388e7b752 81 this->device_address = addr;
Kojto 37:f1e388e7b752 82
Kojto 37:f1e388e7b752 83 }
Kojto 37:f1e388e7b752 84
Kojto 37:f1e388e7b752 85 void USBEndpoint::setSpeed(uint8_t speed)
Kojto 37:f1e388e7b752 86 {
Kojto 37:f1e388e7b752 87 this->speed = speed;
Kojto 37:f1e388e7b752 88 }
Kojto 37:f1e388e7b752 89
Kojto 37:f1e388e7b752 90
Kojto 37:f1e388e7b752 91
Kojto 37:f1e388e7b752 92 void USBEndpoint::setState(USB_TYPE st)
Kojto 37:f1e388e7b752 93 {
Kojto 37:f1e388e7b752 94 /* modify this state is possible only with a plug */
Kojto 37:f1e388e7b752 95 if (state == USB_TYPE_FREE) {
Kojto 37:f1e388e7b752 96 return;
Kojto 37:f1e388e7b752 97 }
Kojto 37:f1e388e7b752 98
Kojto 37:f1e388e7b752 99 state = st;
Kojto 37:f1e388e7b752 100 if (st == USB_TYPE_FREE) {
Kojto 37:f1e388e7b752 101 HCD_HandleTypeDef *hhcd = (HCD_HandleTypeDef*)hced->hhcd;
Kojto 37:f1e388e7b752 102 uint32_t *addr = &((uint32_t *)hhcd->pData)[hced->ch_num];
Kojto 37:f1e388e7b752 103 if ((*addr) && (type != INTERRUPT_ENDPOINT)) {
Kojto 37:f1e388e7b752 104 this->ep_queue.put((uint8_t*)1);
Kojto 37:f1e388e7b752 105 }
Kojto 37:f1e388e7b752 106 MBED_ASSERT(HAL_HCD_HC_Halt((HCD_HandleTypeDef*)hced->hhcd, hced->ch_num)!=HAL_BUSY);
Kojto 37:f1e388e7b752 107 HAL_HCD_DisableInt((HCD_HandleTypeDef*)hced->hhcd, hced->ch_num);
Kojto 37:f1e388e7b752 108 *addr = 0;
Kojto 37:f1e388e7b752 109
Kojto 37:f1e388e7b752 110 }
Kojto 37:f1e388e7b752 111 if (st == USB_TYPE_ERROR) {
Kojto 37:f1e388e7b752 112 MBED_ASSERT(HAL_HCD_HC_Halt((HCD_HandleTypeDef*)hced->hhcd, hced->ch_num)!=HAL_BUSY);
Kojto 37:f1e388e7b752 113 HAL_HCD_DisableInt((HCD_HandleTypeDef*)hced->hhcd, hced->ch_num);
Kojto 37:f1e388e7b752 114
Kojto 37:f1e388e7b752 115 }
Kojto 37:f1e388e7b752 116 if (st == USB_TYPE_ERROR) {
Kojto 37:f1e388e7b752 117 uint8_t hcd_speed = HCD_SPEED_FULL;
Kojto 37:f1e388e7b752 118 /* small speed device with hub not supported
Kojto 37:f1e388e7b752 119 if (this->speed) hcd_speed = HCD_SPEED_LOW;*/
Kojto 37:f1e388e7b752 120 MBED_ASSERT(HAL_HCD_HC_Init((HCD_HandleTypeDef*)hced->hhcd,hced->ch_num, address, 0, hcd_speed, type, size)!=HAL_BUSY);
Kojto 37:f1e388e7b752 121 }
Kojto 37:f1e388e7b752 122 }
Kojto 37:f1e388e7b752 123
Kojto 37:f1e388e7b752 124
Kojto 37:f1e388e7b752 125 extern uint32_t HAL_HCD_HC_GetMaxPacket(HCD_HandleTypeDef *hhcd, uint8_t chn_num);
Kojto 37:f1e388e7b752 126 extern uint32_t HAL_HCD_HC_GetType(HCD_HandleTypeDef *hhcd, uint8_t chn_num);
Kojto 37:f1e388e7b752 127
Kojto 37:f1e388e7b752 128
Kojto 37:f1e388e7b752 129 USB_TYPE USBEndpoint::queueTransfer()
Kojto 37:f1e388e7b752 130 {
Kojto 37:f1e388e7b752 131 HCD_HandleTypeDef *hhcd = (HCD_HandleTypeDef*)hced->hhcd;
Kojto 37:f1e388e7b752 132 uint32_t *addr = &((uint32_t *)hhcd->pData)[hced->ch_num];
Kojto 37:f1e388e7b752 133 uint32_t type = HAL_HCD_HC_GetType(hhcd, hced->ch_num);
Kojto 37:f1e388e7b752 134 uint32_t max_size = HAL_HCD_HC_GetMaxPacket(hhcd, hced->ch_num);
Kojto 37:f1e388e7b752 135 /* if a packet is queue on disconnected ; no solution for now */
Kojto 37:f1e388e7b752 136 if (state == USB_TYPE_FREE) {
Kojto 37:f1e388e7b752 137 td_current->state = USB_TYPE_FREE;
Kojto 37:f1e388e7b752 138 return USB_TYPE_FREE;
Kojto 37:f1e388e7b752 139 }
Kojto 37:f1e388e7b752 140 ep_queue.get(0);
Kojto 37:f1e388e7b752 141 MBED_ASSERT(*addr ==0);
Kojto 37:f1e388e7b752 142 transfer_len = td_current->size <= max_size ? td_current->size : max_size;
Kojto 37:f1e388e7b752 143 buf_start = (uint8_t *)td_current->currBufPtr;
Kojto 37:f1e388e7b752 144
Kojto 37:f1e388e7b752 145 //Now add this free TD at this end of the queue
Kojto 37:f1e388e7b752 146 state = USB_TYPE_PROCESSING;
Kojto 37:f1e388e7b752 147 /* one request */
Kojto 37:f1e388e7b752 148 td_current->nextTD = (hcTd*)0;
Kojto 37:f1e388e7b752 149 #if defined(MAX_NYET_RETRY)
Kojto 37:f1e388e7b752 150 td_current->retry = 0;
Kojto 37:f1e388e7b752 151 #endif
Kojto 37:f1e388e7b752 152 td_current->setup = setup;
Kojto 37:f1e388e7b752 153 *addr = (uint32_t)td_current;
Kojto 37:f1e388e7b752 154 /* dir /setup is inverted for ST */
Kojto 37:f1e388e7b752 155 /* token is useful only ctrl endpoint */
Kojto 37:f1e388e7b752 156 /* last parameter is ping ? */
Kojto 37:f1e388e7b752 157 MBED_ASSERT(HAL_HCD_HC_SubmitRequest((HCD_HandleTypeDef*)hced->hhcd, hced->ch_num, dir-1, type,!setup,(uint8_t*) td_current->currBufPtr, transfer_len, 0)==HAL_OK);
Kojto 37:f1e388e7b752 158 HAL_HCD_EnableInt((HCD_HandleTypeDef*)hced->hhcd, hced->ch_num);
Kojto 37:f1e388e7b752 159
Kojto 37:f1e388e7b752 160 return USB_TYPE_PROCESSING;
Kojto 37:f1e388e7b752 161 }
Kojto 37:f1e388e7b752 162
Kojto 37:f1e388e7b752 163 void USBEndpoint::unqueueTransfer(volatile HCTD * td)
Kojto 37:f1e388e7b752 164 {
Kojto 37:f1e388e7b752 165 if (state==USB_TYPE_FREE) {
Kojto 37:f1e388e7b752 166 return;
Kojto 37:f1e388e7b752 167 }
Kojto 37:f1e388e7b752 168 uint32_t *addr = &((uint32_t *)((HCD_HandleTypeDef*)hced->hhcd)->pData)[hced->ch_num];
Kojto 37:f1e388e7b752 169 td->state=0;
Kojto 37:f1e388e7b752 170 td->currBufPtr=0;
Kojto 37:f1e388e7b752 171 td->size=0;
Kojto 37:f1e388e7b752 172 td->nextTD=0;
Kojto 37:f1e388e7b752 173 *addr = 0;
Kojto 37:f1e388e7b752 174 td_current = td_next;
Kojto 37:f1e388e7b752 175 td_next = td;
Kojto 37:f1e388e7b752 176 }
Kojto 37:f1e388e7b752 177
Kojto 37:f1e388e7b752 178 void USBEndpoint::queueEndpoint(USBEndpoint * ed)
Kojto 37:f1e388e7b752 179 {
Kojto 37:f1e388e7b752 180 nextEp = ed;
Kojto 37:f1e388e7b752 181 }
Kojto 37:f1e388e7b752 182 #endif