1 /**************************************************************************/ 2 /* */ 3 /* Copyright (c) Microsoft Corporation. All rights reserved. */ 4 /* */ 5 /* This software is licensed under the Microsoft Software License */ 6 /* Terms for Microsoft Azure RTOS. Full text of the license can be */ 7 /* found in the LICENSE file at https://aka.ms/AzureRTOS_EULA */ 8 /* and in the root directory of this software. */ 9 /* */ 10 /**************************************************************************/ 11 12 13 /**************************************************************************/ 14 /**************************************************************************/ 15 /** */ 16 /** USBX Component */ 17 /** */ 18 /** EHCI Controller Driver */ 19 /** */ 20 /**************************************************************************/ 21 /**************************************************************************/ 22 23 24 /* Include necessary system files. */ 25 26 #define UX_SOURCE_CODE 27 28 #include "ux_api.h" 29 #include "ux_hcd_ehci.h" 30 #include "ux_host_stack.h" 31 32 33 /**************************************************************************/ 34 /* */ 35 /* FUNCTION RELEASE */ 36 /* */ 37 /* _ux_hcd_ehci_power_root_hubs PORTABLE C */ 38 /* 6.1 */ 39 /* AUTHOR */ 40 /* */ 41 /* Chaoqiong Xiao, Microsoft Corporation */ 42 /* */ 43 /* DESCRIPTION */ 44 /* */ 45 /* This function powers individually or in gang mode the root HUBs */ 46 /* attached to the EHCI controller. */ 47 /* */ 48 /* INPUT */ 49 /* */ 50 /* hcd_ehci Pointer to EHCI controller */ 51 /* */ 52 /* OUTPUT */ 53 /* */ 54 /* None */ 55 /* */ 56 /* CALLS */ 57 /* */ 58 /* _ux_hcd_ehci_register_read Read EHCI register */ 59 /* _ux_hcd_ehci_register_write Write EHCI register */ 60 /* _ux_utility_delay_ms Delay */ 61 /* */ 62 /* CALLED BY */ 63 /* */ 64 /* EHCI Controller Driver */ 65 /* */ 66 /* RELEASE HISTORY */ 67 /* */ 68 /* DATE NAME DESCRIPTION */ 69 /* */ 70 /* 05-19-2020 Chaoqiong Xiao Initial Version 6.0 */ 71 /* 09-30-2020 Chaoqiong Xiao Modified comment(s), */ 72 /* resulting in version 6.1 */ 73 /* */ 74 /**************************************************************************/ _ux_hcd_ehci_power_root_hubs(UX_HCD_EHCI * hcd_ehci)75VOID _ux_hcd_ehci_power_root_hubs(UX_HCD_EHCI *hcd_ehci) 76 { 77 78 ULONG ehci_register; 79 UINT port_index; 80 81 82 /* Read the control PPC field. If the PPC field is set, the controller has 83 implemented port power. */ 84 ehci_register = _ux_hcd_ehci_register_read(hcd_ehci, EHCI_HCCR_HCS_PARAMS); 85 86 if (ehci_register & EHCI_HC_RH_PPC) 87 { 88 89 /* We have power management in this controller. Apply power to each port. */ 90 for (port_index = 0; port_index < hcd_ehci -> ux_hcd_ehci_nb_root_hubs; port_index++) 91 { 92 93 /* Read register first to preserve existing settings. */ 94 ehci_register = _ux_hcd_ehci_register_read(hcd_ehci, EHCI_HCOR_PORT_SC + port_index); 95 96 /* Apply power to a port. */ 97 _ux_hcd_ehci_register_write(hcd_ehci, EHCI_HCOR_PORT_SC + port_index, ehci_register | EHCI_HC_PS_PP); 98 } 99 } 100 101 /* The EHCI needs some time for the power to be stable. */ 102 _ux_utility_delay_ms(EHCI_HC_RH_POWER_STABLE_DELAY); 103 104 /* Return to caller. */ 105 return; 106 } 107 108
