第4章 搭建环境：ns-3.48 + Zigbee 模块

本章目标

把 ns-3.48 装好、跑通第一个官方示例。完成后你就能自己复现本栏目所有日志。

4.1 版本与环境

项	选型	理由
ns-3 版本	ns-3.48	首个内置 zigbee 模块的正式版本
操作系统	WSL2 + Ubuntu 24.04	Windows 下最省事的 Linux 环境
编译工具	g++ / cmake / ninja	ns-3 官方工具链

4.2 安装三步

# 1) 装依赖


<PptMode />
sudo apt update && sudo apt install -y g++ python3 cmake ninja-build ccache git

# 2) 下载解压


<PptMode />
wget https://www.nsnam.org/releases/ns-allinone-3.48.tar.bz2
tar xjf ns-allinone-3.48.tar.bz2 && cd ns-allinone-3.48/ns-3.48

# 3) 编译并验证


<PptMode />
./ns3 build
./ns3 run zigbee-aps-data

验证成功标志

日志里出现设备入网成功、收到数据包（如 Received DATA packet with size 5）即环境 OK。

4.3 官方自带 5 个示例

示例	演示内容
zigbee-aps-data	单播 / 组播应用数据收发
zigbee-nwk-routing	网络层路由发现与路由表
zigbee-nwk-routing-grid	网格拓扑下的路由
zigbee-nwk-association-join	建网与关联入网
zigbee-nwk-direct-join	直接入网

运行技巧

• 带参数运行：./ns3 run "zigbee-mesh-with-ze --layout=2"
• 存日志：./ns3 run zigbee-aps-data > aps-data.log 2>&1
• 本栏目所有日志均来自这套环境的真实输出（数据源见附录）。