• Stephan Gerhold's avatar
    arm64: dts: qcom: msm8916: Define regulator constraints next to usage · b0a8f16a
    Stephan Gerhold authored
    Right now each MSM8916 device has a huge block of regulator constraints
    with allowed voltages for each regulator. For lack of better
    documentation these voltages are often copied as-is from the vendor
    device tree, without much extra thought.
    
    Unfortunately, the voltages in the vendor device trees are often
    misleading or even wrong, e.g. because:
    
     - There is a large voltage range allowed and the actual voltage is
       only set somewhere hidden in some messy vendor driver. This is often
       the case for pm8916_{l14,l15,l16} because they have a broad range of
       1.8-3.3V by default.
    
     - The voltage is actually wrong but thanks to the voltage constraints
       in the RPM firmware it still ends up applying the correct voltage.
    
    To have proper regulator constraints it is important to review them in
    context of the usage. The current setup in the MSM8916 device trees
    makes this quite hard because each device duplicates the standard
    voltages for components of the SoC and mixes those with minor
    device-specific additions and dummy voltages for completely unused
    regulators.
    
    The actual usage of the regulators for the SoC components is in
    msm8916-pm8916.dtsi, so it can and should also define the related
    voltage constraints. These are not board-specific but defined in the
    APQ8016E/PM8916 Device Specification. The board DT can then focus on
    describing the actual board-specific regulators, which makes it much
    easier to review and spot potential mistakes there.
    
    Note that this commit does not make any functional change. All used
    regulators still have the same regulator constraints as before. Unused
    regulators do not have regulator constraints anymore because most of
    these were too broad or even entirely wrong. They should be added back
    with proper voltage constraints when there is an actual usage.
    Signed-off-by: default avatarStephan Gerhold <stephan@gerhold.net>
    Signed-off-by: default avatarBjorn Andersson <andersson@kernel.org>
    Link: https://lore.kernel.org/r/20230510-msm8916-regulators-v1-7-54d4960a05fc@gerhold.net
    b0a8f16a
msm8916-acer-a1-724.dts 3.71 KB