diff --git a/rt-thread-version/rt-thread-standard/_sidebar.md b/rt-thread-version/rt-thread-standard/_sidebar.md index 13c08b53028ef47423df2b5f668169d9bc7c0d98..6ab2062bdcc5cd3b6c509b67ab490e796241d571 100644 --- a/rt-thread-version/rt-thread-standard/_sidebar.md +++ b/rt-thread-version/rt-thread-standard/_sidebar.md @@ -203,6 +203,7 @@ - [英飞凌评估套件](/rt-thread-version/rt-thread-standard/hw-board/ifx-eval-kit/ifx-eval-kit.md) - [HMI-Board](/rt-thread-version/rt-thread-standard/hw-board/ra6m3-hmi-board/ra6m3-hmi-board.md) - [Vision-Board](/rt-thread-version/rt-thread-standard/hw-board/ra8d1-vision-board/ra8d1-vision-board.md) + - [RZN2L-EtherKit](/rt-thread-version/rt-thread-standard/hw-board/rzn2l-etherkit/rzn2l-etherkit.md) - Demo示例 - 开源参考设计 - [英飞凌网关Demo](/rt-thread-version/rt-thread-standard/tutorial/open-projects-design/Infineon/Infineon-gateway-demo.md) diff --git a/rt-thread-version/rt-thread-standard/hw-board/rzn2l-etherkit/figures/env_iar.png b/rt-thread-version/rt-thread-standard/hw-board/rzn2l-etherkit/figures/env_iar.png new file mode 100644 index 0000000000000000000000000000000000000000..0f49f567ec13c2b92a31b50d2ba6dc413eb1a996 Binary files /dev/null and b/rt-thread-version/rt-thread-standard/hw-board/rzn2l-etherkit/figures/env_iar.png differ diff --git a/rt-thread-version/rt-thread-standard/hw-board/rzn2l-etherkit/figures/etherkit.png b/rt-thread-version/rt-thread-standard/hw-board/rzn2l-etherkit/figures/etherkit.png new file mode 100644 index 0000000000000000000000000000000000000000..dc40dbc2d1eba443717b1412f6b07f2b445e178f Binary files /dev/null and b/rt-thread-version/rt-thread-standard/hw-board/rzn2l-etherkit/figures/etherkit.png differ diff --git a/rt-thread-version/rt-thread-standard/hw-board/rzn2l-etherkit/figures/etherkit_hw_resource.png b/rt-thread-version/rt-thread-standard/hw-board/rzn2l-etherkit/figures/etherkit_hw_resource.png new file mode 100644 index 0000000000000000000000000000000000000000..b83ba9621976d4cc831b62c7d5cc9c8320df7363 Binary files /dev/null and b/rt-thread-version/rt-thread-standard/hw-board/rzn2l-etherkit/figures/etherkit_hw_resource.png differ diff --git a/rt-thread-version/rt-thread-standard/hw-board/rzn2l-etherkit/figures/etherkit_pin_view.png b/rt-thread-version/rt-thread-standard/hw-board/rzn2l-etherkit/figures/etherkit_pin_view.png new file mode 100644 index 0000000000000000000000000000000000000000..1b193bf95dd6e7edfffb3efa7fc7feb66f7ee3cb Binary files /dev/null and b/rt-thread-version/rt-thread-standard/hw-board/rzn2l-etherkit/figures/etherkit_pin_view.png differ diff --git a/rt-thread-version/rt-thread-standard/hw-board/rzn2l-etherkit/figures/etherkit_project.png b/rt-thread-version/rt-thread-standard/hw-board/rzn2l-etherkit/figures/etherkit_project.png new file mode 100644 index 0000000000000000000000000000000000000000..e9461f8df639ee0135e6806fdc65b2c208b7293d Binary files /dev/null and b/rt-thread-version/rt-thread-standard/hw-board/rzn2l-etherkit/figures/etherkit_project.png differ diff --git a/rt-thread-version/rt-thread-standard/hw-board/rzn2l-etherkit/figures/etherkit_sdk.png b/rt-thread-version/rt-thread-standard/hw-board/rzn2l-etherkit/figures/etherkit_sdk.png new file mode 100644 index 0000000000000000000000000000000000000000..10d63bf7555ef3c7c5f810da92788905489f16ac Binary files /dev/null and b/rt-thread-version/rt-thread-standard/hw-board/rzn2l-etherkit/figures/etherkit_sdk.png differ diff --git a/rt-thread-version/rt-thread-standard/hw-board/rzn2l-etherkit/figures/iar_complier.png b/rt-thread-version/rt-thread-standard/hw-board/rzn2l-etherkit/figures/iar_complier.png new file mode 100644 index 0000000000000000000000000000000000000000..881c13be50fb784773718079e46053ec45379c97 Binary files /dev/null and b/rt-thread-version/rt-thread-standard/hw-board/rzn2l-etherkit/figures/iar_complier.png differ diff --git a/rt-thread-version/rt-thread-standard/hw-board/rzn2l-etherkit/figures/iar_download.png b/rt-thread-version/rt-thread-standard/hw-board/rzn2l-etherkit/figures/iar_download.png new file mode 100644 index 0000000000000000000000000000000000000000..6e131e1e5334f706f0647711b75863acef6326ba Binary files /dev/null and b/rt-thread-version/rt-thread-standard/hw-board/rzn2l-etherkit/figures/iar_download.png differ diff --git a/rt-thread-version/rt-thread-standard/hw-board/rzn2l-etherkit/figures/mklink.png b/rt-thread-version/rt-thread-standard/hw-board/rzn2l-etherkit/figures/mklink.png new file mode 100644 index 0000000000000000000000000000000000000000..ca5d6fec9570d867114279db2c95be01e2897687 Binary files /dev/null and b/rt-thread-version/rt-thread-standard/hw-board/rzn2l-etherkit/figures/mklink.png differ diff --git a/rt-thread-version/rt-thread-standard/hw-board/rzn2l-etherkit/figures/project_download.png b/rt-thread-version/rt-thread-standard/hw-board/rzn2l-etherkit/figures/project_download.png new file mode 100644 index 0000000000000000000000000000000000000000..cda6e1359db59fdbdb7b76a73c02b41b4c6bcbeb Binary files /dev/null and b/rt-thread-version/rt-thread-standard/hw-board/rzn2l-etherkit/figures/project_download.png differ diff --git a/rt-thread-version/rt-thread-standard/hw-board/rzn2l-etherkit/figures/r52_cpu.png b/rt-thread-version/rt-thread-standard/hw-board/rzn2l-etherkit/figures/r52_cpu.png new file mode 100644 index 0000000000000000000000000000000000000000..9f45f121e7baad724d0a992b9f523097501cbd84 Binary files /dev/null and b/rt-thread-version/rt-thread-standard/hw-board/rzn2l-etherkit/figures/r52_cpu.png differ diff --git a/rt-thread-version/rt-thread-standard/hw-board/rzn2l-etherkit/rzn2l-etherkit.md b/rt-thread-version/rt-thread-standard/hw-board/rzn2l-etherkit/rzn2l-etherkit.md new file mode 100644 index 0000000000000000000000000000000000000000..2c8678abc6773dbc20082a30650c4cc06dae3ac3 --- /dev/null +++ b/rt-thread-version/rt-thread-standard/hw-board/rzn2l-etherkit/rzn2l-etherkit.md @@ -0,0 +1,135 @@ +# EtherKit 开发板 + +EtherKit 是 RT-Thread 联合瑞萨电子推出的一款高性能、多功能以太网MPU开发板，采用瑞萨电子 RZ/N2L 芯片，搭载 **Arm® Cortex®-R52 内核**，主频高达400 MHz；支持 TSN 的3端口千兆以太网端口；支持 EtherCAT、PROFINET RT/IRT、EtherNet/IP™、Modbus、OPC UA 等主流工业以太网通信协议，该开发板能轻松满足各种工业场景对**工业以太网**的需求。 + +![图片](figures/etherkit.png) + +## 资料链接 + +- SDK github：[https://github.com/RT-Thread-Studio/sdk-bsp-rzn2l-etherkit](https://github.com/RT-Thread-Studio/sdk-bsp-rzn2l-etherkit) + +- SDK gitee：[https://gitee.com/RT-Thread-Studio-Mirror/sdk-bsp-rzn2l-etherkit](https://gitee.com/RT-Thread-Studio-Mirror/sdk-bsp-rzn2l-etherkit) + +- 开发板购买链接：[EtherKit 购买链接](https://item.taobao.com/item.htm?abbucket=17&id=855679103445)（请复制至某宝打开) + +## 芯片特性 + +- **主控芯片**：**EtherKit** 采用瑞萨 RZ/N2L芯片，是一个以太网通信微处理器（MPU），具有带 TSN 的高级 3 端口千兆以太网交换机、EtherCAT® 从站控制器等功能。 +- **Arm® Cortex®-R52 内核**：最高可达 400MHz 的处理能力，确保实时任务的高效执行。 +- **三端口千兆以太网交换机**：原生支持 EtherCAT®、PROFINET® RT/IRT、EtherNet/IP™等，简化工业以太网集成。 +- **内存配置**：256KB 紧密耦合内存（ATCM+BTCM）和 1.5MB 内部 RAM，支持 ECC，保证数据完整性和系统稳定性。 +- **三角函数加速器**：提升电机控制算法的计算速度。 + +下图是EtherKit的CPU框图： + +![CPU框图](figures/r52_cpu.png) + +## EtherKit硬件主板资源 + +下面来看下EtherKit的硬件资源： + +- 接口和配置方面，EtherKit搭载瑞萨RZ/N2L系列芯片，型号为**R9A07G084M04GBG**。 +- 外置搭载华邦W958D8NBYA—**32MB**的 **HyperRAM**，同时搭载一颗**8MByte**的QSPI-Flash和**16Kbit**的EEPROM。 +- 在以太网方面，EtherKit搭载了3颗千兆PHY芯片，同时配备了8个以太网状态指示灯。 +- 供电方面，EtherKit支持24V DC直流供电，同时也支持USB Type-C供电。 +- 板载RESET复位按键和2个用户按键，3个用户自定义LED灯+EtherCAT通讯指示灯。 + +**在外置接口方面，EtherKit也非常丰富**： + +- 24V数字输入输出接口各 4个 + 8路ADC采样接口。 +- 板载2路 CANFD 通讯接口以及一路 RS485 接口。 +- 板载一个 20Pin 标准JTAG调试接口。 +- 板载两个 USB Type-C 接口：USB-TTL 可做串口输出功能，方便LOG信息打印； +- USB-DEVICE 接口可以作为USB从机使用。 + +- 在以太网方面，EtherKit 搭载了3颗千兆PHY芯片，同时配备了8个以太网状态指示灯。 +- 供电方面，EtherKit 支持24V DC直流供电，同时也支持 USB Type-C 供电。 +- 板载RESET复位按键和2个用户按键，3个用户自定义LED灯+EtherCAT通讯指示灯。 + +![图片](figures/etherkit_hw_resource.png) + +* 除此之外，还带有一个 Pmod 接口和 40Pin 拓展接口，可拓展IIC、SPI、UART、定时器等功能。 + +![图片](figures/etherkit_pin_view.png) + +## EtherKit软件适配情况 + +目前 RT-Thread 已经完美适配了 ARM Cortex®-R52 架构，现已支持 EtherKit 板级支持包及 SDK ，支持 RT-Thread Studio GCC 及 IAR 开发；此外针对 EtherKit 适配了许多驱动以及针对网络、工业等应用场景的软件包+组件。 + +以下是针对EtherKit软件的支持情况的说明： + +| **EtherCAT方案** | **支持情况** | **EtherCAT方案** | **支持情况** | +| ----------------------------------------------- | ------------ | ------------------- | ------------- | +| EtherCAT_IO | 支持 | EtherCAT_FOE | 支持 | +| EtherCAT_EOE | 支持 | EtherCAT_COE | 支持 | +| **PROFINET方案** | **支持情况** | **Ethernet/IP方案** | **支持情况** | +| P-Net（支持ProfiNET从站协议栈的开源评估软件包） | 支持 | EIP | 正在支持中... | +| **片上外设** | **支持情况** | **组件** | **支持情况** | +| UART | 支持 | LWIP | 支持 | +| GPIO | 支持 | TCP/UDP | 支持 | +| HWIMER | 支持 | MQTT | 支持 | +| IIC | 支持 | TFTP | 支持 | +| WDT | 支持 | Modbus主从站协议 | 支持 | +| RTC | 支持 | | | +| ADC | 支持 | | | +| DAC | 支持 | | | +| SPI | 支持 | | | + +注意：EtherKit 支持 RT-Thread Studio 和 IAR 开发。 + +## 环境搭建 + +环境搭建请参考此文档：[EtherKit 环境搭建文档](https://docs.qq.com/doc/DVFp2a1BGUEtOV2l4) + +## 使用 + +### IAR 开发步骤 + +1.本地克隆 EtherKit SDK 仓库： + +```shell +git clone https://github.com/RT-Thread-Studio/sdk-bsp-rzn2l-etherkit.git +``` + +2.双击 mklinks.bat 文件，执行脚本后会生成 rt-thread、libraries 两个文件夹： + +![image-20241129135712917](figures/mklink.png) + +> 注意： +> +> 1.如果无法执行 mklinks 脚本，需要手动将 sdk-bsp-rzn2l-etherkit 目录下的 rt-thread、libraries 两个文件夹手动拷贝到工程目录； +> +> 2.**IAR版本请选择 IAR EW for Arm 9.50.2 版本及以上**。 + +3.打开 env 执行 scons --target=iar 生成 project.eww + +![image-20241129140259254](figures/env_iar.png) + +4.双击 project.eww 文件打开 IAR 工程，点击下图按钮进行项目全编译： + +![image-20241129140747607](figures/iar_complier.png) + +5.点击下图按钮进行固件烧录： + +![image-20241129140951110](figures/iar_download.png) + +### RT-Thread Studio 开发步骤 + +1.打开 RT-Thread Studio ，安装 EtherKit 开发板支持包（如有最新建议安装最新版本，下图版本仅供参考）； + +![image-20241129141217960](figures/etherkit_sdk.png) + +2.新建 EtherKit 工程，选择左上角文件->新建->RT-Thread 项目->基于开发板，可以创建示例工程和模板工程； + +![image-20241129141447685](figures/etherkit_project.png) + +3.进行工程的编译和下载： + +![image-20241129141710818](figures/project_download.png) + +## 其他资料 + +- [开发板官网主页](https://www.rt-thread.org/document/site/#/rt-thread-version/rt-thread-standard/hw-board/rzn2l-etherkit/rzn2l-etherkit) +- [开发板数据手册](https://www.renesas.cn/zh/document/dst/rzn2l-group-datasheet?r=1622651) +- [开发板硬件手册](https://www.renesas.cn/zh/document/mah/rzn2l-group-users-manual-hardware?r=1622651) +- [开发板用户手册](https://gitee.com/RT-Thread-Studio-Mirror/sdk-bsp-rzn2l-etherkit/blob/master/docs/EtherKit%E7%94%A8%E6%88%B7%E6%89%8B%E5%86%8C_V0.1.0.pdf)