PSoC® Creator™ Component Datasheet 调整和容限 1.30 特性 可与大多数的可调整的 DC-DC 转换器或稳压器一起使用，包括 LDO、开关电路和模块 最多支持 24 个 DC-DC 转换器 8 到 10 位分辨率 PWM 伪 DAC 输出 与电源监控器组件一起使用时，支持实时闭环有源微调 对容限的内置支持 概述 调整和容限组件提供了一种简单的方式来调节和控制最多 24 个 DC-DC 转换器的输出电压，以满 足系统电源要求。 此组件的用户可在直观、易于使用的图形配置 GUI 中轻松地输入电源转换器的额定输出电压、电 压调整范围、容限高设置和容限低设置，剩下的工作由此组件完成。此组件还将协助用户基于性 能要求选择适当的外部无源器件值。 提供的固件 API 使用户能够将电源转换器的输出电压手动调整至电源转换器的工作范围限制内的 任何需要的级别。使用用户控制的更新频率，通过连续运行的背景任务支持实时有源调整或容 限。 何时使用调整和容限 调整和容限组件应用于需要 PSoC 调节和控制多个 DC-DC 电源转换器的输出电压的任何应用。使 用调整和容限组件以及其他功率监控组件来构建您的自定义功率监控解决方案。 赛普拉斯半导体公司• 198 Champion Court • San Jose, CA 95134-1709 • 408-943-2600 Document Number: 001-89813 *A 修订时间：April 22, 2014 Trim and Margin PSoC® Creator™ Component Datasheet 输入/输出接口 本节介绍调整和容限组件的各种输入和输出连接。I/O 列表中的星号（*）表示它是可隐藏的 I/O， 其隐藏条件描述在该 I/O 的说明中。 时钟 — 输入 用于驱动PWM伪DAC输出的时钟信号 启用 — 输入 高电平有效时钟启用与时钟输入保持同步。设置此信号有效将使能PWM。此同步高电平有效信号 作为使能PWM的时钟使用 页 2/24 Document Number: 001-89813 *A PSoC® Creator™ Component Datasheet Trim and Margin 警报 – 输出 由于PWM处于最小或最大占空比，当未达到闭环调整/容限时，Alert将被设置为高电平有效信号， 但不会达到电源转换器所需的输出电压。只要任何输出上存在警报条件，将保持设置。 trim[1..24] — 输出* 这些终端是PWM输出，它们通过外部RC滤波器以生成模拟控制电压，此电压用于调节关联电源转 换器的输出电压。这些终端的数量通过Number of converters（电压数量）参数设置。 原理图宏的信息 本节包含与调整和容限组件的原理图宏相关的信息。 调整和容限 — 8 个轨道 此宏支持 8 个 8 位分辨率 PWM 输出。时钟输入设置为 36 MHz。 Document Number: 001-89813 *A 页 3/24 Trim and Margin PSoC® Creator™ Component Datasheet 调整和容限 — 16 个轨道 此宏支持 16 个 8 位分辨率 PWM 输出。时钟输入设置为 36 MHz。 页 4/24 Document Number: 001-89813 *A PSoC® Creator™ Component Datasheet Trim and Margin 调整和容限 — 24 个轨道 此宏支持 24 个 8 位分辨率 PWM 输出。时钟输入设置为 36 MHz。 Document Number: 001-89813 *A 页 5/24 PSoC® Creator™ Component Datasheet Trim and Margin 组件参数 将调整和容限组件拖入设计中，双击它以打开 Configure（配置）对话框。该对话框包含具有各种 参数的不同选项卡，以及带有常用指令的工具栏。 Voltages（电压）选项卡 Voltages 选项卡允许您了解每个电源转换器的电压特性：额定电压、所需的调整/容限动态范围和 容限高/低设置。显示的行数取决于 Number of voltages（电压数量）参数。 Number of converters（转换器数） 要调整或容限的电源转换器数量。 Name（名称） 文本字段，16 个字符。仅用于注释目的，用于协助用户将此组件的 PWM 输出与其控制的电源转 换器的功能相关联。 Nominal voltage（额定电压） 额定转换器输出电压。仅用于注释目的。 Trim/margin range Min voltage（调整/容限范围最小电压） 转换器最小输出电压。对外部组件产生影响，以达到所需的动态范围的低端。 Calculated Min voltage（计算后的最小电压） 根据在 Hardware（硬件）选项卡中输入的实际组件值计算得出的最小电压。 Vmin calc[ x ] Vnom[ x ] Vresolution[ x ] 2^ 页 6/24 PWMresolution 1 PWM dutycycle Document Number: 001-89813 *A PSoC® Creator™ Component Datasheet Trim and Margin Trim/margin range Max voltage（调整/容限范围最大电压） 转换器最大输出电压。影响外部组件，以达到需要的动态范围的高端。 Calculated Max voltage（计算后的最大电压） 根据在 Hardware（硬件）选项卡中输入的实际组件值计算得出的最大电压。 Vmax calc[ x ] Vnom[ x ] Vresolution[ x ] PWM dutycycle Startup voltage（启动电压） 使用于转换器的用户可配置启动电压。 Margin low（容限低） 用于响应容限低请求所需的转换器输出电压。所需要输入的值是额定电压的百分比。在单独栏 中，该值的单位被转换为伏特。 Margin high（容限高） 用于响应容限高请求所需的转换器输出电压。所需要输入的值是额定电压的百分比。在独立的栏 中，该值的单位被转换为伏特。 Document Number: 001-89813 *A 页 7/24 PSoC® Creator™ Component Datasheet Trim and Margin Hardware（硬件）选项卡 Hardware 选项卡允许您设置硬件参数，如 PWM 分辨率、PWM I/O 电源电压、电源转换器数据 手册参数和外部电路。 底部的电路图旨在帮助您将表格中的器件名称与您的原理图上所需要的器件相关联。 显示的行数通过 Number of voltages 参数设置。 该选项卡下的 Name 和 Nominal voltage 数据是从 Voltages 选项卡中引用过来的，仅供参考， 而不能进行编辑。 PWM resolution（PWM 分辨率） PWM 伪 DAC 输出的分辨率。可在 8 到 10 位之间选择，以让用户在控制电压的粒度和 PWM 输出 频率之间选择最佳权衡。 PWM frequency（PWM 频率） 根据输入时钟计算得出的 PWM 输出频率。 Fpwm F 2 Clock ^ PWMresolution PWM output pin Vddio（PWM 输出引脚 Vddio） 与关联 PWM 输出引脚一起使用的 Vddio 电压。 页 8/24 Document Number: 001-89813 *A PSoC® Creator™ Component Datasheet Trim and Margin Vadj voltage at Vnom（Vnom 时的 Vadj 电压） 调节/反馈控制引脚处为了达到额定输出电压的控制电压。 R1 为了在调节/反馈控制引脚上得到适当的电压，从而在 PWM 输出被禁用时达到额定输出电压所需 的外部扩展电阻值（单位为 kΩ）。此值源自基于电源转换器数据手册规范的用户的 PCB。 R2 为了在调节/反馈控制引脚上达到适当的电压，从而在 PWM 输出被禁用时达到额定输出电压所需 的外部扩展电阻值（单位为 kΩ）。此值源自基于电源转换器数据手册规范的用户的 PCB。 Adjusted R2（调整后的 R2） R2 的实际值可能与用户所输入的值不同。该值可能受与 R2 并行的内部电源转换器阻抗的影响。 例如，ADP3331 的电压调节器的阻抗为 R3int + R4int。因此，要根据下面公式重新计算 R2adj。 R2 adj[ x ] Vadj[ x ] R1[ x ] Vnom[ x ] Vadj[ x ] Calculated R3（已计算的 R3） 外部控制电压求和电阻值（单位为 kΩ）。此值主要控制 PWM 输出的动态范围功能。此值是根据 “Voltages”选项卡中指定的所需调整/容限范围最小/最大值、控制电压（Vadj）以及 R1 和 R2adj 的值进行计算的。 ( R3 R4 )calc[ x ] V max [ x ] Vadj[ x ] R1[ x ] R2 adj[ x ] R2 adj[ x ] Vadj[ x ] R1[ x ] R2 adj[ x ] 总电阻应拆分为 R3 和滤波电阻 R4。 R3calc[ x ] ( R3 R4 ) calc[ x ] R4calc[ x ] 显示的值接近于标准的电阻值，其错差不超过 1%。 R3 用户需要输入他们将在 PCB 上使用的实际电阻值以计算实际动态范围。 Document Number: 001-89813 *A 页 9/24 PSoC® Creator™ Component Datasheet Trim and Margin Calculated R4（已计算的 R4） 外部控制电压滤波电阻值（单位为 kΩ）。此值控制 PWM 输出上 RC 滤波器的截止频率。显示的 值接近于标准的电阻值，其错差不超过 1%。 R4calc[ x ] ( R3 R4 ) calc[ x ] 11 R4 用户需要输入他们将在 PCB 上使用的实际电阻值以计算实际波纹。 Max Ripple on Vadj（Vadj 上的最大波纹） 用户可以指定 RC 滤波器输出上显示的最大允许波纹，它由 R4 和 C1 构成。为此参数设置过低的 值将导致 C1 的组件值很大。 Calculated Max Ripple（计算最大波纹） 根据向 R4 和 C1 输入的实际值计算预期波纹。 VMaxRipple_ calc[ x ] Vddio[ x ] 2 R4[ x ] Fpwm C1[ x ] Calculated C1（所计算的 C1） 外部控制电压滤波电容值（单位为 μF）。此值控制 PWM 输出上 RC 滤波器的截止频率。该值是 根据 Voltages（电压）选项卡中输入的 R4、PWM 分辨率以及此组件的源时钟的频率输入计算得 出的。 C1calc[ x ] Vddio[ x ] 2 R4[ x ] Fpwm VMaxRipple[ x ] C1 用户需要输入在 PCB 上使用的实际电容值以计算实际动态范围。 Nominal PWM（额定 PWM） 显示了计算 PWM 占空比的公式，以获取额定电压值。 PWM dutycycle 页 10/24 Vadj[ x ] Vddio[ x ] 2^ PWMresolution Document Number: 001-89813 *A PSoC® Creator™ Component Datasheet Trim and Margin Trim/Margin resolution（调整/容限分辨率） 此参数表示由占空比以一个步长更改所导致的电源转换器的输出电压变化。使用以下公式计算该 值。 Vresolution[ x ] Vmax real[ x ] Vnom[ x ] PWM dutycycle 其中，根据用户输入的实际 R3 和 R4 的值以及重新计算的 R2adj 值，来计算实际的最大输出电压 （Vmaxreal）。 Vmax real[ x ] Vadj[ x ] R1[ x ] R2 adj[ x ] || ( R3[ x ] R4[ x ] ) Vadj[ x ] 工具栏指令 Load configuration（加载配置） 从某个外部文件恢复所有定制器设置，包括各表。键盘快捷方式 — [Ctrl] [L] Save configuration（保存配置） 存储到某个外部文件中的所有定制器设置，包括各表。键盘快捷方式 — [Ctrl] [S] Import table（导入表格） 将数据从文件导入到工作选项卡上的表格单元格内。支持“.csv”文件格式。键盘快捷方式 — [Ctrl] [M] Export table（导出表格） 将数据从工作选项卡上的表格单元格导出到文件中。支持“.csv”文件格式。键盘快捷方式 — [Ctrl] [R]。 Import all（全部导入） 执行 Voltages（电压）和 Hardware（硬件）表格的导入功能。键盘快捷方式 — [Ctrl] [Alt] [M] Export all（全部导出） 执行 Voltages 和 Hardware 表格的导出功能。键盘快捷方式 — [Ctrl] [Alt] [R]。 Document Number: 001-89813 *A 页 11/24 PSoC® Creator™ Component Datasheet Trim and Margin 时钟选择 该组件中没有内部时钟。您必须添加一个时钟源。此组件根据连接到组件的单一时钟进行操作。 应用编程接口 应用编程接口（API）允许您使用软件配置及控制组件。下面的表格列出并说明了每个函数的接 口。以下各节将更详细地介绍每个函数。 默认情况下，PSoC Creator 将实例名称“TrimMargin_1”分配给指定设计中组件的第一个实例。 您可以将其重新命名为遵循标识符语法规则的任何唯一值。实例名称会成为每个全局函数名称、 变量和常量符号的前缀。为了便于阅读，下表中使用的实例名称为“TrimMargin”。 函数 函数 说明 TrimMargin_Start() 启用此组件 TrimMargin_Stop() 禁用组件 TrimMargin_Init() 初始化组件的参数 TrimMargin_Enable() 使能输出并启动各PWM TrimMargin_SetMarginHighVoltage() 设置容限高电平输出电压参数 TrimMargin_GetMarginHighVoltage() 返回容限高电平输出电压参数 TrimMargin_SetMarginLowVoltage() 设置容限低电平输出电压参数 TrimMargin_GetMarginLowVoltage() 返回容限低电平输出电压参数 TrimMargin_ActiveTrim() 调整指定电源转换器的PWM占空比，以使电源转换器的实际 电压输出更接近于所需的电压输出。 TrimMargin_SetDutyCycle() 设置与指定电源转换器相关联的当前PWM的占空比 TrimMargin_GetDutyCycle() 获得与指定电源转换器相关联的当前PWM的占空比 TrimMargin_GetAlertSource() 返回一个位掩码，用于说明正在生成警报的PWM。 TrimMargin_MarginLow() 将电源转换器的输出电压设置为容限低电平电压 TrimMargin_MarginHigh() 将电源转换器的输出电压设置为容限高电平电压 TrimMargin_SetNominal() 将电源转换器的输出电压设置为额定电压 TrimMargin_SetPreRun() 在使能电源转换器前，设置所需的预充电PMW占空比，以获 得额定电压。 TrimMargin_SetStartup() 将电源转换器的输出电压设置为启动电压 页 12/24 Document Number: 001-89813 *A PSoC® Creator™ Component Datasheet Trim and Margin 函数 说明 TrimMargin_SetStartupPreRun() 在使能电源转换器前，设置所需的预充电PMW占空比，以获 得启动电压。 TrimMargin_ConvertVoltageToDutyCycle() 返回所要求的PWM占空比，以在选定的电源转换器上得到所 需的电压。 TrimMargin_ConvertVoltageToPreRunDutyCycle() 返回所要求的预充电PWM占空比，以在选定的电源转换器上 得到所需的电压。 全局变量 函数 说明 TrimMargin_initVar initVar变量用于说明此组件的初始配置。此变量前面附带了组件名称。此变 量被初始化为0，并在第一次调用TrimMargin_Start()时设置为1。这可以实 现组件初始化，同时无需重新初始化TrimMargin_Start()子程序中的所有后 续调用。 TrimMargin_vMarginLow[] 容限低输出电压参数。它被Init()函数初始化为自定义程序中Voltages（电 压）选项卡中输入的容限低值，且可通过 TrimMargin_SetMarginLowVoltage()函数进行更改。 TrimMargin_vMarginHigh[] 容限高输出电压参数。它被Init()函数初始化为自定义程序中Voltages（电 压）选项卡中输入的容限高值，且可通过 TrimMargin_SetMarginHighVoltage()函数进行更改。 TrimMargin_vMarginLowDutyCycle[] 针对从Init()函数中的ROM中复制的容限低电压的预计算PWM占空比。当设 置好了新的容限值时，可通过TrimMargin_SetMarginLowVoltage()函数重新 计算这些值。由MarginLow()用于设置闭环容限的PWM。 TrimMargin_vMarginHighDutyCycle[] 针对从Init()函数中的ROM中复制的容限高电压的预计算PWM占空比。当设 置了新的容限值时，可通过TrimMargin_SetMarginLowVoltage()函数重新计 算此些值。由MarginHigh()用于设置闭环容限的PWM。 void TrimMargin_Start(void) 说明： 使能组件。如果组件之前未被初始化，则请调用Init() API。调用Enable() API。 参数： 无 返回值： 无 其他影响： 无 Document Number: 001-89813 *A 页 13/24 PSoC® Creator™ Component Datasheet Trim and Margin void TrimMargin_Stop(void) 说明： 禁用组件。停止PWM。 参数： 无 返回值： 无 其他影响： trim[x]输出在未定义状态中暂停。使用特定于引脚的API PinName_SetDriveMode(PIN_DM_DIG_HIZ)，将连接至这些输出引脚的驱动模式更改为高阻 抗数字。 void TrimMargin_Init(void) 说明： 将器件的参数初始化为原理图上放置的器件的自定义程序中由用户设置的参数。通常被称为 TrimMargin_Start() API。 将PWM占空比设置为―预运行‖目标，用于假定未启动（已禁用）电源转换器。 参数： 无 返回值： 无 其他影响： 无 void TrimMargin_Enable(void) 说明： 启用并启动PWM。 参数： 无 返回值： 无 其他影响： 无 页 14/24 Document Number: 001-89813 *A PSoC® Creator™ Component Datasheet Trim and Margin void TrimMargin_SetMarginHighVoltage(uint8 converterNum, uint16 marginHiVoltage) 说明： 设置指定电源转换器的容限高输出电压参数。此函数覆盖自定义程序中Voltages（电压）选项 卡上进行的TrimMargin_vMarginHigh[x]设置，并重新计算供TrimMargin_MarginHigh()宏使用 的TrimMargin_vMarginHighDutyCycle[x]。注意，调用此API不会导致PWM输出占空比出现更 改。 参数： uint8 converterNum。指定电源转换器编号 有效范围：1至24 uint16 marginHiVoltage。指定电源转换器所需的输出容限高电压（单位为mV） 有效范围：1至12,000 返回值： 无 其他影响： 无 uint16 TrimMargin_GetMarginHighVoltage(uint8 converterNum) 说明： 返回指定电源转换器的容限高输出参数 参数： uint8 converterNum。指定电源转换器编号 有效范围：1至24 返回值： uint16：指定电源转换器所需的输出容限高电压（单位为mV） 其他影响： 无 void TrimMargin_SetMarginLowVoltage(uint8 converterNum, uint16 marginLoVoltage) 说明： 设置指定电源转换器的容限低输出电压参数。此函数覆盖自定义程序中Voltages（电压）选项 卡上进行的TrimMargin_vMarginLow[x]设置，并重新计算供TrimMargin_MarginLow()宏使用的 TrimMargin_vMarginLowDutyCycle[x]。注意，调用此API不会导致PWM输出占空比出现更 改。 参数： uint8 converterNum。指定电源转换器编号 有效范围：1至24 uint16 marginLoVoltage。指定电源转换器所需的输出容限低电压（单位为mV） 有效范围：1至11,999 返回值： 无 其他影响： 无 Document Number: 001-89813 *A 页 15/24 PSoC® Creator™ Component Datasheet Trim and Margin uint16 TrimMargin_GetMarginLowVoltage(uint8 converterNum) 说明： 返回指定电源转换器的容限低输出参数 参数： uint8 converterNum。指定电源转换器编号 有效范围：1至24 返回值： uint16：指定电源转换器所需的输出容限低电压（单位为mV） 其他影响： 无 void TrimMargin_ActiveTrim(uint8 converterNum, uint16 actualVoltage, uint16 desiredVoltage) 说明： 此API调整指定电源转换器的PWM占空比，以使电源转换器的实际电压输出更接近于需要的电 压输出。需要定期调用它以确保达到了适当的闭环调节 参数： uint8 converterNum。指定电源转换器编号 有效范围：1至24 uint16 actualVoltage 指定电源转换器中当前实际输出的电压读数（单位为mV）。可通过使用连接至电源转换器输 出电压的电源监控器组件获得此值 有效范围：1至12,000 uint16 desiredVoltage：指定电源转换器所需的输出电压（单位为mV） 有效范围：1至12,000 返回值： 无 其他影响： 调用此API可能会导致驱动选定电源转换器的控制电压的PWM占空比出现更改，从而导致电源 转换器输出电压出现更改。 如果由于PWM占空比处于最小或最大级别而无法达到需要的电压，将设置警报信号，直至此 警报条件被解除，而且只有通过调用API和使用可达到的需要电压方可解除。 页 16/24 Document Number: 001-89813 *A PSoC® Creator™ Component Datasheet Trim and Margin void TrimMargin_SetDutyCycle(uint8 converterNum, uint8/uint16 dutyCycle) 说明： 设置与指定电源转换器相关联的脉冲宽度调制器的PWM占空比。此API可用于闭环调整或容限 目的。PWM周期始终固定使用最大值，取决于自定义程序中设置的分辨率。 参数： uint8 converterNum。指定电源转换器编号 有效范围：1至24 uint8/uint16 dutyCycle。指定PWM时钟计数中的PWM占空比 有效范围：0..255到0..1023，取决于自定义程序中设置的分辨率 返回值： 无 其他影响： 无 uint8/uint16 TrimMargin_GetDutyCycle(uint8 converterNum) 说明： 获得与指定电源转换器相关联的当前脉冲宽度调制器的PWM占空比。注意，如果定期调用 TrimMargin_ActiveTrim()API，应预计返回的值会随着时间出现更改。 参数： uint8 converterNum。指定电源转换器编号 有效范围：1至24 返回值： uint8/uint16。指定PWM时钟计数中的PWM占空比 有效范围：0..255到0..1023，取决于自定义程序中设置的分辨率 其他影响： 无 uint8/uint16/uint32 TrimMargin_GetAlertSource(void) 说明： 返回一个位掩码，用于说明正在生成警报的PWM。 参数： 无 返回值： uint8/uint16/uint32。 位字段 位0 1 = 无法在trim1输出上实现电源转换器调节 位1 1 = 无法在trim2输出上实现电源转换器调节 … … 位23 其他影响： 警报源 1 = 无法在trim24输出上实现电源转换器调节 无 Document Number: 001-89813 *A 页 17/24 PSoC® Creator™ Component Datasheet Trim and Margin void TrimMargin_MarginLow(uint8 converterNum) 说明： 将选定电源转换器的输出电压设置为自定义程序Voltages（电压）选项卡中指定的需要容限低 设置，或按照SetMarginLowVoltage() API设置此输出电压。 参数： uint8 converterNum。指定电源转换器编号 有效范围：1至24 返回值： 无 其他影响： 无 void TrimMargin_MarginHigh(uint8 converterNum) 说明： 将选定电源转换器的输出电压设置为自定义程序Voltages（电压）选项卡中指定的需要容限高 低设置，或按照SetMarginHighVoltage() API设置此输出电压。 参数： uint8 converterNum。指定电源转换器编号 有效范围：1至24 返回值： 无 其他影响： 无 void TrimMargin_SetNominal( uint8 converterNum) 说明： 将选定电源转换器的输出电压设置为自定义程序中Voltages（电压）选项卡中指定的Nominal Voltage（标称电压）设置。 参数： uint8 converterNum。指定电源转换器编号 有效范围：1至24 返回值： 无 其他影响： 无 void TrimMargin_SetPreRun(uint8 converterNum) 说明： 将预充电PWM占空比设置为要求在假定R1与R2并联接地电源转换器使能之前获得标称电压。 参数： uint8 converterNum。指定电源转换器编号 有效范围：1至24 返回值： 无 其他影响： 无 页 18/24 Document Number: 001-89813 *A PSoC® Creator™ Component Datasheet Trim and Margin void TrimMargin_SetStartup(uint8 converterNum) 说明： 将选定电源转换器的输出电压设置为自定义程序中Voltages（电压）选项卡中指定的Nominal Voltage（标称电压）设置。 参数： uint8 converterNum。指定电源转换器编号 有效范围：1至24 返回值： 无 其他影响： 无 void TrimMargin_SetStartupPreRun(uint8 converterNum) 说明： 将预充电PWM占空比设置为要求在假定R1与R2并联接地电源转换器使能之前获得启动电压。 参数： uint8 converterNum。指定电源转换器编号 有效范围：1至24 返回值： 无 其他影响： 无 void TrimMargin_ConvertVoltageToDutyCycle(uint8 converterNum, uint16 desiredVoltage) 说明： 返回所需的PWM占空比，以获得在选择的电源转换器上所需的电压。 参数： uint8 converterNum。指定电源转换器编号 有效范围：1至24 uint16 desiredVoltage。指定电源转换器所需的输出电压（单位为 mV） 返回值： 无 其他影响： 无 Document Number: 001-89813 *A 页 19/24 PSoC® Creator™ Component Datasheet Trim and Margin void TrimMargin_ConvertVoltageToPreRunDutyCycle(uint8 converterNum, uint16 desiredVoltage) 说明： 返回所需的预充电PWM占空比，以获得在选择的电源转换器上所需的电压。 参数： uint8 converterNum。指定电源转换器编号 有效范围：1至24 uint16 desiredVoltage。指定电源转换器所需的输出电压（单位为 mV） 返回值： 无 其他影响： 无 MISRA 符合性 本节介绍了 MISRA-C:2004 规范以及本组件的偏差情况。定义了下面两种类型的偏差： 项目偏差 — 适用于所有 PSoC Creator 器件的偏差 特定偏差 — 仅适用于该组件的偏差 本节介绍了有关组件特定偏差的信息。《系统参考指南》的“MISRA 符合性”章节中介绍了项目 偏差以及有关 MISRA 符合性验证环境的信息。 此调整和容限组件具有如下特定偏差： MISRA-C: 2004规则 19.7 规则类别 （必须（Required） /建议(Advisory)） 建议(A) 规则描述 函数应该优先于类似于函数的宏。 偏差说明 因为使用函数宏以实现更高的代码效 率而导致了偏差。 该组件配有以下嵌入式组件：ControlReg。MISRA 合规性与特定偏差的相关信息，请参见相应组 件数据手册。 固件源代码示例 在 Find Example Project 对话框中，PSoC Creator 提供了大量的示例项目，包括原理图和示例代 码。要获取组件特定的示例，请打开器件目录中的对话框或原理图中的器件实例。要查看通用示 例，请打开‘Start Page’或 File 菜单中的对话框。根据要求，可以通过使用对话框中的 Filter Options 选项来限定可选的项目列表。 更多有关信息，请参考《PSoC Creator 帮助》中主题为“查找示例项”的部分。 页 20/24 Document Number: 001-89813 *A PSoC® Creator™ Component Datasheet Trim and Margin 功能说明 此器件是由大量的 8 位或 10 位的 PWM 构建的。PSoC 中的脉 PWM 输出经过 RC 的过滤以生成 模拟控制电压，这些电压通过求和电阻连接至可调节电源转换器的“调节”、“感应”或“反 馈”点。下图显示了这一过程。 这是一个负反馈控制回路，其中增大脉冲宽度调制器占空比会增大模拟控制电压，进而会导致电 源转换器的输出电压减小。相反，减小脉冲宽度调制器占空比会减小模拟控制电压，进而会导致 电源转换器的输出电压增大。 此模块需要包括调节或反馈控制电压级别以及达到标称输出电压所需的反馈电阻 R1 和 R2 的值， 以在良好的配置中启动，而不会对电源转换器的输出造成不利影响。此信息可在电源转换器基本 介绍中找到。 已基于配置对话中硬件选项卡中的参数设置推荐求和电阻 R3 与 RC 滤波器值 R4 和 C1。 使用资源 调整和容限器件放置在整个 UDB 阵列中。该组件利用以下资源。 资源类型 配置 数据路径 单元 宏单元 状态单元 控制单元 DMA通道 中断 4输出TrimMargin（10位） 4 1 – 1 – – 24输出TrimMargin（8位） 12 1 – 1 – – Document Number: 001-89813 *A 页 21/24 PSoC® Creator™ Component Datasheet Trim and Margin API 存储器的使用情况 根据编译器、器件、所使用的 API 数量以及组件的配置情况的不同，组件所用的存储器使用情况 也不一样。下表提供了给定组件配置中的所有 API 的存储器使用情况。 通过使用 Release（释放）模式下的优化选项配置为空间的相应编译器，完成了资源占用的测 量。对于特定的设计，分析编译器生成的映射文件后可以确定存储器的使用情况。 PSoC 3（Keil_PK51） PSoC 5LP（GCC） 配置 SRAM 闪存字节 SRAM字节 闪存字节 4输出TrimMargin 1709 42 1006 45 24输出TrimMargin 2472 197 1982 197 字节 直流和交流的电气特性 除非另有说明，否则这些规范的适用条件是：-40°C ≤ TA ≤ 85 °C 且 TJ ≤ 100 °C。除非另有说 明，否则这些规范的适用范围为 1.71 V 到 5.5 V。 直流特性 参数 IDD 1 说明 最小值 典型值 [1] 最大值 单位 组件电流消耗 8位单个调整输出 – 2.5 – µA/MHz 9位或10位单个调整输出 – 4 – µA/MHz 未包括设备 IO 和时钟分配的电流。这些值是在温度为 25 °C 时的值。 页 22/24 Document Number: 001-89813 *A PSoC® Creator™ Component Datasheet Trim and Margin 交流特性 参数 说明 典型值 4输出TrimMargin（10位） – – 50 MHz 24输出TrimMargin（8位） – – 55 MHz 组件时钟频率 fCLOCK 最大值 [2] 最小值 单位 [3] 组件勘误表 本部分列出了已知的组件问题。 赛普拉 斯ID 155210 组件版本 所有器件 问题 解决方案 当计算达到所需电压目标所需的占空比时，调整和 容限组件符合特定模型。该模型符合赛普拉斯 CY8CKIT-036开发套件中所配置的线性稳压器，并 不符合其他配置或开关电源。 因此，进行容限时，使用与该器件不符的转换器会 导致过冲或下冲电压。 请检查并核对系统的电源调节器 和该组件预期的配置情况。 需要了解系统中的调节器应不应 该使用其他模型，请联系赛普拉 斯技术支持组，以得到关于如何 将组件适用于系统设计的帮助。 组件更改 本节列出了该组件各版本中的主要更改内容。 版本 更改说明 更改原因/影响 1.30.a 添加了组件Errata章节。 列出组件的已知问题。 1.30 修正了有关 TrimMargin_ConvertVoltageToDutyCycle() API函 数的问题。 此API函数在PSoC 3中不正确运行。 对数据手册进行了少量纠正。 1.20.a 清除了数据手册中有关PSoC 5的参考内容。 PSoC 5被替代为PSoC 5LP。 1.20 已添加了MISRA符合性章节。 该组件具有所描述的特定偏差。 已在定制器的“Hardware”选项卡下添加了 增强可用性。 2 这些值提供了此组件的最大安全工作频率。可以在更高的时钟频率下运行组件，在该频率将需要使用 STA 结果验证时序要求。 3 最大组件时钟频率取决于所选模式和其他功能。 Document Number: 001-89813 *A 页 23/24 PSoC® Creator™ Component Datasheet Trim and Margin 版本 更改说明 更改原因/影响 “PWM frequency”（PWM频率）字段。 添加了“Load / Save configuration”（加载/保存 配置）指令。 更新了定制器的Vmax、Vmin、R2、R3、R4、最 大波形、C1以及额定PWM等数值。 增强可用性。 为了设置电压，已在定制器的“Voltages”选项卡 添加了“Startup voltage”（启动电压）列，并且 还添加了下面的API：TrimMargin_SetStartup()、 TrimMargin_SetStartupPreRun()。 启动自定义电压的能力。 添加了下面的API，用于将电压转换为PWM占空 比： 支持对任意电压的调整。 TrimMargin_ConvertVoltageToDutyCycle() TrimMargin_ConvertVoltageToPreRunDutyCycle() 1.10 1.0 更新了宏的名称及配置。 Import All（全部导入）和Export All（全部导出） 功能向单个CSV文件（不是多个文件）导入/导出 所有表格。更改了CSV格式，使用了“,”分隔符 号。 这能够使用户更加方便地手动编辑器件配置。 已将“Trim/Margin Resolution”（调整/容限分辨 率）列添加到“Hardware”（硬件）选项卡中。 此参数表示由占空比以一个步长更改所导致的电源 转换器的输出电压变化。 此组件的最初版本。 © 赛普拉斯半导体公司，2014。此处，所包含的信息可能会随时更改，恕不另行通知。除赛普拉斯产品内嵌的电路外，赛普拉斯半导体公司不对任何其他电路的使用承担任何责任。也不会根据专 利权或其他权利以明示或暗示的方式授予任何许可。除非与赛普拉斯签订了明确的书面协议，否则赛普拉斯产品不保证产品能够用于或适用于医疗、生命支持、救生、关键控制或安全应用领域。 此外，对于可能发生运转异常和故障并对用户造成严重伤害的生命支持系统，赛普拉斯不授权将其产品用作此类系统的关键组件。若将赛普拉斯产品用于生命支持系统，则表示制造商将承担因此 类使用而招致的所有风险，并确保赛普拉斯免于因此而受到任何指控。 PSoC®是赛普拉斯半导体公司的注册商标，PSoC Creator™和 Programmable System-on-Chip™是赛普拉斯半导体公司的商标。该处引用的所有其它商标或注册商标归其各自所有者所有。 所有源代码（软件和/或固件）均归赛普拉斯半导体公司（赛普拉斯）所有，并受全球专利法规（美国和美国以外的专利法规）、美国版权法以及国际条约规定的保护和约束。赛普拉斯据此向获许 可者授予适用于个人的、非独占性、不可转让的许可，用以复制、使用、修改、创建赛普拉斯源代码的派生作品、编译赛普拉斯源代码和派生作品，并且其目的只能是创建自定义软件和/或固件， 以支持获许可者仅将其获得的产品依照适用协议规定的方式与赛普拉斯集成电路配合使用。除上述指定用途外，未经赛普拉斯的明确书面许可，不得对此类源代码进行任何复制、修改、转换、编 译或演示。 免责声明：赛普拉斯不针对该材料提供任何类型的明示或暗示保证，包括（但不仅限于）针对特定用途的适销性和适用性的暗示保证。赛普拉斯保留在不另行通知的情况下对此处所述材料进行更 改的权利。赛普拉斯不对此处所述之任何产品或电路的应用或使用承担任何责任。对于合理预计可能发生运转异常和故障，并对用户造成严重伤害的生命支持系统，赛普拉斯不授权将其产品用作 此类系统的关键组件。若将赛普拉斯产品用于生命支持系统，则表示制造商将承担因此类使用而导致的所有风险，并确保赛普拉斯免于因此而受到任何指控。 产品使用可能受适用的赛普拉斯软件许可协议限制。 页 24/24 Document Number: 001-89813 *A