Request: Variant of clocks_init() that allows selectively enabling PLLs (and/or clocks) #1746
Description
This is a use case we found in MicroPython, as we added support for retaining the USB peripheral clock in SLEEP mode.
The mp_machine_lightsleep function selectively disables a range of clocks and PLLs, goes to SLEEP mode, and then calls pico-sdk clocks_init() on wake to restore them. Calling the init function again is useful as it saves a bunch of binary size and removes the potential for a mismatch between the clock config "on init" and "on wake".
However, we recently added support for keeping the USB peripheral clock and PLL enabled in sleep (XOSC also enabled). This works most of the time, but intermittently the USB peripheral would hang on wake as clocks_init() is re-enabling the USB PLL and presumably this can glitch the USB clock.
Our solution for now has been to copy clocks_init() as void clocks_init_optional_usb(bool init_usb). The new argument can be false if the USB PLL is already running. See micropython/micropython#15301 for more details.
However, wanted to raise it here as a request. Perhaps there is a broader use for pico-sdk API to have something like clocks_init_flags(unsigned PLL_FLAGS) function where the default clocks_init() becomes clocks_init_flags(ALL_PLL_FLAGS) (or similar).