*******************************************************

   Sealion器件内部晶振使用简要说明   (版本1.2)

*******************************************************

== 版本历史 ==
[2020.12.24]  V1.2 增加25K器件频率参数
[2020.07.23]  V1.1 修正若干笔误（冗余浮点表示相关）
[2020.07.20]  V1.0 初始版本


== 说明正文 ==

Sealion器件内部晶振支持产生频率为2.03M ~ 125M 的时钟信号，使用要点如下：

1. 使用 HqFpga V2.9.2 Build 122420 或更高版本。
  （此前的软件版本也有支持，但有缺陷）

2. 例化原语(primitive) xsOSC
   或者例化OSCH（兼容Lattice XO2器件）

3. 修改参数NOM_FREQ，设置成相应的频率值，例如下面示例配置内部晶振产生频率为5MHz的时钟：
    xsOSC osc_inst(.OSC(osc_clk));
    defparam osc_inst.NOM_FREQ = "5.0";
或者：
    OSCH osc_inst(.OSC(osc_clk));
    defparam osc_inst.NOM_FREQ = "5.0";
（两个示例结果完全相同）

4. NOM_FREQ值的完整列表如下(单位：MHz)：

【注意】NOM_FREQ必须严格从下表中选取值

------------+-----------------
    25K器件 |  非25K器件
------------+-----------------
     1.95   |    2.03
     2.02   |    2.1
     2.08   |    2.17
     2.16   |    2.25
     2.23   |    2.33
     2.31   |    2.42
     2.40   |    2.5
     2.50   |    2.6
     2.60   |    2.71
     2.72   |    2.84
     2.84   |    2.97
     2.98   |    3.125
     3.13   |    3.24
     3.29   |    3.42
     3.47   |    3.62
     3.68   |    3.84
     3.91   |    4.09
     4.03   |    4.23
     4.17   |    4.38
     4.31   |    4.54
     4.46   |    4.71
     4.63   |    4.9
     4.81   |    5.0
     5.00   |    5.2
     5.21   |    5.43
     5.43   |    5.68
     5.68   |    5.95
     5.95   |    6.25
     6.25   |    6.57
     6.58   |    6.94
     6.94   |    7.35
     7.35   |    7.57
     7.81   |    8.06
     8.06   |    8.33
     8.33   |    8.62
     8.62   |    8.92
     8.93   |    9.25
     9.26   |    9.61
     9.62   |   10.0
    10.00   |   10.41
    10.42   |   10.86
    10.87   |   11.36
    11.36   |   11.9
    11.90   |   12.5
    12.50   |   13.15
    13.16   |   13.88
    13.89   |   14.7
    14.71   |   15.625
    15.63   |   16.66
    16.67   |   17.85
    17.86   |   19.23
    19.23   |   20.83
    20.83   |   22.72
    22.73   |   23.8
    25.00   |   25.0
    27.78   |   27.7
    31.25   |   31.25
    35.71   |   35.71
    41.67   |   41.66
    50.00   |   50.0
    62.50   |   71.42
    83.33   |   83.33
   125.00   |  125.0
------------+-----------------