Skip to content

Commit 91d53e5

Browse files
authored
projects/cn0506: Added README files and fix dts (#1703)
* projects/cn0506: Update README files Signed-off-by: Elena-Hadarau_adi <Elena.Hadarau@analog.com> * docs/projects/cn0506: Fix dts Signed-off-by: Elena-Hadarau_adi <Elena.Hadarau@analog.com> --------- Signed-off-by: Elena-Hadarau_adi <Elena.Hadarau@analog.com>
1 parent 1e50dd3 commit 91d53e5

File tree

10 files changed

+198
-44
lines changed

10 files changed

+198
-44
lines changed

docs/projects/cn0506/index.rst

Lines changed: 8 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -356,22 +356,17 @@ HDL related
356356
Software related
357357
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
358358

359-
- :git-linux:`CN0506 MII dtsi source code (arm32) <arch/arm/boot/dts/adi-cn0506-mii.dtsi>`
360-
- :git-linux:`CN0506 RGMII dtsi source code (arm32) <arch/arm/boot/dts/adi-cn0506-rgmii.dtsi>`
361-
- :git-linux:`CN0506 RMII dtsi source code (arm32) <arch/arm/boot/dts/adi-cn0506-rmii.dtsi>`
362-
- :git-linux:`CN0506 MII dtsi source code (arm64) <arch/arm64/boot/dts/xilinx/adi-cn0506-mii.dtsi>`
363-
- :git-linux:`CN0506 RGMII dtsi source code (arm64) <arch/arm64/boot/dts/xilinx/adi-cn0506-rgmii.dtsi>`
364-
- :git-linux:`CN0506 RMII dtsi source code (arm64) <arch/arm64/boot/dts/xilinx/adi-cn0506-rmii.dtsi>`
365-
- :git-linux:`CN0506 MII - A10SOC dts source code (arm32) <arch/arm/boot/dts/socfpga_arria10_socdk_cn0506_mii.dts>`
359+
- :git-linux:`CN0506 MII - A10SOC dts source code (arm32) <arch/arm/boot/dts/intel/socfpga/socfpga_arria10_socdk_cn0506_mii.dts>`
360+
- :git-linux:`CN0506 RGMII - A10SOC dts source code (arm32) <arch/arm/boot/dts/intel/socfpga/socfpga_arria10_socdk_cn0506_rgmii.dts>`
366361
- :git-linux:`CN0506 MII - ZCU102 dts source code (arm64) <arch/arm64/boot/dts/xilinx/zynqmp-zcu102-rev10-cn0506-mii.dts>`
367362
- :git-linux:`CN0506 RGMII - ZCU102 dts source code (arm64) <arch/arm64/boot/dts/xilinx/zynqmp-zcu102-rev10-cn0506-rgmii.dts>`
368363
- :git-linux:`CN0506 RMII - ZCU102 dts source code (arm64) <arch/arm64/boot/dts/xilinx/zynqmp-zcu102-rev10-cn0506-rmii.dts>`
369-
- :git-linux:`CN0506 MII - ZC706 dts source code (arm32) <arch/arm/boot/dts/zynq-zc706-adv7511-cn0506-mii.dts>`
370-
- :git-linux:`CN0506 RGMII - ZC706 dts source code (arm32) <arch/arm/boot/dts/zynq-zc706-adv7511-cn0506-rgmii.dts>`
371-
- :git-linux:`CN0506 RMII - ZC706 dts source code (arm32) <arch/arm/boot/dts/zynq-zc706-adv7511-cn0506-rmii.dts>`
372-
- :git-linux:`CN0506 MII - ZED dts source code (arm32) <arch/arm/boot/dts/zynq-zed-adv7511-cn0506-mii.dts>`
373-
- :git-linux:`CN0506 RGMII - ZED dts source code (arm32) <arch/arm/boot/dts/zynq-zed-adv7511-cn0506-rgmii.dts>`
374-
- :git-linux:`CN0506 RMII - ZED dts source code (arm32) <arch/arm/boot/dts/zynq-zed-adv7511-cn0506-rmii.dts>`
364+
- :git-linux:`CN0506 MII - ZC706 dts source code (arm32) <arch/arm/boot/dts/xilinx/zynq-zc706-adv7511-cn0506-mii.dts>`
365+
- :git-linux:`CN0506 RGMII - ZC706 dts source code (arm32) <arch/arm/boot/dts/xilinx/zynq-zc706-adv7511-cn0506-rgmii.dts>`
366+
- :git-linux:`CN0506 RMII - ZC706 dts source code (arm32) <arch/arm/boot/dts/xilinx/zynq-zc706-adv7511-cn0506-rmii.dts>`
367+
- :git-linux:`CN0506 MII - ZED dts source code (arm32) <arch/arm/boot/dts/xilinx/zynq-zed-adv7511-cn0506-mii.dts>`
368+
- :git-linux:`CN0506 RGMII - ZED dts source code (arm32) <arch/arm/boot/dts/xilinx/zynq-zed-adv7511-cn0506-rgmii.dts>`
369+
- :git-linux:`CN0506 RMII - ZED dts source code (arm32) <arch/arm/boot/dts/xilinx/zynq-zed-adv7511-cn0506-rmii.dts>`
375370
- :dokuwiki:`ADIN1300 driver docs <resources/tools-software/linux-drivers/net-phy/adin>`
376371

377372
.. include:: ../common/more_information.rst

projects/cn0506/README.md

Lines changed: 11 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,15 @@
11
# CN0506 HDL Project
22

3-
Here are some pointers to help you:
4-
* [Board Product Page](https://www.analog.com/cn0506)
5-
* Parts : [Robust, Industrial, Low Latency and Low Power 10 Mbps, 100 Mbps, and 1 Gbps Ethernet PHY](https://www.analog.com/adin1300)
6-
* Project Doc: https://wiki.analog.com/resources/eval/user-guides/circuits-from-the-lab/cn0506
7-
* HDL Doc: https://wiki.analog.com/resources/eval/user-guides/circuits-from-the-lab/cn0506/hdl
8-
* Linux Drivers: https://wiki.analog.com/resources/tools-software/linux-drivers/net-phy/adin
9-
## Building, Generating Bit Files
3+
- Evaluation board product page: [EVAL-CN0506](https://www.analog.com/cn0506)
4+
- System documentation: https://wiki.analog.com/resources/eval/user-guides/circuits-from-the-lab/cn0506
5+
- HDL project documentation: https://analogdevicesinc.github.io/hdl/projects/cn0506/index.html
106

11-
IMPORTANT: Set CN0506 MAC to PHY interface
7+
## Supported parts
128

13-
How to use over-writable parameters from the environment:
14-
```
15-
hdl/projects/cn0506/zed> make INTF_CFG=MII
16-
`` - Defines the MAC to PHY interface: MII, RGMII or RMII.
17-
INTF_CFG - Defines the MAC to PHY interface: MII, RGMII or RMII.
9+
| Part name | Description |
10+
|---------------------------------------------|------------------------------------------------------------------------------------------|
11+
| [ADIN1300](https://www.analog.com/adin1300) | Robust, Industrial, Low Latency and Low Power 10 Mbps, 100 Mbps, and 1 Gbps Ethernet PHY |
12+
13+
## Building the project
14+
15+
Please enter the folder for the FPGA carrier you want to use and read the README.md.

projects/cn0506/a10soc/README.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
# CN0506/A10SOC HDL Project
2+
3+
## Building the project
4+
5+
- Connect on FMC A HPC(V57.1)
6+
- VADJ = 1.8V
7+
- Only the default configuration is supported in MII mode.
8+
- Connected to HPS (EMAC1-PHY0 and EMAC2-PHY1).
9+
10+
```
11+
cd projects/cn0506/a10soc
12+
make
13+
```
14+
15+
Corresponding device trees:
16+
- [socfpga_arria10_socdk_cn0506_mii.dts](https://github.com/analogdevicesinc/linux/blob/main/arch/arm/boot/dts/intel/socfpga/socfpga_arria10_socdk_cn0506_mii.dts)
17+
- [socfpga_arria10_socdk_cn0506_rgmii.dts](https://github.com/analogdevicesinc/linux/blob/main/arch/arm/boot/dts/intel/socfpga/socfpga_arria10_socdk_cn0506_rgmii.dts)

projects/cn0506/a10soc/README.rst

Lines changed: 0 additions & 3 deletions
This file was deleted.

projects/cn0506/zc706/README.md

Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,54 @@
1+
# CN0506/ZC706 HDL Project
2+
3+
## Building the project
4+
5+
The parameters configurable through the `make` command, can be found below, as well as in the **system_project.tcl** file; it contains the default configuration.
6+
7+
```
8+
cd projects/cn0506/zc706
9+
make
10+
```
11+
12+
The overwritable parameter from the environment is:
13+
14+
- INTF_CFG - defines the MAC to PHY interface type (MII, RGMII or RMII)
15+
16+
### Example configurations
17+
18+
- Connect on FMC LPC
19+
- VADJ = 2.5V
20+
21+
#### RGMII mode (default)
22+
23+
- RGMII mode uses a GMII-to-RGMII converter, connected to PS7's Ethernet 0 (PHY 0) and Ethernet 1 (PHY 1)
24+
25+
This specific command is equivalent to running `make` only:
26+
27+
```
28+
cd projects/cn0506/zc706
29+
make INTF_CFG=RGMII
30+
```
31+
32+
Corresponding device tree: [zynq-zc706-adv7511-cn0506-rgmii.dts](https://github.com/analogdevicesinc/linux/blob/main/arch/arm/boot/dts/xilinx/zynq-zc706-adv7511-cn0506-rgmii.dts)
33+
34+
#### MII mode
35+
36+
- Connected to PS7's Ethernet 0 (PHY 0) and Ethernet 1 (PHY 1)
37+
38+
```
39+
cd projects/cn0506/zc706
40+
make INTF_CFG=MII
41+
```
42+
43+
Corresponding device tree: [zynq-zc706-adv7511-cn0506-mii.dts](https://github.com/analogdevicesinc/linux/blob/main/arch/arm/boot/dts/xilinx/zynq-zc706-adv7511-cn0506-mii.dts)
44+
45+
#### RMII mode
46+
47+
- RMII mode uses a MII-to-RMII converter, connected to PS7's Ethernet 0 (PHY 0) and Ethernet 1 (PHY 1)
48+
49+
```
50+
cd projects/cn0506/zc706
51+
make INTF_CFG=RMII
52+
```
53+
54+
Corresponding device tree: [zynq-zc706-adv7511-cn0506-rmii.dts](https://github.com/analogdevicesinc/linux/blob/main/arch/arm/boot/dts/xilinx/zynq-zc706-adv7511-cn0506-rmii.dts)

projects/cn0506/zc706/README.rst

Lines changed: 0 additions & 5 deletions
This file was deleted.

projects/cn0506/zcu102/README.md

Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,54 @@
1+
# CN0506/ZCU102 HDL Project
2+
3+
## Building the project
4+
5+
The parameters configurable through the `make` command, can be found below, as well as in the **system_project.tcl** file; it contains the default configuration.
6+
7+
```
8+
cd projects/cn0506/zcu102
9+
make
10+
```
11+
12+
The overwritable parameter from the environment:
13+
14+
- INTF_CFG - defines the MAC to PHY interface type (MII, RGMII or RMII)
15+
16+
### Example configurations
17+
18+
- Connect on FMC1
19+
- VADJ = 1.8V
20+
21+
#### RGMII mode (default)
22+
23+
- RGMII mode uses a GMII-to-RGMII converter, connected to PS8's Ethernet 0(PHY 0) and Ethernet 1(PHY 1)
24+
25+
This specific command is equivalent to running `make` only:
26+
27+
```
28+
cd projects/cn0506/zcu102
29+
make INTF_CFG=RGMII
30+
```
31+
32+
Corresponding device tree: [zynqmp-zcu102-rev10-cn0506-rgmii.dts](https://github.com/analogdevicesinc/linux/blob/main/arch/arm64/boot/dts/xilinx/zynqmp-zcu102-rev10-cn0506-rgmii.dts)
33+
34+
#### MII mode
35+
36+
- Connected to PS8's Ethernet 0(PHY 0) and Ethernet 1(PHY 1)
37+
38+
```
39+
cd projects/cn0506/zcu102
40+
make INTF_CFG=MII
41+
```
42+
43+
Corresponding device tree: [zynqmp-zcu102-rev10-cn0506-mii.dts](https://github.com/analogdevicesinc/linux/blob/main/arch/arm64/boot/dts/xilinx/zynqmp-zcu102-rev10-cn0506-mii.dts)
44+
45+
#### RMII mode
46+
47+
- RMII mode uses a MII-to-RMII converter, connected to PS8's Ethernet 0(PHY 0) and Ethernet 1(PHY 1)
48+
49+
```
50+
cd projects/cn0506/zcu102
51+
make INTF_CFG=RMII
52+
```
53+
54+
Corresponding device tree: [zynqmp-zcu102-rev10-cn0506-rmii.dts](https://github.com/analogdevicesinc/linux/blob/main/arch/arm64/boot/dts/xilinx/zynqmp-zcu102-rev10-cn0506-rmii.dts)

projects/cn0506/zcu102/README.rst

Lines changed: 0 additions & 5 deletions
This file was deleted.

projects/cn0506/zed/README.md

Lines changed: 54 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,54 @@
1+
# CN0506/ZED HDL Project
2+
3+
## Building the project
4+
5+
The parameters configurable through the `make` command, can be found below, as well as in the **system_project.tcl** file; it contains the default configuration.
6+
7+
```
8+
cd projects/cn0506/zed
9+
make
10+
```
11+
12+
The overwritable parameter from the environment:
13+
14+
- INTF_CFG - defines the MAC to PHY interface type (MII, RGMII or RMII)
15+
16+
### Example configurations
17+
18+
- Connect on FMC LPC
19+
- VADJ = 2.5V
20+
21+
#### RGMII mode (default)
22+
23+
- RGMII mode uses a GMII-to-RGMII converter, connected to PS7's Ethernet 0(PHY 0) and Ethernet 1(PHY 1).
24+
25+
This specific command is equivalent to running `make` only:
26+
27+
```
28+
cd projects/cn0506/zed
29+
make INTF_CFG=RGMII
30+
```
31+
32+
Corresponding device tree: [zynq-zed-adv7511-cn0506-rgmii.dts](https://github.com/analogdevicesinc/linux/blob/main/arch/arm/boot/dts/xilinx/zynq-zed-adv7511-cn0506-rgmii.dts)
33+
34+
#### MII mode
35+
36+
- Connected to PS7's Ethernet 0(PHY 0) and Ethernet 1(PHY 1).
37+
38+
```
39+
cd projects/cn0506/zed
40+
make INTF_CFG=MII
41+
```
42+
43+
Corresponding device tree: [zynq-zed-adv7511-cn0506-mii.dts](https://github.com/analogdevicesinc/linux/blob/main/arch/arm/boot/dts/xilinx/zynq-zed-adv7511-cn0506-mii.dts)
44+
45+
#### RMII mode
46+
47+
- RMII mode uses a MII-to-RMII converter, connected to PS7's Ethernet 0(PHY 0) and Ethernet 1(PHY 1).
48+
49+
```
50+
cd projects/cn0506/zed
51+
make INTF_CFG=RMII
52+
```
53+
54+
Corresponding device tree: [zynq-zed-adv7511-cn0506-rmii.dts](https://github.com/analogdevicesinc/linux/blob/main/arch/arm/boot/dts/xilinx/zynq-zed-adv7511-cn0506-rmii.dts)

projects/cn0506/zed/README.rst

Lines changed: 0 additions & 5 deletions
This file was deleted.

0 commit comments

Comments
 (0)