Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The guide will give a technical overview about the product and by the end of it you should be able to boot an operating system and begin testing your application.

Revision and Notes

 

Hardware Setup

Product Specifications

 

ClearFog LX2162A

I/Os

1 x USB 2.0

1 x USB 3.0 (RunBMC)

Networking

2 x SFP28 ports (25GbE each)
2 x SFP+ ports (10GbE each)
8 x 1GbE copper (RJ45)

Processor

NXP Layerscape LX2162A 16-core Arm Cortex A72 up to 2GHz

Memory & Storage

Up to 32GB DDR4
8GB eMMC
MicroSD

Misc.

USB to STM32 for remote management
RunBMC compliant socket

Development and Debug interfaces

mini USB
JTAG

Power

12V DC Jack
ATX standard

Expansion card I/Os

*2 x mPCIe x1 Gen 3.0

Temperature

Commercial: 0°C to 70°C

Dimensions

PCBA: 170 x 137mm

  

Block Diagram

The following figure describes the ClearFog LX2162A Block Diagram.

...

Before powering up the board for the first time it is recommended to select the boot media. In order to configure the boot media, please refer to the following DIP switch:

Boot media

Switch 1

Switch 2

Switch 3

Switch 4

Switch 5

SD

OFF

ON

ON

ON

X

eMMC

OFF

ON

ON

OFF

X

SPI

OFF

OFF

OFF

OFF

X

The following shows how to set the switches on the boot source selector:

...

The switches on the boot source SW1 selector must be set as follows:

Switch 1

Switch 2

Switch 3

Switch 4

Switch 5

OFF

ON

ON

ON

X

The following shows how to set the switches on the boot source selector:

...

Download a pre-built snapshot image from SolidRun Images

Those images are built with the suffix of the board name, SerDes protocol organised by branch, build date and commit ID of the from GitHub - SolidRun/lx2160a_build  project that you can clone and build by yourself. for example - https://images.solid-run.com/LX2k/lx2160a_build/lx2160acex7_2000_700_3200_LX2162A_CLEARFOGImages filenames are generated with boot media, serdes protocol, module and board names.

For example - ls-5.15.71-2.2.0/2024-11-01_c61a32e/lx2162a_rev2_som_clearfog_2000_650_2900_18_9_0-850cda0c61a32e.img.xz - generate from commit c61a32e on November 1. 2024 targets LX2162A SoM on Clearfog with SFP connectors at 25/10Gbps and 8x Ethernet at 1Gbps each, built from commit 850cda0Board with SerDes protocols 18 and 9 (SFPs at 10/25Gbps, RJ45 at 1Gbps).

You can build your own image using the script in here – GitHub - SolidRun/lx2160a_build

...

Use the following commands for writing the image to an SD card:

Code Block
xz -dc lx2160acex7_2000_700lx2160a_....img.xz | dd of=/dev/sdX bs=4M conv=fdatasyncfsync

Note: Plug a micro SD into your Linux PC, the following assumes that the micro SD is added as /dev/sdX and all it’s partitions are unmounted.

  1. SD card insertion
    Please Insert the SD card into your device.

  2. Serial Connection
    Please insert the miniUSB into your device, then you can refer to Serial Connection for installing necessary serial connection software in Linux/Windows.

  3. Power connection
    Connect your DC power , and then connect the adaptor to mains supply.

...

Code Block
languagetext
load mmc 0:1 0xa4000000 ubuntu-core.img
mmc dev 1
mmc write 0xa4000000 0 0xd2000

...

Note

Please Note:

The above commands should be run only once (in the fist boot).

...

  1. Run fdisk /dev/mmcblk0 if using SD, or run if using fdisk /dev/mmcblk1 eMMC.

  2. Recreate the first partition by deleting it and then creating a new partition that starts at block 131072 and extends to the end of the drive (or less depending on your needs).

  3. Write the new partition, when prompt about ‘Do you want to remove the signature?’ then answer with No.

  4. Run resize2fs /dev/mmcblk0p1 if using SD Card, or Run resize2fs /dev/mmcblk1p1 if using eMMC.

  5. In this stage the root partition should be big enough to start populating it; but first update the RTC clock.

  6. Activate Network Interfaces
    The native NICs of the SoC currently need to be explicitly enabled after boot, by instantiating a Linux network interface for each desired physical mac. Please are enabled automatically at boot time. Their numbering follows the numerical order of dpmac (LX2160 native NICs) starting from 0 , please find a mapping of the mac numbers to physical connectors in the picture below.

    For example to enable the RJ45 bottom port at the end of the PCB , execute

    Code Block
    ls-addni dpmac.18

    The kernel will then create an eth? device automatically. The first interface is called eth0, successive ones receive incremental numbers. Please also refer to the output of dmesg command to find kernel messages about the interfaces that have been created.(dpmac8) is eth11.

  7. Connect the RJ45 to your network with internet access (and DHCP server); and then run dhclient .

  8. Update the RTC clock by running ntpdate pool.ntp.org and then hwclock -w.

  9. Run apt-update and then populate the root filesystem as you wish.

...

For some SFP modules that work on SolidRun networking hardware platforms, please refer to SFP Modules .

Packet Generator using DPDK

...

  1. Make sure that the kernel is booted with the following variables in the command line –

    Code Block
    default_hugepagesz=1024m hugepagesz=1024m hugepages=2 isolcpus=1-15 iommu.passthrough=1

    If using the above installation of Ubuntu then the /extlinux/extlinux.conf file should look as follows (the default installation with the addition of isolcpus=1-15 iommu.passthrough=1) –

    Code Block
      TIMEOUT 30
      DEFAULT linux
      MENU TITLE linux-lx2160a boot options
      LABEL primary
      MENU LABEL primary kernel
      LINUX /boot/Image
        FDT /boot/fsl-lx2160a-cex7.dtb
        APPEND console=ttyAMA0,115200 earlycon=pl011,mmio32,0x21c0000 default_hugepagesz=1024m hugepagesz=1024m hugepages=2 isolcpus=1-15 iommu.passthrough=1 pci=pcie_bus_perf root=PARTUUID=30303030-01 rw rootwait
    
  2. From build/dpdk directory under the lx2160a_build project, search for dynamic_dpl.sh and testpmd files and copy them over to the LX2160A Ubuntu root filesystem

  3. After boot unbind the linux network interfaces (ethX)

  4. Run the following that will generate 10Gbps traffic on dpmac.10 using only a single core. Can be used to generate traffic on dpmac.1 and other interfaces –

...

Tip
  • Download a pre-built snapshot image based on Ubuntu 20.04 from here SolidRun Images

Documentation

 

File

Modified

Schematics and Board Layout Rev 1.1

Rev 1.1 files here

December 2022

Mechanical files Rev 1.1

Rev 1.1 files here

December 2022

...