This version is outdated by a newer approved version.
This version (05 Dec 2022 06:53) was approved by Alexandru Tachici.The Previously approved version (05 Dec 2022 06:47) is available.
This version (05 Dec 2022 06:53) was approved by Alexandru Tachici.The Previously approved version (05 Dec 2022 06:47) is available.This is an old revision of the document!
Table of Contents
ADIN1110 10BASE-T1L MAC-PHY Linux Driver Quick Start
Description
This is a Quick Start Guide on how to properly connect and use the EVAL-ADIN1110EBZ on multiple platforms in a Linux environment.
RPI 3
Wiring/software needed is the same also for RPI 4.
Wiring
| RPI 3 | EVAL-ADIN1110EBZ |
|---|---|
| SPI_MOSI (GPIO 10) (Pin 19) | T1L_MOSI |
| SPI_MISO (GPIO 9) (Pin 21) | T1L_MISO |
| SPI_CLK (GPIO 11) (Pin 23) | T1L_CLK |
| SPI_CEO_N (GPIO 8) (Pin 24) | T1L_CS_N |
| GPIO 25 (Pin 22) | T1L_INT_N |
Connect both grounds (idealy) to the most accessible ground to you on the RPI 3.
Board settings
ADIN1110 needs to operate in Generic SPI mode (see Datasheet) and with CRC protection enabled. In order to do this find S201 and set every switch to the following table:
| SWITCH | POSITION |
|---|---|
| SPI_CFG0 | OFF |
| SPI_CFG1 | ON |
| SWPD_N | ON |
| TX2V4_DIS | OFF |
| MS_SEL | OFF |
Software Setup
Getting a Raspbian Image
Download an SD Card Image: ADI Kuiper or other Raspbian Linux Image.
Preparing the SD card
Write the image to the sd card:
sudo dd status=progress if=2022-05-29-ADI-Kuiper-full.img of=/dev/mmcblk0 bs=4M conv=fsync
Setup RPI to use the ADIN1110 overlay. To do this go to the boot partition of the SD card and write in the config.txt file:
[all] dtoverlay=rpi-adin1110
NXP 8MMINI-BB
Wiring
| 8MMINI-BB | EVAL-ADIN1110EBZ |
|---|---|
| ECSPI2_MOSI (Pin 19) | T1L_MOSI |
| ECSPI2_MISO (Pin 21) | T1L_MISO |
| ECSPI2_SCLK (Pin 23) | T1L_CLK |
| GPIO 24 (Pin 35) | T1L_CS_N |
| GPIO 25 (Pin 37) | T1L_INT_N |
Connect both grounds (idealy) to the most accessible ground to you on the 8MMINI-BB.
Board settings
ADIN1110 needs to operate in Generic SPI mode (see Datasheet) and with CRC protection enabled. In order to do this find S201 and set every switch to the following table:
| SWITCH | POSITION |
|---|---|
| SPI_CFG0 | OFF |
| SPI_CFG1 | ON |
| SWPD_N | ON |
| TX2V4_DIS | OFF |
| MS_SEL | OFF |
Make sure IMX8MM-BB is set to boot from the SD Card, for more details go to Boot Switch Setup.
Software Setup
Preparing an SD Card
You need a SD Card with a NXP Linux image on it, more details here. From NPX Software Downloads page, download the L5.15.52_2.1.0 SD card image. In case of broken link/missing image, try any other that is at least 5.10. Extract the archive and find the SD Card image file:
6,8G imx-image-full-imx8mmevk.wic
This you can directly write to an SD Card in order to get a functional 8MMINI-BB system:
sudo dd status=progress if=imx-image-full-imx8mmevk.wic of=/dev/mmcblk0 bs=4M conv=fsync
At this point you can insert the card in the 8MMINI-BB, power it, connect the UART and you should be able to login.
NXP i.MX Release Distro 5.15-kirkstone imx8mmevk ttymxc1 imx8mmevk login: [ 12.063688] fec 30be0000.ethernet eth0: Link is Up - 1Gbps/Full - flow control rx/tx [ 12.071502] IPv6: ADDRCONF(NETDEV_CHANGE): eth0: link becomes ready imx8mmevk login: root root@imx8mmevk:~#
Setting up Linux
Get the latest branch from NXP: linux-fslc. At this moment 5.19.x+fslc is the latest. The reason is that ADIN1100, the 10-BaseT1L PHY already is added here.
Add the ADIN1110 driver from torvalds git. You can also apply these two patches bellow: net-adin1110-5-19-add-support.zip
Compiling Linux
sudo apt-get install gcc-aarch64-linux-gnu export ARCH=arm64 export CROSS_COMPILE=/usr/bin/aarch64-linux-gnu- cp arch/arm64/configs/defconfig .config make menuconfig
Enable ADIN1100 and ADIN1110 from the make menuconfig.
make -j 8 Image modules dtbs sudo make modules_install INSTALL_MOD_PATH=/media/<user>/rootfs cp arch/arm64/boot/Image /media/<user>/boot/Image cp arch/arm64/boot/dts/freescale/imx8mm-evk.dtb /media/<user>/BOOT
You also need to add ADIN1110 to the device tree. You can add the following line at the end of arch/arm64/boot/dts/freescale/imx8mm-evk.dts.
&iomux {
pinctrl_ecspi2: ecspi2-grp {
fsl,pins = <
MX8MM_IOMUXC_ECSPI2_MISO_ECSPI2_MISO 0x00000116
MX8MM_IOMUXC_ECSPI2_MOSI_ECSPI2_MOSI 0x00000116
MX8MM_IOMUXC_ECSPI2_SCLK_ECSPI2_SCLK 0x00001916
MX8MM_IOMUXC_SAI5_RXD3_GPIO3_IO24 0x00000116
MX8MM_IOMUXC_SAI5_RXD1_GPIO3_IO22 0x00000116
>;
};
};
&ecspi2 {
pinctrl-names = "default";
pinctrl-0 = <&pinctrl_ecspi2>;
cs-gpios = <&gpio3 24 GPIO_ACTIVE_LOW>;
dmas = <0>;
dma-names = <0>;
status = "okay";
ethernet@0 {
compatible = "adi,adin1110";
/* SPI CS number */
reg = <0>;
/* will need 23 MHz for 10 Mbps, lower speeds will result in lower bandwidth */
spi-max-frequency = <10000000>;
/* optional, will check all control read/writes over SPI */
adi,spi-crc;
#address-cells = <1>;
#size-cells = <0>;
/* an IRQ is required, INT_N pin is configured to signal RX/TX frames */
interrupt-parent = <&gpio3>;
interrupts = <22 IRQ_TYPE_LEVEL_LOW>;
/* This is the host MAC address, by default ADIN1110 will also accept broadcast frames */
mac-address = [ CA 2F B7 10 23 63 ];
phy@0 {
compatible = "ethernet-phy-id0283.bc91";
phy-10base-t1l-2.4vpp = <1>;
reg = <0x0>;
};
};
};
Copy the modified DT on the boot partition of the SD Card:
cp arch/arm64/boot/dts/freescale/imx8mm-evk.dtb arch/arm64/boot/dts/freescale/imx8mm-evk.dtb
Testing
If everything worked fine when typing ip a you should see:
[alarm@alarm ~]$ ip a
1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000
link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
inet 127.0.0.1/8 scope host lo
valid_lft forever preferred_lft forever
inet6 ::1/128 scope host
valid_lft forever preferred_lft forever
2: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP group default qlen 1000
link/ether ca:2f:b7:10:23:63 brd ff:ff:ff:ff:ff:ff
inet6 fe80::c82f:b7ff:fe10:2363/64 scope link
valid_lft forever preferred_lft forever
3: eth1: <NO-CARRIER,BROADCAST,MULTICAST,UP> mtu 1500 qdisc mq state DOWN group default qlen 1000
link/ether 00:04:9f:05:fa:58 brd ff:ff:ff:ff:ff:ff
To figure out which one is the ADIN1110:
[alarm@alarm ~]$ cat /sys/class/net/eth0/device/modalias spi:adin1110
NVIDIA Jetson Nano
Wiring
| Jetson Nano | EVAL-ADIN1110EBZ |
|---|---|
| SPI0_MOSI (GPIO 16) (Pin 19) | T1L_MOSI |
| SPI0_MISO (GPIO 17) (Pin 21) | T1L_MISO |
| SPI0_CLK (GPIO 18) (Pin 23) | T1L_CLK |
| SPI0_CS0 (GPIO 19) (Pin 24) | T1L_CS_N |
| GPIO 13 (Pin 22) | T1L_INT_N |
Connect both grounds (AGND) (idealy) to the most accessible ground to you on the Jetson Nano. Also, avoid powering the EVAL-ADIN1110EBZ from the USB of Jetson Nano, driver won't probe correctly because on power-up (not reboot), power to the USB is given too late in boot stage. (Try powering from 5V pins or externally if possible).
Board settings
ADIN1110 needs to operate in Generic SPI mode (see Datasheet) and with CRC protection disabled. You may enable the CRC but that needs a change in the DT also. See adin1110.yaml.
In order to do this find S1 and set every switch to the following table:
| SWITCH | POSITION |
|---|---|
| SPI_CFG0 | ON |
| SPI_CFG1 | ON |
| SWPD_N | ON |
| TX2V4_DIS | OFF |
| MS_SEL | OFF |
Board settings
ADIN1110 needs to operate in Generic SPI mode (see Datasheet) and with CRC protection disabled. You may enable the CRC but that needs a change in the DT also. See adin1110.yaml.
Getting your Jetson Nano flashed with the SDK Manager
Here we are flashing the Jetson Nano P3448. In this case we have the production kit that boots from an eMMC and not the one with the SD Card reader.
Skip this step if you have already flashed the Jetson Nano and have the 4.9 Kernel installed. Go to Changing the Kernel and DT step.
Setup for NVIDIA Jetson Nano and ADIN1110 (8 Nov 2022)
Download and load the Docker version of SDK Manager from NVIDIA. Power NVIDIA Jetson Nano board in recovery mode. (By connecting pin 9 and 10). Connect the UART.
Launch the SDK Manager Docker:
sudo docker run -it --rm --privileged -v /dev/bus/usb:/dev/bus/usb/ -v /dev:/dev -v /media/$USER:/media/nvidia:slave --name JetPack_NX_Devkit --network host 77ae6063b39c \ --cli install --logintype devzone --product Jetson --version 4.6.2 --targetos Linux --host --target JETSON_NANO_TARGETS --flash all --additionalsdk 'DeepStream 6.0.1'
Where 77ae6063b39c is the id of the docker loaded previously.
Follow the instructions provided in the GUI of the SDK Manager.
At the end of this process you should now have an NVIDIA Jetson Nano flashed with the 4.9 Linux Kernel Version. Make sure you can access the board via ssh, you will need it later.
Changing the Kernel and DT
In order to build the 4.9 Kernel and DTs from NVIDIA you need to setup the environment.
1. Install the Linaro 7.3.1 2018.05 toolchain:
mkdir $HOME/linaro-2018-gcc cd $HOME/linaro-2018-gcc wget http://releases.linaro.org/components/toolchain/binaries/7.3-2018.05/aarch64-linux-gnu/gcc-linaro-7.3.1-2018.05-x86_64_aarch64-linux-gnu.tar.xz tar xf gcc-linaro-7.3.1-2018.05-x86_64_aarch64-linux-gnu.tar.xz
2. Download the public NVIDIA Jetson Nano sources:
wget https://developer.download.nvidia.com/embedded/L4T/r32-3-1_Release_v1.0/Sources/T210/public_sources.tbz2 tar -xvf public_sources.tbz2 cd Linux_for_Tegra/source/public NVIDIA_JETSON_NANO_KERNEL=$(pwd) tar -xf kernel_src.tbz2
After following the guide above, you should have the following directories:
user$ ~/Linux_for_Tegra/source/public ls -la | grep -ie drwx drwxr-xr-x 7 <user> <user> 4096 nov 18 19:23 . drwxr-xr-x 4 <user> <user> 4096 nov 16 13:28 .. drwxrwxr-x 3 <user> <user> 4096 nov 15 21:06 hardware drwxrwxr-x 5 <user> <user> 4096 nov 18 19:23 kernel
By default the 4.9 Kernel does not have the ADIN1100 driver nor the ADIN1110. You will need to download the kernel sources, add the adin1100/adin1110 drivers.
Extract this archive 4.9.253-adin1110_tegra_files.zip and copy the contents of adi_tegra_files in Linux_for_Tegra/source/public path. This archive contains:
| File | Description |
|---|---|
| kernel/kernel-4.9/driver/drivers/net/phy/Kconfig | Linux 4.9 PHY Kconfig with the necessary adjustments |
| kernel/kernel-4.9/driver/drivers/net/phy/Makefile | Linux 4.9 PHY Makefile with the necessary adjustments |
| kernel/kernel-4.9/driver/drivers/net/phy/adin1100.c | Linux 4.9 adin1100 PHY |
| kernel/kernel-4.9/driver/drivers/net/ethernet/adi/adin1110.c | Linux 4.9 adin1110/2111 MAC/SWITCH |
| kernel/kernel-4.9/driver/drivers/net/ethernet/Makefile | Linux 4.9 adin1110/2111 MAC/SWITCH Makefile |
| kernel/kernel-4.9/driver/drivers/net/ethernet/Kconfig | Linux 4.9 adin1110/2111 MAC/SWITCH Kconfig |
| kernel/kernel-4.9/driver/drivers/net/ethernet/Makefile | Linux 4.9 ethernet Makefile with the necessary adjustments |
| kernel/kernel-4.9/driver/drivers/net/ethernet/Kconfig | Linux 4.9 ethernet Kconfig with the necessary adjustments |
| kernel/kernel-4.9/arch/arm64/configs/adi_tegra_defconfig | A modified tegra_defconfig with PHY + MAC + SWITCHDEV enabled |
| kernel/kernel-4.9/scripts/Kbuild.include | Original Kbuild.include with a small bugfix see here details |
| kernel/kernel-4.9/include/uapi/linux/types.h | Original types.h with a compile error fixed. |
| hardware/nvidia/platform/t210/porg/kernel-dts/tegra-jetson-nano-adin1110.dtsi | ADIN1110 dtsi connected to Jetson Nano DT |
| hardware/nvidia/platform/t210/porg/kernel-dts/tegra-jetson-nano-adin2111.dtsi | ADIN2111 dtsi connected to Jetson Nano DT |
| hardware/nvidia/platform/t210/porg/kernel-dts/tegra210-p3448-0002-p3449-0000-b00-adin1110.dts | dts for ADIN1110 with the rest of includes |
| hardware/nvidia/platform/t210/porg/kernel-dts/tegra210-p3448-0002-p3449-0000-b00-adin2111.dts | dts for ADIN2111 with the rest of includes |
| hardware/nvidia/platform/t210/porg/kernel-dts/Makefile | Original Makefile with added compile directives |
On ADI repo there is a branch with both ADIN1100 and ADIN1110 backported. See last two commits.
Building the Kernel and DT
Run the commands bellow in order to build the kernel and the dtbs. No need to also build/install the modules at this point.
NVIDIA_JETSON_NANO_KERNEL=$(pwd)
LINARO_TOOLCHAIN=$HOME/linaro-2018-gcc/gcc-linaro-7.3.1-2018.05-x86_64_aarch64-linux-gnu/bin/aarch64-linux-gnu-
TEGRA_KERNEL_OUT=$NVIDIA_JETSON_NANO_KERNEL/build
make -C kernel/kernel-4.9/ ARCH=arm64 O=$TEGRA_KERNEL_OUT LOCALVERSION=-tegra CROSS_COMPILE=${LINARO_TOOLCHAIN} adi_tegra_defconfig
make -C kernel/kernel-4.9/ ARCH=arm64 O=$TEGRA_KERNEL_OUT LOCALVERSION=-tegra CROSS_COMPILE=${LINARO_TOOLCHAIN} -j 8 --output-sync=target Image
make -C kernel/kernel-4.9/ ARCH=arm64 O=$TEGRA_KERNEL_OUT LOCALVERSION=-tegra CROSS_COMPILE=${LINARO_TOOLCHAIN} -j 8 --output-sync=target dtbs
After running the commands above you should have the following resources:
./build/arch/arm64/boot/dts/tegra210-p3448-0002-p3449-0000-b00-adin2111.dtb ./build/arch/arm64/boot/dts/tegra210-p3448-0002-p3449-0000-b00-adin1110.dtb ./build/arch/arm64/boot/Image
If using a make newer than 4.3, there is a BUG, workaround is to:
To make it working you must edit the file: scripts/Kbuild.include
Then change lines:
the-space := the-space +=
To:
E = the-space = $E $E
Installing the Kernel and DT
Copy the binaries to the board:
scp build/arch/arm64/boot/Image <user>@<jetson-nano-ip>:. scp ./build/arch/arm64/boot/dts/tegra210-p3448-0002-p3449-0000-b00-adin1110.dtb <user>@<jetson-nano-ip>:.
Login on the board and copy these files to the /boot folder. Boot partion should be mounted there:
analog@analog-desktop:~$ sudo cp Image /boot/ analog@analog-desktop:~$ sudo cp tegra210-p3448-0002-p3449-0000-b00-adin1110.dtb /boot/
Make extlinux.conf point to the newly added dt:
analog@analog-desktop:~$ cat /boot/extlinux/extlinux.conf
TIMEOUT 30
DEFAULT primary
MENU TITLE L4T boot options
LABEL primary
MENU LABEL primary kernel
LINUX /boot/Image
FDT /boot/tegra210-p3448-0002-p3449-0000-b00-adin1110.dtb
INITRD /boot/initrd
APPEND ${cbootargs} quiet root=/dev/mmcblk0p1 rw rootwait rootfstype=ext4 console=ttyS0,115200n8 console=tty0 fbcon=map:0 net.ifnames=0 sdhci_tegra.en_boot_part_access=1
Reboot the Jetson Nano.
Testing
If everything worked out fine, you should be able to see after typing ip a or ifconfig:
analog@analog-desktop:~$ ip a
1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1
link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00
inet 127.0.0.1/8 scope host lo
valid_lft forever preferred_lft forever
inet6 ::1/128 scope host
valid_lft forever preferred_lft forever
2: dummy0: <BROADCAST,NOARP> mtu 1500 qdisc noop state DOWN group default qlen 1000
link/ether 26:e1:6f:ab:e2:87 brd ff:ff:ff:ff:ff:ff
3: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP group default qlen 1000
link/ether ca:2f:b7:10:23:63 brd ff:ff:ff:ff:ff:ff
inet6 fe80::af3b:584c:73b7:6c4c/64 scope link noprefixroute
valid_lft forever preferred_lft forever
4: eth1: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc pfifo_fast state UP group default qlen 1000
link/ether 00:04:4b:ea:59:ee brd ff:ff:ff:ff:ff:ff
inet 10.48.65.145/24 brd 10.48.65.255 scope global dynamic noprefixroute eth1
valid_lft 21053sec preferred_lft 21053sec
inet6 fe80::509a:e324:c836:2fa2/64 scope link noprefixroute
valid_lft forever preferred_lft forever
5: l4tbr0: <BROADCAST,MULTICAST> mtu 1500 qdisc noop state DOWN group default qlen 1000
link/ether f2:79:c1:47:c6:11 brd ff:ff:ff:ff:ff:ff
6: rndis0: <NO-CARRIER,BROADCAST,MULTICAST,UP> mtu 1500 qdisc pfifo_fast master l4tbr0 state DOWN group default qlen 1000
link/ether f2:79:c1:47:c6:11 brd ff:ff:ff:ff:ff:ff
7: usb0: <NO-CARRIER,BROADCAST,MULTICAST,UP> mtu 1500 qdisc pfifo_fast master l4tbr0 state DOWN group default qlen 1000
link/ether f2:79:c1:47:c6:13 brd ff:ff:ff:ff:ff:ff
Check if the port belongs to ADIN1110 with:
analog@analog-desktop:~$ cat /sys/class/net/eth0/device/modalias spi:adin1110
More Info
Ask a question: Engineer Zone Linux .
Details about the ADIN1100 Linux Driver .
Details about the ADIN1110 Linux Driver .
resources/quick-start/adin1110_linux_quick_start_guide.1670219599.txt.gz · Last modified: 05 Dec 2022 06:53 by Alexandru Tachici