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="`${(&quot;mxs40srss_ver3&quot; 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, &quot;error&quot;)}`" 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, &quot;frequency&quot;) : 0}`" min="0" max="400000000" resolution="1" visible="false" editable="false" desc="" />
53    <ParamString id="accuracy"  name="Accuracy"  group="Internal" default="`${!error ? getExposedMember(sourceClockRsc, &quot;accuracy&quot;) : 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="`${(&quot;mxs40srss_ver3&quot; 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="`${(&quot;mxs40srss&quot; eq getIpBlockName())}`" editable="true" desc="" />
62    <ParamRange id="intDivider" name="Integer Divider" group="General" default="1" min="1" max="256" resolution="1" visible="`${(&quot;mxs40srss_ver3&quot; eq getIpBlockName())}`"  editable="true" desc="" />
63    <ParamRange id="fracDivider" name="Fractional Divider" group="General" default="0" min="0" max="31" resolution="1" visible="`${(&quot;mxs40srss_ver3&quot; 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="`${(&quot;mxs40srss_ver3&quot; 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="`${(&quot;mxs40srss&quot; eq getIpBlockName())}`" />
78    <ConfigDefine name="CY_CFG_SYSCLK_CLKFAST_DIVIDER" value="`${divider - 1}`"  public="false" include="`${(&quot;mxs40srss&quot; eq getIpBlockName())}`" />
79    <ConfigDefine name="CY_CFG_SYSCLK_CLKFAST_`${getInstNumber(&quot;fastclk&quot;)}`_ENABLED" value="1" public="false" include="`${(&quot;mxs40srss_ver3&quot; eq getIpBlockName())}`" />
80    <ConfigDefine name="CY_CFG_SYSCLK_CLKFAST_`${getInstNumber(&quot;fastclk&quot;)}`_INT_DIVIDER" value="`${intDivider - 1}`"  public="false" include="`${(&quot;mxs40srss_ver3&quot; eq getIpBlockName())}`" />
81    <ConfigDefine name="CY_CFG_SYSCLK_CLKFAST_`${getInstNumber(&quot;fastclk&quot;)}`_FRAC_DIVIDER" value="`${fracDivider}`"  public="false" include="`${(&quot;mxs40srss_ver3&quot; eq getIpBlockName())}`" />
82    <ConfigFunction signature="__STATIC_INLINE void Cy_SysClk_ClkFast_`${getInstNumber(&quot;fastclk&quot;)}`_Init()" body="    Cy_SysClk_ClkFastSrcSetDivider(`${getInstNumber(&quot;fastclk&quot;)}`, CY_CFG_SYSCLK_CLKFAST_`${getInstNumber(&quot;fastclk&quot;)}`_INT_DIVIDER, CY_CFG_SYSCLK_CLKFAST_`${getInstNumber(&quot;fastclk&quot;)}`_FRAC_DIVIDER);" public="false" include="`${(&quot;mxs40srss_ver3&quot; eq getIpBlockName())}`" />
83    <ConfigFunction signature="__STATIC_INLINE void Cy_SysClk_ClkFastInit()" body="    Cy_SysClk_ClkFastSetDivider(`${divider - 1}`U);" public="false" include="`${(&quot;mxs40srss&quot; eq getIpBlockName())}`" guard="(!defined(CY_DEVICE_SECURE))" />
84  </ConfigFirmware>
85</Personality>
86