xref: /utopia/UTPA2-700.0.x/modules/usb/drv/usb_ecos/newhost/drvBulktran.h (revision 53ee8cc121a030b8d368113ac3e966b4705770ef)
1*53ee8cc1Swenshuai.xi //<MStar Software>
2*53ee8cc1Swenshuai.xi //******************************************************************************
3*53ee8cc1Swenshuai.xi // MStar Software
4*53ee8cc1Swenshuai.xi // Copyright (c) 2010 - 2012 MStar Semiconductor, Inc. All rights reserved.
5*53ee8cc1Swenshuai.xi // All software, firmware and related documentation herein ("MStar Software") are
6*53ee8cc1Swenshuai.xi // intellectual property of MStar Semiconductor, Inc. ("MStar") and protected by
7*53ee8cc1Swenshuai.xi // law, including, but not limited to, copyright law and international treaties.
8*53ee8cc1Swenshuai.xi // Any use, modification, reproduction, retransmission, or republication of all
9*53ee8cc1Swenshuai.xi // or part of MStar Software is expressly prohibited, unless prior written
10*53ee8cc1Swenshuai.xi // permission has been granted by MStar.
11*53ee8cc1Swenshuai.xi //
12*53ee8cc1Swenshuai.xi // By accessing, browsing and/or using MStar Software, you acknowledge that you
13*53ee8cc1Swenshuai.xi // have read, understood, and agree, to be bound by below terms ("Terms") and to
14*53ee8cc1Swenshuai.xi // comply with all applicable laws and regulations:
15*53ee8cc1Swenshuai.xi //
16*53ee8cc1Swenshuai.xi // 1. MStar shall retain any and all right, ownership and interest to MStar
17*53ee8cc1Swenshuai.xi //    Software and any modification/derivatives thereof.
18*53ee8cc1Swenshuai.xi //    No right, ownership, or interest to MStar Software and any
19*53ee8cc1Swenshuai.xi //    modification/derivatives thereof is transferred to you under Terms.
20*53ee8cc1Swenshuai.xi //
21*53ee8cc1Swenshuai.xi // 2. You understand that MStar Software might include, incorporate or be
22*53ee8cc1Swenshuai.xi //    supplied together with third party`s software and the use of MStar
23*53ee8cc1Swenshuai.xi //    Software may require additional licenses from third parties.
24*53ee8cc1Swenshuai.xi //    Therefore, you hereby agree it is your sole responsibility to separately
25*53ee8cc1Swenshuai.xi //    obtain any and all third party right and license necessary for your use of
26*53ee8cc1Swenshuai.xi //    such third party`s software.
27*53ee8cc1Swenshuai.xi //
28*53ee8cc1Swenshuai.xi // 3. MStar Software and any modification/derivatives thereof shall be deemed as
29*53ee8cc1Swenshuai.xi //    MStar`s confidential information and you agree to keep MStar`s
30*53ee8cc1Swenshuai.xi //    confidential information in strictest confidence and not disclose to any
31*53ee8cc1Swenshuai.xi //    third party.
32*53ee8cc1Swenshuai.xi //
33*53ee8cc1Swenshuai.xi // 4. MStar Software is provided on an "AS IS" basis without warranties of any
34*53ee8cc1Swenshuai.xi //    kind. Any warranties are hereby expressly disclaimed by MStar, including
35*53ee8cc1Swenshuai.xi //    without limitation, any warranties of merchantability, non-infringement of
36*53ee8cc1Swenshuai.xi //    intellectual property rights, fitness for a particular purpose, error free
37*53ee8cc1Swenshuai.xi //    and in conformity with any international standard.  You agree to waive any
38*53ee8cc1Swenshuai.xi //    claim against MStar for any loss, damage, cost or expense that you may
39*53ee8cc1Swenshuai.xi //    incur related to your use of MStar Software.
40*53ee8cc1Swenshuai.xi //    In no event shall MStar be liable for any direct, indirect, incidental or
41*53ee8cc1Swenshuai.xi //    consequential damages, including without limitation, lost of profit or
42*53ee8cc1Swenshuai.xi //    revenues, lost or damage of data, and unauthorized system use.
43*53ee8cc1Swenshuai.xi //    You agree that this Section 4 shall still apply without being affected
44*53ee8cc1Swenshuai.xi //    even if MStar Software has been modified by MStar in accordance with your
45*53ee8cc1Swenshuai.xi //    request or instruction for your use, except otherwise agreed by both
46*53ee8cc1Swenshuai.xi //    parties in writing.
47*53ee8cc1Swenshuai.xi //
48*53ee8cc1Swenshuai.xi // 5. If requested, MStar may from time to time provide technical supports or
49*53ee8cc1Swenshuai.xi //    services in relation with MStar Software to you for your use of
50*53ee8cc1Swenshuai.xi //    MStar Software in conjunction with your or your customer`s product
51*53ee8cc1Swenshuai.xi //    ("Services").
52*53ee8cc1Swenshuai.xi //    You understand and agree that, except otherwise agreed by both parties in
53*53ee8cc1Swenshuai.xi //    writing, Services are provided on an "AS IS" basis and the warranty
54*53ee8cc1Swenshuai.xi //    disclaimer set forth in Section 4 above shall apply.
55*53ee8cc1Swenshuai.xi //
56*53ee8cc1Swenshuai.xi // 6. Nothing contained herein shall be construed as by implication, estoppels
57*53ee8cc1Swenshuai.xi //    or otherwise:
58*53ee8cc1Swenshuai.xi //    (a) conferring any license or right to use MStar name, trademark, service
59*53ee8cc1Swenshuai.xi //        mark, symbol or any other identification;
60*53ee8cc1Swenshuai.xi //    (b) obligating MStar or any of its affiliates to furnish any person,
61*53ee8cc1Swenshuai.xi //        including without limitation, you and your customers, any assistance
62*53ee8cc1Swenshuai.xi //        of any kind whatsoever, or any information; or
63*53ee8cc1Swenshuai.xi //    (c) conferring any license or right under any intellectual property right.
64*53ee8cc1Swenshuai.xi //
65*53ee8cc1Swenshuai.xi // 7. These terms shall be governed by and construed in accordance with the laws
66*53ee8cc1Swenshuai.xi //    of Taiwan, R.O.C., excluding its conflict of law rules.
67*53ee8cc1Swenshuai.xi //    Any and all dispute arising out hereof or related hereto shall be finally
68*53ee8cc1Swenshuai.xi //    settled by arbitration referred to the Chinese Arbitration Association,
69*53ee8cc1Swenshuai.xi //    Taipei in accordance with the ROC Arbitration Law and the Arbitration
70*53ee8cc1Swenshuai.xi //    Rules of the Association by three (3) arbitrators appointed in accordance
71*53ee8cc1Swenshuai.xi //    with the said Rules.
72*53ee8cc1Swenshuai.xi //    The place of arbitration shall be in Taipei, Taiwan and the language shall
73*53ee8cc1Swenshuai.xi //    be English.
74*53ee8cc1Swenshuai.xi //    The arbitration award shall be final and binding to both parties.
75*53ee8cc1Swenshuai.xi //
76*53ee8cc1Swenshuai.xi //******************************************************************************
77*53ee8cc1Swenshuai.xi //<MStar Software>
78*53ee8cc1Swenshuai.xi 
79*53ee8cc1Swenshuai.xi 
80*53ee8cc1Swenshuai.xi #ifndef _TRANSPORT_H_
81*53ee8cc1Swenshuai.xi #define _TRANSPORT_H_
82*53ee8cc1Swenshuai.xi 
83*53ee8cc1Swenshuai.xi //#include <MsTypes.h> // NUSED
84*53ee8cc1Swenshuai.xi #include  "include/drvConfig.h"
85*53ee8cc1Swenshuai.xi #include "drvMassStor.h"
86*53ee8cc1Swenshuai.xi //#include "drvMSC.h" // NUSED
87*53ee8cc1Swenshuai.xi 
88*53ee8cc1Swenshuai.xi /*=========Sub Classes=========*/
89*53ee8cc1Swenshuai.xi #define MS_RBC_SC       0x01    /* Typically, flash devices */
90*53ee8cc1Swenshuai.xi #define MS_ATAPI_SC     0x02    /* CD-ROM */
91*53ee8cc1Swenshuai.xi #define MS_QIC_SC       0x03    /* QIC-157 Tapes */
92*53ee8cc1Swenshuai.xi #define MS_UFI_SC       0x04    /* Floppy */
93*53ee8cc1Swenshuai.xi #define MS_SFF_SC       0x05    /* Removable media */
94*53ee8cc1Swenshuai.xi #define MS_SCSI_SC      0x06    /* Transparent */
95*53ee8cc1Swenshuai.xi #define MS_LSD_SC       0x07    /* LSD FS */
96*53ee8cc1Swenshuai.xi #define MS_DEVICE_SC    0xff    /* Use device's value */
97*53ee8cc1Swenshuai.xi /*=============================*/
98*53ee8cc1Swenshuai.xi /*==========Protocols==========*/
99*53ee8cc1Swenshuai.xi #define MS_CBI_PR       0x00    /* CBI */
100*53ee8cc1Swenshuai.xi #define MS_CB_PR        0x01    /* CB */
101*53ee8cc1Swenshuai.xi #define MS_BULK_PR      0x50    /* BOT */
102*53ee8cc1Swenshuai.xi #define MS_DEVICE_PR    0xff
103*53ee8cc1Swenshuai.xi /*=============================*/
104*53ee8cc1Swenshuai.xi 
105*53ee8cc1Swenshuai.xi struct stBulk_cb
106*53ee8cc1Swenshuai.xi {
107*53ee8cc1Swenshuai.xi     U32 Inscription;
108*53ee8cc1Swenshuai.xi     U32 Label;
109*53ee8cc1Swenshuai.xi     U32 DataLength;
110*53ee8cc1Swenshuai.xi     unsigned char   Flag;
111*53ee8cc1Swenshuai.xi     unsigned char   Lun;
112*53ee8cc1Swenshuai.xi     unsigned char   Len;
113*53ee8cc1Swenshuai.xi     unsigned char   CDB[16];
114*53ee8cc1Swenshuai.xi };
115*53ee8cc1Swenshuai.xi 
116*53ee8cc1Swenshuai.xi struct stBulk_cs
117*53ee8cc1Swenshuai.xi {
118*53ee8cc1Swenshuai.xi     U32 Inscription;
119*53ee8cc1Swenshuai.xi     U32 Label;
120*53ee8cc1Swenshuai.xi     U32 Remains;
121*53ee8cc1Swenshuai.xi     unsigned char   Class;
122*53ee8cc1Swenshuai.xi };
123*53ee8cc1Swenshuai.xi 
124*53ee8cc1Swenshuai.xi #define BULK_CB_WRAP_LEN    31
125*53ee8cc1Swenshuai.xi #define BULK_CB_SIGN        0x43425355
126*53ee8cc1Swenshuai.xi #define BULK_CS_WRAP_LEN    13
127*53ee8cc1Swenshuai.xi #define BULK_CS_SIGN        0x53425355
128*53ee8cc1Swenshuai.xi 
129*53ee8cc1Swenshuai.xi #define BULK_CS_OLYMPUS_SIGN    0x55425355
130*53ee8cc1Swenshuai.xi #define BULK_STAT_OK            0
131*53ee8cc1Swenshuai.xi #define BULK_STAT_FAIL          1
132*53ee8cc1Swenshuai.xi #define BULK_STAT_PHASE         2
133*53ee8cc1Swenshuai.xi 
134*53ee8cc1Swenshuai.xi #define BULK_RESET_REQUEST  0xff
135*53ee8cc1Swenshuai.xi #define BULK_GET_MAX_LUN    0xfe
136*53ee8cc1Swenshuai.xi 
137*53ee8cc1Swenshuai.xi #define XFER_GOOD   0
138*53ee8cc1Swenshuai.xi #define XFER_SHORT  1
139*53ee8cc1Swenshuai.xi #define XFER_STALLED    2
140*53ee8cc1Swenshuai.xi #define XFER_LONG   3
141*53ee8cc1Swenshuai.xi #define XFER_ERROR  4
142*53ee8cc1Swenshuai.xi #define XFER_NO_DEV    5
143*53ee8cc1Swenshuai.xi 
144*53ee8cc1Swenshuai.xi #define TRANSPORT_GOOD      0
145*53ee8cc1Swenshuai.xi #define TRANSPORT_FAILED    1
146*53ee8cc1Swenshuai.xi #define TRANSPORT_NO_SENSE  2
147*53ee8cc1Swenshuai.xi #define TRANSPORT_ERROR     3
148*53ee8cc1Swenshuai.xi #define TRANSPORT_NO_DEVICE  4
149*53ee8cc1Swenshuai.xi 
150*53ee8cc1Swenshuai.xi #define MS_CBI_ADSC     0
151*53ee8cc1Swenshuai.xi 
152*53ee8cc1Swenshuai.xi #if SupportOtherDevice
153*53ee8cc1Swenshuai.xi extern void ms_usb_qic157_command(stCmd_scsi*, struct ms_usdata*);
154*53ee8cc1Swenshuai.xi extern void ms_usb_ufi_command(stCmd_scsi*, struct ms_usdata*);
155*53ee8cc1Swenshuai.xi #endif
156*53ee8cc1Swenshuai.xi extern void ms_usb_transparent_scsi_command(stCmd_scsi*, struct ms_usdata*);
157*53ee8cc1Swenshuai.xi extern int ms_usb_CB_transport(stCmd_scsi*, struct ms_usdata*);
158*53ee8cc1Swenshuai.xi extern int ms_usb_CB_reset(struct ms_usdata*);
159*53ee8cc1Swenshuai.xi extern int ms_usb_bulk_transport(stCmd_scsi*, struct ms_usdata*);
160*53ee8cc1Swenshuai.xi extern int ms_usb_bulk_reset(struct ms_usdata*);
161*53ee8cc1Swenshuai.xi extern void ms_usb_invoke_transport(stCmd_scsi*, struct ms_usdata*);
162*53ee8cc1Swenshuai.xi extern int ms_usb_control_msg(struct ms_usdata *ptr, U32 pipe,
163*53ee8cc1Swenshuai.xi         unsigned char req, unsigned char rt, U16 val, U16 idx, void *data, U16 len, int time_out);
164*53ee8cc1Swenshuai.xi extern int ms_usb_msc_clear_halt(struct ms_usdata *ptr, U32 pipe);
165*53ee8cc1Swenshuai.xi extern int ms_usb_bulk_transfer_buf(struct ms_usdata *ptr, U32 pipe, void *buf, U32 len, U32 *act_len);
166*53ee8cc1Swenshuai.xi #endif
167