4 * This file is part of BeRTOS.
6 * Bertos is free software; you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation; either version 2 of the License, or
9 * (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License
17 * along with this program; if not, write to the Free Software
18 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
20 * As a special exception, you may use this file as part of a free software
21 * library without restriction. Specifically, if other files instantiate
22 * templates or use macros or inline functions from this file, or you compile
23 * this file and link it with other files to produce an executable, this
24 * file does not by itself cause the resulting executable to be covered by
25 * the GNU General Public License. This exception does not however
26 * invalidate any other reasons why the executable file might be covered by
27 * the GNU General Public License.
29 * Copyright 2010 Develer S.r.l. (http://www.develer.com/)
33 * \brief STM32 USB driver
35 * \author Andrea Righi <arighi@develer.com>
38 #include "cfg/cfg_usb.h"
40 #define LOG_LEVEL USB_LOG_LEVEL
41 #define LOG_FORMAT USB_LOG_FORMAT
44 #include <cfg/debug.h>
45 #include <cfg/macros.h>
46 #include <cfg/module.h>
49 #include <cpu/power.h>
51 #include <drv/irq_cm3.h>
52 #include <drv/gpio_stm32.h>
53 #include <drv/clock_stm32.h>
54 #include <drv/timer.h>
57 #include <mware/event.h>
59 #include <string.h> /* memcpy() */
61 #include "usb_stm32.h"
63 /* XXX: consider to move this to cfg/macros.h */
65 /* XXX: redefine this to make it usable within C expression */
66 #define _MIN(a,b) (((a) < (b)) ? (a) : (b))
68 /* STM32 USB registers */
79 reg32_t __reserved[8];
87 /* Hardware registers */
88 static struct stm32_usb *usb = (struct stm32_usb *)USB_BASE_ADDR;
90 /* Endpoint descriptors: used for handling requests to use with endpoints */
91 static stm32_UsbEp ep_cnfg[EP_MAX_NUM];
92 STATIC_ASSERT(EP_MAX_NUM <= EP_MAX_HW_NUM);
94 /* USB EP0 control descriptor */
95 static const UsbEndpointDesc USB_CtrlEpDescr0 =
97 .bLength = sizeof(USB_CtrlEpDescr0),
98 .bDescriptorType = USB_DT_ENDPOINT,
99 .bEndpointAddress = USB_DIR_OUT | 0,
100 .bmAttributes = USB_ENDPOINT_XFER_CONTROL,
101 .wMaxPacketSize = USB_EP0_MAX_SIZE,
105 /* USB EP1 control descriptor */
106 static const UsbEndpointDesc USB_CtrlEpDescr1 =
108 .bLength = sizeof(USB_CtrlEpDescr1),
109 .bDescriptorType = USB_DT_ENDPOINT,
110 .bEndpointAddress = USB_DIR_IN | 0,
111 .bmAttributes = USB_ENDPOINT_XFER_CONTROL,
112 .wMaxPacketSize = USB_EP0_MAX_SIZE,
116 /* USB setup packet */
117 static UsbCtrlRequest setup_packet;
119 /* USB device controller: max supported interfaces */
120 #define USB_MAX_INTERFACE CONFIG_USB_INTERFACE_MAX
122 /* USB device controller features */
123 #define STM32_UDC_FEATURE_SELFPOWERED BV(0)
124 #define STM32_UDC_FEATURE_REMOTE_WAKEUP BV(1)
126 /* Hardware-specific USB device controller structure */
127 typedef struct stm32_udc
131 const UsbConfigDesc *cfg;
133 uint32_t alt[USB_MAX_INTERFACE];
136 } PACKED stm32_udc_t;
138 /* Hardware-specific USB Device Controller */
139 static stm32_udc_t udc;
141 /* Generic USB Device Controller structure */
142 static UsbDevice *usb_dev;
144 /* USB packet memory management: list of allocated chunks */
145 static stm32_UsbMemSlot *mem_use;
147 /* USB packet memory management: memory buffer metadata */
148 static stm32_UsbMemSlot memory_buffer[EP_MAX_NUM];
150 /* Endpoint TX and RX buffers */
152 /* XXX: use the empty cond section to silent a buggy doxygen warning */
153 static size_t rx_size, tx_size;
155 #define EP_BUFFER_SIZE _MIN(CONFIG_USB_BUFSIZE, USB_XFER_MAX_SIZE)
156 STATIC_ASSERT(!(EP_BUFFER_SIZE & 0x03));
158 static uint8_t ep_buffer[EP_MAX_NUM][EP_BUFFER_SIZE] ALIGNED(4);
161 static Event usb_event_done[EP_MAX_SLOTS];
163 /* Check if we're running in atomic (non-sleepable) context or not */
164 static volatile bool in_atomic = false;
166 /* Allocate a free block of the packet memory */
167 static stm32_UsbMemSlot *usb_malloc(void)
171 for (i = 0; i < countof(memory_buffer); i++)
172 if (memory_buffer[i].Size == 0)
173 return &memory_buffer[i];
177 /* Release a block of the packet memory */
178 static void usb_free(stm32_UsbMemSlot *pPntr)
183 /* Allocate a free chunk of the packet memory (inside a block) */
184 static bool usb_alloc_buffer(uint16_t *pOffset, uint32_t *size,
187 stm32_UsbMemSlot *mem = mem_use,
188 *memNext, *mem_useNew;
189 uint32_t max_size = *size;
192 * Packet size alignment:
193 * - fine-granularity allocation: size alignment by 2;
194 * - coarse-granularity allocation: size alignment by 32.
197 max_size = ALIGN_UP(max_size, 2);
199 max_size = ALIGN_UP(max_size, 32);
201 * Finding free memory chunks from the allocated blocks of the USB
207 /* Offset alignment by 4 */
208 *pOffset = ALIGN_UP(mem->Start + mem->Size, 4);
210 if ((mem->next == NULL) ||
212 *pOffset + max_size))
216 /* Check for out-of-memory condition */
217 if (UNLIKELY((*pOffset + max_size) >= USB_BDT_OFFSET))
220 * Allocate a new memory block, next to the last allocated block.
222 mem_useNew = usb_malloc();
223 if (UNLIKELY(mem_useNew == NULL))
225 /* Insert the block to the list of allocated blocks */
228 mem_use = mem_useNew;
229 mem_use->next = NULL;
233 mem_useNew->next = mem->next;
234 mem->next = mem_useNew;
236 /* Update block's metadata */
237 mem_useNew->ep_addr = EndPoint;
238 mem_useNew->Start = *pOffset;
239 mem_useNew->Size = max_size;
246 /* Release a chunk of the packet memory (inside a block) */
247 static void usb_free_buffer(int EndPoint)
249 stm32_UsbMemSlot *mem, *memPrev = NULL;
254 if (mem->ep_addr == EndPoint)
256 if (UNLIKELY(memPrev == NULL))
258 /* Free the first element of the list */
259 mem_use = mem_use->next;
264 memPrev->next = mem->next;
273 /*-------------------------------------------------------------------------*/
275 /* Connect USB controller */
276 static void usb_connect(void)
278 stm32_gpioPinWrite((struct stm32_gpio *)GPIOC_BASE, 1 << 11, 0);
281 /* Set USB device address */
282 static void usb_set_address(uint32_t addr)
284 usb->DADDR = addr | 0x80;
287 /* Suspend USB controller */
288 static void usb_suspend(void)
290 usb->CNTR |= bmFSUSP | bmLPMODE;
293 /* Resume USB controller */
294 static void usb_resume(void)
296 uint32_t line_status;
298 line_status = usb->FNR & 0xc000;
301 /* check for noise and eventually return to sleep */
302 if (line_status == 0xc000)
305 usb->CNTR &= ~(bmFSUSP | bmLPMODE);
308 /* Convert logical EP address to physical EP address */
309 static int usb_ep_logical_to_hw(uint8_t ep_addr)
311 int addr = (ep_addr & 0x0f) << 1;
312 return (ep_addr & 0x80) ? addr + 1 : addr;
316 static void ep_ctrl_set_ea(reg32_t *reg, uint32_t val)
319 val |= *reg & 0x0700;
320 val |= USB_CTRL_CLEAR_ONLY_MASK;
324 /* Get EP IN status */
325 static uint32_t ep_ctrl_get_stat_tx(reg32_t *reg)
327 return (*reg & (0x3UL << 4)) >> 4;
330 /* Set EP IN state */
331 static void ep_ctrl_set_stat_tx(reg32_t *reg, stm32_UsbEpState val)
337 * The EP can change state between read and write operations from VALID
338 * to NAK and result of set operation will be invalid.
340 for (i = 0; i < 2; i++)
342 if (ep_ctrl_get_stat_tx(reg) == val)
347 state |= USB_CTRL_CLEAR_ONLY_MASK;
348 /* Clear the toggle bits without STAT_TX (4,5) */
354 /* Set EP DTOG_TX bit (IN) */
355 static void ep_ctrl_set_dtog_tx(reg32_t *reg, uint32_t val)
357 val = val ? (*reg ^ (1UL << 6)) : *reg;
358 /* Clear the toggle bits without DTOG_TX (6) */
360 val |= USB_CTRL_CLEAR_ONLY_MASK;
364 /* Clear EP CTR_TX bit (IN) */
365 static void ep_ctrl_clr_ctr_tx(reg32_t *reg)
369 val &= ~(USB_CTRL_TOGGLE_MASK | 1UL << 7);
375 /* Clear EP CTR_RX bit (OUT) */
376 static void ep_ctrl_clr_ctr_rx(reg32_t *reg)
379 val &= ~(USB_CTRL_TOGGLE_MASK | 1UL << 15);
385 /* Set EP KIND bit */
386 static void ep_ctrl_set_ep_kind(reg32_t *reg, uint32_t val)
388 val = val ? (1UL << 8) : 0;
389 val |= *reg & ~(USB_CTRL_TOGGLE_MASK | (1UL << 8));
390 val |= USB_CTRL_CLEAR_ONLY_MASK;
395 static int ep_ctrl_set_ep_type(reg32_t *reg, uint8_t val)
399 if (UNLIKELY(val >= EP_TYPE_MAX))
402 return USB_INVAL_ERROR;
406 type |= *reg & ~(USB_CTRL_TOGGLE_MASK | (0x3UL << 9));
407 type |= USB_CTRL_CLEAR_ONLY_MASK;
413 /* Get EP STAT_RX (OUT) */
414 static uint32_t ep_ctrl_get_stat_rx(reg32_t *reg)
416 uint32_t val = *reg & (0x3UL << 12);
420 /* Set EP STAT_RX (OUT) */
421 static void ep_ctrl_set_stat_rx(reg32_t *reg, stm32_UsbEpState val)
427 * The EP can change state between read and write operations from VALID
428 * to NAK and result of set operation will be invalid.
430 for (i = 0; i < 2; i++)
432 if (ep_ctrl_get_stat_rx(reg) == val)
437 state |= USB_CTRL_CLEAR_ONLY_MASK;
438 /* Clear the toggle bits without STAT_RX (12,13) */
444 /* Set DTOG_RX bit */
445 static void ep_ctrl_set_dtog_rx(reg32_t *reg, uint32_t val)
447 val = val ? (*reg ^ (1UL << 14)) : *reg;
448 /* Clear the toggle bits without DTOG_RX (14) */
450 val |= USB_CTRL_CLEAR_ONLY_MASK;
454 /* Get EP SETUP bit */
455 static uint32_t ep_ctrl_get_setup(reg32_t *reg)
457 uint32_t val = *reg & (1UL << 11);
461 /* Core endpoint I/O function */
462 static void __usb_ep_io(int EP)
464 ssize_t Count, CountHold, Offset;
465 uint32_t *pDst, *pSrc, Data;
466 stm32_UsbEp *epd = &ep_cnfg[EP];
468 if (UNLIKELY(epd->hw == NULL))
470 LOG_ERR("%s: invalid endpoint (EP%d-%s)\n",
473 (EP & 0x01) ? "IN" : "OUT");
477 if (epd->status != BEGIN_SERVICED && epd->status != NO_SERVICED)
483 Count = epd->size - epd->offset;
484 while (epd->avail_data)
486 if (!Count && !(epd->flags & STM32_USB_EP_ZERO_PACKET))
490 epd->status = BEGIN_SERVICED;
492 if ((epd->flags & STM32_USB_EP_ZERO_PACKET) &&
493 (Count == epd->max_size))
494 epd->flags |= STM32_USB_EP_ZERO_PACKET |
495 STM32_USB_EP_ZERO_POSSIBLE;
497 CountHold = Count = MIN(Count, epd->max_size);
499 epd->flags |= STM32_USB_EP_ZERO_PACKET;
500 Offset = epd->offset;
501 epd->offset += Count;
504 case USB_ENDPOINT_XFER_CONTROL:
505 case USB_ENDPOINT_XFER_INT:
506 pDst = (uint32_t *)USB_MEM_ADDR(EP_DTB_READ(EP >> 1, ADDR_TX_OFFSET));
508 case USB_ENDPOINT_XFER_BULK:
509 pDst = (uint32_t *)USB_MEM_ADDR(EP_DTB_READ(EP >> 1, ADDR_TX_OFFSET));
511 case USB_ENDPOINT_XFER_ISOC:
512 LOG_ERR("%s: isochronous transfer not supported\n",
514 /* Fallback to default */
520 /* Write data to packet memory buffer */
523 Data = *(epd->write_buffer + Offset++);
526 Data |= (uint32_t)(*(epd->write_buffer + Offset++)) << 8;
532 EP_DTB_WRITE(EP >> 1, COUNT_TX_OFFSET, CountHold);
533 ep_ctrl_set_stat_tx(epd->hw, EP_VALID);
535 --ep_cnfg[EP].avail_data;
536 Count = epd->size - epd->offset;
538 if (!Count && !(epd->flags & STM32_USB_EP_ZERO_PACKET))
540 epd->status = COMPLETE;
541 /* call callback function */
549 while (epd->avail_data)
551 /* Get data size and buffer pointer */
554 case USB_ENDPOINT_XFER_CONTROL:
555 case USB_ENDPOINT_XFER_INT:
556 /* Get received bytes number */
557 Count = EP_DTB_READ(EP >> 1, COUNT_RX_OFFSET) & 0x3FF;
558 /* Get address of the USB packet buffer for corresponding EP */
559 pSrc = (uint32_t *)USB_MEM_ADDR(EP_DTB_READ(EP >> 1, ADDR_RX_OFFSET));
561 case USB_ENDPOINT_XFER_BULK:
562 /* Get received bytes number */
563 Count = EP_DTB_READ(EP >> 1, COUNT_RX_OFFSET) & 0x3FF;
564 /* Get address of the USB packet buffer for corresponding EP */
565 pSrc = (uint32_t *)USB_MEM_ADDR(EP_DTB_READ(EP >> 1, ADDR_RX_OFFSET));
567 case USB_ENDPOINT_XFER_ISOC:
568 LOG_ERR("%s: isochronous transfer not supported\n",
570 /* Fallback to default */
576 if (Count > (epd->size - epd->offset))
578 epd->status = BUFFER_OVERRUN;
579 epd->size = ep_cnfg[EP].offset;
582 else if (Count < ep_cnfg[EP].max_size)
584 epd->status = BUFFER_UNDERRUN;
585 epd->size = ep_cnfg[EP].offset + Count;
588 epd->status = BEGIN_SERVICED;
590 Offset = epd->offset;
591 epd->offset += Count;
593 /* Read data from packet memory buffer */
597 *(epd->read_buffer + Offset++) = Data;
601 *(epd->read_buffer + Offset++) = Data;
606 ep_ctrl_set_stat_rx(epd->hw, EP_VALID);
608 --ep_cnfg[EP].avail_data;
610 if (*epd->hw & (1UL << 11))
612 ep_cnfg[EP].status = SETUP_OVERWRITE;
615 if (!(Count = (epd->size - epd->offset)))
617 epd->status = COMPLETE;
621 if (epd->status != BEGIN_SERVICED && epd->status != NO_SERVICED)
623 /* call callback function */
631 * Return the lower value from Host expected size and size and set a flag
632 * STM32_USB_EP_ZERO_POSSIBLE when size is lower that host expected size.
634 static size_t usb_size(size_t size, size_t host_size)
636 if (size < host_size)
638 ep_cnfg[CTRL_ENP_IN].flags |= STM32_USB_EP_ZERO_POSSIBLE;
644 /* Configure an EP descriptor before performing a I/O operation */
645 #define USB_EP_IO(__EP, __op, __buf, __size, __complete) \
648 stm32_UsbIoStatus ret; \
650 /* Fill EP descriptor */ \
651 IRQ_SAVE_DISABLE(flags); \
654 ep_cnfg[__EP].status = NOT_READY; \
655 ep_cnfg[__EP].complete = NULL; \
659 if (ep_cnfg[__EP].status == BEGIN_SERVICED) \
665 * NOTE: the write_buffer and read_buffer are actually the \
666 * same location in memory (it's a union). \
668 * We have to do this trick to silent a build warning by \
669 * casting the I/O buffer to (void *) or (const void *). \
671 ep_cnfg[__EP].__op ## _buffer = __buf; \
672 ep_cnfg[__EP].offset = 0; \
673 ep_cnfg[__EP].size = __size; \
674 ep_cnfg[__EP].complete = __complete; \
676 ep_cnfg[__EP].flags = STM32_USB_EP_ZERO_PACKET; \
678 ep_cnfg[__EP].flags = 0; \
679 ep_cnfg[__EP].status = NO_SERVICED; \
681 /* Perform the I/O operation */ \
684 ret = ep_cnfg[__EP].status; \
686 IRQ_RESTORE(flags); \
690 /* Configure and endponint and perform a read operation */
691 static stm32_UsbIoStatus
692 __usb_ep_read(int ep, void *buffer, ssize_t size, void (*complete)(int))
694 if (UNLIKELY((ep >= EP_MAX_NUM) || (ep & 0x01)))
696 LOG_ERR("%s: invalid EP number %d\n", __func__, ep);
700 if (UNLIKELY((size_t)buffer & 0x03))
702 LOG_ERR("%s: unaligned buffer @ %p\n", __func__, buffer);
706 return USB_EP_IO(ep, read, buffer, size, complete);
709 /* Configure and endponint and perform a write operation */
710 static stm32_UsbIoStatus
711 __usb_ep_write(int ep, const void *buffer, ssize_t size, void (*complete)(int))
713 if (UNLIKELY((ep >= EP_MAX_NUM) || !(ep & 0x01)))
715 LOG_ERR("%s: invalid EP number %d\n", __func__, ep);
719 if (UNLIKELY((size_t)buffer & 0x03))
721 LOG_ERR("%s: unaligned buffer @ %p\n", __func__, buffer);
725 return USB_EP_IO(ep, write, buffer, size, complete);
728 static void usb_ep_low_level_config(int ep, uint16_t offset, uint16_t size)
730 stm32_UsbEp *epc = &ep_cnfg[ep];
736 ep_ctrl_set_stat_tx(epc->hw, EP_DISABLED);
737 /* Clear Tx toggle */
738 ep_ctrl_set_dtog_tx(epc->hw, 0);
739 /* Clear Correct Transfer for transmission flag */
740 ep_ctrl_clr_ctr_tx(epc->hw);
742 /* Update EP description table */
743 EP_DTB_WRITE(ep >> 1, ADDR_TX_OFFSET, offset);
744 EP_DTB_WRITE(ep >> 1, COUNT_TX_OFFSET, 0);
749 uint16_t rx_count = 0;
752 ep_ctrl_set_stat_rx(epc->hw, EP_DISABLED);
753 /* Clear Rx toggle */
754 ep_ctrl_set_dtog_rx(epc->hw, 0);
755 /* Clear Correct Transfer for reception flag */
756 ep_ctrl_clr_ctr_rx(epc->hw);
757 /* Descriptor block size field */
758 rx_count |= (size > 62) << 15;
759 /* Descriptor number of blocks field */
760 rx_count |= (((size > 62) ? (size >> 5) - 1 : size >> 1) &
762 /* Update EP description table */
763 EP_DTB_WRITE(ep >> 1, ADDR_RX_OFFSET, offset);
764 EP_DTB_WRITE(ep >> 1, COUNT_RX_OFFSET, rx_count);
768 /* Enable/Disable an endpoint */
769 static int usb_ep_configure(const UsbEndpointDesc *epd, bool enable)
777 EP = usb_ep_logical_to_hw(epd->bEndpointAddress);
778 ep_hw = &ep_cnfg[EP];
783 * Allocate packet memory for EP buffer/s calculate actual size
784 * only for the OUT EPs.
786 size = epd->wMaxPacketSize;
787 if (!usb_alloc_buffer(&Offset, &size, EP))
788 return -USB_MEMORY_FULL;
791 ep_hw->status = NOT_READY;
795 /* Set endpoint type */
796 ep_hw->type = usb_endpointType(epd);
797 /* Init EP max packet size */
798 ep_hw->max_size = epd->wMaxPacketSize;
801 ep_hw->avail_data = 1;
803 ep_hw->avail_data = 0;
804 hw = (reg32_t *)&usb->EP0R;
808 ep_ctrl_set_ea(hw, EP >> 1);
810 LOG_INFO("%s: EP%d-%s configured\n",
811 __func__, EP >> 1, EP & 1 ? "IN" : "OUT");
813 /* Low-level endpoint configuration */
814 usb_ep_low_level_config(EP, Offset, size);
816 /* Set EP Kind & enable */
819 case USB_ENDPOINT_XFER_CONTROL:
820 LOG_INFO("EP%d: CONTROL %s\n", EP >> 1,
821 EP & 1 ? "IN" : "OUT");
822 ep_ctrl_set_ep_type(hw, EP_CTRL);
823 ep_ctrl_set_ep_kind(hw, 0);
825 case USB_ENDPOINT_XFER_INT:
826 LOG_INFO("EP%d: INTERRUPT %s\n", EP >> 1,
827 EP & 1 ? "IN" : "OUT");
828 ep_ctrl_set_ep_type(hw, EP_INTERRUPT);
829 ep_ctrl_set_ep_kind(hw, 0);
831 case USB_ENDPOINT_XFER_BULK:
832 LOG_INFO("EP%d: BULK %s\n", EP >> 1,
833 EP & 1 ? "IN" : "OUT");
834 ep_ctrl_set_ep_type(hw, EP_BULK);
835 ep_ctrl_set_ep_kind(hw, 0);
837 case USB_ENDPOINT_XFER_ISOC:
838 LOG_ERR("EP%d: ISOCHRONOUS %s: not supported\n",
840 EP & 1 ? "IN" : "OUT");
841 /* Fallback to default */
844 return -USB_NODEV_ERROR;
849 ep_ctrl_set_stat_tx(hw, EP_NAK);
850 /* Clear Correct Transfer for transmission flag */
851 ep_ctrl_clr_ctr_tx(hw);
856 ep_ctrl_set_stat_rx(hw, EP_VALID);
859 else if (ep_cnfg[EP].hw)
861 hw = (reg32_t *)&usb->EP0R;
868 ep_ctrl_set_stat_tx(hw, EP_DISABLED);
869 /* Clear Correct Transfer for reception flag */
870 ep_ctrl_clr_ctr_tx(hw);
876 ep_ctrl_set_stat_rx(hw, EP_DISABLED);
877 /* Clear Correct Transfer for reception flag */
878 ep_ctrl_clr_ctr_rx(hw);
882 ep_cnfg[EP].hw = NULL;
887 /* Get EP stall/unstall */
888 static int usb_ep_get_stall(int EP, bool *pStall)
890 if (ep_cnfg[EP].hw == NULL)
891 return -USB_NODEV_ERROR;
893 *pStall = (EP & 0x01) ?
894 (ep_ctrl_get_stat_tx(ep_cnfg[EP].hw) == EP_STALL): /* IN EP */
895 (ep_ctrl_get_stat_rx(ep_cnfg[EP].hw) == EP_STALL); /* OUT EP */
900 /* Set EP stall/unstall */
901 static int usb_ep_set_stall(int EP, bool Stall)
903 if (ep_cnfg[EP].hw == NULL)
904 return -USB_NODEV_ERROR;
908 ep_cnfg[EP].status = STALLED;
912 ep_ctrl_set_stat_tx(ep_cnfg[EP].hw, EP_STALL);
913 ep_cnfg[EP].avail_data = 1;
918 ep_ctrl_set_stat_rx(ep_cnfg[EP].hw, EP_STALL);
919 ep_cnfg[EP].avail_data = 0;
924 ep_cnfg[EP].status = NOT_READY;
928 ep_cnfg[EP].avail_data = 1;
929 /* reset Data Toggle bit */
930 ep_ctrl_set_dtog_tx(ep_cnfg[EP].hw, 0);
931 ep_ctrl_set_stat_tx(ep_cnfg[EP].hw, EP_NAK);
936 ep_cnfg[EP].avail_data = 0;
937 /* reset Data Toggle bit */
938 ep_ctrl_set_dtog_rx(ep_cnfg[EP].hw, 0);
939 ep_ctrl_set_stat_rx(ep_cnfg[EP].hw, EP_VALID);
945 /* Stall both directions of the control EP */
946 static void usb_ep_set_stall_ctrl(void)
948 ep_cnfg[CTRL_ENP_IN].avail_data = 1;
949 ep_cnfg[CTRL_ENP_IN].status = STALLED;
950 ep_cnfg[CTRL_ENP_OUT].avail_data = 0;
951 ep_cnfg[CTRL_ENP_OUT].status = STALLED;
953 usb_ep_set_stall(CTRL_ENP_IN, true);
954 usb_ep_set_stall(CTRL_ENP_OUT, true);
958 * Find the position of an interface descriptor inside the configuration
961 static int usb_find_interface(uint32_t num, uint32_t alt)
963 const UsbInterfaceDesc *id;
968 /* TODO: support more than one configuration per device */
969 id = (const UsbInterfaceDesc *)usb_dev->config[i];
972 if (id->bDescriptorType != USB_DT_INTERFACE)
974 if ((id->bInterfaceNumber == num) &&
975 (id->bAlternateSetting == alt))
978 return -USB_NODEV_ERROR;
982 * Configure/deconfigure EPs of a certain interface.
985 usb_configure_ep_interface(unsigned int num, unsigned int alt, bool enable)
987 const UsbEndpointDesc *epd;
991 * Find the position of the interface descriptor (inside the
992 * configuration descriptor).
994 start = usb_find_interface(num, alt);
997 LOG_ERR("%s: interface (%u,%u) not found\n",
1002 * Cycle over endpoint descriptors.
1004 * NOTE: the first endpoint descriptor is placed next to the interface
1005 * descriptor, so we need to add +1 to the position of the interface
1006 * descriptor to find it.
1008 for (i = start + 1; ; i++)
1010 epd = (const UsbEndpointDesc *)usb_dev->config[i];
1011 if ((epd == NULL) || (epd->bDescriptorType == USB_DT_INTERFACE))
1013 if (epd->bDescriptorType != USB_DT_ENDPOINT)
1015 if (UNLIKELY(usb_ep_configure(epd, enable) < 0))
1017 LOG_ERR("%s: out of memory, can't initialize EP\n",
1024 /* Set device state */
1025 static void usb_set_device_state(int state)
1029 LOG_INFO("%s: new state %d\n", __func__, state);
1031 if (udc.state == USB_STATE_CONFIGURED)
1033 /* Deconfigure device */
1034 for (i = 0; i < udc.interfaces; ++i)
1035 usb_configure_ep_interface(i,
1040 case USB_STATE_ATTACHED:
1041 case USB_STATE_POWERED:
1042 case USB_STATE_DEFAULT:
1044 usb_dev->configured = false;
1045 udc.address = udc.cfg_id = 0;
1047 case USB_STATE_ADDRESS:
1050 case USB_STATE_CONFIGURED:
1051 /* Configure device */
1052 for (i = 0; i < udc.interfaces; ++i)
1053 usb_configure_ep_interface(i,
1057 /* Unknown state: disconnected or connection in progress */
1058 usb_dev->configured = false;
1066 /* Setup packet: set address status phase end handler */
1067 static void usb_add_status_handler_end(UNUSED_ARG(int, EP))
1071 w_value = usb_le16_to_cpu(setup_packet.wValue);
1072 udc.address = w_value & 0xff;
1073 usb_set_address(udc.address);
1076 usb_set_device_state(USB_STATE_ADDRESS);
1078 usb_set_device_state(USB_STATE_DEFAULT);
1080 __usb_ep_write(CTRL_ENP_IN, NULL, -1, NULL);
1081 __usb_ep_read(CTRL_ENP_OUT, NULL, -1, NULL);
1084 /* Prepare status phase */
1085 static void usb_status_phase(bool in)
1088 __usb_ep_write(CTRL_ENP_IN, NULL, 0, NULL);
1091 /* Setup packet: status phase end handler */
1092 static void usb_status_handler_end(UNUSED_ARG(int, EP))
1094 __usb_ep_write(CTRL_ENP_IN, NULL, -1, NULL);
1095 __usb_ep_read(CTRL_ENP_OUT, NULL, -1, NULL);
1098 /* Address status handler */
1099 static void usb_status_handler(UNUSED_ARG(int, EP))
1101 if (setup_packet.mRequestType & USB_DIR_IN)
1103 usb_status_phase(false);
1104 ep_cnfg[CTRL_ENP_OUT].complete = usb_status_handler_end;
1108 usb_status_phase(true);
1109 ep_cnfg[CTRL_ENP_IN].complete =
1110 (setup_packet.bRequest == USB_REQ_SET_ADDRESS) ?
1111 usb_add_status_handler_end :
1112 usb_status_handler_end;
1116 static void usb_endpointRead_complete(int ep)
1118 if (UNLIKELY(ep >= EP_MAX_NUM))
1123 ASSERT(!(ep & 0x01));
1125 event_do(&usb_event_done[ep >> 1]);
1126 rx_size = ep_cnfg[ep].size;
1129 ssize_t usb_endpointRead(int ep, void *buffer, ssize_t size)
1131 int ep_num = usb_ep_logical_to_hw(ep);
1132 ssize_t max_size = sizeof(ep_buffer[ep_num]);
1134 /* Non-blocking read for EP0 */
1135 if (in_atomic && (ep_num == CTRL_ENP_OUT))
1137 size = usb_size(size, usb_le16_to_cpu(setup_packet.wLength));
1138 if (UNLIKELY(size > max_size))
1140 LOG_ERR("%s: ep_buffer exceeded, try to enlarge CONFIG_USB_BUFSIZE\n",
1143 return -USB_BUF_OVERFLOW;
1146 usb_status_handler(ep_num);
1149 __usb_ep_read(ep_num, ep_buffer[ep_num], size,
1150 usb_status_handler);
1151 memcpy(buffer, ep_buffer[ep_num], size);
1155 if (UNLIKELY(!size))
1157 size = MIN(size, max_size);
1158 event_initGeneric(&usb_event_done[ep_num >> 1]);
1162 __usb_ep_read(ep_num, ep_buffer[ep_num], size,
1163 usb_endpointRead_complete);
1164 event_wait(&usb_event_done[ep_num >> 1]);
1165 memcpy(buffer, ep_buffer[ep_num], rx_size);
1170 static void usb_endpointWrite_complete(int ep)
1172 if (UNLIKELY(ep >= EP_MAX_NUM))
1179 event_do(&usb_event_done[ep >> 1]);
1180 tx_size = ep_cnfg[ep].size;
1183 ssize_t usb_endpointWrite(int ep, const void *buffer, ssize_t size)
1185 int ep_num = usb_ep_logical_to_hw(ep);
1186 ssize_t max_size = sizeof(ep_buffer[ep_num]);
1188 /* Non-blocking write for EP0 */
1189 if (in_atomic && (ep_num == CTRL_ENP_IN))
1191 size = usb_size(size, usb_le16_to_cpu(setup_packet.wLength));
1192 if (UNLIKELY(size > max_size))
1194 LOG_ERR("%s: ep_buffer exceeded, try to enlarge CONFIG_USB_BUFSIZE\n",
1197 return -USB_BUF_OVERFLOW;
1200 usb_status_handler(ep_num);
1203 memcpy(ep_buffer[ep_num], buffer, size);
1204 __usb_ep_write(ep_num, ep_buffer[ep_num], size,
1205 usb_status_handler);
1209 if (UNLIKELY(!size))
1211 size = MIN(size, max_size);
1212 event_initGeneric(&usb_event_done[ep_num >> 1]);
1215 /* Blocking write */
1216 memcpy(ep_buffer[ep_num], buffer, size);
1217 __usb_ep_write(ep_num, ep_buffer[ep_num], size,
1218 usb_endpointWrite_complete);
1219 event_wait(&usb_event_done[ep_num >> 1]);
1224 /* Global variable to handle the following non-blocking I/O operations */
1225 static uint32_t InData;
1227 /* Get device status */
1228 static int usb_send_device_status(uint16_t index)
1231 return -USB_NODEV_ERROR;
1233 InData = ((uint32_t)udc.feature) & 0xff;
1234 __usb_ep_write(CTRL_ENP_IN,
1235 (uint8_t *)&InData, sizeof(uint16_t),
1236 usb_status_handler);
1240 /* Get interface status */
1241 static int usb_send_interface_status(UNUSED_ARG(uint16_t, index))
1244 __usb_ep_write(CTRL_ENP_IN,
1245 (uint8_t *)&InData, sizeof(uint16_t),
1246 usb_status_handler);
1250 /* Get endpoint status */
1251 static int usb_send_ep_status(uint16_t index)
1253 if ((index & 0x7F) > 16)
1254 return -USB_NODEV_ERROR;
1257 usb_ep_get_stall(usb_ep_logical_to_hw(index), (bool *)&InData);
1258 __usb_ep_write(CTRL_ENP_IN,
1259 (uint8_t *)&InData, sizeof(uint16_t),
1260 usb_status_handler);
1264 /* USB setup packet: GET_STATUS request handler */
1265 static void usb_get_status_handler(void)
1267 uint16_t w_value = usb_le16_to_cpu(setup_packet.wValue);
1268 uint16_t w_index = usb_le16_to_cpu(setup_packet.wIndex);
1269 uint16_t w_length = usb_le16_to_cpu(setup_packet.wLength);
1271 /* GET_STATUS sanity checks */
1272 if (udc.state < USB_STATE_ADDRESS)
1274 LOG_WARN("%s: bad GET_STATUS request (State=%02x)\n",
1275 __func__, udc.state);
1276 ep_cnfg[CTRL_ENP_OUT].status = STALLED;
1281 LOG_WARN("%s: bad GET_STATUS request (wLength.Word=%02x)\n",
1282 __func__, w_length);
1283 ep_cnfg[CTRL_ENP_OUT].status = STALLED;
1286 if (!(setup_packet.mRequestType & USB_DIR_IN))
1288 LOG_WARN("%s: bad GET_STATUS request (mRequestType=%02x)\n",
1289 __func__, setup_packet.mRequestType);
1290 ep_cnfg[CTRL_ENP_OUT].status = STALLED;
1295 LOG_WARN("%s: bad GET_STATUS request (wValue=%02x)\n",
1297 ep_cnfg[CTRL_ENP_OUT].status = STALLED;
1301 /* Process GET_STATUS request */
1302 switch (setup_packet.mRequestType & USB_RECIP_MASK)
1304 case USB_RECIP_DEVICE:
1305 if (usb_send_device_status(w_index) < 0)
1307 LOG_WARN("%s: GET_STATUS: invalid UsbRecipientDevice\n",
1309 ep_cnfg[CTRL_ENP_OUT].status = STALLED;
1312 LOG_INFO("%s: GET_STATUS: mRequestType=%02x (UsbRecipientDevice)\n",
1313 __func__, setup_packet.mRequestType);
1315 case USB_RECIP_INTERFACE:
1316 if (usb_send_interface_status(w_index) < 0)
1318 LOG_WARN("%s: GET_STATUS: invalid UsbRecipientInterface\n",
1320 ep_cnfg[CTRL_ENP_OUT].status = STALLED;
1323 LOG_INFO("%s: GET_STATUS: mRequestType=%02x (UsbRecipientInterface)\n",
1324 __func__, setup_packet.mRequestType);
1326 case USB_RECIP_ENDPOINT:
1327 if (usb_send_ep_status(w_index) < 0)
1329 LOG_WARN("%s: GET_STATUS: invalid UsbRecipientEndpoint\n",
1331 ep_cnfg[CTRL_ENP_OUT].status = STALLED;
1334 LOG_INFO("%s: GET_STATUS: mRequestType=%02x (UsbRecipientEndpoint)\n",
1335 __func__, setup_packet.mRequestType);
1338 LOG_WARN("%s: GET_STATUS: invalid UsbRecipientEndpoint\n",
1340 ep_cnfg[CTRL_ENP_OUT].status = STALLED;
1345 static int usb_get_device_descriptor(int id)
1348 return -USB_NODEV_ERROR;
1350 usb_dev->device->bMaxPacketSize0 = USB_EP0_MAX_SIZE;
1351 __usb_ep_write(CTRL_ENP_IN, (const uint8_t *)usb_dev->device,
1352 usb_size(usb_dev->device->bLength,
1353 usb_le16_to_cpu(setup_packet.wLength)),
1354 usb_status_handler);
1359 * TODO: refactor this part to remove this temporary buffer.
1361 * It would be better to define all the USB descriptors in the right order and
1362 * send them as a contiguous buffer directly from the flash / rodata memory.
1364 #define USB_BUFSIZE (128)
1365 static uint8_t usb_cfg_buffer[USB_BUFSIZE];
1366 STATIC_ASSERT(USB_BUFSIZE < (1 << (sizeof(uint16_t) * 8)));
1368 static int usb_get_configuration_descriptor(int id)
1370 const UsbConfigDesc **config =
1371 (const UsbConfigDesc **)usb_dev->config;
1372 uint8_t *p = usb_cfg_buffer;
1375 /* TODO: support more than one configuration per device */
1376 if (UNLIKELY(id > 0))
1377 return -USB_NODEV_ERROR;
1379 for (i = 0; config[i]; i++)
1381 memcpy(p, config[i], config[i]->bLength);
1382 p += config[i]->bLength;
1384 if (UNLIKELY((p - usb_cfg_buffer) > USB_BUFSIZE))
1387 return -USB_BUF_OVERFLOW;
1390 ((UsbConfigDesc *)usb_cfg_buffer)->wTotalLength =
1391 usb_cpu_to_le16((uint16_t)(p - usb_cfg_buffer));
1392 __usb_ep_write(CTRL_ENP_IN,
1394 usb_size(p - usb_cfg_buffer,
1395 usb_le16_to_cpu(setup_packet.wLength)),
1396 usb_status_handler);
1400 static int usb_get_string_descriptor(unsigned int id)
1402 const UsbStringDesc *lang_str;
1403 unsigned int lang_id, str_id;
1404 uint16_t w_index_lo = usb_le16_to_cpu(setup_packet.wIndex) & 0x00ff;
1405 uint16_t w_index_hi = (usb_le16_to_cpu(setup_packet.wIndex) &
1408 ASSERT(usb_dev->strings != NULL);
1409 ASSERT(usb_dev->strings[0] != NULL);
1411 lang_str = usb_dev->strings[0];
1414 /* Find Language index */
1415 for (lang_id = 0; ; lang_id++)
1417 const UsbStringDesc *str =
1418 usb_dev->strings[lang_id];
1419 if (UNLIKELY(str == NULL))
1420 return -USB_NODEV_ERROR;
1421 if ((str->data[0] == w_index_lo) &&
1422 (str->data[1] == w_index_hi))
1425 /* Check buffer overflow to find string index */
1426 for (str_id = 0; str_id < id; str_id++)
1428 lang_str = usb_dev->strings[lang_id + 1 + str_id];
1429 if (lang_str == NULL)
1430 return -USB_NODEV_ERROR;
1433 __usb_ep_write(CTRL_ENP_IN,
1435 usb_size(lang_str->bLength,
1436 usb_le16_to_cpu(setup_packet.wLength)),
1437 usb_status_handler);
1441 static void usb_get_descriptor(void)
1443 uint16_t w_value_lo = usb_le16_to_cpu(setup_packet.wValue) & 0x00ff;
1444 uint16_t w_value_hi = (usb_le16_to_cpu(setup_packet.wValue) & 0xff00) >> 8;
1446 if (udc.state < USB_STATE_DEFAULT)
1448 ep_cnfg[CTRL_ENP_OUT].status = STALLED;
1454 LOG_INFO("%s: GET_DEVICE_DESCRIPTOR: id=%d, state=%d\n",
1458 if (usb_get_device_descriptor(w_value_lo) < 0)
1459 ep_cnfg[CTRL_ENP_OUT].status = STALLED;
1462 LOG_INFO("%s: GET_CONFIG_DESCRIPTOR: id=%d, state=%d\n",
1463 __func__, w_value_lo, udc.state);
1464 if (usb_get_configuration_descriptor(w_value_lo) < 0)
1465 ep_cnfg[CTRL_ENP_OUT].status = STALLED;
1468 LOG_INFO("%s: GET_STRING_DESCRIPTOR: id=%d, state=%d\n",
1469 __func__, w_value_lo, udc.state);
1470 if (usb_get_string_descriptor(w_value_lo) < 0)
1471 ep_cnfg[CTRL_ENP_OUT].status = STALLED;
1474 LOG_WARN("%s: GET_UNKNOWN_DESCRIPTOR: id=%d, state=%d\n",
1475 __func__, w_value_lo, udc.state);
1476 ep_cnfg[CTRL_ENP_OUT].status = STALLED;
1481 /* USB setup packet: class/vendor request handler */
1482 static void usb_event_handler(UsbDevice *dev)
1485 * TODO: get the appropriate usb_dev in function of the endpoint
1489 dev->event_cb(&setup_packet);
1492 /* USB setup packet: GET_DESCRIPTOR handler */
1493 static void usb_get_descriptor_handler(void)
1495 LOG_INFO("%s: GET_DESCRIPTOR: RECIP = %d\n",
1497 setup_packet.mRequestType & USB_RECIP_MASK);
1498 if ((setup_packet.mRequestType & USB_RECIP_MASK) ==
1500 usb_get_descriptor();
1502 usb_event_handler(usb_dev);
1505 /* USB setup packet: SET_ADDRESS handler */
1506 static void usb_set_address_handler(void)
1508 uint16_t w_value = usb_le16_to_cpu(setup_packet.wValue);
1509 uint16_t w_index = usb_le16_to_cpu(setup_packet.wIndex);
1510 uint16_t w_length = usb_le16_to_cpu(setup_packet.wLength);
1512 LOG_INFO("%s: SET_ADDRESS: %d\n",
1513 __func__, usb_le16_to_cpu(setup_packet.wValue));
1514 if ((udc.state >= USB_STATE_DEFAULT) &&
1515 ((setup_packet.mRequestType & USB_RECIP_MASK) ==
1516 USB_RECIP_DEVICE) &&
1517 (w_index == 0) && (w_length == 0) && (w_value < 128))
1518 usb_status_handler(CTRL_ENP_IN);
1520 ep_cnfg[CTRL_ENP_OUT].status = STALLED;
1523 /* USB setup packet: GET_CONFIGURATION handler */
1524 static void usb_get_config_handler(void)
1526 uint16_t w_value = usb_le16_to_cpu(setup_packet.wValue);
1527 uint16_t w_index = usb_le16_to_cpu(setup_packet.wIndex);
1529 LOG_INFO("%s: GET_CONFIGURATION\n", __func__);
1530 if ((udc.state >= USB_STATE_ADDRESS) &&
1531 (w_value == 0) && (w_index == 0) && (w_value == 1))
1533 InData = udc.cfg_id;
1534 __usb_ep_write(CTRL_ENP_IN, (uint8_t *)&InData, 1, usb_status_handler);
1537 ep_cnfg[CTRL_ENP_OUT].status = STALLED;
1540 static const UsbConfigDesc *usb_find_configuration(int num)
1542 const UsbConfigDesc *cfg;
1547 cfg = (const UsbConfigDesc *)usb_dev->config[i];
1550 if (cfg->bDescriptorType != USB_DT_CONFIG)
1552 if (cfg->bConfigurationValue == num)
1558 static int usb_set_config_state(uint32_t conf)
1560 const UsbConfigDesc *pCnfg;
1565 /* Find configuration descriptor */
1566 pCnfg = usb_find_configuration(conf);
1568 return -USB_NODEV_ERROR;
1570 /* Reset current configuration */
1571 usb_set_device_state(USB_STATE_ADDRESS);
1572 usb_dev->configured = false;
1575 /* Set Interface and Alternative Setting */
1577 /* Set self-powered state */
1578 if (pCnfg->bmAttributes & USB_CONFIG_ATT_SELFPOWER)
1579 udc.feature |= STM32_UDC_FEATURE_SELFPOWERED;
1581 /* Configure all existing interfaces to alternative setting 0 */
1582 ASSERT(pCnfg->bNumInterfaces <= USB_MAX_INTERFACE);
1583 udc.interfaces = pCnfg->bNumInterfaces;
1584 for (i = 0; i < udc.interfaces; i++)
1586 usb_set_device_state(USB_STATE_CONFIGURED);
1587 usb_dev->configured = true;
1588 event_do(&usb_event_done[0]);
1589 LOG_INFO("%s: device configured\n", __func__);
1593 usb_dev->configured = false;
1594 usb_set_device_state(USB_STATE_ADDRESS);
1599 /* USB setup packet: SET_CONFIGURATION handler */
1600 static void usb_set_config_handler(void)
1602 uint16_t w_value = usb_le16_to_cpu(setup_packet.wValue);
1603 uint16_t w_index = usb_le16_to_cpu(setup_packet.wIndex);
1604 uint16_t w_length = usb_le16_to_cpu(setup_packet.wLength);
1606 LOG_INFO("%s: SET_CONFIGURATION: %d\n",
1608 if ((udc.state >= USB_STATE_ADDRESS) &&
1609 (w_index == 0) && (w_length == 0) &&
1610 (usb_set_config_state(w_value & 0xff) == 0))
1611 usb_status_handler(CTRL_ENP_OUT);
1613 ep_cnfg[CTRL_ENP_OUT].status = STALLED;
1616 /* USB setup packet: standard request handler */
1617 static void usb_standard_request_handler(void)
1619 switch (setup_packet.bRequest)
1621 case USB_REQ_GET_STATUS:
1622 usb_get_status_handler();
1624 case USB_REQ_CLEAR_FEATURE:
1625 LOG_INFO("%s: bRequest=%d (CLEAR_FEATURE)\n",
1626 __func__, setup_packet.bRequest);
1628 case USB_REQ_SET_FEATURE:
1629 LOG_INFO("%s: bRequest=%d (SET_FEATURE)\n",
1630 __func__, setup_packet.bRequest);
1632 case USB_REQ_SET_ADDRESS:
1633 usb_set_address_handler();
1635 case USB_REQ_GET_DESCRIPTOR:
1636 usb_get_descriptor_handler();
1638 case USB_REQ_SET_DESCRIPTOR:
1639 LOG_INFO("%s: bRequest=%d (SET_DESCRIPTOR)\n",
1640 __func__, setup_packet.bRequest);
1642 case USB_REQ_GET_CONFIGURATION:
1643 usb_get_config_handler();
1645 case USB_REQ_SET_CONFIGURATION:
1646 usb_set_config_handler();
1648 case USB_REQ_GET_INTERFACE:
1649 LOG_INFO("%s: bRequest=%d (GET_INTERFACE)\n",
1650 __func__, setup_packet.bRequest);
1652 case USB_REQ_SET_INTERFACE:
1653 LOG_INFO("%s: bRequest=%d (SET_INTERFACE)\n",
1654 __func__, setup_packet.bRequest);
1656 case USB_REQ_SYNCH_FRAME:
1657 LOG_INFO("%s: bRequest=%d (SYNCH_FRAME)\n",
1658 __func__, setup_packet.bRequest);
1661 LOG_WARN("%s: bRequest=%d (Unknown)\n",
1662 __func__, setup_packet.bRequest);
1663 ep_cnfg[CTRL_ENP_OUT].status = STALLED;
1668 /* USB setup packet handler */
1669 static void usb_setup_handler(void)
1671 switch (setup_packet.mRequestType & USB_TYPE_MASK)
1674 case USB_TYPE_STANDARD:
1675 LOG_INFO("%s: bmRequestType=%02x (Standard)\n",
1676 __func__, setup_packet.mRequestType);
1677 usb_standard_request_handler();
1680 case USB_TYPE_CLASS:
1681 LOG_INFO("%s: bmRequestType=%02x (Class)\n",
1682 __func__, setup_packet.mRequestType);
1683 usb_event_handler(usb_dev);
1686 case USB_TYPE_VENDOR:
1687 LOG_INFO("%s: bmRequestType=%02x (Vendor)\n",
1688 __func__, setup_packet.mRequestType);
1689 usb_event_handler(usb_dev);
1691 case USB_TYPE_RESERVED:
1692 LOG_INFO("%s: bmRequestType=%02x (Reserved)\n",
1693 __func__, setup_packet.mRequestType);
1697 LOG_WARN("%s: bmRequestType=%02x (Unknown)\n",
1698 __func__, setup_packet.mRequestType);
1699 ep_cnfg[CTRL_ENP_OUT].status = STALLED;
1704 /* USB: low-level hardware initialization */
1705 static void usb_hw_reset(void)
1710 /* Initialize endpoint descriptors */
1711 for (i = 0; i < countof(ep_cnfg); i++)
1712 ep_cnfg[i].hw = NULL;
1714 /* Initialize USB memory */
1715 for (i = 0; i < countof(memory_buffer); i++)
1716 memory_buffer[i].Size = 0;
1717 usb->BTABLE = USB_BDT_OFFSET;
1720 /* Endpoint initialization */
1721 ret = usb_ep_configure(&USB_CtrlEpDescr0, true);
1722 if (UNLIKELY(ret < 0))
1724 LOG_WARN("%s: out of memory, cannot initialize EP0\n",
1728 ret = usb_ep_configure(&USB_CtrlEpDescr1, true);
1729 if (UNLIKELY(ret < 0))
1731 LOG_WARN("%s: out of memory, cannot initialize EP1\n",
1736 /* Set default address */
1739 /* Enable all the device interrupts */
1740 usb->CNTR = bmCTRM | bmRESETM | bmSOFM | bmERRM | bmPMAOVRM |
1744 /* Handle a correct transfer under ISR */
1745 static void usb_isr_correct_transfer(stm32_usb_irq_status_t interrupt)
1748 reg32_t *pReg = (reg32_t *)&usb->EP0R;
1750 /* Find corresponding EP */
1751 pReg += interrupt.EP_ID;
1752 EP = (int)(((*pReg & 0x0f) << 1) + (interrupt.DIR ? 0 : 1));
1753 ep_cnfg[EP].avail_data = 1;
1755 ASSERT(ep_cnfg[EP].hw);
1758 ep_ctrl_clr_ctr_tx(ep_cnfg[EP].hw);
1760 ep_ctrl_clr_ctr_rx(ep_cnfg[EP].hw);
1761 if (EP == CTRL_ENP_OUT)
1763 /* Determinate type of packet (only for control EP) */
1764 bool SetupPacket = ep_ctrl_get_setup(ep_cnfg[CTRL_ENP_OUT].hw);
1768 ep_cnfg[CTRL_ENP_IN].avail_data = 1;
1769 /* init IO to receive Setup packet */
1770 __usb_ep_write(CTRL_ENP_IN, NULL, -1, NULL);
1771 __usb_ep_read(CTRL_ENP_OUT, &setup_packet,
1772 sizeof(setup_packet), NULL);
1774 /* reset EP IO ctrl */
1775 if (setup_packet.mRequestType & USB_DIR_IN)
1776 usb_status_handler(CTRL_ENP_OUT);
1777 usb_setup_handler();
1778 if (ep_cnfg[CTRL_ENP_OUT].status == STALLED)
1779 usb_ep_set_stall_ctrl();
1783 if (ep_cnfg[CTRL_ENP_OUT].complete &&
1784 setup_packet.mRequestType & USB_DIR_IN)
1785 ep_cnfg[CTRL_ENP_OUT].complete(CTRL_ENP_OUT);
1790 else if (EP == CTRL_ENP_IN)
1792 if (ep_cnfg[CTRL_ENP_IN].complete &&
1793 !(setup_packet.mRequestType & USB_DIR_IN))
1794 ep_cnfg[CTRL_ENP_IN].complete(CTRL_ENP_IN);
1803 /* USB: interrupt service routine */
1804 static void usb_isr(void)
1806 stm32_usb_irq_status_t interrupt;
1808 /* Get masked interrupt flags */
1809 interrupt.status = usb->ISTR;
1810 interrupt.status &= usb->CNTR | 0x1f;
1812 /* Set the context as atomic */
1815 if (interrupt.PMAOVR)
1817 LOG_WARN("%s: DMA overrun / underrun\n", __func__);
1818 usb->ISTR = ~bmPMAOVRM;
1822 LOG_WARN("%s: engine error\n", __func__);
1823 usb->ISTR = ~bmERRM;
1825 if (interrupt.RESET)
1827 LOG_INFO("%s: device reset\n", __func__);
1828 usb->ISTR = ~bmRESETM;
1830 usb_set_device_state(USB_STATE_DEFAULT);
1836 * XXX: disable logging of frame interrupts (too much noise!)
1838 uint16_t frame_nr = usb->FNR & 0x0fff;
1839 LOG_INFO("%s: frame %#x\n", __func__, frame_nr);
1841 usb->ISTR = ~bmSOFM;
1845 LOG_INFO("%s: wake-up\n", __func__);
1846 usb->ISTR = ~(bmSUSPM | bmWKUPM);
1851 LOG_INFO("%s: suspend\n", __func__);
1853 usb->ISTR = ~(bmSUSPM | bmWKUPM);
1857 LOG_INFO("%s: expected frame\n", __func__);
1858 usb->ISTR = ~bmESOFM;
1862 usb_isr_correct_transfer(interrupt);
1867 /* USB: hardware initialization */
1868 static void usb_hw_init(void)
1870 /* Enable clocking on the required GPIO pins */
1871 RCC->APB2ENR |= RCC_APB2_GPIOA | RCC_APB2_GPIOC;
1873 /* Make sure that the CAN controller is disabled and held in reset */
1874 RCC->APB1ENR &= ~RCC_APB1_CAN;
1876 /* Configure USB_DM and USB_DP to work as USB lines */
1877 stm32_gpioPinConfig((struct stm32_gpio *)GPIOA_BASE,
1878 USB_DM_PIN | USB_DP_PIN,
1879 GPIO_MODE_AF_PP, GPIO_SPEED_50MHZ);
1880 /* Configure USB_DISC to work as USB disconnect */
1881 stm32_gpioPinConfig((struct stm32_gpio *)GPIOC_BASE,
1883 GPIO_MODE_OUT_PP, GPIO_SPEED_50MHZ);
1884 stm32_gpioPinWrite((struct stm32_gpio *)GPIOC_BASE,
1887 /* Ensure the USB clock is disabled before setting the prescaler */
1888 RCC->APB1ENR &= ~RCC_APB1_USB;
1890 /* Configure USB clock (48MHz) */
1891 *CFGR_USBPRE_BB &= ~RCC_USBCLK_PLLCLK_1DIV5;
1893 /* Activate USB clock */
1894 RCC->APB1ENR |= RCC_APB1_USB;
1896 /* Force USB reset and disable USB interrupts */
1900 /* Issue a USB reset */
1903 /* Clear spurious pending interrupt */
1906 /* Register interrupt handler */
1907 sysirq_setHandler(USB_LP_CAN_RX0_IRQHANDLER, usb_isr);
1909 /* Software connection enable */
1913 /* Initialize the USB controller */
1914 static void usb_init(void)
1916 udc.state = USB_STATE_NOTATTACHED;
1922 /* Register an upper layer USB device into the driver */
1923 int usb_deviceRegister(UsbDevice *dev)
1929 usb_dev->configured = false;
1931 event_initGeneric(&usb_event_done[0]);
1933 event_wait(&usb_event_done[0]);