141 lines
4.0 KiB
C
141 lines
4.0 KiB
C
/**@file otg.h
|
||
* @brief otg驱动头文件
|
||
* @details 结构体声明，功能函数声明
|
||
* @author jieli
|
||
* @date 2021-7-22
|
||
* @version V1.0
|
||
* @copyright Copyright(c)2010-2021 珠海市杰理科技股份有限公司
|
||
*********************************************************************
|
||
* @attention
|
||
* 硬件平台：AC632N
|
||
* SDK版本：AC632N_V1.0.0_SDK
|
||
* @修改日志：
|
||
* <table>
|
||
* <tr><th>Date <th>Version <th>Author <th>Description
|
||
* <tr><td>2021-7-22 <td>1.0 <td>jieli <td>创建初始版本
|
||
* </table>
|
||
*
|
||
*********************************************************************
|
||
*/
|
||
#ifndef __OTG_H__
|
||
#define __OTG_H__
|
||
|
||
#include "asm/usb.h"
|
||
|
||
/**@enum usb_hotplug.state 或 usb_hotplug.last_state
|
||
* @brief otg当前所处模式 或 上一次所处模式
|
||
*/
|
||
enum {
|
||
IDLE_MODE = 0, ///<空闲模式
|
||
DISCONN_MODE = 1, ///<断连模式
|
||
HOST_MODE = 2, ///<主机模式
|
||
PRE_SLAVE_MODE, ///<成为从机模式前的一个中间模式
|
||
SLAVE_MODE_WAIT_CONFIRMATION, ///<从机模式还需等待再次确认
|
||
SLAVE_MODE, ///<从机模式
|
||
CHARGE_MODE, ///<充电模式
|
||
OTG_USER_MODE, ///<用户模式，暂时未具体定义
|
||
};
|
||
|
||
/**@enum 空
|
||
* @brief otg挂起时，所选操作模式
|
||
*/
|
||
enum {
|
||
OTG_OP_NULL = 0, ///< ///<空，无意义
|
||
OTG_UNINSTALL = 1, ///<OTG卸载
|
||
OTG_KEEP_STATE, ///<OTG保持
|
||
OTG_SUSPEND, ///< OTG挂起
|
||
OTG_RESUME, ///< OTG恢复
|
||
};
|
||
|
||
#define OTG_HOST_MODE BIT(0)
|
||
#define OTG_SLAVE_MODE BIT(1)
|
||
#define OTG_CHARGE_MODE BIT(2)
|
||
#define OTG_DET_DP_ONLY BIT(3)
|
||
#define OTG_DET_DM_ONLY BIT(4)
|
||
|
||
/**@struct otg_dev_data
|
||
* @brief otg_dev_data信息结构体 \n
|
||
* 自定义的存储otg设备相关数据信息
|
||
*/
|
||
struct otg_dev_data {
|
||
u8 usb_dev_en; ///<有哪几个otg设备使能，如USB0，USB1。
|
||
u8 slave_online_cnt; ///<从机上线阈值
|
||
u8 slave_offline_cnt; ///<从机下线阈值
|
||
u8 host_online_cnt; ///<主机上线阈值
|
||
u8 host_offline_cnt; ///<主机下线阈值
|
||
u8 detect_mode; ///<otg可用模式配置
|
||
u8 detect_time_interval; ///<检测时间间隔，单位 ms
|
||
|
||
void *otg1; //需要使用双USB口独立配置时，在板级.c文件用户自定义一个otg信息的结构体，并指向它。
|
||
};
|
||
|
||
|
||
/**@brief USB设备当前模式获取
|
||
* @param[in] usb_id USB接口的id号
|
||
* @return 函数的执行结果
|
||
* - IDLE_MODE
|
||
* - DISCONN_MODE
|
||
* - HOST_MODE
|
||
* - PRE_SLAVE_MODE
|
||
* - SLAVE_MODE_WAIT_CONFIRMATION
|
||
* - SLAVE_MODE
|
||
* - CHARGE_MODE
|
||
* - OTG_USER_MODE
|
||
* @par 示例：
|
||
* @code
|
||
* usb_otg_online(0); 获取USB0当前模式
|
||
* @encode
|
||
*/
|
||
u32 usb_otg_online(const usb_dev usb_id);
|
||
// u32 usb_otg_init(u32 mode);
|
||
|
||
/**@brief 将DP/DM脚设为高阻
|
||
* @param[in] usb_id USB接口的id号
|
||
* @return 无
|
||
* @par 示例：
|
||
* @code
|
||
* usb_otg_io_suspend(0); 将USB0的DP/DM脚设为高阻状态
|
||
* @encode
|
||
*/
|
||
void usb_otg_io_suspend(usb_dev usb_id);
|
||
|
||
/**@brief 恢复DP/DM引脚的USB功能，并发起usb reset
|
||
* @param[in] usb_id USB接口的id号
|
||
* @return 无
|
||
* @par 示例：
|
||
* @code
|
||
* usb_otg_io_resume(0); 将USB0的IO口功能恢复
|
||
* @encode
|
||
*/
|
||
void usb_otg_io_resume(usb_dev usb_id);
|
||
|
||
/**@brief 将usb_otg设备挂起
|
||
* @param[in] usb_id USB接口的id号
|
||
* @param[in] op_mode 选择挂起模式
|
||
* @ref OTG_UNINSTALL OTG卸载
|
||
* @ref OTG_KEEP_STATE OTG保持原模式
|
||
* @return 无
|
||
* @par 示例：
|
||
* @code
|
||
* usb_otg_suspend(0,OTG_KEEP_STATE); USB0保持原来的模式
|
||
* @encode
|
||
*/
|
||
void usb_otg_suspend(usb_dev usb_id, u8 op_mode);
|
||
|
||
/**@brief 将usb_otg设备恢复
|
||
* @param[in] usb_id USB接口的id号
|
||
* @return 无
|
||
* @par 示例：
|
||
* @code
|
||
* usb_otg_resume(0); USB0恢复
|
||
* @encode
|
||
*/
|
||
void usb_otg_resume(usb_dev usb_id);
|
||
|
||
void usb_otg_sof_check_register_hooks(void (*before)(), void (*after)());
|
||
|
||
extern const struct device_operations usb_dev_ops;
|
||
|
||
|
||
#endif /*OTG_H*/
|