jmg
/
lora-irrigation
1
0
Fork 0
Code Issues 0 Pull Requests 0 Releases 0 Wiki Activity
Implement a secure ICS protocol targeting LoRa Node151 microcontroller for controlling irrigation.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
177 Commits
4 Branches
18 MiB
 
 
 
 
 
 
Tree: a4f76dc0bb
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from 'a4f76dc0bb'
${ noResults }
lora-irrigation/stm32/f103c8t6/stm32f1xx_ll_usb.h

679 lines
26 KiB
Raw Blame History 

  1. /**

  2.   ******************************************************************************

  3.   * @file    stm32f1xx_ll_usb.h

  4.   * @author  MCD Application Team

  5.   * @brief   Header file of USB Low Layer HAL module.

  6.   ******************************************************************************

  7.   * @attention

  8.   *

  9.   * <h2><center>&copy; Copyright (c) 2016 STMicroelectronics.

  10.   * All rights reserved.</center></h2>

  11.   *

  12.   * This software component is licensed by ST under BSD 3-Clause license,

  13.   * the "License"; You may not use this file except in compliance with the

  14.   * License. You may obtain a copy of the License at:

  15.   *                        opensource.org/licenses/BSD-3-Clause

  16.   *

  17.   ******************************************************************************

  18.   */

  19. 

  20. /* Define to prevent recursive inclusion -------------------------------------*/

  21. #ifndef STM32F1xx_LL_USB_H

  22. #define STM32F1xx_LL_USB_H

  23. 

  24. #ifdef __cplusplus

  25. extern "C" {

  26. #endif

  27. 

  28. /* Includes ------------------------------------------------------------------*/

  29. #include "stm32f1xx_hal_def.h"

  30. 

  31. #if defined (USB) || defined (USB_OTG_FS)

  32. /** @addtogroup STM32F1xx_HAL_Driver

  33.   * @{

  34.   */

  35. 

  36. /** @addtogroup USB_LL

  37.   * @{

  38.   */

  39. 

  40. /* Exported types ------------------------------------------------------------*/

  41. 

  42. /**

  43.   * @brief  USB Mode definition

  44.   */

  45. #if defined (USB_OTG_FS)

  46. 

  47. typedef enum

  48. {

  49.   USB_DEVICE_MODE  = 0,

  50.   USB_HOST_MODE    = 1,

  51.   USB_DRD_MODE     = 2

  52. } USB_ModeTypeDef;

  53. 

  54. /**

  55.   * @brief  URB States definition

  56.   */

  57. typedef enum

  58. {

  59.   URB_IDLE = 0,

  60.   URB_DONE,

  61.   URB_NOTREADY,

  62.   URB_NYET,

  63.   URB_ERROR,

  64.   URB_STALL

  65. } USB_OTG_URBStateTypeDef;

  66. 

  67. /**

  68.   * @brief  Host channel States  definition

  69.   */

  70. typedef enum

  71. {

  72.   HC_IDLE = 0,

  73.   HC_XFRC,

  74.   HC_HALTED,

  75.   HC_NAK,

  76.   HC_NYET,

  77.   HC_STALL,

  78.   HC_XACTERR,

  79.   HC_BBLERR,

  80.   HC_DATATGLERR

  81. } USB_OTG_HCStateTypeDef;

  82. 

  83. /**

  84.   * @brief  USB Instance Initialization Structure definition

  85.   */

  86. typedef struct

  87. {

  88.   uint32_t dev_endpoints;           /*!< Device Endpoints number.

  89.                                          This parameter depends on the used USB core.

  90.                                          This parameter must be a number between Min_Data = 1 and Max_Data = 15 */

  91. 

  92.   uint32_t Host_channels;           /*!< Host Channels number.

  93.                                          This parameter Depends on the used USB core.

  94.                                          This parameter must be a number between Min_Data = 1 and Max_Data = 15 */

  95. 

  96.   uint32_t speed;                   /*!< USB Core speed.

  97.                                          This parameter can be any value of @ref PCD_Speed/HCD_Speed

  98.                                                                                  (HCD_SPEED_xxx, HCD_SPEED_xxx) */

  99. 

  100.   uint32_t dma_enable;              /*!< Enable or disable of the USB embedded DMA used only for OTG HS.        */

  101. 

  102.   uint32_t ep0_mps;                 /*!< Set the Endpoint 0 Max Packet size.                                    */

  103. 

  104.   uint32_t phy_itface;              /*!< Select the used PHY interface.

  105.                                          This parameter can be any value of @ref PCD_PHY_Module/HCD_PHY_Module  */

  106. 

  107.   uint32_t Sof_enable;              /*!< Enable or disable the output of the SOF signal.                        */

  108. 

  109.   uint32_t low_power_enable;        /*!< Enable or disable the low power mode.                                  */

  110. 

  111.   uint32_t lpm_enable;              /*!< Enable or disable Link Power Management.                               */

  112. 

  113.   uint32_t battery_charging_enable; /*!< Enable or disable Battery charging.                                    */

  114. 

  115.   uint32_t vbus_sensing_enable;     /*!< Enable or disable the VBUS Sensing feature.                            */

  116. 

  117.   uint32_t use_dedicated_ep1;       /*!< Enable or disable the use of the dedicated EP1 interrupt.              */

  118. 

  119.   uint32_t use_external_vbus;       /*!< Enable or disable the use of the external VBUS.                        */

  120. 

  121. } USB_OTG_CfgTypeDef;

  122. 

  123. typedef struct

  124. {

  125.   uint8_t   num;                  /*!< Endpoint number

  126.                                        This parameter must be a number between Min_Data = 1 and Max_Data = 15   */

  127. 

  128.   uint8_t   is_in;                /*!< Endpoint direction

  129.                                        This parameter must be a number between Min_Data = 0 and Max_Data = 1    */

  130. 

  131.   uint8_t   is_stall;             /*!< Endpoint stall condition

  132.                                        This parameter must be a number between Min_Data = 0 and Max_Data = 1    */

  133. 

  134.   uint8_t   type;                 /*!< Endpoint type

  135.                                        This parameter can be any value of @ref USB_LL_EP_Type                   */

  136. 

  137.   uint8_t   data_pid_start;       /*!< Initial data PID

  138.                                        This parameter must be a number between Min_Data = 0 and Max_Data = 1    */

  139. 

  140.   uint8_t   even_odd_frame;       /*!< IFrame parity

  141.                                        This parameter must be a number between Min_Data = 0 and Max_Data = 1    */

  142. 

  143.   uint16_t  tx_fifo_num;          /*!< Transmission FIFO number

  144.                                        This parameter must be a number between Min_Data = 1 and Max_Data = 15   */

  145. 

  146.   uint32_t  maxpacket;            /*!< Endpoint Max packet size

  147.                                        This parameter must be a number between Min_Data = 0 and Max_Data = 64KB */

  148. 

  149.   uint8_t   *xfer_buff;           /*!< Pointer to transfer buffer                                               */

  150. 

  151.   uint32_t  dma_addr;             /*!< 32 bits aligned transfer buffer address                                  */

  152. 

  153.   uint32_t  xfer_len;             /*!< Current transfer length                                                  */

  154. 

  155.   uint32_t  xfer_count;           /*!< Partial transfer length in case of multi packet transfer                 */

  156. } USB_OTG_EPTypeDef;

  157. 

  158. typedef struct

  159. {

  160.   uint8_t   dev_addr;           /*!< USB device address.

  161.                                      This parameter must be a number between Min_Data = 1 and Max_Data = 255    */

  162. 

  163.   uint8_t   ch_num;             /*!< Host channel number.

  164.                                      This parameter must be a number between Min_Data = 1 and Max_Data = 15     */

  165. 

  166.   uint8_t   ep_num;             /*!< Endpoint number.

  167.                                      This parameter must be a number between Min_Data = 1 and Max_Data = 15     */

  168. 

  169.   uint8_t   ep_is_in;           /*!< Endpoint direction

  170.                                      This parameter must be a number between Min_Data = 0 and Max_Data = 1      */

  171. 

  172.   uint8_t   speed;              /*!< USB Host Channel speed.

  173.                                      This parameter can be any value of @ref HCD_Device_Speed:

  174.                                                                              (HCD_DEVICE_SPEED_xxx)             */

  175. 

  176.   uint8_t   do_ping;            /*!< Enable or disable the use of the PING protocol for HS mode.                */

  177. 

  178.   uint8_t   process_ping;       /*!< Execute the PING protocol for HS mode.                                     */

  179. 

  180.   uint8_t   ep_type;            /*!< Endpoint Type.

  181.                                      This parameter can be any value of @ref USB_LL_EP_Type                     */

  182. 

  183.   uint16_t  max_packet;         /*!< Endpoint Max packet size.

  184.                                      This parameter must be a number between Min_Data = 0 and Max_Data = 64KB   */

  185. 

  186.   uint8_t   data_pid;           /*!< Initial data PID.

  187.                                      This parameter must be a number between Min_Data = 0 and Max_Data = 1      */

  188. 

  189.   uint8_t   *xfer_buff;         /*!< Pointer to transfer buffer.                                                */

  190. 

  191.   uint32_t  XferSize;             /*!< OTG Channel transfer size.                                                   */

  192. 

  193.   uint32_t  xfer_len;           /*!< Current transfer length.                                                   */

  194. 

  195.   uint32_t  xfer_count;         /*!< Partial transfer length in case of multi packet transfer.                  */

  196. 

  197.   uint8_t   toggle_in;          /*!< IN transfer current toggle flag.

  198.                                      This parameter must be a number between Min_Data = 0 and Max_Data = 1      */

  199. 

  200.   uint8_t   toggle_out;         /*!< OUT transfer current toggle flag

  201.                                      This parameter must be a number between Min_Data = 0 and Max_Data = 1      */

  202. 

  203.   uint32_t  dma_addr;           /*!< 32 bits aligned transfer buffer address.                                   */

  204. 

  205.   uint32_t  ErrCnt;             /*!< Host channel error count.                                                  */

  206. 

  207.   USB_OTG_URBStateTypeDef urb_state;  /*!< URB state.

  208.                                             This parameter can be any value of @ref USB_OTG_URBStateTypeDef */

  209. 

  210.   USB_OTG_HCStateTypeDef state;       /*!< Host Channel state.

  211.                                             This parameter can be any value of @ref USB_OTG_HCStateTypeDef  */

  212. } USB_OTG_HCTypeDef;

  213. #endif /* defined (USB_OTG_FS) */

  214. 

  215. #if defined (USB)

  216. 

  217. typedef enum

  218. {

  219.   USB_DEVICE_MODE  = 0

  220. } USB_ModeTypeDef;

  221. 

  222. /**

  223.   * @brief  USB Initialization Structure definition

  224.   */

  225. typedef struct

  226. {

  227.   uint32_t dev_endpoints;           /*!< Device Endpoints number.

  228.                                          This parameter depends on the used USB core.

  229.                                          This parameter must be a number between Min_Data = 1 and Max_Data = 15 */

  230. 

  231.   uint32_t speed;                   /*!< USB Core speed.

  232.                                          This parameter can be any value of @ref PCD_Speed/HCD_Speed

  233.                                                                                  (HCD_SPEED_xxx, HCD_SPEED_xxx) */

  234. 

  235.   uint32_t ep0_mps;                 /*!< Set the Endpoint 0 Max Packet size.                                    */

  236. 

  237.   uint32_t phy_itface;              /*!< Select the used PHY interface.

  238.                                          This parameter can be any value of @ref PCD_PHY_Module/HCD_PHY_Module  */

  239. 

  240.   uint32_t Sof_enable;              /*!< Enable or disable the output of the SOF signal.                        */

  241. 

  242.   uint32_t low_power_enable;        /*!< Enable or disable Low Power mode                                       */

  243. 

  244.   uint32_t lpm_enable;              /*!< Enable or disable Battery charging.                                    */

  245. 

  246.   uint32_t battery_charging_enable; /*!< Enable or disable Battery charging.                                    */

  247. } USB_CfgTypeDef;

  248. 

  249. typedef struct

  250. {

  251.   uint8_t   num;             /*!< Endpoint number

  252.                                   This parameter must be a number between Min_Data = 1 and Max_Data = 15    */

  253. 

  254.   uint8_t   is_in;           /*!< Endpoint direction

  255.                                   This parameter must be a number between Min_Data = 0 and Max_Data = 1     */

  256. 

  257.   uint8_t   is_stall;        /*!< Endpoint stall condition

  258.                                   This parameter must be a number between Min_Data = 0 and Max_Data = 1     */

  259. 

  260.   uint8_t   type;            /*!< Endpoint type

  261.                                   This parameter can be any value of @ref USB_EP_Type                       */

  262. 

  263.   uint8_t   data_pid_start;  /*!< Initial data PID

  264.                                   This parameter must be a number between Min_Data = 0 and Max_Data = 1     */

  265. 

  266.   uint16_t  pmaadress;       /*!< PMA Address

  267.                                   This parameter can be any value between Min_addr = 0 and Max_addr = 1K    */

  268. 

  269.   uint16_t  pmaaddr0;        /*!< PMA Address0

  270.                                   This parameter can be any value between Min_addr = 0 and Max_addr = 1K    */

  271. 

  272.   uint16_t  pmaaddr1;        /*!< PMA Address1

  273.                                   This parameter can be any value between Min_addr = 0 and Max_addr = 1K    */

  274. 

  275.   uint8_t   doublebuffer;    /*!< Double buffer enable

  276.                                   This parameter can be 0 or 1                                              */

  277. 

  278.   uint16_t  tx_fifo_num;     /*!< This parameter is not required by USB Device FS peripheral, it is used

  279.                                   only by USB OTG FS peripheral

  280.                                   This parameter is added to ensure compatibility across USB peripherals    */

  281. 

  282.   uint32_t  maxpacket;       /*!< Endpoint Max packet size

  283.                                   This parameter must be a number between Min_Data = 0 and Max_Data = 64KB  */

  284. 

  285.   uint8_t   *xfer_buff;      /*!< Pointer to transfer buffer                                                */

  286. 

  287.   uint32_t  xfer_len;        /*!< Current transfer length                                                   */

  288. 

  289.   uint32_t  xfer_count;      /*!< Partial transfer length in case of multi packet transfer                  */

  290. 

  291.   uint32_t  xfer_len_db;      /*!< double buffer transfer length used with bulk double buffer in           */

  292. 

  293.   uint8_t   xfer_fill_db;     /*!< double buffer Need to Fill new buffer  used with bulk_in                */

  294. 

  295. } USB_EPTypeDef;

  296. #endif /* defined (USB) */

  297. 

  298. /* Exported constants --------------------------------------------------------*/

  299. 

  300. /** @defgroup PCD_Exported_Constants PCD Exported Constants

  301.   * @{

  302.   */

  303. 

  304. #if defined (USB_OTG_FS)

  305. /** @defgroup USB_OTG_CORE VERSION ID

  306.   * @{

  307.   */

  308. #define USB_OTG_CORE_ID_300A          0x4F54300AU

  309. #define USB_OTG_CORE_ID_310A          0x4F54310AU

  310. /**

  311.   * @}

  312.   */

  313. 

  314. /** @defgroup USB_Core_Mode_ USB Core Mode

  315.   * @{

  316.   */

  317. #define USB_OTG_MODE_DEVICE                    0U

  318. #define USB_OTG_MODE_HOST                      1U

  319. #define USB_OTG_MODE_DRD                       2U

  320. /**

  321.   * @}

  322.   */

  323. 

  324. /** @defgroup USB_LL Device Speed

  325.   * @{

  326.   */

  327. #define USBD_FS_SPEED                          2U

  328. #define USBH_FSLS_SPEED                        1U

  329. /**

  330.   * @}

  331.   */

  332. 

  333. /** @defgroup USB_LL_Core_Speed USB Low Layer Core Speed

  334.   * @{

  335.   */

  336. #define USB_OTG_SPEED_FULL                     3U

  337. /**

  338.   * @}

  339.   */

  340. 

  341. /** @defgroup USB_LL_Core_PHY USB Low Layer Core PHY

  342.   * @{

  343.   */

  344. #define USB_OTG_ULPI_PHY                       1U

  345. #define USB_OTG_EMBEDDED_PHY                   2U

  346. /**

  347.   * @}

  348.   */

  349. 

  350. /** @defgroup USB_LL_Turnaround_Timeout Turnaround Timeout Value

  351.   * @{

  352.   */

  353. #ifndef USBD_FS_TRDT_VALUE

  354. #define USBD_FS_TRDT_VALUE                     5U

  355. #define USBD_DEFAULT_TRDT_VALUE                9U

  356. #endif /* USBD_HS_TRDT_VALUE */

  357. /**

  358.   * @}

  359.   */

  360. 

  361. /** @defgroup USB_LL_Core_MPS USB Low Layer Core MPS

  362.   * @{

  363.   */

  364. #define USB_OTG_FS_MAX_PACKET_SIZE            64U

  365. #define USB_OTG_MAX_EP0_SIZE                  64U

  366. /**

  367.   * @}

  368.   */

  369. 

  370. /** @defgroup USB_LL_Core_PHY_Frequency USB Low Layer Core PHY Frequency

  371.   * @{

  372.   */

  373. #define DSTS_ENUMSPD_HS_PHY_30MHZ_OR_60MHZ     (0U << 1)

  374. #define DSTS_ENUMSPD_FS_PHY_30MHZ_OR_60MHZ     (1U << 1)

  375. #define DSTS_ENUMSPD_FS_PHY_48MHZ              (3U << 1)

  376. /**

  377.   * @}

  378.   */

  379. 

  380. /** @defgroup USB_LL_CORE_Frame_Interval USB Low Layer Core Frame Interval

  381.   * @{

  382.   */

  383. #define DCFG_FRAME_INTERVAL_80                 0U

  384. #define DCFG_FRAME_INTERVAL_85                 1U

  385. #define DCFG_FRAME_INTERVAL_90                 2U

  386. #define DCFG_FRAME_INTERVAL_95                 3U

  387. /**

  388.   * @}

  389.   */

  390. 

  391. /** @defgroup USB_LL_EP0_MPS USB Low Layer EP0 MPS

  392.   * @{

  393.   */

  394. #define EP_MPS_64                        0U

  395. #define EP_MPS_32                        1U

  396. #define EP_MPS_16                        2U

  397. #define EP_MPS_8                         3U

  398. /**

  399.   * @}

  400.   */

  401. 

  402. /** @defgroup USB_LL_EP_Speed USB Low Layer EP Speed

  403.   * @{

  404.   */

  405. #define EP_SPEED_LOW                           0U

  406. #define EP_SPEED_FULL                          1U

  407. #define EP_SPEED_HIGH                          2U

  408. /**

  409.   * @}

  410.   */

  411. 

  412. /** @defgroup USB_LL_EP_Type USB Low Layer EP Type

  413.   * @{

  414.   */

  415. #define EP_TYPE_CTRL                           0U

  416. #define EP_TYPE_ISOC                           1U

  417. #define EP_TYPE_BULK                           2U

  418. #define EP_TYPE_INTR                           3U

  419. #define EP_TYPE_MSK                            3U

  420. /**

  421.   * @}

  422.   */

  423. 

  424. /** @defgroup USB_LL_STS_Defines USB Low Layer STS Defines

  425.   * @{

  426.   */

  427. #define STS_GOUT_NAK                           1U

  428. #define STS_DATA_UPDT                          2U

  429. #define STS_XFER_COMP                          3U

  430. #define STS_SETUP_COMP                         4U

  431. #define STS_SETUP_UPDT                         6U

  432. /**

  433.   * @}

  434.   */

  435. 

  436. /** @defgroup USB_LL_HCFG_SPEED_Defines USB Low Layer HCFG Speed Defines

  437.   * @{

  438.   */

  439. #define HCFG_30_60_MHZ                         0U

  440. #define HCFG_48_MHZ                            1U

  441. #define HCFG_6_MHZ                             2U

  442. /**

  443.   * @}

  444.   */

  445. 

  446. /** @defgroup USB_LL_HPRT0_PRTSPD_SPEED_Defines USB Low Layer HPRT0 PRTSPD Speed Defines

  447.   * @{

  448.   */

  449. #define HPRT0_PRTSPD_HIGH_SPEED                0U

  450. #define HPRT0_PRTSPD_FULL_SPEED                1U

  451. #define HPRT0_PRTSPD_LOW_SPEED                 2U

  452. /**

  453.   * @}

  454.   */

  455. 

  456. #define HCCHAR_CTRL                            0U

  457. #define HCCHAR_ISOC                            1U

  458. #define HCCHAR_BULK                            2U

  459. #define HCCHAR_INTR                            3U

  460. 

  461. #define HC_PID_DATA0                           0U

  462. #define HC_PID_DATA2                           1U

  463. #define HC_PID_DATA1                           2U

  464. #define HC_PID_SETUP                           3U

  465. 

  466. #define GRXSTS_PKTSTS_IN                       2U

  467. #define GRXSTS_PKTSTS_IN_XFER_COMP             3U

  468. #define GRXSTS_PKTSTS_DATA_TOGGLE_ERR          5U

  469. #define GRXSTS_PKTSTS_CH_HALTED                7U

  470. 

  471. #define USBx_PCGCCTL    *(__IO uint32_t *)((uint32_t)USBx_BASE + USB_OTG_PCGCCTL_BASE)

  472. #define USBx_HPRT0      *(__IO uint32_t *)((uint32_t)USBx_BASE + USB_OTG_HOST_PORT_BASE)

  473. 

  474. #define USBx_DEVICE     ((USB_OTG_DeviceTypeDef *)(USBx_BASE + USB_OTG_DEVICE_BASE))

  475. #define USBx_INEP(i)    ((USB_OTG_INEndpointTypeDef *)(USBx_BASE\

  476.                                                        + USB_OTG_IN_ENDPOINT_BASE + ((i) * USB_OTG_EP_REG_SIZE)))

  477. 

  478. #define USBx_OUTEP(i)   ((USB_OTG_OUTEndpointTypeDef *)(USBx_BASE\

  479.                                                         + USB_OTG_OUT_ENDPOINT_BASE + ((i) * USB_OTG_EP_REG_SIZE)))

  480. 

  481. #define USBx_DFIFO(i)   *(__IO uint32_t *)(USBx_BASE + USB_OTG_FIFO_BASE + ((i) * USB_OTG_FIFO_SIZE))

  482. 

  483. #define USBx_HOST       ((USB_OTG_HostTypeDef *)(USBx_BASE + USB_OTG_HOST_BASE))

  484. #define USBx_HC(i)      ((USB_OTG_HostChannelTypeDef *)(USBx_BASE\

  485.                                                         + USB_OTG_HOST_CHANNEL_BASE\

  486.                                                         + ((i) * USB_OTG_HOST_CHANNEL_SIZE)))

  487. 

  488. #endif /* defined (USB_OTG_FS) */

  489. 

  490. #if defined (USB)

  491. /** @defgroup USB_LL_EP0_MPS USB Low Layer EP0 MPS

  492.   * @{

  493.   */

  494. #define EP_MPS_64                              0U

  495. #define EP_MPS_32                              1U

  496. #define EP_MPS_16                              2U

  497. #define EP_MPS_8                               3U

  498. /**

  499.   * @}

  500.   */

  501. 

  502. /** @defgroup USB_LL_EP_Type USB Low Layer EP Type

  503.   * @{

  504.   */

  505. #define EP_TYPE_CTRL                           0U

  506. #define EP_TYPE_ISOC                           1U

  507. #define EP_TYPE_BULK                           2U

  508. #define EP_TYPE_INTR                           3U

  509. #define EP_TYPE_MSK                            3U

  510. /**

  511.   * @}

  512.   */

  513. 

  514. /** @defgroup USB_LL Device Speed

  515.   * @{

  516.   */

  517. #define USBD_FS_SPEED                          2U

  518. /**

  519.   * @}

  520.   */

  521. 

  522. #define BTABLE_ADDRESS                         0x000U

  523. #define PMA_ACCESS                             2U

  524. #endif /* defined (USB) */

  525. #if defined (USB_OTG_FS)

  526. #define EP_ADDR_MSK                            0xFU

  527. #endif /* defined (USB_OTG_FS) */

  528. #if defined (USB)

  529. #define EP_ADDR_MSK                            0x7U

  530. #endif /* defined (USB) */

  531. /**

  532.   * @}

  533.   */

  534. 

  535. /* Exported macro ------------------------------------------------------------*/

  536. /** @defgroup USB_LL_Exported_Macros USB Low Layer Exported Macros

  537.   * @{

  538.   */

  539. #if defined (USB_OTG_FS)

  540. #define USB_MASK_INTERRUPT(__INSTANCE__, __INTERRUPT__)     ((__INSTANCE__)->GINTMSK &= ~(__INTERRUPT__))

  541. #define USB_UNMASK_INTERRUPT(__INSTANCE__, __INTERRUPT__)   ((__INSTANCE__)->GINTMSK |= (__INTERRUPT__))

  542. 

  543. #define CLEAR_IN_EP_INTR(__EPNUM__, __INTERRUPT__)          (USBx_INEP(__EPNUM__)->DIEPINT = (__INTERRUPT__))

  544. #define CLEAR_OUT_EP_INTR(__EPNUM__, __INTERRUPT__)         (USBx_OUTEP(__EPNUM__)->DOEPINT = (__INTERRUPT__))

  545. #endif /* defined (USB_OTG_FS) */

  546. /**

  547.   * @}

  548.   */

  549. 

  550. /* Exported functions --------------------------------------------------------*/

  551. /** @addtogroup USB_LL_Exported_Functions USB Low Layer Exported Functions

  552.   * @{

  553.   */

  554. #if defined (USB_OTG_FS)

  555. HAL_StatusTypeDef USB_CoreInit(USB_OTG_GlobalTypeDef *USBx, USB_OTG_CfgTypeDef cfg);

  556. HAL_StatusTypeDef USB_DevInit(USB_OTG_GlobalTypeDef *USBx, USB_OTG_CfgTypeDef cfg);

  557. HAL_StatusTypeDef USB_EnableGlobalInt(USB_OTG_GlobalTypeDef *USBx);

  558. HAL_StatusTypeDef USB_DisableGlobalInt(USB_OTG_GlobalTypeDef *USBx);

  559. HAL_StatusTypeDef USB_SetTurnaroundTime(USB_OTG_GlobalTypeDef *USBx, uint32_t hclk, uint8_t speed);

  560. HAL_StatusTypeDef USB_SetCurrentMode(USB_OTG_GlobalTypeDef *USBx, USB_ModeTypeDef mode);

  561. HAL_StatusTypeDef USB_SetDevSpeed(USB_OTG_GlobalTypeDef *USBx, uint8_t speed);

  562. HAL_StatusTypeDef USB_FlushRxFifo(USB_OTG_GlobalTypeDef *USBx);

  563. HAL_StatusTypeDef USB_FlushTxFifo(USB_OTG_GlobalTypeDef *USBx, uint32_t num);

  564. HAL_StatusTypeDef USB_ActivateEndpoint(USB_OTG_GlobalTypeDef *USBx, USB_OTG_EPTypeDef *ep);

  565. HAL_StatusTypeDef USB_DeactivateEndpoint(USB_OTG_GlobalTypeDef *USBx, USB_OTG_EPTypeDef *ep);

  566. HAL_StatusTypeDef USB_ActivateDedicatedEndpoint(USB_OTG_GlobalTypeDef *USBx, USB_OTG_EPTypeDef *ep);

  567. HAL_StatusTypeDef USB_DeactivateDedicatedEndpoint(USB_OTG_GlobalTypeDef *USBx, USB_OTG_EPTypeDef *ep);

  568. HAL_StatusTypeDef USB_EPStartXfer(USB_OTG_GlobalTypeDef *USBx, USB_OTG_EPTypeDef *ep);

  569. HAL_StatusTypeDef USB_EP0StartXfer(USB_OTG_GlobalTypeDef *USBx, USB_OTG_EPTypeDef *ep);

  570. HAL_StatusTypeDef USB_WritePacket(USB_OTG_GlobalTypeDef *USBx, uint8_t *src,

  571.                                   uint8_t ch_ep_num, uint16_t len);

  572. 

  573. void             *USB_ReadPacket(USB_OTG_GlobalTypeDef *USBx, uint8_t *dest, uint16_t len);

  574. HAL_StatusTypeDef USB_EPSetStall(USB_OTG_GlobalTypeDef *USBx, USB_OTG_EPTypeDef *ep);

  575. HAL_StatusTypeDef USB_EPClearStall(USB_OTG_GlobalTypeDef *USBx, USB_OTG_EPTypeDef *ep);

  576. HAL_StatusTypeDef USB_SetDevAddress(USB_OTG_GlobalTypeDef *USBx, uint8_t address);

  577. HAL_StatusTypeDef USB_DevConnect(USB_OTG_GlobalTypeDef *USBx);

  578. HAL_StatusTypeDef USB_DevDisconnect(USB_OTG_GlobalTypeDef *USBx);

  579. HAL_StatusTypeDef USB_StopDevice(USB_OTG_GlobalTypeDef *USBx);

  580. HAL_StatusTypeDef USB_ActivateSetup(USB_OTG_GlobalTypeDef *USBx);

  581. HAL_StatusTypeDef USB_EP0_OutStart(USB_OTG_GlobalTypeDef *USBx, uint8_t *psetup);

  582. uint8_t           USB_GetDevSpeed(USB_OTG_GlobalTypeDef *USBx);

  583. uint32_t          USB_GetMode(USB_OTG_GlobalTypeDef *USBx);

  584. uint32_t          USB_ReadInterrupts(USB_OTG_GlobalTypeDef *USBx);

  585. uint32_t          USB_ReadDevAllOutEpInterrupt(USB_OTG_GlobalTypeDef *USBx);

  586. uint32_t          USB_ReadDevOutEPInterrupt(USB_OTG_GlobalTypeDef *USBx, uint8_t epnum);

  587. uint32_t          USB_ReadDevAllInEpInterrupt(USB_OTG_GlobalTypeDef *USBx);

  588. uint32_t          USB_ReadDevInEPInterrupt(USB_OTG_GlobalTypeDef *USBx, uint8_t epnum);

  589. void              USB_ClearInterrupts(USB_OTG_GlobalTypeDef *USBx, uint32_t interrupt);

  590. 

  591. HAL_StatusTypeDef USB_HostInit(USB_OTG_GlobalTypeDef *USBx, USB_OTG_CfgTypeDef cfg);

  592. HAL_StatusTypeDef USB_InitFSLSPClkSel(USB_OTG_GlobalTypeDef *USBx, uint8_t freq);

  593. HAL_StatusTypeDef USB_ResetPort(USB_OTG_GlobalTypeDef *USBx);

  594. HAL_StatusTypeDef USB_DriveVbus(USB_OTG_GlobalTypeDef *USBx, uint8_t state);

  595. uint32_t          USB_GetHostSpeed(USB_OTG_GlobalTypeDef *USBx);

  596. uint32_t          USB_GetCurrentFrame(USB_OTG_GlobalTypeDef *USBx);

  597. HAL_StatusTypeDef USB_HC_Init(USB_OTG_GlobalTypeDef *USBx, uint8_t ch_num,

  598.                               uint8_t epnum, uint8_t dev_address, uint8_t speed,

  599.                               uint8_t ep_type, uint16_t mps);

  600. HAL_StatusTypeDef USB_HC_StartXfer(USB_OTG_GlobalTypeDef *USBx,

  601.                                    USB_OTG_HCTypeDef *hc);

  602. 

  603. uint32_t          USB_HC_ReadInterrupt(USB_OTG_GlobalTypeDef *USBx);

  604. HAL_StatusTypeDef USB_HC_Halt(USB_OTG_GlobalTypeDef *USBx, uint8_t hc_num);

  605. HAL_StatusTypeDef USB_DoPing(USB_OTG_GlobalTypeDef *USBx, uint8_t ch_num);

  606. HAL_StatusTypeDef USB_StopHost(USB_OTG_GlobalTypeDef *USBx);

  607. HAL_StatusTypeDef USB_ActivateRemoteWakeup(USB_OTG_GlobalTypeDef *USBx);

  608. HAL_StatusTypeDef USB_DeActivateRemoteWakeup(USB_OTG_GlobalTypeDef *USBx);

  609. #endif /* defined (USB_OTG_FS) */

  610. 

  611. #if defined (USB)

  612. HAL_StatusTypeDef USB_CoreInit(USB_TypeDef *USBx, USB_CfgTypeDef cfg);

  613. HAL_StatusTypeDef USB_DevInit(USB_TypeDef *USBx, USB_CfgTypeDef cfg);

  614. HAL_StatusTypeDef USB_EnableGlobalInt(USB_TypeDef *USBx);

  615. HAL_StatusTypeDef USB_DisableGlobalInt(USB_TypeDef *USBx);

  616. HAL_StatusTypeDef USB_SetCurrentMode(USB_TypeDef *USBx, USB_ModeTypeDef mode);

  617. HAL_StatusTypeDef USB_SetDevSpeed(USB_TypeDef *USBx, uint8_t speed);

  618. HAL_StatusTypeDef USB_FlushRxFifo(USB_TypeDef *USBx);

  619. HAL_StatusTypeDef USB_FlushTxFifo(USB_TypeDef *USBx, uint32_t num);

  620. 

  621. #if defined (HAL_PCD_MODULE_ENABLED)

  622. HAL_StatusTypeDef USB_ActivateEndpoint(USB_TypeDef *USBx, USB_EPTypeDef *ep);

  623. HAL_StatusTypeDef USB_DeactivateEndpoint(USB_TypeDef *USBx, USB_EPTypeDef *ep);

  624. HAL_StatusTypeDef USB_EPStartXfer(USB_TypeDef *USBx, USB_EPTypeDef *ep);

  625. HAL_StatusTypeDef USB_EPSetStall(USB_TypeDef *USBx, USB_EPTypeDef *ep);

  626. HAL_StatusTypeDef USB_EPClearStall(USB_TypeDef *USBx, USB_EPTypeDef *ep);

  627. #endif

  628. 

  629. HAL_StatusTypeDef USB_SetDevAddress(USB_TypeDef *USBx, uint8_t address);

  630. HAL_StatusTypeDef USB_DevConnect(USB_TypeDef *USBx);

  631. HAL_StatusTypeDef USB_DevDisconnect(USB_TypeDef *USBx);

  632. HAL_StatusTypeDef USB_StopDevice(USB_TypeDef *USBx);

  633. HAL_StatusTypeDef USB_EP0_OutStart(USB_TypeDef *USBx, uint8_t *psetup);

  634. HAL_StatusTypeDef USB_WritePacket(USB_TypeDef *USBx, uint8_t *src,

  635.                                   uint8_t ch_ep_num, uint16_t len);

  636. 

  637. void             *USB_ReadPacket(USB_TypeDef *USBx, uint8_t *dest, uint16_t len);

  638. 

  639. uint32_t          USB_ReadInterrupts(USB_TypeDef *USBx);

  640. uint32_t          USB_ReadDevAllOutEpInterrupt(USB_TypeDef *USBx);

  641. uint32_t          USB_ReadDevOutEPInterrupt(USB_TypeDef *USBx, uint8_t epnum);

  642. uint32_t          USB_ReadDevAllInEpInterrupt(USB_TypeDef *USBx);

  643. uint32_t          USB_ReadDevInEPInterrupt(USB_TypeDef *USBx, uint8_t epnum);

  644. void              USB_ClearInterrupts(USB_TypeDef *USBx, uint32_t interrupt);

  645. HAL_StatusTypeDef USB_ActivateRemoteWakeup(USB_TypeDef *USBx);

  646. HAL_StatusTypeDef USB_DeActivateRemoteWakeup(USB_TypeDef *USBx);

  647. 

  648. void              USB_WritePMA(USB_TypeDef *USBx, uint8_t *pbUsrBuf,

  649.                                uint16_t wPMABufAddr, uint16_t wNBytes);

  650. 

  651. void              USB_ReadPMA(USB_TypeDef *USBx, uint8_t *pbUsrBuf,

  652.                               uint16_t wPMABufAddr, uint16_t wNBytes);

  653. #endif /* defined (USB) */

  654. /**

  655.   * @}

  656.   */

  657. 

  658. /**

  659.   * @}

  660.   */

  661. 

  662. /**

  663.   * @}

  664.   */

  665. 

  666. /**

  667.   * @}

  668.   */

  669. #endif /* defined (USB) || defined (USB_OTG_FS) */

  670. 

  671. #ifdef __cplusplus

  672. }

  673. #endif

  674. 

  675. 

  676. #endif /* STM32F1xx_LL_USB_H */

  677. 

  678. /************************ (C) COPYRIGHT STMicroelectronics *****END OF FILE****/