Clock（时钟） 1.60 Features（特性） 快速定义新时钟 请参见系统或设计范围时钟 配置时钟频率容差 General Description（概述） 时钟组件具有两个重要功能：首先，它支持本地时钟的创建，其次，它支持在设计与系统及设计 范围时钟之间建立连接。有关所有时钟的详细信息，请参见 Design-Wide Resources（设计范围 资源）( DWR ) Clock Editor（时钟编辑器）这部分。有关更多信息，请参见 "PSoC Creator Help （帮助）" 的“Clock Editor（时钟编辑器）”这部分。 定义时钟有多种方法，例如： 作为自动选择时钟源的频率 作为用户选择时钟源的频率 作为分频器和用户选择的时钟源 如果指定频率，PSoC Creator 将自动选择能够产生最精确结果频率的分频器。若允许，PSoC Creator 还检测所有系统和设计范围时钟，并选择能够产生最精确结果频率的源和分频器对。 Appearance（外观） 时钟组件波形符号的颜色随时钟域的变化而变化（参见“DWR Clock Editor（时钟编辑器）”），如 下所示： 数字 - 波形颜色与数字连线的颜色相同，均为黑色外形。 Cypress Semiconductor Corporation • 198 Champion Court • San Jose, CA 95134-1709 • 408-943-2600 001-78343 Rev ** 模拟 - 波形颜色与模拟连线的颜色相同，均为黑色外形。 中间 - 波形颜色为白色，无外形。 Input/Output Connections（输入/输出连接） 本节介绍时钟的各种输入和输出连接。I/O 列表中的星号 (*) 表示 I/O 可能在该 I/O 说明中所列条 件的符号中隐藏。 时钟 – 输出 时钟具有标准的输出终端，通过此终端，可以访问时钟信号。 数据域 – 输出 * 如果选择 Force clock to be Analog Clock（强制时钟充当模拟时钟），此可选输出可以接入模 拟时钟的数据域输出。在 Configure（配置）对话框中，使用 Advanced（高级）选项卡中的选 项启用此输出。 Component Parameters（元件参数） 将 Clock（时钟）拖入设计中，双击 Clock（时钟），打开 Configure（配置）对话框。 注意： 对于您添加到设计中的任何本地时钟而言，DWR 时钟编辑器包含“Start on Reset”（“复位 启动”）选项，默认情况下，此选项为启用状态。在某些情况下，您需要以编程的方式控制时钟， 例如，降低功耗。在这种情况下，取消选择“Start on Reset”（“复位启动”）选项，在代码中插入 Clock_Start() 函数。更多信息，请参见此数据表中的“应用程序接口”这部分，或 PSoC Creator 帮 助的“时钟编辑器”这部分。 001-78343 Rev ** 第 2 页，共 23 页 Configure Clock Tab（配置时钟选项卡） Configure Clock（配置时钟）选项卡包含时钟类型和源参数。根据您的选择，此选项卡将包含其 他各种参数，如下图所示： Figure 1（图）. Clock Type（时钟类型）：New / Source（新建/源）：<Auto> <自动> 001-78343 Rev ** 第 3 页，共 23 页 Figure 2（图）. Clock Type（时钟类型）：New / Source（新建/源）：Specific Clock（特定 时钟） Figure 3（图）. Clock Type（时钟类型）：Existing （现有的） 以下各节介绍时钟组件参数： 001-78343 Rev ** 第 4 页，共 23 页 Clock Type（时钟类型） 共有两种时钟类型：新建时钟和现有时钟。对于新时钟而言，可以指定时钟源以使用或支持 PSoC Creator 通过选择 <自动> 来完成选择。如果选择 <Auto><自动>，还可以输入特定 Frequency （频率）和可选 Tolerance（容差）。如果指定一个 Source（源），则既可以指定 Frequency （频率），也可以选择 Divider（分频器）。对于现有时钟而言，仅可以选择时钟 Source（源）。 在电路图中，不同的配置显示不同的时钟符号，如下列示例所示。 在器件中，配置为 New（新建）的时钟组件消耗时钟源，并具有适时生成的 API。在器件中，配 置到系统或设计范围时钟的 Existing（现有）时钟组件不消耗任何物理源，而且不具有适时生成 的 API。相反，他们使用选定系统或设计范围时钟。 Source（源） 如果 PSoC Creator 自动定位可用源时钟，而该源时钟在向下分频时提供最精确的结果频率，则选 择<自动>（默认）。带有<Auto><自动>源的时钟仅可以输入所需频率。此外，还可以提供一个容 差（可选）。 从供应列表中选择一个系统或设计范围时钟，用来强制 PSoC Creator 使用那个时钟作为时钟源。 Frequency（频率） 输入所需频率和单位（默认值 = 24 MHz） 然后，PSoC Creator 将计算用来创建时钟信号的分颁 器，其结果尽可能接近于所需频率。 Tolerance（容差） 如果将<Auto><自动>选作时钟源，则可以输入该时钟所需的容差值（默认值为 ± 5%）。PSoC Creator 将确保结果时钟的精确度介于指定容差范围之内，如果所需时钟无法实现，则生成警告。 时钟容差指定为百分比。（Note（注意）：输入 ppm 将导致所输入的值被转换成相应的百分比 值。） 如果不存在所需容差范围，则取消选择容差旁边的复选框，而此时钟不会生成任何警告。 001-78343 Rev ** 第 5 页，共 23 页 Divider（除数） 如果选择特定的 Source（源），则可以为 Divider（分频器）输入显式值。另外，如果保留 Source（源）设置为<Auto><自动>，Divider（分频器）选项不可用 default（默认）。 如果选择 Divider（分频器）选项，则 Frequency（频率）选项不可用。 Advanced Tab（高级选项卡） 该 Advanced（高级）选项卡包含两个参数。 强制该时钟充当模拟时钟 若勾选此选项（默认值 = 未勾选），该选项添加模拟时钟版本终端，并且，该模拟时钟使用主数 据同步时钟作为重新同步时钟。若使用该时钟，则系统强制该时钟进入模拟域；然而，新添加的 终端位于数字域。 001-78343 Rev ** 第 6 页，共 23 页 与 MASTER_CLK 同步 若选择该选项（默认值 = 未选中），时钟与 MASTER（主控）时钟保持同步；否则，该时钟不同 步。 Placement（位置）和 Resources（资源） 资源使用情况因配置和连通性的不同而异。 配置为 Existing（现有）的时钟组件不消耗芯片上的任何资源。 配置为 New（新建）的时钟组件消耗单个时钟源。PSoC Creator 显示时钟是与数字外设连接 还是与模拟外设连接，并在必要时消耗数字时钟或模拟时钟源。 API Memory (Bytes)（API 存储器 （字节）） Digital Blocks（数字模块） RAM Datapaths Macro cells Status Registers Control Registers Counter7 Flash Analog Block （数据路 （宏单 （状态寄存 （控制寄 （计数器 （闪 （模拟模块） 径） 元） 器） 存器） 7） 存） 存） 外部 I/O）） N/A（不可用） N/A（不可 N/A（不 N/A（不可 N/A（不 N/A（不可 698 0 N/A（不可 用） 可用） 用） 可用） 用） 001-78343 Rev ** （随机 Pins (per External I/O) 访问内 （引脚（每个 用） 第 7 页，共 23 页 Application Programming Interface（应用程序编程接口） Application Programming Interface（应用程序编程接口） (API) 子程序允许您使用软件配置组 件。下表列出了每个函数的接口，并进行了说明。以下各节将详细介绍每个函数。 默认情况下，PSoC Creator 将实例名称“Clock_1”分配给指定设计中组件的第一个实例。您可以将 其重命名为遵循标识符语法规则的任何唯一值。实例名称会成为每个全局函数名称、变量和常量 符号的前缀。出于可读性考虑，下表中使用的实例名称为“Clock”（时钟）。 Note（注意）：在 Configure（配置）对话框中，配置为 Existing（现有）Clock Type（时钟类 型）的本地时钟均不生成任何 API。 Function（函数） Description（说明） Clock_Start() Enables the clock（启用时钟）。 Clock_Stop() Disables the clock（禁用时钟）。 Clock_StopBlock() 禁用时钟，并等待，直到该时钟被禁用时为止。 Clock_StandbyPower() 选择待机 Alternate Active（备用活动）操作模式的功耗。 Clock_SetDivider() 设置时钟分频器，并立即重启该时钟分频器。 Clock_SetDividerRegister() 设置时钟分频器，并立即重启该时钟分频器（可选）。 Clock_SetDividerValue() 设置时钟分频器，并立即重启该时钟分频器。 Clock_GetDividerRegister() 获得时钟分频器寄存器值。 Clock_SetMode() 设置用于控制时钟操作模式的标志。 Clock_SetModeRegister() 设置用于控制时钟操作模式的标志。 Clock_GetModeRegister() 获得时钟模式寄存器值。 Clock_ClearModeRegister() 清除用于控制时钟操作模式的标志。 Clock_SetSource() Sets the source of the clock.（设置时钟源）。 Clock_SetSourceRegister() Sets the source of the clock.（设置时钟源）。 Clock_GetSourceRegister() Gets the source of the clock.（获得时钟源）。 001-78343 Rev ** 第 8 页，共 23 页 Function（函数） Description（说明） Clock_SetPhase() 设置模拟时钟的相位延迟（仅为模拟时钟生成）。 Clock_SetPhaseRegister() 设置模拟时钟的相位延迟（仅为模拟时钟生成）。 Clock_SetPhaseValue() 设置模拟时钟的相位延迟（仅为模拟时钟生成）。 Clock_GetPhaseRegister() 获得模拟时钟的相位延迟（仅为模拟时钟生成）。 void Clock_Start(void) Description: （说明）： Starts the clock（启动时钟）。 Note（注意）：启动时，如果在 DWR 时钟编辑器中启用 Start on Reset（复位启动），则时 钟已经运行。 Parameters: Void （参数）： Return Value: Void （返回值）： Side Effects: （副作用）： 启用时钟。 void Clock_Stop(void) Description: （说明）： 停止时钟并立即返回。此 API 不需要运行源时钟，但可能在实际禁用硬件之前返回。如果调 用此函数之前更改时钟设置，则在启动时，时钟可能产生短时脉冲。为避免产生短时脉冲，请 使用 Clock_StopBlock() 函数。 Parameters: Void （参数）： Return Value: Void （返回值）： Side Effects: （副作用）： 禁用时钟。输出将为逻辑 0。 注：使用 PSoC 5 硅片时，具有“MASTER_CLK”源的时钟和分频器 1 将始终保持运行。 001-78343 Rev ** 第 9 页，共 23 页 void Clock_StopBlock(void) Description: （说明）： 返回前，停止时钟并等待硬件实际被禁用时为止。这样确保时钟从未被截断（禁用时钟和 API 返回前，大半个周期将终止）。注意：由于无法禁用停止的时钟，必须运行源时钟，或从不返 回 API。 Parameters: Void （参数）： Return Value: Void （返回值）： Side Effects: （副作用）： 禁用时钟。输出将为逻辑 0。 注：在 PSoC3 ES2 和 PSoC 5 硅片上不支持 Clock_StopBlock() API，并且不予生成该函数。 void Clock_StandbyPower(uint8 state) Description: （说明）： Parameters: （参数）： 选择待机 Alternate Active（备用活动）操作模式的功耗。 uint8 状态：0 值用于在备用活动模式期间禁用时钟，而非零用于启用时钟。 Return Value: Void （返回值）： Side Effects: （副作用）： None（无） void Clock_SetDivider(uint16 clkDivider) Description: （说明）： 修改时钟分频器，由此修改频率。当时钟分频器寄存器设置为零或被更改为除零以外的值时， 将暂时禁用该时钟，以便更改模式位。如果调用 Clock_SetDivider() 时启用时钟，则必须运行 源时钟。当前时钟周期将被截断，新的分频值将立即生效。 Parameters: （参数）： uint16 clkDivider：分频器寄存器值 (0-65,535)。该值不是分频器；时钟硬件由 clkDivider加1 后分频。例如，要按 2 对时钟进行分频，则此参数应设置为 1。 Return Value: Void （返回值）： Side Effects: （副作用）： 001-78343 Rev ** None（无） 第 10 页，共 23 页 void Clock_SetDividerRegister(uint16 clkDivider, uint8 reset) Description: （说明）： 修改时钟分频器，由此修改频率。当时钟分频器寄存器设置为零或被更改为除零以外的值时， 将暂时禁用该时钟，以便更改模式位。如果调用 Clock_SetDivider() 时启用时钟，则必须运行 源时钟。 Parameters: （参数）： uint16 clkDivider：分频器寄存器值 (0-65,535)。该值不是分频器；时钟硬件由 clkDivider加1 后分频。例如，要按 2 对时钟进行分频，则此参数应设置为 1。 uint8 复位：如果为非零值，重启时钟分频器；当前时钟周期将被截断，新的分频值立即生 效。如果为零，新的分频值将在当前时钟周期结束时生效。 Return Value: Void （返回值）： Side Effects: （副作用）： None（无） void Clock_SetDividerValue(uint16 clkDivider) Description: （说明）： 修改时钟分频器，由此修改频率。当时钟分频器寄存器设置为零或被更改为除零以外的值时， 将暂时禁用该时钟，以便更改模式位。如果调用 Clock_SetDivider() 时启用时钟，则必须运行 源时钟。当前时钟周期将被截断，新的分频值将立即生效。 Parameters: （参数）： uint16 clkDivider：分频值 (1-65535) 或零。如果 clkDivider 为零，则时钟为 65,536 分频。 该方法与 Clock_SetDivider() 之间的差异在于不必考虑 +1 因素。 Return Value: Void （返回值）： Side Effects: （副作用）： 001-78343 Rev ** None（无） 第 11 页，共 23 页 uint16 Clock_GetDividerRegister(void) Description: （说明）： Parameters: 获得时钟分频器寄存器值。 Void （参数）： Return Value: 时钟的分频值减去 1。例如，时钟设置为 2 频时，返回值为 1。 （返回值）： Side Effects: （副作用）： None（无） void Clock_SetMode(uint8 clkMode) Description: （说明）： Parameters: （参数）： 设置用于控制时钟操作模式的标志。此函数仅将标志从 0 改为 1；而已经为 1 的标志保持不 变。要清除标志，请使用 Clock_ClearModeRegister() 函数。该时钟必须在更改模式前禁用。 uint8 clkMode：位掩码包含要设置的位。对于 PSoC 3 和 PSoC 5 而言，clkMode 应是以下 可选位集合或组合： CYCLK_EARLY：启用初期相位模式。当分频器计时器达到分频值的 1/2 时，输出时钟将 出现上升沿。 CYCLK_DUTY：启用 50% 占空比输出。当启用时，输出时钟激活时间约为半个周期。当 禁用时，输出时钟激活时间为一个源时钟周期。 CYCLK_SYNC：启用输出同步化到主控时钟。这应针对所有同步化时钟而启用。 有关设置时钟模式的详细信息，请参见《技术参考手册》。有关具体内容，请参见 CLKDIST.DCFG.CFG2 寄存器。 Return Value: Void （返回值）： Side Effects: （副作用）： 001-78343 Rev ** None（无） 第 12 页，共 23 页 void Clock_SetModeRegister(uint8 clkMode) Description: （说明）： 同 Clock_SetMode()。设置用于控制时钟操作模式的标志。此函数仅将标志从 0 更改为 1；已 经为 1 的标志保持不变。要清除标志，请使用 Clock_ClearModeRegister() 函数。该时钟必须 在更改模式前禁用。 Parameters: （参数）： uint8 clkMode：位掩码包含要设置的位。它应是下列可选位设置或组合： CYCLK_EARLY：启用初期相位模式。当分频器计时器达到分频值的 1/2 时，输出时钟将 出现上升沿。 CYCLK_DUTY：启用 50% 占空比输出。当启用时，输出时钟激活时间约为半个周期。当 禁用时，输出时钟激活时间为一个源时钟周期。 CYCLK_SYNC：启用输出同步化到主控时钟。这应针对所有同步化时钟而启用。 有关设置时钟模式的详细信息，请参见《技术参考手册》。有关具体内容，请参见 CLKDIST.DCFG.CFG2 寄存器。 Return Value: Void （返回值）： Side Effects: （副作用）： None（无） uint8 Clock_GetModeRegister(void) Description: （说明）： Parameters: 获得时钟模式寄存器值。 Void （参数）： Return Value: 位掩码表示已启用模式位。有关模式位的详细信息，请参见 Clock_SetModeRegister() 和 （返回值）： Clock_ClearModeRegister() 说明。 Side Effects: （副作用）： 001-78343 Rev ** None（无） 第 13 页，共 23 页 void Clock_ClearModeRegister(uint8 clkMode) Description: （说明）： Parameters: （参数）： 清除用于控制时钟操作模式的标志。此函数仅将标志从 1 改为 0；已经为 0 的标志保持不变。 该时钟必须在更改模式前禁用。 uint8 clkMode：位掩码包含要清除的位。它应是下列可选位设置或组合： CYCLK_EARLY：启用初期相位模式。当分频器计时器达到分频值的 1/2 时，输出时钟将 出现上升沿。 CYCLK_DUTY：启用 50% 占空比输出。当启用时，输出时钟激活时间约为半个周期。当 禁用时，输出时钟激活时间为一个源时钟周期。 CYCLK_SYNC：启用输出同步化到主控时钟。这应针对所有同步化时钟而启用。 有关设置时钟模式的详细信息，请参见《技术参考手册》。有关具体内容，请参见 CLKDIST.DCFG.CFG2 寄存器。 Return Value: Void （返回值）： Side Effects: （副作用）： 001-78343 Rev ** None（无） 第 14 页，共 23 页 void Clock_SetSource(uint8 clkSource) Description: （说明）： Parameters: （参数）： 设置时钟的输入源。该时钟必须在更改源之前禁用。必须运行新和旧时钟源。 uint8 clkSource：应是下列输入源之一： CYCLK_SRC_SEL_SYNC_DIG：相位延迟主控时钟 CYCLK_SRC_SEL_IMO：内部主振荡器 CYCLK_SRC_SEL_XTALM：4-33 MHz 外部晶振 CYCLK_SRC_SEL_ILO：内部低速振荡器 CYCLK_SRC_SEL_PLL：锁相互环输出 CYCLK_SRC_SEL_XTALK：32.768 kHz 外部晶振 CYCLK_SRC_SEL_DSI_G：DSI 全局输入信号 CYCLK_SRC_SEL_DSI_D：DSI 数字输入信号 CYCLK_SRC_SEL_DSI_A：DSI 模拟输入信号 有关时钟源的详细信息，请参见《PSoC 技术参考手册》。 Return Value: Void （返回值）： Side Effects: （副作用）： 001-78343 Rev ** None（无） 第 15 页，共 23 页 void Clock_SetSourceRegister(uint8 clkSource) Description: （说明）： Parameters: （参数）： Same as Clock_SetSource(). 设置时钟的输入源。该时钟必须在更改源之前禁用。必须运行 新和旧时钟源。 uint8 clkSource：它应是下列输入源之一： CYCLK_SRC_SEL_SYNC_DIG：相位延迟主控时钟 CYCLK_SRC_SEL_IMO：内部主振荡器 CYCLK_SRC_SEL_XTALM：4-33 MHz 外部晶振 CYCLK_SRC_SEL_ILO：内部低速振荡器 CYCLK_SRC_SEL_PLL：锁相互环输出 CYCLK_SRC_SEL_XTALK：32.768 kHz 外部晶振 CYCLK_SRC_SEL_DSI_G：DSI 全局输入信号 CYCLK_SRC_SEL_DSI_D/CYCLK_SRC_SEL_DSI_A：DSI 输入信号 有关时钟源的详细信息，请参见《PSoC 技术参考手册》。 Return Value: Void （返回值）： Side Effects: （副作用）： None（无） uint8 Clock_GetSource(void) Description: （说明）： Parameters: 获得时钟的输入源。 Void （参数）： Return Value: 时钟的输入源。有关详细信息，请参见 Clock_SetSourceRegister()。 （返回值）： Side Effects: （副作用）： 001-78343 Rev ** None（无） 第 16 页，共 23 页 void Clock_SetPhase(uint8 clkPhase) Description: （说明）： Parameters: （参数）： 设置模拟时钟的相位延迟。此函数仅用于模拟时钟。更改相位延迟之前必须禁用该时钟以避免 产生短时脉冲。 uint8 clkPhase：总计达到时钟相位延迟，以 1.0-ns 递增。clkPhase 必须介于 1-11（含）之 间。其他值，包括 0，禁用时钟。 clkPhase 值 PSoC 3 ES2 和更早版本 PSoC 3 生产版本和更高版本 PSoC 5 0 禁用时钟 禁用时钟 1 2.5 ns 0.0 ns 2 3.5 ns 1.0 ns 3 4.5 ns 2.0 ns 4 5.5 ns 3.0 ns 5 6.5 ns 4.0 ns 6 7.5 ns 5.0 ns 7 8.5 ns 6.0 ns 8 9.5 ns 7.0 ns 9 10.5 ns 8.0 ns 10 11.5 ns 9.0 ns 11 12.5 ns 10.0 ns 12-15 禁用时钟 禁用时钟 Return Value: void （返回值）： Side Effects: （副作用）： 001-78343 Rev ** None（无） 第 17 页，共 23 页 void Clock_SetPhaseRegister(uint8 clkPhase) Description: （说明）： Parameters: （参数）： 与 Clock_SetPhase() 相同。设置模拟时钟相位延迟。此函数仅用于模拟时钟。更改相位延迟 之前必须禁用该时钟以避免产生短时脉冲。 uint8 clkPhase：总计达到时钟相位延迟，以 1.0-ns 递增。clkPhase 必须介于 1-11（含）之 间。其他值，包括 0，禁用时钟。 clkPhase 值 PSoC 3 ES2 和更早版本 PSoC 3 生产版本和更高版本 PSoC 5 0 禁用时钟 禁用时钟 1 2.5 ns 0.0 ns 2 3.5 ns 1.0 ns 3 4.5 ns 2.0 ns 4 5.5 ns 3.0 ns 5 6.5 ns 4.0 ns 6 7.5 ns 5.0 ns 7 8.5 ns 6.0 ns 8 9.5 ns 7.0 ns 9 10.5 ns 8.0 ns 10 11.5 ns 9.0 ns 11 12.5 ns 10.0 ns 12-15 禁用时钟 禁用时钟 Return Value: void （返回值）： Side Effects: （副作用）： 001-78343 Rev ** None（无） 第 18 页，共 23 页 void Clock_SetPhaseValue(uint8 clkPhase) Description: （说明）： 设置模拟时钟的相位延迟。此函数仅用于模拟时钟。更改相位延迟之前必须禁用该时钟以避免 产生短时脉冲。与 Clock_SetPhase() 相同，但 Clock_SetPhaseValue() 在这个值上加1，然 后通过该值调用 Clock_SetPhaseRegister()。 Parameters: （参数）： uint8 clkPhase：总计达到时钟相位延迟，以 1.0-ns 递增。clkPhase 必须介于 0-10（含）之 间。其他值禁用时钟。 clkPhase 值 PSoC 3 ES2 和更早版本 PSoC 3 生产版本和更高版本 PSoC 5 0 2.5 ns 0.0 ns 1 3.5 ns 1.0 ns 2 4.5 ns 2.0 ns 3 5.5 ns 3.0 ns 4 6.5 ns 4.0 ns 5 7.5 ns 5.0 ns 6 8.5 ns 6.0 ns 7 9.5 ns 7.0 ns 8 10.5 ns 8.0 ns 9 11.5 ns 9.0 ns 10 12.5 ns 10.0 ns 11-15 禁用时钟 禁用时钟 Return Value: void （返回值）： Side Effects: （副作用）： 001-78343 Rev ** None（无） 第 19 页，共 23 页 uint8 Clock_GetPhaseRegister(void) Description: （说明）： Parameters: 获得模拟时钟的相位延迟。此函数仅用于模拟时钟。 void （参数）： Return Value: 模拟时钟（纳秒）的相位。更多信息，请参见 Clock_SetPhaseRegister()。 （返回值）： Side Effects: （副作用）： None（无） 固件源代码示例 PSoC Creator 在“查找示例项目”对话框中提供了大量包括原理图和代码示例的示例项目。要获取 组件特定的示例，请打开组件目录中的对话框或原理图中的组件实例。要获取通用的示例，请打 开开始页或文件菜单中的对话框。根据需要，使用对话框中的滤波器选项可缩小可选项目的列表。 更多信息，请参考 PSoC Creator 帮助中的“查找示例项目”这一主题。 组件更改 本节介绍组件与以前版本相比的主要更改。 Version （版本） 1.60 Description of Changes（更改说明） 更新了 Clock_SetDivider() 和 Clock_SetDividerRegister() APIs Reason for Changes / Impact（更改/影响原因） 确定 API 以便与 PSoC 5 一起正确运行 更改“数字域 – 输出”的措辞 在数据表中补充了 Clock_Stop() 注解 1.50.a 在数据表中补充了 Clock_StopBlock() 注解， 以说明硅片支持的欠缺。 对数据表进行了少量编辑和更新 001-78343 Rev ** 第 20 页，共 23 页 Version （版本） 1.50 Description of Changes（更改说明） 补充了 Clock_StopBlock() API Reason for Changes / Impact（更改/影响原因） 此函数用来停止时钟，并等待时钟被禁用。更改设置和重 新启用时钟时，要防止短时脉冲。 补充了 Clock_GetPhaseRegister() API（仅 允许固件读取当前的相位值。 限模拟） 补充了 Clock_SetPhaseValue() API（仅限模 此宏返转 Clock_SetPhaseRegister()，并自动添加 1 到 拟） 相位值，以提供更多直观接口。 重新命名 Clock_SetPhase() 为 以便与其他名称保持一致。对于兼容性，SetPhase 用作 Clock_SetPhaseRegister()（仅限模拟） 宏，并与 Clock_SetPhaseRegister() 的作用相同。 补充了 Clock_GetSourceRegister() API 允许固件读取当前的时钟源。 重新命名 Clock_SetSource() 为 Clock_SetSourceRegister() 以便与其他名称保持一致。对于兼容性，SetSource 用作 补充了 Clock_GetModeRegister() API 允许固件读取当前模式的标志。 补充了 Clock_SetModeRegister() API 此函数用来替换 Clock_SetMode()。对于兼容性， 宏，并与 Clock_SetSourceRegister() 的作用相同。 SetMode 用作宏，并与 Clock_SetModeRegister() 的作 用相同。Clock_SetModeRegister() 仅将模式标志从 0 改 为 1。这样可以防止意外清除其他模式位，例如，SYNC 。 补充了 Clock_ClearModeRegister() API 此函数类似于 Clock_SetModeRegister()，但只将模式标 志从 1 改为 0。 补充了 Clock_GetDividerRegister() API 允许固件读取当前分频器的值。 补充了 Clock_SetDividerRegister() API The Clock_SetDivider() API 无条件地复位时钟分频器。 Clock_SetDividerRegister() 支持固件作者控制是否复位 分频器。 补充了 Clock_SetDividerValue() API 此宏返转 Clock_SetDividerRegister()，并自动从分频器 减去 1，以提供更多直观接口。 设置 SSS in Clock_SetDividerRegister() 按 1 分频（分频值为 0），必须设置 SSS 位，以便绕过 分频器。Clock_SetDividerRegister() 函数将自动设置/清 除 SSS，如有必要，可暂时禁用时钟。 001-78343 Rev ** 第 21 页，共 23 页 Version （版本） Description of Changes（更改说明） Reason for Changes / Impact（更改/影响原因） 更改寄存器定义 更新以符合组件编码准则。 更正了 Clock_SetDivider() API 文档 Clock_SetDivider() API 文档声明 clkDivider 参数分频值 应为 + 1。此分频值应为 -1。文档错误地声明 0 对于 clkDivider 而言是无效值。 将“与总线同步”改为“与主控同步”，并与 更新以符合器件工作方式。这仅是外观更改。 Configure（配置）对话框的工具提示相关 联。 补充了参数以实现模拟时钟的数字域输出。 来自硬件模拟时钟的信号可用，但该信号以前未在组件上 暴露。 将 `=ReentrantKeil($INSTANCE_NAME . 如需重入，请允许用户将这些 API 设置为重新进入。 "_...")` 添加到下列函数中： void Clock_Start() void Clock_Stop() void Clock_StopBlock() void Clock_StandbyPower() void Clock_SetDividerRegister() uint16 Clock_GetDividerRegister() void Clock_SetModeRegister() void Clock_ClearModeRegister() uint8 Clock_GetModeRegister() void Clock_SetSourceRegister() uint8 Clock_GetSourceRegister() void Clock_SetPhaseRegister() uint8 Clock_GetPhaseRegister() 1.0.a 将 CYCLK_ constants 移到 cydevice.h/cydevice_trm.h. 此时从所选器件寄存器映射中生成适用于模式和源的 CYCLK_ constants。这允许时钟组件不依赖于器件特定 的寄存器值。包含时钟头的 cydevice.h 文件，因此不必 更改用户代码。 在数据表中补充 CYCLK_ constants 描述。 Clock_SetMode() 和 Clock_SetSource() API 当前包含每 个值的描述。 001-78343 Rev ** 第 22 页，共 23 页 © 赛普拉斯半导体公司，2012。此处所包含的信息可能会随时更改，恕不另行通知。除赛普拉斯产品的内嵌电路之外，赛普拉斯半导体公司不对任何其他电路的使用承担任何责任。也不根据专利 或其他权利以明示或暗示的方式授予任何许可。除非与赛普拉斯签订明确的书面协议，否则赛普拉斯产品不保证能够用于或适用于医疗、生命支持、救生、关键控制或安全应用领域。此外，对于 可能发生运转异常和故障并对用户造成严重伤害的生命支持系统，赛普拉斯不授权将其产品用作此类系统的关键组件。若将赛普拉斯产品用于生命支持系统中，则表示制造商将承担因此类使用而 招致的所有风险，并确保赛普拉斯免于因此而受到任何指控。 PSoC® 是赛普拉斯半导体公司的注册商标，PSoC® Creator™ 和 Programmable System-on-Chip™ 是赛普拉斯半导体公司的商标。此处引用的所有其他商标或注册商标归其各自所有者所有。 所有源代码（软件和/或固件）均归赛普拉斯半导体公司（赛普拉斯）所有，并受全球专利法规（美国和美国以外的专利法规）、美国版权法以及国际条约规定的保护和约束。赛普拉斯据此向获许 可者授予适用于个人的、非独占性、不可转让的许可，用以复制、使用、修改、创建赛普拉斯源代码的派生作品、编译赛普拉斯源代码和派生作品，并且其目的只能是创建自定义软件和/或固件， 以支持获许可者仅将其获得的产品依照适用协议规定的方式与赛普拉斯集成电路配合使用。除上述指定的用途之外，未经赛普拉斯的明确书面许可，不得对此类源代码进行任何复制、修改、转换、 编译或演示。 免责声明：赛普拉斯不针对此材料提供任何类型的明示或暗示保证，包括（但不仅限于）针对特定用途的适销性和适用性的暗示保证。赛普拉斯保留在不做出通知的情况下对此处所述材料进行更 改的权利。赛普拉斯不对此处所述之任何产品或电路的应用或使用承担任何责任。对于可能发生运转异常和故障并对用户造成严重伤害的生命支持系统，赛普拉斯不授权将其产品用作此类系统的 关键组件。若将赛普拉斯产品用于生命支持系统中，则表示制造商将承担因此类使用而招致的所有风险，并确保赛普拉斯免于因此而受到任何指控。 产品使用可能受适用的赛普拉斯软件许可协议限制。 001-78343 Rev ** 第 23 页，共 23 页