产品定位PRODUCT POSITIONING
GW1NR 系列在 GW1N FPGA 基础上集成存储芯片，面向低功耗、瞬时启动、小尺寸的系统级封装场景。
GOWIN / DATASHEET CONDITIONAL PUBLISHING
10业务条件维度
12TC 条件代码
10共享库候选 Topic
12410 份手册重复段落
76.19%最高跨系列相似度
1DITA 主版本
01
条件预览：同一条源内容，随条件改变输出
选择型号、封装、存储和版本，右侧数据手册会实时过滤。带 共享 标记的内容始终显示；带条件表达式的内容只在表达式为真时出现。点击矩阵行可载入预设。
FILTERED OUTPUT · DATASHEET PREVIEW
GW1NR-9 系列 FPGA 产品数据手册
DS117 · GW1NR-9 · MG100P · PSRAM 128M
主版本
zh-CN
HTML5 / PDF / DOCX
8,640LUT4
468KBSRAM bits
20DSP 乘法器
2PLL
硬核 MIPI D-PHY RXGW1NR-2 ONLY
(TC000005=hard-mipi)GW1NR-2 内嵌硬核 MIPI D-PHY RX，Bank6 为 MIPI 专用 Bank，支持 MIPI DSI / CSI-2 RX，单通道可达 2Gbps。
MIPI IO 模式GW1NR-9
(TC000005=mipi-io)GW1NR-9 的 GPIO 支持 MIPI IO 模式，Bank2 可配置为 MIPI I/O 输出，用于显示与摄像接口。
DSP 资源GW1NR-2
(TC000009=dsp-none)GW1NR-2 暂不支持数字信号处理模块 DSP 资源。涉及 DSP 的章节、时序表和资源表应在此目标中过滤。
DSP 资源GW1NR-4
(TC000009=dsp-16)GW1NR-4 集成 16 个 18×18 乘法器，面向 FIR、FFT 等高性能数字信号处理场景。
DSP 资源GW1NR-9
(TC000009=dsp-20)GW1NR-9 集成 20 个 18×18 乘法器，在同类小蜜蜂器件中提供更高的 DSP 资源密度。
BSRAM 双端口模式GW1NR-9 · C 版本
(TC000002=gw1nr-9) and (TC000006=c-version)GW1NR-9 器件中，仅 C 版本支持 BSRAM 双端口模式。非 C 版本应过滤本段，改用“不支持双端口”的说明。
BSRAM 只读模式GW1NR-4 · D 版本
(TC000002=gw1nr-4) and (TC000006=d-version)GW1NR-4 器件中，仅 D 版本支持 BSRAM 只读模式。该条件应与“双端口/伪双端口”分开展示，避免错配。
MG49G 配置模式限制PACKAGE-DEPENDENT
(TC000003=mg49g)MG49G 封装仅支持 I²C 与 Autoboot 配置模式；当配置模式支持 I²C 时，SDA / SCL 管脚需要外上拉。
封装内 PSRAMPACKAGE MEMORY
(TC000004=psram)当前封装集成 PSRAM，容量与位宽随封装不同。
封装内 NOR FlashPACKAGE MEMORY
(TC000004=nor-flash)当前封装集成 NOR Flash，适合需要非易失配置/数据存储的目标。
版权声明SHARED · 10/10 DOCS
均为广东高云半导体科技股份有限公司注册商标，本手册中提到的其他任何商标，其所有权利属其拥有者所有。
免责声明SHARED · 10/10 DOCS
本文档并未授予任何知识产权的许可，也未以明示或暗示方式授予任何知识产权许可。
过滤日志表达式为假的块会出现在这里
为什么这很重要：同一个 GW1NR-9 源文件，切到 GW1NR-4 时 MIPI 块自动消失、DSP 变为 16；切到非 C 版本时双端口说明消失。过滤发生在发布层，不是复制 3 份文档后手工删改。
02
条件模型：10 个业务维度，12 个 TC 代码
维度来自数据手册的真实差异源。简单条件挂标准 DITA 属性；跨维度组合用 rtcondition 布尔表达式。语言作为独立发布轴，不混入业务布尔式。
TC000001product
产品系列
数据手册所属产品家族。
gw1ngw1nrgw1nsgw1nzgw2agw2ar
TC000002product
器件型号
同系列内的资源/能力差异。
gw1nr-2gw1nr-4gw1nr-9
TC000003otherprops
封装
封装决定存储、I/O 与部分配置限制。
qn88qn88pmg81pmg100pmg49pmg49gmg49pglq144p
TC000004platform
存储类型
封装内集成 Memory 的类型。
sdrampsramnor-flashnone
TC000005platform
MIPI 能力
硬核 D-PHY 或 MIPI IO。
hard-mipimipi-ionone
TC000006otherprops
版本 / 电压
硅版本与核心电压版本。
c-versiond-versionuvlv
TC000007audience
受众/车规
工业、商业、车规。
industrialcommercialautomotive
TC000008otherprops
结温等级
商业/工业/车规温度范围。
tj0-85tj-40-100tj-40-125
TC000009platform
DSP 资源
乘法器/DSP 宏单元数量。
dsp-nonedsp-16dsp-20
TC000010platform
PLL 资源
锁相环数量。
pll-1pll-2
TC000011otherprops
用户闪存寿命
写寿命周期。
uf-100kuf-10k
TC000012otherprops
配置模式
GowinCONFIG 模式集合。
config-7config-6config-4config-i2c-autoboot
单维 vs 跨维：什么时候用标准属性，什么时候用 rtcondition
| 场景 | 写法 | 说明 |
|---|---|---|
| 单维度 | product="gw1nr"otherprops="mg100p" | 标准 DITA 条件属性；DITAVAL 直接 include/exclude。 |
| 多值 OR | platform="psram sdram" | 同一属性内的多个取值，按 OR 解释。 |
| 跨维度组合 | rtcondition="(TC000002=gw1nr-9) and (TC000006=c-version)" | 平台扩展布尔表达式，支持 AND / OR / NOT / 嵌套。 |
| 语言 | xml:lang="zh-CN" + DITAVAL | 语言是独立过滤轴，不与业务布尔式混写。 |
条件互锁：发布前先拦截无效组合
| 条件 A | 关系 | 条件 B | 数据依据 |
|---|---|---|---|
TC000003=mg49g | implies | TC000004=nor-flash | MG49G 封装集成 4M NOR Flash |
TC000003=mg49p | implies | TC000004=psram | MG49P 封装集成 64M PSRAM |
TC000002=gw1nr-2 | implies | TC000009=dsp-none | GW1NR-2 暂不支持 DSP |
TC000002=gw1nr-9 + TC000006=c-version | enables | BSRAM 双端口 | 仅 GW1NR-9 C 版本支持双端口 |
TC000002=gw1nr-4 + TC000006=d-version | enables | BSRAM 只读 | 仅 GW1NR-4 D 版本支持只读 |
TC000007=automotive | implies | TC000008=tj-40-125 | 车规级结温 -40~+125℃ |
互锁不是文档说明，而是发布前校验：未注册的隐含关系会导致“GW1NR-2 显示 DSP 章节”“MG49P 显示 NOR 配置”等错配。条件库、互锁表、表达式构建器应在同一处维护。
03
共享库：把 10 份手册的重复段落收成 10 个 Topic
复用分析器在 10 份 GOWIN 数据手册中发现 124 个重复段落、1,609 条重复关系、578 次出现。高频 Top 30 中约 27 条是技术描述，3 条是法律/版权。下面是最值得优先抽出的 10 个候选。
124重复段落
1,609重复关系
578出现次数
10 / 10文档覆盖率（Top 段落）
LIB 01 · 无条件共享10/10
版权声明
广东高云半导体科技股份有限公司注册商标与复制限制。
<p conref="common/lib/legal/copyright.dita#copyright/p1"/>owner: Legal变更需法务确认
LIB 02 · 无条件共享10/10
免责声明
知识产权许可、担保责任、内容准确性说明。
<p conref="common/lib/legal/disclaimer.dita#disclaimer/p1"/>owner: Legal无条件共享
LIB 03 · 跨系列共享10/10
CLU / CFU 结构描述
可配置逻辑块与可配置功能单元的静态存储能力差异。
<p conref="common/lib/arch/cfu_clu.dita#cfu_clu/p1"/>owner: Architecture跨系列共享
LIB 04 · 跨系列共享10/10
I/O Bus Keeper / 上下拉
每个 I/O 的 Bus Keeper、上下拉与 Open Drain 选项。
<p conref="common/lib/io/bus_keeper.dita#bus_keeper/p1"/>owner: IO跨系列共享
LIB 05 · 跨系列共享10/10
GCLK 输入约束
CI 作为 GCLK 输入时，DI/Q/Q0/Qn-1 不可作为 IO。
<p conref="common/lib/clock/gclk.dita#gclk/p1"/>owner: Clock跨系列共享
LIB 06 · 跨系列共享10/10
BSRAM 单端口/伪双端口
单端口、伪双端口的读写模式与时钟沿行为。
<p conref="common/lib/memory/bsram_modes.dita#modes/p1"/>owner: Memory跨系列共享
LIB 07 · 跨系列共享10/10
BSRAM 5 种操作模式
Bypass、Pipeline、Normal、Write-through、Read-before-write。
<p conref="common/lib/memory/bsram_ops.dita#ops/p1"/>owner: Memory跨系列共享
LIB 08 · 跨系列共享10/10
PLL 定义
锁相环反馈控制电路、参考时钟与输出时钟关系。
<p conref="common/lib/clock/pll.dita#pll/p1"/>owner: Clock跨系列共享
LIB 09 · 跨系列共享10/10
工作条件建议
推荐工作条件与工作范围，超出范围的数据仅供参考。
<p conref="common/lib/quality/operating.dita#operating/p1"/>owner: Quality跨系列共享
LIB 10 · 跨系列共享10/10
Hysteresis 说明
NONE / L2H / H2L / HIGH 选项与 VHYST 关系。
<p conref="common/lib/io/hysteresis.dita#hysteresis/p1"/>owner: IO跨系列共享
复用边界：法律/免责声明可无条件共享；通用架构、IO、时钟、BSRAM 描述可跨系列共享；涉及具体型号参数、版本能力、封装差异的内容必须条件化或 keyref，不要整段 conref。
04
表达式：把“仅 C 版本”“仅 D 版本”“无 DSP”写对
简单差异用标准属性；跨维度差异用 rtcondition。每个条件项用括号包住，项与项之间显式写 and / or / not，不要用空格拼接。
BSRAM 双端口 / 只读：版本 × 型号AND
<!-- GW1NR-9 仅 C 版本支持双端口 -->
<p rtcondition="(TC000002=gw1nr-9) and (TC000006=c-version)">
GW1NR-9 的 C 版本支持 BSRAM 双端口模式。
</p>
<!-- GW1NR-4 仅 D 版本支持只读 -->
<p rtcondition="(TC000002=gw1nr-4) and (TC000006=d-version)">
GW1NR-4 的 D 版本支持 BSRAM 只读模式。
</p>
<!-- 非 C 版本：显式否定 -->
<p rtcondition="(TC000002=gw1nr-9) and not (TC000006=c-version)">
GW1NR-9 的非 C 版本不支持双端口模式。
</p>型号 / 封装 / 车规：单维与互锁AND / IMPLIES
<!-- GW1NR-2 无 DSP -->
<p rtcondition="(TC000002=gw1nr-2)">
GW1NR-2 暂不支持 DSP 资源。
</p>
<!-- MG49G 配置限制 -->
<p otherprops="mg49g">
MG49G 仅支持 I²C 与 Autoboot 配置模式。
</p>
<!-- 车规级：受众 + 温度 -->
<p audience="automotive" otherprops="tj-40-125">
结温范围：-40℃ ~ +125℃。
</p>语法规则
| 规则 | 正确 | 错误 / 后果 |
|---|---|---|
| 每个条件项加括号 | (TC000002=gw1nr-9) and (TC000006=c-version) | TC000002=gw1nr-9 and TC000006=c-version：求值失败或语义不明。 |
| 显式布尔运算符 | and / or / not | 用空格拼接：引擎无法判断关系。 |
| 大小写敏感 | gw1nr-9、c-version | GW1NR-9 / C-version：匹配不到。 |
| 语言独立轴 | xml:lang="zh-CN" + DITAVAL | 不要把 l=zh 混入业务布尔式。 |
| 多值 OR 在取值内部 | platform="psram sdram" | 不要把两个取值写成两个条件项再拼 AND。 |
三层挂载：元素 / Topic / Map
| 层级 | 适用 | 示例 |
|---|---|---|
| 元素级 | 段落、表格行、列表项 | <p rtcondition="(TC000002=gw1nr-2)">...</p> |
| Topic 级 | 整个 topic 只对某型号/版本有意义 | <topic product="gw1nr" otherprops="gw1nr-9"> |
| Map 级 | 整个章节/附录只对某发布目标出现 | <topicref href="..." product="gw1nr" audience="industrial"/> |
平台差异：rtcondition 是写管用条件发布平台扩展属性；如果客户只用标准 DITA-OT，可把跨维条件拆成
otherprops/platform + DITAVAL，或使用平台过滤器。页面展示的是平台能力，不宣称 rtcondition 是 OASIS 标准属性。05
过滤矩阵：12 个代表性组合，发布前逐项验收
矩阵覆盖“型号 × 封装 × 存储 × MIPI × 版本 × 车规”的代表组合。点击 GW1NR 行可直接载入上方预览；跨系列行引导到下一节的车规示例。
点击行载入条件组合 · 跨系列行滚动到交叉复用
显示条件化过滤
| # | 场景 | 型号 · 封装 | 存储 | MIPI | 版本 | 车规/温度 | 关键预期 |
|---|---|---|---|---|---|---|---|
| 01 | GW1NR-2 · MG49P | GW1NR-2 / MG49P | PSRAM 64M | Hard MIPI | C | 工业 -40~100 | DSP 0 MIPI |
| 02 | GW1NR-2 · MG49G | GW1NR-2 / MG49G | NOR 4M | Hard MIPI | C | 工业 -40~100 | I²C/Autoboot |
| 03 | GW1NR-2 · MG49PG | GW1NR-2 / MG49PG | PSRAM+NOR | Hard MIPI | C | 工业 -40~100 | 双存储 |
| 04 | GW1NR-4 · QN88 | GW1NR-4 / QN88 | SDRAM 64M | None | C | 工业 -40~100 | DSP 16 MIPI |
| 05 | GW1NR-4 · MG81P | GW1NR-4 / MG81P | PSRAM 64M | None | C | 工业 -40~100 | DSP 16 |
| 06 | GW1NR-4 · D 版本 | GW1NR-4 / QN88 | SDRAM 64M | None | D | 工业 -40~100 | 只读模式 |
| 07 | GW1NR-9 · QN88 | GW1NR-9 / QN88 | SDRAM 64M | MIPI IO | C | 工业 -40~100 | DSP 20 双端口 |
| 08 | GW1NR-9 · MG100P | GW1NR-9 / MG100P | PSRAM 128M | MIPI IO | C | 工业 -40~100 | 双端口 128M |
| 09 | GW1NR-9 · LQ144P | GW1NR-9 / LQ144P | PSRAM 64M | MIPI IO | C | 工业 -40~100 | 双端口 |
| 10 | GW1N-9 · C 版本 | GW1N-9 / MG100 | None | — | C | 工业 -40~100 | 跨系列 双端口 |
| 11 | GW1N-9 · 车规级 | DS173 / GW1N-9 | None | — | C | 车规 -40~125 | 76.19% 车规 |
| 12 | GW2A-18 · 车规级 | DS208 / GW2A-18 | None | — | — | 车规 -40~125 | 72.14% 车规 |
验收方式：每行不仅看“显示/隐藏”，还要看表达式求值、互锁校验、共享库引用是否解析。矩阵是发布前的最小回归集，不是全部组合的穷举。
06
跨系列复用：车规级是最大的条件化机会
相似度矩阵显示：GW1N 与 GW1N 车规级 76.19%，GW2A 与 GW2A 车规级 72.14%。这意味着“同一主版本 + 车规/温度条件”比维护两本手册更合理。
76.19%
GW1N ↔ GW1N 车规级
DS100 与 DS173 相似度最高。共享架构、资源、IO、时钟描述；车规差异集中在结温、认证、部分封装限制。
DS100-3.2.5 ↔ DS173-1.6
72.14%
GW2A ↔ GW2A 车规级
DS102 与 DS208：主体技术内容高度共享，车规条件应独立为 audience=automotive + 温度条件。
DS102-2.7.3 ↔ DS208-1.5
41.06%
GW1NS ↔ GW1NSR
同家族不同系列的复用机会；41.06% 说明“部分共享”，必须按 topic/段落判断，不能整本 conref。
DS821-2.1 ↔ DS861-1.7
边界：相似度高不等于全部可 conref。法律/通用技术描述可共享；型号参数、封装能力、版本限制必须条件化或 keyref。GW1NR 本页是工业级样本；车规级示例来自 DS173/DS208，不把 GW1NR 标准手册误标为车规。
车规级条件示例
同一主版本，按受众/温度过滤AUDIENCE
<p audience="automotive" otherprops="tj-40-125">
结温范围：-40℃ ~ +125℃。
</p>
<p audience="industrial" otherprops="tj-40-100">
结温范围：-40℃ ~ +100℃。
</p>共享 + 条件组合CONREF + CONDITION
<!-- 共享的架构描述 -->
<p conref="common/lib/arch/cfu_clu.dita#cfu_clu/p1"/>
<!-- 车规专有段落 -->
<p audience="automotive">
本器件满足车规级应用要求。
</p>07
从业务规则到发布：8 步落地
不是“先写内容再考虑条件”，而是先把差异源建模，再写 DITA、挂条件、建表达式、做发布验证。
识别差异源
型号、封装、存储、MIPI、版本、环境、DSP/PLL、闪存、配置模式。
10 dimensions条件库 / TC
分配 TC 代码，导入条件库；CSV/条件树统一维护。
12 TCs注册互锁
implies / excludes / depends_on，拦截无效组合。
interlocksDITA 标注
元素 / Topic / Map 三层挂载条件属性。
3 levels共享库
公共法律、架构、IO、时钟、BSRAM 抽 topic，conref/keyref 引用。
10 lib topics表达式 / 预览
构建 rtcondition，发布前预览过滤结果，检查空内容与错配。
preview发布
按目标条件输出 HTML5 / PDF / DOCX；记录条件组合。
HTML / PDF / DOCX验收 / 基线
过滤矩阵回归、互锁校验、共享库影响分析、Git baseline。
audit + tag发布前检查清单
- 条件库 TC 代码与 DITA 属性一一对应，无孤儿值。
- 所有跨维度表达式都有括号与显式 and/or/not。
- 互锁表覆盖型号-封装-存储-版本的关键组合。
- 共享库 topic 的 conref 目标存在，引用可解析。
- 过滤矩阵的 12 个代表组合全部通过，预期与结果一致。
- 空内容、重复内容、低配显示高配等错配为 0。
- 共享库变更已做 where-used 影响分析。
- 发布物记录条件组合、主版本 commit/tag。
08
价值：有效通过条件，最大化复用
条件发布不是“多写几套条件”，而是把重复内容收进共享库、把差异收进条件层，让同一主版本覆盖更多型号/封装/版本。
REUSE OPPORTUNITY
10 份数据手册的复用基线
分析器在 10 份 GOWIN 数据手册中发现 124 个重复段落、1,609 条重复关系、578 次出现；Top 30 高频段落中约 27 条是技术描述，3 条是法律/版权。共享库优先抽这 10 类内容，而不是逐篇复制。
124重复段落
1,609重复关系
578出现次数
10共享库候选
CONDITIONAL PUBLISHING VALUE
一套主版本，覆盖多构型
一次编写：共享架构、IO、时钟、BSRAM 描述只维护一处。按条件输出：MIPI、DSP、双端口、配置限制随型号/版本自动切换。发布前拦截：互锁表阻止“GW1NR-2 显示 DSP”“MG49G 显示不支持的配置”。
- 共享库变更一次，10 份手册同步生效
- 条件组合可预览，发布前发现空内容/错配
- 同一条 DITA 源，输出 HTML5 / PDF / DOCX
- 条件组合与主版本 commit/tag 可追溯
口径说明：上方的 124/1,609/578 是内容复用基线；复用分析器的 10.1% 复用率、$2,113 毛节省是另一个 142 篇工程语料口径，不能直接当作 GOWIN 平台净 ROI。平台投资需另算迁移、许可、运维和治理成本；本页不把“毛节省”当“净收益”。
09
附录：数据来源与速查
页面中的事实来自高云 DITA 数据手册与复用分析器输出。条件值为演示配置，正式项目需在 Kick-off 冻结。
| 数据 | 来源 | 用途 |
|---|---|---|
| GW1NR 型号/封装/存储/DSP/PLL | DS117_GW1NR_FPGA.ditamap；topics 1_2、1_3、2_5_2 | 交互预览与条件示例 |
| MIPI / 配置限制 | DS117 topics 1_1、1_3、2_4_1、2_12 | MIPI 与 MG49G 条件 |
| 车规温度 | DS173/DS208 数据手册 | 跨系列车规示例 |
| 相似度 | similarity_matrix.csv | 76.19% / 72.14% / 41.06% |
| 重复段落 | detailed_reuse_analysis.txt / reused_passages_analysis.xlsx | 124 段 / 1,609 关系 / 578 次 |
常见问题
条件过滤后内容为空？
检查表达式括号、大小写和布尔运算符；用预览确认目标条件是否覆盖该段落。
低配型号显示了高配内容？
检查互锁规则是否遗漏，属性值是否在条件库中声明；重点查型号-封装-存储的隐含关系。
共享库改一处，影响哪些文档？
先做 where-used / 引用扫描，再改共享 topic；共享内容变更必须走评审与基线。
rtcondition 是标准 DITA 吗？
不是；它是写管用平台扩展。标准 DITA-OT 场景请用标准属性 + DITAVAL，或使用平台过滤器。
使用建议：先把 10 份数据手册作为“条件化试点”，用 12 个矩阵组合验收；再扩展到 GW1N/GW2A 车规系列。共享库先抽法律/架构/IO/时钟/BSRAM，参数与版本能力留给 keyref/条件，不要为了复用率强行 conref。
源数据注意：DS117 1.1 列出 7 种 GowinCONFIG 模式，2.12/3.6 章节出现“6 种”表述；本页按 1.1 特性表展示，正式发布前需产品确认统一口径。共享库路径为规划命名，落地时按实际 DITA 公共库调整。