# Trimming Support

Power, clock, and sensor component trimming hardware abstraction layer.

## Summary

Variables

- trim_args1 : Trim targets for items needing one trim.
- trim_args2 : Trim targets for items needing two trims.

Enumerations

- TrimTarget_t : Default trim targets present in NVR7.
- TrimName_t : Voltage rail and oscillator names.

Macros

- NULL_POINTER : NULL pointer.
- MIN_32_BIT : Minimum 32-bit value.
- MAX_32_BIT : Maximum 32-bit value.
- MIN_18_BIT : Minimum 18-bit value.
- MAX_18_BIT : Maximum 18-bit value.
- MIN_16_BIT : Minimum 16-bit value.
- MAX_16_BIT : Maximum 16-bit value.
- MIN_8_BIT : Minimum 8-bit value.
- MAX_8_BIT : Maximum 8-bit value.
- MAX_4_BIT : Maximum 4-bit value.
- ERROR_NO_ERROR
- ERROR_NULL : Null pointer error.
- ERROR_NO_TRIM_FOUND : Target trim value not found.
- ERROR_INVALID_TRIM : Trims in region specified are not valid.
- ERROR_INVALID_CRC : Trim region CRC has failed.
- ERROR_BG_INVALID : Bandgap target value is invalid.
- ERROR_BG_V_INVALID : Bandgap voltage trim is invalid.
- ERROR_BG_I_INVALID : Bandgap current trim is invalid.
- ERROR_DCDC_INVALID : DCDC trim is invalid.
- ERROR_VDDC_INVALID : VDDC trim is invalid.
- ERROR_VDDC_STBY_INVALID : VDCC standby trim is invalid.
- ERROR_VDDM_INVALID : VDDM trim is invalid.
- ERROR_VDDM_STBY_INVALID : VDCM standby trim is invalid.
- ERROR_VDDRF_INVALID : VDDRF trim is invalid.
- ERROR_VDDPA_INVALID : VDDPA trim is invalid.
- ERROR_VDDPA_MIN_INVALID : VDDPA minimum trim is invalid.
- ERROR_VDDIF_INVALID : VDDIF trim is invalid.
- ERROR_VDDFLASH_INVALID : VDDFLASH trim is invalid.
- ERROR_RCOSC_INVALID : RC start oscillator trim is invalid.
- ERROR_RCOSC32_INVALID : RC standby oscillator trim is invalid.
- ERROR_LSAD_INVALID : LSAD gain or offset is invalid.
- ERROR_TEMPERATURE_INVALID : Temperature sensor gain or offset is invalid.
- ERROR_THERMISTOR_INVALID : Thermistor gain or offset is invalid.
- ERROR_MEASURED_INVALID : Measured reference temperature is invalid.
- ERROR_TRIM_CUSTOM_SIGNATURE_INVALID : Custom signature check is invalid.
- ERROR_TRIM_CUSTOM_ICH_INVALID : Custom ICH trim value is invalid.
- ERROR_TRIM_CUSTOM_XTAL_INVALID : Custom Xtal trim value is invalid.
- TR_REG_TRIM_MASK : Temperature record 18-bit trim value mask.
- TRIM_8_BIT_TRIM_MASK : 8-bit trim value mask
- TRIM_16_BIT_TRIM_MASK : 16-bit trim value mask
- TRIM_NVR7_2_BIT_RC_FSEL_MASK
- TRIM_NVR7_VCC_DCDC_Pos
- LSAD_HF : LSAD high frequency compensation values.
- LSAD_LF : LSAD low frequency compensation values.
- LSAD_OFFSET : LSAD offset compensation address offset.
- LSAD_OFFSET_MASK : LSAD offset compensation mask.
- LSAD_GAIN : LSAD gain compensation address offset.
- LSAD_GAIN_MASK : LSAD gain compensation mask.
- TRIM : Default trim instance, pointing to NVR7.
- TRIM_SUPPLEMENTAL : Supplemental trim instance, pointing to NVR4.
- TRIM_CUSTOM_SIP1_SIGNATURE : SiP Signature for NVR6 custom trim calibration.
- TRIM_CUSTOM_CUST_SIGNATURE : Custom Signature for NVR6 custom trim calibration.
- ICH_TRIM_DEFAULT
- SYS_TRIM_LOAD_DEFAULT : Load default trim values from NVR7.
- SYS_TRIM_LOAD_SUPPLEMENTAL : Load supplemental trim values from NVR4.
- SYS_TRIM_LOAD_CUSTOM : Load custom trim values from NVR6.

Functions

- Sys_Trim_LoadTrims : Load trim values from the specified memory location.
- Sys_Trim_LoadSingleTrim : Load a trim value for a specific voltage regulator or oscillator.
- Sys_Trim_VerifyTrims : Verify if the trims memory is populated correctly.
- Sys_Trim_CheckCRC : Check if the CRC for the indicated region is valid.
- Sys_Trim_GetTrim : Get the trim value requested, check if it is valid.
- Sys_Trim_LoadBandgap : Load target trim value, if present.
- Sys_Trim_LoadDCDC : Load target trim value for current mode (LDO or BUCK).
- Sys_Trim_LoadVDDC : Load target trim value, if present.
- Sys_Trim_LoadVDDM : Load target trim value, if present.
- Sys_Trim_LoadVDDPA : Load target trim value, if present.
- Sys_Trim_LoadVDDRF : Load target trim value, if present.
- Sys_Trim_LoadCustom : Load custom trim values from NVR6.
- Sys_Trim_LoadVDDFLASH : Load target trim value, if present.
- Sys_Trim_LoadRCOSC : Load target trim value, if present.
- Sys_Trim_LoadRCOSC32 : Load target trim value, if present.
- Sys_Trim_LoadThermistor : Load target trim value, if present.
- Sys_Trim_GetLSADTrim : Load LSAD gain and offset value from specified address. Verifies valid values first.