1<?xml version="1.0" encoding="utf-8"?> 2 3 4<!--**************************************************************************** 5* \file fastclk.cypersonality 6* \version 2.0 7* 8* \brief 9* CLK_FAST personality description file. It supports CAT1A, CAT1B, CAT1C and 10* CAT1D devices. 11* 12******************************************************************************** 13* \copyright 14* Copyright 2018-2022 Cypress Semiconductor Corporation 15* SPDX-License-Identifier: Apache-2.0 16* 17* Licensed under the Apache License, Version 2.0 (the "License"); 18* you may not use this file except in compliance with the License. 19* You may obtain a copy of the License at 20* 21* http://www.apache.org/licenses/LICENSE-2.0 22* 23* Unless required by applicable law or agreed to in writing, software 24* distributed under the License is distributed on an "AS IS" BASIS, 25* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 26* See the License for the specific language governing permissions and 27* limitations under the License. 28*****************************************************************************--> 29 30<Personality id="fastclk" name="CLK_FAST" version="2.0" xmlns="http://cypress.com/xsd/cyhwpersonality_v7"> 31 <Dependencies> 32 <IpBlock name="mxs40srss,mxs40srss_ver3" /> 33 <Resource name="srss\.clock\.fastclk" /> 34 </Dependencies> 35 <ExposedMembers> 36 <ExposedMember key="frequency" paramId="frequency" /> 37 <ExposedMember key="accuracy" paramId="accuracy" /> 38 </ExposedMembers> 39 <Parameters> 40 <!-- PDL documentation --> 41 <ParamDoc id="pdlDoc" name="Configuration Help" group="Overview" default="file:///`${cy_libs_path()}`/docs/pdl_api_reference_manual/html/group__group__sysclk__clk__fast.html" linkText="Open Fast Clock Documentation" visible="true" desc="Opens the Peripheral Driver Library Documentation" /> 42 43 <!-- Source clock --> 44 <ParamString id="sourceClockRscMxs40srss" name="Source Clock" group="Internal" default="srss[0].clock[0].hfclk[0]" visible="false" editable="false" desc="" /> 45 <ParamString id="sourceClockRscMxs40srss_ver3" name="Source Clock" group="Internal" default="srss[0].clock[0].hfclk[1]" visible="false" editable="false" desc="" /> 46 <ParamString id="sourceClockRsc" name="Source Clock" group="Internal" default="`${("mxs40srss_ver3" eq getIpBlockName()) ? (sourceClockRscMxs40srss_ver3) : (sourceClockRscMxs40srss)}`" visible="false" editable="false" desc="" /> 47 48 <!-- Set an error if the source clock is not enabled or contains an error --> 49 <ParamBool id="srcNotUsed" name="Clock Source Enabled" group="Internal" default="`${!isBlockUsed(sourceClockRsc)}`" visible="false" editable="false" desc="" /> 50 <ParamBool id="error" name="Clock Error" group="Internal" default="`${srcNotUsed || getExposedMember(sourceClockRsc, "error")}`" visible="false" editable="false" desc="" /> 51 <!-- Use default values in case of error --> 52 <ParamRange id="sourceFreq" name="Source Frequency" group="Internal" default="`${!error ? getExposedMember(sourceClockRsc, "frequency") : 0}`" min="0" max="400000000" resolution="1" visible="false" editable="false" desc="" /> 53 <ParamString id="accuracy" name="Accuracy" group="Internal" default="`${!error ? getExposedMember(sourceClockRsc, "accuracy") : 0}`" visible="false" editable="false" desc="" /> 54 <ParamString id="sourceFrequencyInfoMxs40srss" name="Source Clock" group="General" default="CLK_HF0 (`${formatFrequency(sourceFreq,accuracy)}`)" visible="false" editable="false" desc="Source clock frequency" /> 55 <ParamString id="sourceFrequencyInfoMxs40srss_ver3" name="Source Clock" group="General" default="CLK_HF1 (`${formatFrequency(sourceFreq,accuracy)}`)" visible="false" editable="false" desc="Source clock frequency" /> 56 <ParamString id="sourceFrequencyInfo" name="Source Clock" group="General" default="`${("mxs40srss_ver3" eq getIpBlockName()) ? (sourceFrequencyInfoMxs40srss_ver3) : (sourceFrequencyInfoMxs40srss)}`" visible="true" editable="false" desc="Source clock frequency" /> 57 58 <ParamChoice id="accuracyUnit" name="Accuracy Unit" group="Internal" default="1" visible="false" editable="false" desc=""> 59 <Entry name="%" value="1" visible="true" /> 60 </ParamChoice> 61 <ParamRange id="divider" name="Divider" group="General" default="1" min="1" max="256" resolution="1" visible="`${("mxs40srss" eq getIpBlockName())}`" editable="true" desc="" /> 62 <ParamRange id="intDivider" name="Integer Divider" group="General" default="1" min="1" max="256" resolution="1" visible="`${("mxs40srss_ver3" eq getIpBlockName())}`" editable="true" desc="" /> 63 <ParamRange id="fracDivider" name="Fractional Divider" group="General" default="0" min="0" max="31" resolution="1" visible="`${("mxs40srss_ver3" eq getIpBlockName())}`" editable="true" desc="" /> 64 <ParamRange id="frequencyMxs40srss" name="Frequency" group="Internal" default="`${sourceFreq / divider}`" min="0" max="400000000" resolution="1" visible="false" editable="false" desc="" /> 65 <ParamRange id="frequencyMxs40srss_ver3" name="Frequency" group="Internal" default="`${sourceFreq / (intDivider + fracDivider / 32.0)}`" min="0" max="400000000" resolution="1" visible="false" editable="false" desc="" /> 66 <ParamRange id="frequency" name="Frequency" group="Internal" default="`${("mxs40srss_ver3" eq getIpBlockName()) ? (frequencyMxs40srss_ver3) : (frequencyMxs40srss)}`" min="0" max="400000000" resolution="1" visible="false" editable="false" desc="" /> 67 <!-- If the frequency is less than one MHz, display its value in kHz --> 68 <ParamString id="frequencyInfo" name="Frequency" group="General" default="`${formatFrequency(frequency,accuracy)}`" visible="true" editable="false" desc="The resulting CLK_FAST output clock frequency" /> 69 </Parameters> 70 <DRCs> 71 <DRC type="ERROR" text="Source clock for CLK_FAST is not enabled" condition="`${srcNotUsed}`" > 72 <FixIt action="ENABLE_BLOCK" target="`${sourceClockRsc}`" value="" valid="true" /> 73 </DRC> 74 </DRCs> 75 <ConfigFirmware> 76 <ConfigInclude value="cy_sysclk.h" include="true" /> 77 <ConfigDefine name="CY_CFG_SYSCLK_CLKFAST_ENABLED" value="1" public="false" include="`${("mxs40srss" eq getIpBlockName())}`" /> 78 <ConfigDefine name="CY_CFG_SYSCLK_CLKFAST_DIVIDER" value="`${divider - 1}`" public="false" include="`${("mxs40srss" eq getIpBlockName())}`" /> 79 <ConfigDefine name="CY_CFG_SYSCLK_CLKFAST_`${getInstNumber("fastclk")}`_ENABLED" value="1" public="false" include="`${("mxs40srss_ver3" eq getIpBlockName())}`" /> 80 <ConfigDefine name="CY_CFG_SYSCLK_CLKFAST_`${getInstNumber("fastclk")}`_INT_DIVIDER" value="`${intDivider - 1}`" public="false" include="`${("mxs40srss_ver3" eq getIpBlockName())}`" /> 81 <ConfigDefine name="CY_CFG_SYSCLK_CLKFAST_`${getInstNumber("fastclk")}`_FRAC_DIVIDER" value="`${fracDivider}`" public="false" include="`${("mxs40srss_ver3" eq getIpBlockName())}`" /> 82 <ConfigFunction signature="__STATIC_INLINE void Cy_SysClk_ClkFast_`${getInstNumber("fastclk")}`_Init()" body=" Cy_SysClk_ClkFastSrcSetDivider(`${getInstNumber("fastclk")}`, CY_CFG_SYSCLK_CLKFAST_`${getInstNumber("fastclk")}`_INT_DIVIDER, CY_CFG_SYSCLK_CLKFAST_`${getInstNumber("fastclk")}`_FRAC_DIVIDER);" public="false" include="`${("mxs40srss_ver3" eq getIpBlockName())}`" /> 83 <ConfigFunction signature="__STATIC_INLINE void Cy_SysClk_ClkFastInit()" body=" Cy_SysClk_ClkFastSetDivider(`${divider - 1}`U);" public="false" include="`${("mxs40srss" eq getIpBlockName())}`" guard="(!defined(CY_DEVICE_SECURE))" /> 84 </ConfigFirmware> 85</Personality> 86