104 lines
3.9 KiB
C
104 lines
3.9 KiB
C
/*
|
||
* Copyright : (C) 2022 Phytium Information Technology, Inc.
|
||
* All Rights Reserved.
|
||
*
|
||
* This program is OPEN SOURCE software: you can redistribute it and/or modify it
|
||
* under the terms of the Phytium Public License as published by the Phytium Technology Co.,Ltd,
|
||
* either version 1.0 of the License, or (at your option) any later version.
|
||
*
|
||
* This program is distributed in the hope that it will be useful,but WITHOUT ANY WARRANTY;
|
||
* without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
|
||
* See the Phytium Public License for more details.
|
||
*
|
||
*
|
||
* FilePath: fusb_private.h
|
||
* Date: 2022-02-11 13:33:11
|
||
* LastEditTime: 2022-02-18 09:21:22
|
||
* Description: This files is for definition of internal function interface
|
||
*
|
||
* Modify History:
|
||
* Ver Who Date Changes
|
||
* ----- ------ -------- --------------------------------------
|
||
* 1.0 Zhugengyu 2022/2/7 init commit
|
||
*/
|
||
|
||
#pragma once
|
||
|
||
/***************************** Include Files *********************************/
|
||
#ifdef __aarch64__
|
||
#include "faarch64.h"
|
||
#else
|
||
#include "fcp15.h"
|
||
#endif
|
||
|
||
#include "fkernel.h"
|
||
#include "fio.h"
|
||
#include "fassert.h"
|
||
#include "fusb.h"
|
||
|
||
/************************** Constant Definitions *****************************/
|
||
|
||
/**************************** Type Definitions *******************************/
|
||
|
||
/************************** Variable Definitions *****************************/
|
||
|
||
/***************** Macros (Inline Functions) Definitions *********************/
|
||
#define FUSB_REG32_GET_BITS(x, a, b) (u32)((((u32)(x)) & GENMASK(a, b)) >> b)
|
||
#define FUSB_REG32_SET_BITS(x, a, b) (u32)((((u32)(x)) << b) & GENMASK(a, b))
|
||
#define FUSB_REG64_GET_BITS(x, a, b) (u64)((((u64)(x)) & GENMASK_ULL(a, b)) >> b)
|
||
#define FUSB_REG64_SET_BITS(x, a, b) (u64)((((u64)(x)) << b) & GENMASK_ULL(a, b))
|
||
|
||
/************************** Function Prototypes ******************************/
|
||
/* 创建USB控制器实例，添加到USB实例的Hc链表中 */
|
||
FUsbHc *FUsbAllocateHc(FUsb *instance);
|
||
|
||
/* 删除USB控制器实例，从USB实例的Hc链表中删去 */
|
||
void FUsbDetachHc(FUsbHc *controller);
|
||
|
||
/* 初始化USB设备 */
|
||
FUsbDev *FUsbInitDevEntry(FUsbHc *controller, int slot_id);
|
||
|
||
/* 根据USB设备速度，选择最大包长度 */
|
||
int FUsbDecodeMaxPacketSz0(FUsbSpeed speed, u8 bMaxPacketSize0);
|
||
|
||
/* 据设备速度获取最大包长度 */
|
||
int FUsbSpeedtoDefaultMaxPacketSz(FUsbSpeed speed);
|
||
|
||
/* 配置USB配置描述符解析器 */
|
||
FError FUsbSetupConfigParser(FUsbDev *dev, const void *buf, u32 buf_len);
|
||
|
||
/* 去初始化USB配置描述符解析器 */
|
||
void FUsbRevokeConfigParser(FUsbDev *dev);
|
||
|
||
/* 初始化字符串描述符解析器 */
|
||
void FUsbSetupStringParser(FUsbDev *dev);
|
||
|
||
/* 去初始化字符串描述符解析器 */
|
||
void FUsbRevokeStringParser(FUsbDev *dev);
|
||
|
||
/* 检索字符串描述符，保存在FUsbStringParser结构中 */
|
||
FError FUsbSearchStringDescriptor(FUsb *instance, FUsbDev *dev, u8 id);
|
||
|
||
/* 获取刚刚检索到的字符串描述符内容 */
|
||
const char *FUsbGetString(const FUsbDev *const dev);
|
||
|
||
/* 从配置描述符解析器中获取指定类型的描述符（端点描述符/接口描述符） */
|
||
const FUsbDescriptor *FUsbGetDescriptorFromParser(FUsbConfigParser *parser, FUsbDescriptorType type);
|
||
|
||
/* 默认的USB设备初始化函数 */
|
||
void FUsbNopDevInit(FUsbDev *dev);
|
||
|
||
/* 默认的USB设备初始化函数 */
|
||
void FUsbGenericDevInit(FUsbDev *dev);
|
||
|
||
/* 打印设备描述符信息 */
|
||
void FUsbDumpDeviceDescriptor(const FUsbDeviceDescriptor *descriptor);
|
||
|
||
/* 打印配置描述符信息 */
|
||
void FUsbDumpConfigDescriptor(const FUsbConfigurationDescriptor *descriptor);
|
||
|
||
/* 打印接口描述符信息 */
|
||
void FUsbDumpInterfaceDescriptor(const FUsbInterfaceDescriptor *descriptor);
|
||
|
||
/* 打印端点描述符信息 */
|
||
void FUsbDumpEndpointDescriptor(const FUsbEndpointDescriptor *descriptor); |