1 /* ---------------------------------------------------------------------------- 2 * Copyright (c) Huawei Technologies Co., Ltd. 2021-2021. All rights reserved. 3 * Description: LiteOS USB Driver Generic EP0 Data Stream HeadFile 4 * Author: Yannik Li 5 * Create: 2021-02-21 6 * Redistribution and use in source and binary forms, with or without modification, 7 * are permitted provided that the following conditions are met: 8 * 1. Redistributions of source code must retain the above copyright notice, this list of 9 * conditions and the following disclaimer. 10 * 2. Redistributions in binary form must reproduce the above copyright notice, this list 11 * of conditions and the following disclaimer in the documentation and/or other materials 12 * provided with the distribution. 13 * 3. Neither the name of the copyright holder nor the names of its contributors may be used 14 * to endorse or promote products derived from this software without specific prior written 15 * permission. 16 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 17 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, 18 * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 19 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR 20 * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, 21 * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, 22 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; 23 * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, 24 * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR 25 * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF 26 * ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 27 * --------------------------------------------------------------------------- */ 28 /* ---------------------------------------------------------------------------- 29 * Notice of Export Control Law 30 * =============================================== 31 * Huawei LiteOS may be subject to applicable export control laws and regulations, which might 32 * include those applicable to Huawei LiteOS of U.S. and the country in which you are located. 33 * Import, export and usage of Huawei LiteOS in any manner by you shall be in compliance with such 34 * applicable export control laws and regulations. 35 * --------------------------------------------------------------------------- */ 36 37 #ifndef LITEOS_USB_DEVICE_GENERIC_EP0_H 38 #define LITEOS_USB_DEVICE_GENERIC_EP0_H 39 40 #include "f_generic.h" 41 42 #ifdef __cplusplus 43 #if __cplusplus 44 //extern "C" { 45 #endif /* __cplusplus */ 46 #endif /* __cplusplus */ 47 48 enum { 49 GENERIC_DESCRIPTORS_MAGIC = 1, 50 GENERIC_STRINGS_MAGIC = 2, 51 }; 52 53 enum generic_flags { 54 GENERIC_HAS_FS_DESC = 1, 55 GENERIC_HAS_HS_DESC = 2, 56 GENERIC_HAS_SS_DESC = 4, 57 GENERIC_ALL_CTRL_RECIP = 8, 58 }; 59 60 struct generic_descs_head { 61 uint32_t magic; 62 uint32_t length; 63 uint32_t flags; 64 } __attribute__((packed)); 65 66 struct generic_strings_head { 67 uint32_t magic; 68 uint32_t length; 69 uint32_t str_count; 70 uint32_t lang_count; 71 } __attribute__((packed)); 72 73 struct ep0_io_data 74 { 75 uint32_t buf; 76 int32_t result; 77 uint32_t xfrd; 78 uint32_t len; 79 }; 80 81 struct ep0_io_data_ret 82 { 83 uint32_t buf; 84 uint32_t actual; 85 int status; 86 }; 87 88 struct ep0_request 89 { 90 struct list_head entry; 91 struct ep0_io_data io_data; 92 void *priv; 93 uint32_t user_buf; 94 }; 95 96 extern int generic_create_ep0(struct generic_dev_s *dev); 97 extern int generic_remove_ep0(struct generic_dev_s *dev); 98 99 #ifdef __cplusplus 100 #if __cplusplus 101 //} 102 #endif /* __cplusplus */ 103 #endif /* __cplusplus */ 104 105 #endif /* LITEOS_USB_DEVICE_GENERIC_EP0_H */ 106