mirror of
https://github.com/espressif/esp-idf.git
synced 2024-10-05 20:47:46 -04:00
16677b0d3c
peripheral enable/disable usually should be managed by driver itself, so make it as espressif private APIs, not recommended for user to use it in application code. However, if user want to re-write the driver or ports to other platform, this is still possible by including the header in this way: "esp_private/peripheral_ctrl.h"
329 lines
14 KiB
C
329 lines
14 KiB
C
/*
|
|
* SPDX-FileCopyrightText: 2015-2021 Espressif Systems (Shanghai) CO LTD
|
|
*
|
|
* SPDX-License-Identifier: Apache-2.0
|
|
*/
|
|
|
|
#include <esp_types.h>
|
|
#include <string.h>
|
|
#include "freertos/FreeRTOS.h"
|
|
#include "esp_log.h"
|
|
#include "esp_check.h"
|
|
#include "esp_private/periph_ctrl.h"
|
|
#include "esp_private/usb_phy.h"
|
|
#include "soc/usb_phy_periph.h"
|
|
#include "hal/usb_phy_hal.h"
|
|
#include "hal/usb_phy_ll.h"
|
|
#include "esp_rom_gpio.h"
|
|
#include "driver/gpio.h"
|
|
#include "hal/gpio_ll.h"
|
|
#include "soc/usb_pins.h"
|
|
|
|
static const char *USBPHY_TAG = "usb_phy";
|
|
|
|
#define USBPHY_NOT_INIT_ERR_STR "USB_PHY is not initialized"
|
|
|
|
typedef struct phy_context_t phy_context_t;
|
|
|
|
struct phy_context_t {
|
|
usb_phy_target_t target; /**< PHY target */
|
|
usb_phy_controller_t controller; /**< PHY controller */
|
|
usb_phy_status_t status; /**< PHY status */
|
|
usb_otg_mode_t otg_mode; /**< USB OTG mode */
|
|
usb_phy_speed_t otg_speed; /**< USB speed */
|
|
usb_phy_gpio_conf_t *iopins; /**< external PHY I/O pins */
|
|
usb_phy_hal_context_t hal_context; /**< USB_PHY hal context */
|
|
};
|
|
|
|
typedef struct {
|
|
phy_context_t *internal_phy; /**< internal PHY context */
|
|
phy_context_t *external_phy; /**< external PHY context */
|
|
uint32_t ref_count; /**< reference count used to protect p_phy_ctrl_obj */
|
|
} phy_ctrl_obj_t;
|
|
|
|
/**
|
|
* @brief A pin descriptor for initialize external PHY I/O pins
|
|
*/
|
|
typedef struct {
|
|
int pin; /**< GPIO pin num */
|
|
const int func; /**< GPIO matrix signal */
|
|
const bool is_output; /**< input/output signal */
|
|
} usb_iopin_dsc_t;
|
|
|
|
static phy_ctrl_obj_t *p_phy_ctrl_obj = NULL;
|
|
static portMUX_TYPE phy_spinlock = portMUX_INITIALIZER_UNLOCKED;
|
|
|
|
static esp_err_t phy_external_iopins_configure(usb_phy_gpio_conf_t *gpio_conf)
|
|
{
|
|
const usb_iopin_dsc_t usb_periph_iopins[] = {
|
|
{gpio_conf->vp_io_num, usb_phy_periph_signal.extphy_vp_in, 0},
|
|
{gpio_conf->vm_io_num, usb_phy_periph_signal.extphy_vm_in, 0},
|
|
{gpio_conf->rcv_io_num, usb_phy_periph_signal.extphy_rcv_in, 0},
|
|
{gpio_conf->oen_io_num, usb_phy_periph_signal.extphy_oen_out, 1},
|
|
{gpio_conf->vpo_io_num, usb_phy_periph_signal.extphy_vpo_out, 1},
|
|
{gpio_conf->vmo_io_num, usb_phy_periph_signal.extphy_vmo_out, 1},
|
|
};
|
|
|
|
for (int i = 0; i < sizeof(usb_periph_iopins)/sizeof(usb_iopin_dsc_t); i++) {
|
|
const usb_iopin_dsc_t iopin = usb_periph_iopins[i];
|
|
if (iopin.pin != -1) {
|
|
ESP_RETURN_ON_FALSE((iopin.is_output && GPIO_IS_VALID_OUTPUT_GPIO(iopin.pin)) ||
|
|
(!iopin.is_output && GPIO_IS_VALID_GPIO(iopin.pin)),
|
|
ESP_ERR_INVALID_ARG, USBPHY_TAG, "io_num argument is invalid");
|
|
esp_rom_gpio_pad_select_gpio(iopin.pin);
|
|
if (iopin.is_output) {
|
|
esp_rom_gpio_connect_out_signal(iopin.pin, iopin.func, false, false);
|
|
} else {
|
|
esp_rom_gpio_connect_in_signal(iopin.pin, iopin.func, false);
|
|
gpio_ll_input_enable(&GPIO, iopin.pin);
|
|
}
|
|
esp_rom_gpio_pad_unhold(iopin.pin);
|
|
}
|
|
}
|
|
return ESP_OK;
|
|
}
|
|
|
|
esp_err_t usb_phy_otg_set_mode(usb_phy_handle_t handle, usb_otg_mode_t mode)
|
|
{
|
|
ESP_RETURN_ON_FALSE(handle, ESP_ERR_INVALID_ARG, USBPHY_TAG, "handle argument is invalid");
|
|
ESP_RETURN_ON_FALSE(mode < USB_OTG_MODE_MAX, ESP_ERR_INVALID_ARG, USBPHY_TAG, "mode argument is invalid");
|
|
ESP_RETURN_ON_FALSE(handle->controller == USB_PHY_CTRL_OTG, ESP_FAIL, USBPHY_TAG, "phy source is not USB_OTG");
|
|
|
|
handle->otg_mode = mode;
|
|
if (mode == USB_OTG_MODE_HOST) {
|
|
esp_rom_gpio_connect_in_signal(GPIO_MATRIX_CONST_ZERO_INPUT, USB_OTG_IDDIG_IN_IDX, false); //connected connector is A side
|
|
esp_rom_gpio_connect_in_signal(GPIO_MATRIX_CONST_ZERO_INPUT, USB_SRP_BVALID_IN_IDX, false);
|
|
esp_rom_gpio_connect_in_signal(GPIO_MATRIX_CONST_ONE_INPUT, USB_OTG_VBUSVALID_IN_IDX, false); //receiving a valid Vbus from host
|
|
esp_rom_gpio_connect_in_signal(GPIO_MATRIX_CONST_ONE_INPUT, USB_OTG_AVALID_IN_IDX, false); //HIGH to force USB host mode
|
|
if (handle->target == USB_PHY_TARGET_INT) {
|
|
usb_phy_hal_int_load_conf_host(&(handle->hal_context));
|
|
}
|
|
} else if (mode == USB_OTG_MODE_DEVICE) {
|
|
esp_rom_gpio_connect_in_signal(GPIO_MATRIX_CONST_ONE_INPUT, USB_OTG_IDDIG_IN_IDX, false); //connected connector is mini-B side
|
|
esp_rom_gpio_connect_in_signal(GPIO_MATRIX_CONST_ONE_INPUT, USB_SRP_BVALID_IN_IDX, false); //HIGH to force USB device mode
|
|
esp_rom_gpio_connect_in_signal(GPIO_MATRIX_CONST_ONE_INPUT, USB_OTG_VBUSVALID_IN_IDX, false); //receiving a valid Vbus from device
|
|
esp_rom_gpio_connect_in_signal(GPIO_MATRIX_CONST_ZERO_INPUT, USB_OTG_AVALID_IN_IDX, false);
|
|
}
|
|
|
|
return ESP_OK;
|
|
}
|
|
|
|
esp_err_t usb_phy_otg_dev_set_speed(usb_phy_handle_t handle, usb_phy_speed_t speed)
|
|
{
|
|
ESP_RETURN_ON_FALSE(handle, ESP_ERR_INVALID_ARG, USBPHY_TAG, "handle argument is invalid");
|
|
ESP_RETURN_ON_FALSE(speed < USB_PHY_SPEED_MAX, ESP_ERR_INVALID_ARG, USBPHY_TAG, "speed argument is invalid");
|
|
ESP_RETURN_ON_FALSE(handle->controller == USB_PHY_CTRL_OTG, ESP_FAIL, USBPHY_TAG, "phy source is not USB_OTG");
|
|
ESP_RETURN_ON_FALSE((handle->target == USB_PHY_TARGET_INT && handle->otg_mode == USB_OTG_MODE_DEVICE), ESP_FAIL,
|
|
USBPHY_TAG, "set speed not supported");
|
|
|
|
handle->otg_speed = speed;
|
|
usb_priv_speed_t hal_speed = 0;
|
|
if (speed == USB_PHY_SPEED_LOW) {
|
|
hal_speed = USB_PRIV_SPEED_LOW;
|
|
} else if (speed == USB_PHY_SPEED_FULL) {
|
|
hal_speed = USB_PRIV_SPEED_FULL;
|
|
}
|
|
usb_phy_hal_int_load_conf_dev(&(handle->hal_context), hal_speed);
|
|
return ESP_OK;
|
|
}
|
|
|
|
esp_err_t usb_phy_action(usb_phy_handle_t handle, usb_phy_action_t action)
|
|
{
|
|
ESP_RETURN_ON_FALSE(handle, ESP_ERR_INVALID_ARG, USBPHY_TAG, "handle argument is invalid");
|
|
ESP_RETURN_ON_FALSE(action < USB_PHY_ACTION_MAX, ESP_ERR_INVALID_ARG, USBPHY_TAG, "action argument is invalid");
|
|
ESP_RETURN_ON_FALSE((action == USB_PHY_ACTION_HOST_ALLOW_CONN && handle->controller == USB_PHY_CTRL_OTG) ||
|
|
(action == USB_PHY_ACTION_HOST_FORCE_DISCONN && handle->controller == USB_PHY_CTRL_OTG),
|
|
ESP_ERR_INVALID_ARG, USBPHY_TAG, "wrong target for the action");
|
|
|
|
esp_err_t ret = ESP_OK;
|
|
switch (action) {
|
|
case USB_PHY_ACTION_HOST_ALLOW_CONN:
|
|
if (handle->target == USB_PHY_TARGET_INT) {
|
|
usb_phy_hal_int_mimick_disconn(&(handle->hal_context), false);
|
|
} else {
|
|
if (!handle->iopins) {
|
|
ret = ESP_FAIL;
|
|
ESP_LOGE(USBPHY_TAG, "no I/O pins provided for connection");
|
|
break;
|
|
}
|
|
/*
|
|
Allow for connections on the external PHY by connecting the VP and VM signals to the external PHY.
|
|
*/
|
|
esp_rom_gpio_connect_in_signal(handle->iopins->vp_io_num, USB_EXTPHY_VP_IDX, false);
|
|
esp_rom_gpio_connect_in_signal(handle->iopins->vm_io_num, USB_EXTPHY_VM_IDX, false);
|
|
}
|
|
break;
|
|
|
|
case USB_PHY_ACTION_HOST_FORCE_DISCONN:
|
|
if (handle->target == USB_PHY_TARGET_INT) {
|
|
usb_phy_hal_int_mimick_disconn(&(handle->hal_context), true);
|
|
} else {
|
|
/*
|
|
Disable connections on the external PHY by connecting the VP and VM signals to the constant LOW signal.
|
|
*/
|
|
esp_rom_gpio_connect_in_signal(GPIO_MATRIX_CONST_ZERO_INPUT, USB_EXTPHY_VP_IDX, false);
|
|
esp_rom_gpio_connect_in_signal(GPIO_MATRIX_CONST_ZERO_INPUT, USB_EXTPHY_VM_IDX, false);
|
|
}
|
|
break;
|
|
|
|
default:
|
|
break;
|
|
}
|
|
|
|
return ret;
|
|
}
|
|
|
|
static esp_err_t usb_phy_install(void)
|
|
{
|
|
portENTER_CRITICAL(&phy_spinlock);
|
|
if (p_phy_ctrl_obj) {
|
|
// p_phy_ctrl_obj already installed, return immediately
|
|
portEXIT_CRITICAL(&phy_spinlock);
|
|
return ESP_OK;
|
|
}
|
|
portEXIT_CRITICAL(&phy_spinlock);
|
|
|
|
esp_err_t ret = ESP_OK;
|
|
phy_ctrl_obj_t *phy_ctrl_obj = (phy_ctrl_obj_t *) calloc(1, sizeof(phy_ctrl_obj_t));
|
|
ESP_GOTO_ON_FALSE(phy_ctrl_obj, ESP_ERR_NO_MEM, cleanup, USBPHY_TAG, "no mem for USB_PHY driver");
|
|
|
|
portENTER_CRITICAL(&phy_spinlock);
|
|
if (!p_phy_ctrl_obj) {
|
|
p_phy_ctrl_obj = phy_ctrl_obj;
|
|
p_phy_ctrl_obj->ref_count = 0;
|
|
} else {
|
|
// p_phy_ctrl_obj already installed, need to free resource
|
|
portEXIT_CRITICAL(&phy_spinlock);
|
|
goto cleanup;
|
|
}
|
|
portEXIT_CRITICAL(&phy_spinlock);
|
|
periph_module_enable(usb_phy_periph_signal.module);
|
|
periph_module_reset(usb_phy_periph_signal.module);
|
|
return ESP_OK;
|
|
|
|
cleanup:
|
|
free(phy_ctrl_obj);
|
|
return ret;
|
|
}
|
|
|
|
esp_err_t usb_new_phy(const usb_phy_config_t *config, usb_phy_handle_t *handle_ret)
|
|
{
|
|
ESP_RETURN_ON_FALSE(config, ESP_ERR_INVALID_ARG, USBPHY_TAG, "config argument is invalid");
|
|
ESP_RETURN_ON_FALSE(config->target < USB_PHY_TARGET_MAX, ESP_ERR_INVALID_ARG, USBPHY_TAG, "specified PHY argument is invalid");
|
|
ESP_RETURN_ON_FALSE(config->controller < USB_PHY_CTRL_MAX, ESP_ERR_INVALID_ARG, USBPHY_TAG, "specified source argument is invalid");
|
|
|
|
ESP_RETURN_ON_ERROR(usb_phy_install(), USBPHY_TAG, "usb_phy driver installation failed");
|
|
esp_err_t ret = ESP_OK;
|
|
bool new_phy = false;
|
|
phy_context_t *phy_context = (phy_context_t *) calloc(1, sizeof(phy_context_t));
|
|
ESP_GOTO_ON_FALSE(phy_context, ESP_ERR_NO_MEM, cleanup, USBPHY_TAG, "no mem for phy context");
|
|
|
|
portENTER_CRITICAL(&phy_spinlock);
|
|
usb_phy_get_phy_status(config->target, &phy_context->status);
|
|
if (phy_context->status == USB_PHY_STATUS_FREE) {
|
|
new_phy = true;
|
|
p_phy_ctrl_obj->ref_count++;
|
|
if (config->target == USB_PHY_TARGET_EXT) {
|
|
p_phy_ctrl_obj->external_phy = phy_context;
|
|
} else {
|
|
p_phy_ctrl_obj->internal_phy = phy_context;
|
|
}
|
|
}
|
|
portEXIT_CRITICAL(&phy_spinlock);
|
|
ESP_GOTO_ON_FALSE(new_phy, ESP_ERR_INVALID_STATE, cleanup, USBPHY_TAG, "selected PHY is in use");
|
|
|
|
phy_context->target = config->target;
|
|
phy_context->controller = config->controller;
|
|
phy_context->status = USB_PHY_STATUS_IN_USE;
|
|
|
|
usb_phy_hal_init(&(phy_context->hal_context));
|
|
if (config->controller == USB_PHY_CTRL_OTG) {
|
|
usb_phy_hal_otg_conf(&(phy_context->hal_context), config->target == USB_PHY_TARGET_EXT);
|
|
}
|
|
#if SOC_USB_SERIAL_JTAG_SUPPORTED
|
|
else if (config->controller == USB_PHY_CTRL_SERIAL_JTAG) {
|
|
usb_phy_hal_jtag_conf(&(phy_context->hal_context), config->target == USB_PHY_TARGET_EXT);
|
|
phy_context->otg_mode = USB_OTG_MODE_DEVICE;
|
|
phy_context->otg_speed = USB_PHY_SPEED_FULL;
|
|
}
|
|
#endif
|
|
|
|
if (config->target == USB_PHY_TARGET_INT) {
|
|
gpio_set_drive_capability(USBPHY_DM_NUM, GPIO_DRIVE_CAP_3);
|
|
gpio_set_drive_capability(USBPHY_DP_NUM, GPIO_DRIVE_CAP_3);
|
|
}
|
|
|
|
*handle_ret = (usb_phy_handle_t) phy_context;
|
|
if (config->gpio_conf && config->target == USB_PHY_TARGET_EXT) {
|
|
phy_context->iopins = (usb_phy_gpio_conf_t *) calloc(1, sizeof(usb_phy_gpio_conf_t));
|
|
ESP_GOTO_ON_FALSE(phy_context->iopins, ESP_ERR_NO_MEM, cleanup, USBPHY_TAG, "no mem for storing I/O pins");
|
|
memcpy(phy_context->iopins, config->gpio_conf, sizeof(usb_phy_gpio_conf_t));
|
|
ESP_ERROR_CHECK(phy_external_iopins_configure(phy_context->iopins));
|
|
}
|
|
if (config->otg_mode != USB_PHY_MODE_DEFAULT) {
|
|
ESP_ERROR_CHECK(usb_phy_otg_set_mode(*handle_ret, config->otg_mode));
|
|
}
|
|
if (config->otg_speed != USB_PHY_SPEED_UNDEFINED) {
|
|
ESP_ERROR_CHECK(usb_phy_otg_dev_set_speed(*handle_ret, config->otg_speed));
|
|
}
|
|
return ESP_OK;
|
|
|
|
cleanup:
|
|
free(phy_context->iopins);
|
|
free(phy_context);
|
|
if (p_phy_ctrl_obj->ref_count == 0) {
|
|
free(p_phy_ctrl_obj);
|
|
p_phy_ctrl_obj = NULL;
|
|
}
|
|
return ret;
|
|
}
|
|
|
|
static void phy_uninstall(void)
|
|
{
|
|
phy_ctrl_obj_t *p_phy_ctrl_obj_free = NULL;
|
|
portENTER_CRITICAL(&phy_spinlock);
|
|
if (p_phy_ctrl_obj->ref_count == 0) {
|
|
p_phy_ctrl_obj_free = p_phy_ctrl_obj;
|
|
p_phy_ctrl_obj = NULL;
|
|
// Disable USB peripheral
|
|
periph_module_disable(usb_phy_periph_signal.module);
|
|
}
|
|
portEXIT_CRITICAL(&phy_spinlock);
|
|
free(p_phy_ctrl_obj_free);
|
|
}
|
|
|
|
esp_err_t usb_del_phy(usb_phy_handle_t handle)
|
|
{
|
|
ESP_RETURN_ON_FALSE(handle, ESP_ERR_INVALID_ARG, USBPHY_TAG, "handle argument is invalid");
|
|
|
|
portENTER_CRITICAL(&phy_spinlock);
|
|
p_phy_ctrl_obj->ref_count--;
|
|
if (handle->target == USB_PHY_TARGET_EXT) {
|
|
p_phy_ctrl_obj->external_phy = NULL;
|
|
} else {
|
|
// Clear pullup and pulldown loads on D+ / D-
|
|
usb_phy_ll_int_load_conf(handle->hal_context.wrap_dev, false, false, false, false);
|
|
p_phy_ctrl_obj->internal_phy = NULL;
|
|
}
|
|
portEXIT_CRITICAL(&phy_spinlock);
|
|
free(handle->iopins);
|
|
free(handle);
|
|
phy_uninstall();
|
|
return ESP_OK;
|
|
}
|
|
|
|
esp_err_t usb_phy_get_phy_status(usb_phy_target_t target, usb_phy_status_t *status)
|
|
{
|
|
ESP_RETURN_ON_FALSE(target < USB_PHY_TARGET_MAX, ESP_ERR_INVALID_ARG, USBPHY_TAG, "argument is invalid");
|
|
ESP_RETURN_ON_FALSE(p_phy_ctrl_obj, ESP_ERR_INVALID_STATE, USBPHY_TAG, USBPHY_NOT_INIT_ERR_STR);
|
|
|
|
if (target == USB_PHY_TARGET_EXT && p_phy_ctrl_obj->external_phy) {
|
|
*status = p_phy_ctrl_obj->external_phy->status;
|
|
} else if (target == USB_PHY_TARGET_INT && p_phy_ctrl_obj->internal_phy) {
|
|
*status = p_phy_ctrl_obj->internal_phy->status;
|
|
} else {
|
|
*status = USB_PHY_STATUS_FREE;
|
|
}
|
|
return ESP_OK;
|
|
}
|