简介：RTL9303-CG 数据手册面向交换机硬件设计、底层驱动开发与网络设备验证人员，提供 Realtek 三层管理型八端口万兆以太网交换控制器的芯片级技术资料。正文覆盖万兆端口能力、三层路由、虚拟局域网划分、服务质量调度、访问控制安全机制及管理接口，并给出引脚定义、电气参数、串行外设接口时序、万兆以太网发送差分幅度等设计要点，可用于原理图评审、印制板布线核对、功耗散热评估和驱动适配。文档还包含静电放电防护要求与版本修订记录，便于研发团队快速定位关键章节。压缩包内只有一份便携式文档，体积约 2.45MB，版本为 Rev. 1.1-1，目录按功能模块编排，检索方便。现有 3590 人学习下载，适合需要核对芯片规格、排查高速接口问题或搭建万兆交换机原型的工程师参考。

1. 万兆交换机芯片的数据手册，到底是本什么书

买台热水器，箱子里那张纸教你怎么按按钮；但如果你买的是一颗万兆交换机芯片，随货的那份 PDF 就完全不是这个路数。它叫数据手册，是给画电路板和写驱动的人看的“硬件契约”。很多人第一次搜到它，打开就是几十页引脚表、几百个缩写，扫两眼就关掉，以为是厂商内部的天书。其实它回答的问题很朴素：这颗三层交换控制器有几个口、每个口能跑多快、上电那一瞬间默认是什么状态、哪些功能是硬件直接做掉的、哪些得靠外挂的处理器补。搞懂一份数据手册在讲什么，你就能判断一台万兆交换机的能力边界，而不是只看包装盒上印的“8×10G”。

2. 为什么万兆口要配一颗专门的控制器：交换芯片、CPU 与 PHY 的分工

拆开一台八口万兆设备的外壳，你能看到三拨东西在干活：一排光模块笼子、几颗发热量不小的芯片、还有一颗跑着系统的小处理器。要把数据手册读明白，先得知道这三拨东西谁管什么，否则你会把引脚表里的缩写当成一锅粥。

2.1 一台交换机里的三种角色：调度室、分拣机、装卸口

用物流仓库存货打比方。仓库大门是光模块和 PHY，负责把光信号翻译成电信号、再把电信号翻译回光；中间那条传送带和分拣机是交换控制器，绝大多数包从进门到出门只在这条带上走一趟，压根不进办公室；办公室里的调度员是 CPU，只处理“第一次见到的地址”“需要人拍板的策略”“管理员敲进来的命令”。

这三者的分工决定了手册的篇幅分配。一份典型的交换控制器数据手册，七八成内容在写那条传送带——端口怎么接、包怎么查表、队列怎么排、限速怎么算；只有很小一块写办公室，也就是片上 CPU 子系统。你如果抱着“学网络配置”的期待去翻它，会非常挫败；反过来，你如果想知道“为什么这台机器在满负载下时延忽高忽低”，答案八成藏在传送带那几章，而不是办公室。

管理型和非管理型的差别也在这里。俗称的傻瓜交换机，功能出厂就固化，插上就能用，因为它压根没打算让人改；管理型要能配 VLAN、配 ACL、配优先级、做端口镜像、做限速，还得能被外部监控系统看见——手册里 MIB 计数、日志计数、OAM 这些看起来冷门的章节，全是为“被监控”这件事准备的。所以“管理型”三个字不是营销词，它意味着这颗芯片必须留出配置通道和观测通道。

2.2 为什么不用通用 CPU 干这活

有人会问：既然 CPU 什么都能算，为什么不让它直接把包从一个口转到另一个口？答案在数字里。一个万兆口跑满最小包，每秒要处理大约一千四百八十八万个包；八个口一起跑，就是上亿的量级。通用 CPU 每处理一个包都要进一次中断、拷一次内存、查一次表、再排队出门，这套流程在千兆时代就已经吃力，到万兆直接崩。

交换控制器走的是另一条路：把“收包”拆成固定几段流水线——解析包头、查表决定往哪送、改写需要改的字段、丢进对应队列。段与段之间可以同时处理不同的包，就像流水线上八个人各管一道工序，而不是一个人从头装到尾。更关键的是查表：MAC 地址表、路由表、ACL 规则表都放在芯片能直接访问的地方，查一次是几个时钟周期的事，不需要绕到内存里翻文件。

代价也很明确：流水线是写死的。芯片设计时定了支持哪些协议、表能装多少条、队列有几个，出厂就改不了。所以你会看到手册里到处是“最多支持多少条表项”“最多多少个队列”这类硬上限——这些数字就是这颗芯片的天花板，选型时最该盯的就是它们。手册里专门有一节讲 NIC 和 CPU tag 转发，说的正是快慢两条路怎么交接：绝大多数包在快路径上过去，少数“需要人看一眼”的包被打上标签送上行，交给 CPU 处理。

2.3 把“三层管理型”四个字拆开看

“二层”指的是看 MAC 地址转发。同一个网段内，A 找 B 靠的是 MAC 表：芯片记住“某个源 MAC 从某个口进来”，下次有人找这个 MAC，直接从对应口送出去。表里没有的地址怎么办？泛洪——往除入口外的所有口都发一份。这套机制简单、快，但只在同一个广播域里有效。

跨网段就不行了。这时候要看 IP，也就是“三层”。三层交换做的事说起来很朴素：查路由表找到下一跳、把包头里的目的 MAC 换成下一跳的 MAC、把 TTL 减一、重新算校验和，然后从对应口送出去。整个过程还是在那条传送带上完成，不需要把包送到 CPU 那里排队等判决。这就是三层交换和“软件路由”的本质差别——前者是硬件顺手做掉的一个动作，后者是处理器一件一件办的事。

至于“管理型”，它管的是可配置和可观测：VLAN 怎么划、哪些流量优先、哪些包要丢、哪个口的流量要复制一份出来分析、每个口错了多少包。这三件事凑齐，才叫三层管理型。少一样，都会在真实组网里露馅。

2.4 8×10G 到底是多少活

把数字摊开看更直观。单个万兆口每秒 100 亿比特，八个口单向合计 800 亿比特；因为收发可以同时进行，全双工算下来是 1600 亿比特。这个量级决定了芯片内部总线宽度、片上缓存大小、以及为什么这类芯片通常要外挂一颗 DDR3 内存——表项和缓冲区放片上根本不够。

包转发率更值得算。以太网最小的帧是 64 字节，加上 8 字节前导码和 12 字节帧间隙，一个最小包在线上实际占 84 字节、672 比特。100 亿除以 672，单口大约是每秒 1488 万个包；八个口合起来接近每秒 1.19 亿个包。这个数字是“最坏情况”，因为包越小，单位时间内要处理的包头越多，查表、判优、排队的次数也越多。很多设备在跑大包时表现良好，一跑小包就掉速，原因就在这里。

理解了这三个数字——160Gbps、1.19 亿包每秒、以及背后需要的表项规模——你再看手册里的功能列表，就不会把它们当成一堆并列的名词，而会明白每一项都是在回答“这么大的流量怎么管得住”。

3. 手册前三分之一：引脚、接口与电气参数怎么读

很多人翻手册的习惯是从目录跳到功能列表，看到一堆特性就以为读完了。真正让硬件工程师熬夜的，恰恰是前面那些看起来最枯燥的部分：引脚分配、接口定义、电气参数。这部分读错，板子回来就是不能点亮。

3.1 引脚表和 pin strapping：上电第一秒的默认答案

引脚分配一般给两张图：顶视图的物理排布，和一张密密麻麻的表格。表格里每一行是一个引脚编号、名称、类型（输入、输出、双向、电源）、以及复位后的默认状态。初学者最容易忽略最后一列，但它往往是排查“板子插上没反应”的第一现场。

更隐蔽的是 pin strapping，也就是引脚在上电瞬间的电平被芯片采样，用来决定启动配置。它相当于主板上的拨码开关，只不过用的是上下拉电阻。芯片复位释放的那一瞬间，几个特定引脚是高还是低，决定了它从哪个接口加载固件、端口默认怎么初始化。这里有个典型的踩坑场景：某个 strapping 引脚在电路图上顺手挂了个指示灯，上电时被拉低，芯片于是进了一个完全意料之外的启动模式，现象是“什么都不工作，连串口都没输出”。查电源、查时钟、换芯片，折腾两天，最后发现是一个电阻的事。

所以读手册的顺序，我的建议是先看复位章节和 strapping 章节，搞清楚“上电后它自己会做什么”，再回头看功能。手册里硬件复位和软件复位是分开写的，两者触发的范围不一样：硬件复位把几乎一切打回原形，软件复位往往只重置转发逻辑而不动配置接口。分不清这两者，调试时会误以为配置丢了。

3.2 对外接口清单：每个缩写对应板子上的什么东西

引脚描述章节会按接口分组，一组一组列下去。把它翻译成板子上的实物，大致是这样：

这张表解释了一件常被误解的事：交换控制器本身通常不直接“上网”,它要么被一颗主控 CPU 通过 SPI 从设备接口配置，要么自己片上带一个处理器跑系统。手册里同时出现 SPI 主和 SPI 从，说明两种用法都考虑到了：做纯芯片方案时，外部 CPU 当主、它当从；做单芯片方案时，它自己当主去读 Flash。

读 PDF 时有个省时间的做法：先把文本抽出来，用关键词定位章节页码，再回原文件精读那一页。

# 先把 PDF 转成纯文本（表格会错行，只用来定位，不要拿来当数据源） pdftotext controller-datasheet.pdf ds.txt # 抓出调试时最常回头查的几类词，记下页码再去原文件看 grep -n -E "Strapping|Software Reset|Absolute Maximum|DDR3|SGMII" ds.txt

这段命令不解决任何技术问题，只解决“在几十页里找那一页”的问题。参数就两个：输入文件名和你要找的词。注意转换后的表格会散架，千万别拿它抄引脚号，一定回原版 PDF 核对。

3.3 电气特性里的那次 900mV 到 1200mV 修订

电气特性章节分 AC 和 DC 两块，开头通常是绝对最大额定值——超过就烧，没有商量余地。往后是各路电源的电压容差、电流需求、以及高速接口的差分信号指标。

这份文档的修订记录里有一处很值得琢磨的改动：10GBase-R 的差分输出摆幅指标，从 900mV 提到了 1200mV；同一版还更新了主 SPI 的时序。摆幅这个东西，通俗地说就是“喊话的音量”。万兆信号在板子上走线、过连接器、过 AC 耦合电容，一路都在衰减；接收端的均衡能力有限，发送端音量不够，到了对面就淹没在噪声里。表现是什么？链路能起来，但跑久了开始丢包，误码计数缓慢上涨，换个模块就好、过两天又犯——典型的玄学故障。

指标往上调，意味着按老版本设计余量可能不够，尤其是走线长、连接器多的背板方案。这也是为什么数据手册要标版本号和修订记录：它不是一份写完就冻结的文件，每次改动背后通常都有真实的兼容性问题。拿到手册第一件事，看修订记录里有没有涉及你正要用的那个接口。

同一章还有一段 ESD 警告，读起来像废话，其实很实在：芯片是静电敏感器件，拆包装前先摸一下接地的金属、戴防静电手环、工作台铺防静电垫。这类损坏往往不是当场击穿，而是让某个引脚变“虚”，出厂测试能过，装到现场跑几个月开始出怪问题。

3.4 用带宽和包转发率反推需求

选型时最常见的错误是拿“端口数 × 端口速率”当整机能力。用几行代码把前面算过的数字摆出来，很多争论就结束了。

ports = 8 port_bps = 10e9 # 单口有效载荷速率：10Gbps frame_bits = (64 + 8 + 12) * 8 # 最小帧 64B + 前导 8B + 帧间隙 12B pps_per_port = port_bps / frame_bits # 单口每秒能收到多少个最小包 total_pps = pps_per_port * ports # 八口合计（单向） duplex_bps = port_bps * ports * 2 # 全双工：收发各算一遍 print(f"单口 {pps_per_port/1e6:.2f} Mpps") # 14.88 Mpps print(f"整机 {total_pps/1e6:.0f} Mpps 单向") # 119 Mpps print(f"双向合计 {duplex_bps/1e9:.0f} Gbps") # 160 Gbps

三行结果对应三个判断：14.88 Mpps 是单个口的极限压力，119 Mpps 是整机的包处理门槛，160 Gbps 是内部总带宽的下限。改参数也很简单：端口数换成 4，或者单口换成 25G，立刻就能看出另一颗芯片该是什么量级。

这里必须说明为什么用最小帧算：包越小，单位时间内要处理的包头越多，查表、判优、入队的次数也越多，这是最不利的情况。为什么加 8 字节前导和 12 字节帧间隙：这些也是在线路上真实占用时间的，不算进去会高估吞吐。为什么乘 2：全双工收发同时进行，两个方向都要过一遍内部通路。

4. 手册后半本：交换功能那一章怎么读

功能描述那一章是最厚的一块，也是最容易被跳过的。它按“这颗芯片能做什么”逐条展开，读法不该是从头看到尾，而是带着问题去查：我这个组网需求，它硬件上接不接得住。

4.1 二层转发：学习、转发、隔离与生成树

二层转发是所有功能的地基，手册一般把它拆成学习、转发、约束三小节。学习是指从入向包的源 MAC 和入端口建一条记录；转发是指拿目的 MAC 去查表，命中就单播送出，不命中就泛洪；约束是指对学习行为本身做限制，比如某个口最多学多少个地址、某些地址干脆不许学。

端口隔离是同一层里最实用的一条。它让同一颗芯片上的两个口互相看不见，只允许和指定的上行口通信，典型场景是小区宽带或者酒店客房——大家都在一个物理设备上，但互相之间不该有流量。这条在硬件里做掉，比在服务器上配防火墙省事得多。

组播部分会区分二层组播和 IP 组播，还会提到保留组播地址的处理：有些地址是协议专用的，不该被普通转发逻辑乱送。生成树那一节列了 802.1D、802.1W、802.1S 三代标准，作用是防环——网络里一旦有环路，广播包会绕圈放大，几分钟就能把整网打死。链路聚合那节，则是把多条物理链路捆成一条逻辑链路，既加带宽也做冗余。

镜像和采样经常被放在一起讲，但用途不同：镜像是把某个口的流量原样复制一份到指定观察口，供抓包分析；采样是按比例抽一部分包出来，压力小、适合长期观测。

4.2 VLAN 与 Q-in-Q：从一层标签到两层标签

VLAN 的作用是把一台物理设备切成多个逻辑网络，广播域互相隔开，安全性上去，广播风暴也压下来了。802.1Q 的办法是在以太帧里插 4 个字节的标签，其中 12 位是 VLAN ID，所以理论上限是四千多个。

Q-in-Q 是在标签外面再套一层标签。内层是用户自己的 VLAN，外层是运营商或上级网络分配的 VLAN。好处是两层的编号互不干扰：不同的租户可以用相同的内层编号，靠外层区分。手册里还会写入口和出口的 VLAN 翻译——包进来时把某个标签换成另一个，出去时再换回来。这在多局点互联时很有用，因为不同局点的编号规划往往不一致。

这里有个容易被忽略的点：标签处理是在线速下做的。也就是说，一个包可能被改两次标签、查两次表，仍然不影响吞吐。这件事在软件里做，一次改动就意味着一次内存拷贝，量一大就撑不住。

4.3 安全与限速：ACL、检测引擎、风暴抑制与三色标记

安全这一块，手册里通常围绕一个叫报文检测引擎的模块展开，配套的是 VLAN ACL 和入口 ACL。ACL 就是一串规则：匹配哪些字段、命中之后是放行、丢弃还是改优先级。因为规则是硬件并行比对的，所以能在满速下逐包检查，不掉性能。规则表有容量上限，这是选型时必须问清楚的一个数字——规则一多，要么装不下，要么被迫下沉到软件，性能立刻变脸。

日志计数是 ACL 的配套：某条规则命中多少次，硬件记着，软件定期来读。排查攻击时这个计数非常有用，能直接看到是哪条规则在拦东西。

流量抑制拆成三件事：入口带宽控制，按端口限速；ACL 限速，按规则限速；风暴控制，针对广播、组播、未知单播这三类容易泛滥的流量单独设阈值。三色标记则是更精细的限速方式——单速率和双速率两种模型，把流量标成绿、黄、红三档，绿色放行、黄色降优先级、红色丢弃。配合加权随机早期检测，在队列快满之前就开始有选择地丢包，避免“满了才丢、一丢就丢一大片”造成的全局同步。

流控那两节写的是背压：全双工下用 802.3x 的暂停帧告诉对面“慢点发”；半双工下没法发暂停帧，只能靠制造冲突（Jam 模式）或者推迟发送（Defer 模式）来变相减速。半双工在今天几乎见不到了，但手册仍会写全，因为总有些老设备还在用。

4.4 QoS 与队列调度：优先级从哪来，往哪去

QoS 要解决的是一个资源分配问题：出口就一个，都想先走，得有个规矩。手册里的顺序一般是优先级决策、包调度、出口重标记。

优先级从哪来？几个来源：端口默认值、包自带的 802.1p 优先级、IP 头里的 DSCP 字段、以及 ACL 命中后的强制指定。这四路汇到一处，冲突时谁说了算，手册会给出明确的选择顺序。搞不清这个顺序，会出现“明明配了高优先级，语音还是卡”的情况——因为包在入口就被端口默认值按住了。

包调度是决定谁先出队。严格优先级的好处是关键业务绝对优先，坏处是低优先级可能被饿死；加权轮询则按权重分配机会，牺牲一点确定性换取公平。多数实现是两者混合：高优先级队列用严格优先，其余队列之间加权轮询。出口重标记是临出门前再改一次优先级字段，让下游设备知道这个包该怎么对待。

4.5 CPU 子系统：芯片里为什么还要住一个小 CPU

功能列表翻到最后会看到一块不太像“交换机”的内容：片上处理器核、SPI Flash 控制器、DDR 内存控制器。原因是很多设备并不想再单独配一颗主控，希望一颗芯片加一颗 Flash 就能开箱。

这个片上处理器干的事很杂：开机时从 Flash 加载固件、初始化各个硬件模块、跑管理协议、响应外部管理请求、定期读走硬件计数。配套的还有表访问机制和外部 PHY 寄存器访问——后者让它能去配置挂在端口上的收发器芯片，比如协商速率、读光模块信息。

低功耗那一节出现的 EEE，指的是在链路空闲时让收发电路降功耗。这功能听起来无害，实际部署时经常被关掉，因为老设备兼容性不好会导致链路反复震荡。手册写“支持”是一回事，现场开不开是另一回事，这个区别后面还会再提。

5. 常见误区与易混概念：这五组东西经常被混为一谈

5.1 数据手册、寄存器手册、参考设计不是一回事

易混点：都叫“文档”，都跟这颗芯片有关，很多人以为拿到一份就全有了。

为什么混：搜出来的 PDF 名字都很像，内容又互相引用，页码还经常对不上。

怎么区分：数据手册回答“这颗芯片是什么、能做什么、引脚怎么接、电气指标多少”，写给做硬件和做系统的人；寄存器手册回答“每个功能具体往哪个地址写什么值”，写给写驱动的人，通常更厚更细；参考设计是“照着画就能工作的电路图和物料清单”，解决的是工程落地。三者缺一，项目都会卡在不同阶段。手里只有数据手册时，别指望靠它写出驱动。

5.2 三层交换不等于路由器

易混点：都能跨网段转发，都被叫做“三层设备”。

为什么混：功能表现上确实像——两边的主机配好网关就能互通，看不出差别。

怎么区分：三层交换的核心是“硬件查表转发”，路由表规模有限、转发路径极短、不做会话状态；路由器的强项是复杂的策略、地址转换、广域接口、以及大表项。设备选型时看两个数字就够了：路由表能装多少条、每秒能新建多少条会话。家用到小企业，三层交换足够；需要做地址转换、需要接广域线路，就得往上走一层。

5.3 交换控制器不等于 PHY，也不等于光模块

易混点：都跟“口”有关，出问题时不知道该找谁。

为什么混：现象都表现为“这个口不通”或“这个口丢包”。

怎么区分：交换控制器管的是包往哪走、怎么排队、怎么限速；PHY 和光模块管的是电信号和光信号之间的翻译，以及链路能不能协商起来。判断方法很土但有效——看链路灯：灯不亮，问题在 PHY 或光模块；灯亮但不通，问题在转发逻辑、VLAN 或 ACL。手册里会写明哪些接口是接主端口的、哪些是接低速收发器的，对着看就知道该查哪一段。

5.4 端口速率之和不等于整机吞吐

易混点：八个万兆口，就以为整机能跑 80Gbps 不间断。

为什么混：参数表上写的就是“8×10G”，很容易直接相乘。

怎么区分：要看内部总带宽和实际流量模型。如果八个口都是对同一个上行口发数据，上行那边就是瓶颈，这叫收敛比。手册给的是芯片能力上限，实际设备的吞吐还要看缓存多大、表项多少、CPU 跟不跟得上。评估时用上一章那几行代码算一遍最坏情况，比看宣传语靠谱。

5.5 “手册里写了”不等于“你的板子上能用”

易混点：把功能列表当成开箱即得的清单。

为什么混：功能章节写得很确定，好像每一项都默认打开。

怎么区分：至少有三道关卡。第一是引脚配置，某些功能要靠 strapping 引脚在上电时选对模式；第二是软件栈，硬件支持但驱动没写，等于没有；第三是资源上限，ACL 规则、VLAN 数量、组播组数都有硬顶，超了就得上软件兜底。做需求对照表时，把这三列都加上，别只对着功能列表打勾。

6. 什么时候用得上它，什么时候别指望它

先说结论：这份资料是给“要动手做设备”的人准备的，不是给“要用好网络”的人准备的。

用得上的场景很集中。做硬件选型时，你要拿它的端口能力、接口种类、封装和供电需求去和方案对表；画原理图时，引脚分配表和 strapping 定义是必须逐条核对的；写驱动或移植系统时，复位时序、表访问方式、SPI 时序、外部收发器寄存器访问这几节会被反复翻；排查链路问题时，电气特性里的差分摆幅、AC 耦合要求、以及修订记录里那次指标调整，是判断“是不是余量不够”的直接依据。还有一个常被低估的用途：做需求评审。客户提了一堆功能要求，你拿功能章节逐条对照，能当场判断哪些是硬件直接做掉的、哪些要靠软件补、哪些压根不支持。

用不上的场景也很明确。想学网络基础，看它没用，它假设你已经知道什么是 VLAN、什么是生成树；想配一台交换机，看它也没用，配置命令在软件文档里，不在芯片手册里；想做网络规划、算需要几台设备、怎么划分地址段，它同样帮不上忙——那是设计层面的事。最容易走偏的是把它当“速查表”：几十页表格确实像查询工具，但每一条参数背后都绑着电气条件和上下文的限制，抽出来单看很容易误读。

有个教训我记了很久。早年接手一个项目，功能列表上写着支持某种限速方式，我理所当然地认为打开就能用，方案里直接把这项当成卖点写了进去。等到联调才发现，规则表容量比预想的少一个数量级，一上真实策略就装不下，只能临时改成软件限速，性能掉了一大截，前面画的饼全得重画。从那以后我每次拿到一份新的数据手册，都强制走一遍同样的流程：先翻修订记录看有没有坑，再翻引脚和 strapping 确认硬件前提，然后把要用到的每个功能对应的容量上限抄进需求表，最后才去看功能列表里那些好听的名字。多花两个小时，能省掉后面两周的返工。

这份手册的完整版本放在下载区，需要对照引脚和参数的时候直接取用就行。希望帮到你。

本文还有配套的精品资源，点击获取