/* Copyright (c) 2014 The Chromium OS Authors. All rights reserved. * Use of this source code is governed by a BSD-style license that can be * found in the LICENSE file. */ /* samus_pd board configuration */ #include "adc.h" #include "adc_chip.h" #include "battery.h" #include "charge_manager.h" #include "charge_ramp.h" #include "common.h" #include "console.h" #include "gpio.h" #include "hooks.h" #include "host_command.h" #include "i2c.h" #include "pi3usb9281.h" #include "power.h" #include "pwm.h" #include "pwm_chip.h" #include "registers.h" #include "switch.h" #include "system.h" #include "task.h" #include "usb_charge.h" #include "usb_descriptor.h" #include "usb_pd.h" #include "util.h" #define CPRINTS(format, args...) cprints(CC_USBCHARGE, format, ## args) /* * When battery is high, system may not be pulling full current. Also, when * high AND input voltage is below boost bypass, then limit input current * limit to HIGH_BATT_LIMIT_CURR_MA to reduce audible ringing. */ #define HIGH_BATT_THRESHOLD 90 #define HIGH_BATT_LIMIT_BOOST_BYPASS_MV 11000 #define HIGH_BATT_LIMIT_CURR_MA 2000 /* Chipset power state */ static enum power_state ps; /* Battery state of charge */ static int batt_soc; /* Default to 5V charging allowed for dead battery case */ static enum pd_charge_state charge_state = PD_CHARGE_5V; /* PD MCU status and host event status for host command */ static int32_t host_event_status_flags; static int32_t pd_status_flags; static struct ec_response_pd_status pd_status; /* Desired input current limit */ static int desired_charge_rate_ma = -1; /* PWM channels. Must be in the exact same order as in enum pwm_channel. */ const struct pwm_t pwm_channels[] = { {STM32_TIM(15), STM32_TIM_CH(2), 0}, }; BUILD_ASSERT(ARRAY_SIZE(pwm_channels) == PWM_CH_COUNT); struct mutex pericom_mux_lock; struct pi3usb9281_config pi3usb9281_chips[] = { { .i2c_port = I2C_PORT_PERICOM, .mux_gpio = GPIO_USB_C_BC12_SEL, .mux_gpio_level = 0, .mux_lock = &pericom_mux_lock, }, { .i2c_port = I2C_PORT_PERICOM, .mux_gpio = GPIO_USB_C_BC12_SEL, .mux_gpio_level = 1, .mux_lock = &pericom_mux_lock, }, }; BUILD_ASSERT(ARRAY_SIZE(pi3usb9281_chips) == CONFIG_BC12_DETECT_PI3USB9281_CHIP_COUNT); static void pericom_port0_reenable_interrupts(void) { CPRINTS("VBUS p0 %d", gpio_get_level(GPIO_USB_C0_VBUS_WAKE)); pi3usb9281_enable_interrupts(0); } DECLARE_DEFERRED(pericom_port0_reenable_interrupts); static void pericom_port1_reenable_interrupts(void) { CPRINTS("VBUS p1 %d", gpio_get_level(GPIO_USB_C1_VBUS_WAKE)); pi3usb9281_enable_interrupts(1); } DECLARE_DEFERRED(pericom_port1_reenable_interrupts); void vbus0_evt(enum gpio_signal signal) { usb_charger_vbus_change(0, gpio_get_level(signal)); task_wake(TASK_ID_PD_C0); } void vbus1_evt(enum gpio_signal signal) { usb_charger_vbus_change(1, gpio_get_level(signal)); task_wake(TASK_ID_PD_C1); } void usb0_evt(enum gpio_signal signal) { task_set_event(TASK_ID_USB_CHG_P0, USB_CHG_EVENT_BC12, 0); } void usb1_evt(enum gpio_signal signal) { task_set_event(TASK_ID_USB_CHG_P1, USB_CHG_EVENT_BC12, 0); } static void chipset_s5_to_s3(void) { ps = POWER_S3; hook_notify(HOOK_CHIPSET_STARTUP); } static void chipset_s3_to_s0(void) { /* Disable deep sleep and restore charge override port */ disable_sleep(SLEEP_MASK_AP_RUN); ps = POWER_S0; hook_notify(HOOK_CHIPSET_RESUME); } static void chipset_s3_to_s5(void) { ps = POWER_S5; hook_notify(HOOK_CHIPSET_SHUTDOWN); } static void chipset_s0_to_s3(void) { /* Enable deep sleep and store charge override port */ enable_sleep(SLEEP_MASK_AP_RUN); ps = POWER_S3; hook_notify(HOOK_CHIPSET_SUSPEND); } static void pch_evt_deferred(void) { /* Determine new chipset state, trigger corresponding transition */ switch (ps) { case POWER_S5: if (gpio_get_level(GPIO_PCH_SLP_S5_L)) chipset_s5_to_s3(); if (gpio_get_level(GPIO_PCH_SLP_S3_L)) chipset_s3_to_s0(); break; case POWER_S3: if (gpio_get_level(GPIO_PCH_SLP_S3_L)) chipset_s3_to_s0(); else if (!gpio_get_level(GPIO_PCH_SLP_S5_L)) chipset_s3_to_s5(); break; case POWER_S0: if (!gpio_get_level(GPIO_PCH_SLP_S3_L)) chipset_s0_to_s3(); if (!gpio_get_level(GPIO_PCH_SLP_S5_L)) chipset_s3_to_s5(); break; default: break; } } DECLARE_DEFERRED(pch_evt_deferred); void pch_evt(enum gpio_signal signal) { hook_call_deferred(&pch_evt_deferred_data, 0); } void board_config_pre_init(void) { /* enable SYSCFG clock */ STM32_RCC_APB2ENR |= 1 << 0; /* * the DMA mapping is : * Chan 2 : TIM1_CH1 (C0 RX) * Chan 3 : SPI1_TX (C1 TX) * Chan 4 : USART1_TX * Chan 5 : USART1_RX * Chan 6 : TIM3_CH1 (C1 RX) * Chan 7 : SPI2_TX (C0 TX) */ /* * Remap USART1 RX/TX DMA to match uart driver. Remap SPI2 RX/TX and * TIM3_CH1 for unique DMA channels. */ STM32_SYSCFG_CFGR1 |= (1 << 9) | (1 << 10) | (1 << 24) | (1 << 30); } #include "gpio_list.h" /* Initialize board. */ static void board_init(void) { int slp_s5 = gpio_get_level(GPIO_PCH_SLP_S5_L); int slp_s3 = gpio_get_level(GPIO_PCH_SLP_S3_L); /* * Enable CC lines after all GPIO have been initialized. Note, it is * important that this is enabled after the CC_ODL lines are set low * to specify device mode. */ gpio_set_level(GPIO_USB_C_CC_EN, 1); /* Enable interrupts on VBUS transitions. */ gpio_enable_interrupt(GPIO_USB_C0_VBUS_WAKE); gpio_enable_interrupt(GPIO_USB_C1_VBUS_WAKE); /* Enable pericom BC1.2 interrupts. */ gpio_enable_interrupt(GPIO_USB_C0_BC12_INT_L); gpio_enable_interrupt(GPIO_USB_C1_BC12_INT_L); /* Determine initial chipset state */ if (slp_s5 && slp_s3) { disable_sleep(SLEEP_MASK_AP_RUN); hook_notify(HOOK_CHIPSET_RESUME); ps = POWER_S0; } else if (slp_s5 && !slp_s3) { enable_sleep(SLEEP_MASK_AP_RUN); hook_notify(HOOK_CHIPSET_STARTUP); ps = POWER_S3; } else { enable_sleep(SLEEP_MASK_AP_RUN); hook_notify(HOOK_CHIPSET_SHUTDOWN); ps = POWER_S5; } /* Enable interrupts on PCH state change */ gpio_enable_interrupt(GPIO_PCH_SLP_S3_L); gpio_enable_interrupt(GPIO_PCH_SLP_S5_L); /* Initialize active charge port to none */ pd_status.active_charge_port = CHARGE_PORT_NONE; /* Set PD MCU system status bits */ if (system_jumped_to_this_image()) pd_status_flags |= PD_STATUS_JUMPED_TO_IMAGE; if (system_is_in_rw()) pd_status_flags |= PD_STATUS_IN_RW; #ifdef CONFIG_PWM /* Enable ILIM PWM: initial duty cycle 0% = 500mA limit. */ pwm_enable(PWM_CH_ILIM, 1); pwm_set_duty(PWM_CH_ILIM, 0); #endif } DECLARE_HOOK(HOOK_INIT, board_init, HOOK_PRIO_DEFAULT); /* ADC channels */ const struct adc_t adc_channels[] = { /* USB PD CC lines sensing. Converted to mV (3300mV/4096). */ [ADC_C0_CC1_PD] = {"C0_CC1_PD", 3300, 4096, 0, STM32_AIN(0)}, [ADC_C1_CC1_PD] = {"C1_CC1_PD", 3300, 4096, 0, STM32_AIN(2)}, [ADC_C0_CC2_PD] = {"C0_CC2_PD", 3300, 4096, 0, STM32_AIN(4)}, [ADC_C1_CC2_PD] = {"C1_CC2_PD", 3300, 4096, 0, STM32_AIN(5)}, /* Vbus sensing. Converted to mV, full ADC is equivalent to 25.774V. */ [ADC_VBUS] = {"VBUS", 25774, 4096, 0, STM32_AIN(11)}, }; BUILD_ASSERT(ARRAY_SIZE(adc_channels) == ADC_CH_COUNT); /* I2C ports */ const struct i2c_port_t i2c_ports[] = { {"master", I2C_PORT_MASTER, 100, GPIO_MASTER_I2C_SCL, GPIO_MASTER_I2C_SDA}, {"slave", I2C_PORT_SLAVE, 100, GPIO_SLAVE_I2C_SCL, GPIO_SLAVE_I2C_SDA}, }; const unsigned int i2c_ports_used = ARRAY_SIZE(i2c_ports); int board_get_battery_soc(void) { return batt_soc; } enum battery_present battery_is_present(void) { if (batt_soc >= 0) return BP_YES; return BP_NOT_SURE; } static void pd_send_ec_int(void) { gpio_set_level(GPIO_EC_INT, 1); /* * Delay long enough to guarantee EC see's the change. Slowest * EC clock speed is 250kHz in deep sleep -> 4us, and add 1us * for buffer. */ usleep(5); gpio_set_level(GPIO_EC_INT, 0); } /** * Set active charge port -- only one port can be active at a time. * * @param charge_port Charge port to enable. * * Returns EC_SUCCESS if charge port is accepted and made active, * EC_ERROR_* otherwise. */ int board_set_active_charge_port(int charge_port) { /* charge port is a realy physical port */ int is_real_port = (charge_port >= 0 && charge_port < CONFIG_USB_PD_PORT_COUNT); /* check if we are source vbus on that port */ if (is_real_port && usb_charger_port_is_sourcing_vbus(charge_port)) { CPRINTS("Skip enable p%d", charge_port); return EC_ERROR_INVAL; } CPRINTS("New chg p%d", charge_port); /* * If charging and the active charge port is changed, then disable * charging to guarantee charge circuit starts up cleanly. */ if (pd_status.active_charge_port != CHARGE_PORT_NONE && (charge_port == CHARGE_PORT_NONE || charge_port != pd_status.active_charge_port)) { gpio_set_level(GPIO_USB_C0_CHARGE_EN_L, 1); gpio_set_level(GPIO_USB_C1_CHARGE_EN_L, 1); charge_state = PD_CHARGE_NONE; pd_status.active_charge_port = charge_port; CPRINTS("Chg: None\n"); return EC_SUCCESS; } /* Save active charge port and enable charging if allowed */ pd_status.active_charge_port = charge_port; if (charge_state != PD_CHARGE_NONE) { gpio_set_level(GPIO_USB_C0_CHARGE_EN_L, !(charge_port == 0)); gpio_set_level(GPIO_USB_C1_CHARGE_EN_L, !(charge_port == 1)); } return EC_SUCCESS; } /** * Return if max voltage charging is allowed. */ int pd_is_max_request_allowed(void) { return charge_state == PD_CHARGE_MAX; } /** * Return if board is consuming full amount of input current */ int charge_is_consuming_full_input_current(void) { return batt_soc >= 1 && batt_soc < HIGH_BATT_THRESHOLD; } /* * Number of VBUS samples to average when computing if VBUS is too low * for the ramp stable state. */ #define VBUS_STABLE_SAMPLE_COUNT 4 /* VBUS too low threshold */ #define VBUS_LOW_THRESHOLD_MV 4600 /** * Return if VBUS is sagging too low */ int board_is_vbus_too_low(int port, enum chg_ramp_vbus_state ramp_state) { static int vbus[VBUS_STABLE_SAMPLE_COUNT]; static int vbus_idx, vbus_samples_full; int vbus_sum, i; /* * If we are not allowing charging, it's because the EC saw * ACOK go low, so we know VBUS is drooping too far. */ if (charge_state == PD_CHARGE_NONE) return 1; /* If we are ramping, only look at one reading */ if (ramp_state == CHG_RAMP_VBUS_RAMPING) { /* Reset the VBUS array vars used for the stable state */ vbus_idx = vbus_samples_full = 0; return adc_read_channel(ADC_VBUS) < VBUS_LOW_THRESHOLD_MV; } /* Fill VBUS array with ADC readings */ vbus[vbus_idx] = adc_read_channel(ADC_VBUS); vbus_idx = (vbus_idx == VBUS_STABLE_SAMPLE_COUNT-1) ? 0 : vbus_idx + 1; if (vbus_idx == 0) vbus_samples_full = 1; /* If VBUS array is not full yet, then return ok */ if (!vbus_samples_full) return 0; /* All VBUS samples are populated, take average */ vbus_sum = 0; for (i = 0; i < VBUS_STABLE_SAMPLE_COUNT; i++) vbus_sum += vbus[i]; /* Return if average is lower than threshold */ return vbus_sum < (VBUS_STABLE_SAMPLE_COUNT * VBUS_LOW_THRESHOLD_MV); } static int board_update_charge_limit(int charge_ma) { #ifdef CONFIG_PWM int pwm_duty; #endif static int actual_charge_rate_ma = -1; desired_charge_rate_ma = charge_ma; if (batt_soc >= HIGH_BATT_THRESHOLD && adc_read_channel(ADC_VBUS) < HIGH_BATT_LIMIT_BOOST_BYPASS_MV) charge_ma = MIN(charge_ma, HIGH_BATT_LIMIT_CURR_MA); /* if current hasn't changed, don't do anything */ if (charge_ma == actual_charge_rate_ma) return 0; actual_charge_rate_ma = charge_ma; #ifdef CONFIG_PWM pwm_duty = MA_TO_PWM(charge_ma); if (pwm_duty < 0) pwm_duty = 0; else if (pwm_duty > 100) pwm_duty = 100; pwm_set_duty(PWM_CH_ILIM, pwm_duty); #endif pd_status.curr_lim_ma = charge_ma >= 500 ? (charge_ma - 500) * 92 / 100 + 256 : 0; CPRINTS("New ilim %d", charge_ma); return 1; } /** * Set the charge limit based upon desired maximum. * * @param port Port number. * @param supplier Charge supplier type. * @param charge_ma Desired charge limit (mA). * @param charge_mv Negotiated charge voltage (mV). */ void board_set_charge_limit(int port, int supplier, int charge_ma, int max_ma, int charge_mv) { /* Update current limit and notify EC if it changed */ if (board_update_charge_limit(charge_ma), charge_mv) pd_send_ec_int(); } static void board_update_battery_soc(int soc) { if (batt_soc != soc) { batt_soc = soc; if (batt_soc >= CONFIG_CHARGE_MANAGER_BAT_PCT_SAFE_MODE_EXIT) charge_manager_leave_safe_mode(); board_update_charge_limit(desired_charge_rate_ma); hook_notify(HOOK_BATTERY_SOC_CHANGE); } } /* Send host event up to AP */ void pd_send_host_event(int mask) { /* mask must be set */ if (!mask) return; atomic_or(&(host_event_status_flags), mask); atomic_or(&(pd_status_flags), PD_STATUS_HOST_EVENT); pd_send_ec_int(); } /****************************************************************************/ /* Console commands */ static int command_ec_int(int argc, char **argv) { pd_send_ec_int(); return EC_SUCCESS; } DECLARE_CONSOLE_COMMAND(ecint, command_ec_int, "", "Toggle EC interrupt line"); static int command_pd_host_event(int argc, char **argv) { int event_mask; char *e; if (argc < 2) return EC_ERROR_PARAM_COUNT; event_mask = strtoi(argv[1], &e, 10); if (*e) return EC_ERROR_PARAM1; pd_send_host_event(event_mask); return EC_SUCCESS; } DECLARE_CONSOLE_COMMAND(pdevent, command_pd_host_event, "event_mask", "Send PD host event"); /****************************************************************************/ /* Host commands */ static int ec_status_host_cmd(struct host_cmd_handler_args *args) { const struct ec_params_pd_status *p = args->params; struct ec_response_pd_status *r = args->response; /* update battery soc */ board_update_battery_soc(p->batt_soc); if (p->charge_state != charge_state) { switch (p->charge_state) { case PD_CHARGE_NONE: /* * No current allowed in, set new power request * so that PD negotiates down to vSafe5V. */ charge_state = p->charge_state; gpio_set_level(GPIO_USB_C0_CHARGE_EN_L, 1); gpio_set_level(GPIO_USB_C1_CHARGE_EN_L, 1); pd_set_new_power_request( pd_status.active_charge_port); /* * Wake charge ramp task so that it will check * board_is_vbus_too_low() and stop ramping up. */ task_wake(TASK_ID_CHG_RAMP); CPRINTS("Chg: None"); break; case PD_CHARGE_5V: /* Allow current on the active charge port */ charge_state = p->charge_state; gpio_set_level(GPIO_USB_C0_CHARGE_EN_L, !(pd_status.active_charge_port == 0)); gpio_set_level(GPIO_USB_C1_CHARGE_EN_L, !(pd_status.active_charge_port == 1)); CPRINTS("Chg: 5V"); break; case PD_CHARGE_MAX: /* * Allow negotiation above vSafe5V. Should only * ever get this command when 5V charging is * already allowed. */ if (charge_state == PD_CHARGE_5V) { charge_state = p->charge_state; pd_set_new_power_request( pd_status.active_charge_port); CPRINTS("Chg: Max"); } break; default: break; } } *r = pd_status; r->status = pd_status_flags; /* Clear host event */ atomic_clear(&(pd_status_flags), PD_STATUS_HOST_EVENT); args->response_size = sizeof(*r); return EC_RES_SUCCESS; } DECLARE_HOST_COMMAND(EC_CMD_PD_EXCHANGE_STATUS, ec_status_host_cmd, EC_VER_MASK(EC_VER_PD_EXCHANGE_STATUS)); static int host_event_status_host_cmd(struct host_cmd_handler_args *args) { struct ec_response_host_event_status *r = args->response; /* Clear host event bit to avoid sending more unnecessary events */ atomic_clear(&(pd_status_flags), PD_STATUS_HOST_EVENT); /* Read and clear the host event status to return to AP */ r->status = atomic_read_clear(&(host_event_status_flags)); args->response_size = sizeof(*r); return EC_RES_SUCCESS; } DECLARE_HOST_COMMAND(EC_CMD_PD_HOST_EVENT_STATUS, host_event_status_host_cmd, EC_VER_MASK(0));