devs-cpsw-j742s2.so

Driver for Texas Instruments Common Platform Ethernet Switch (CPSW) J7/AM62 devices

Syntax:

io-sock -m fdt -m phy -m phy_fdt -d cpsw-j742s2 [option[,option...]]

mount -T io-sock [-o option[,option...]] fdt
mount -T io-sock [-o option[,option...]] phy
mount -T io-sock [-o option[,option...]] phy_fdt
mount -T io-sock [-o option[,option...]] cpsw-j742s2

Runs on:

QNX OS

Options:

Use commas, not spaces, to separate the options.
prefix=prefix
Specifies the instance of io-sock that mounts this driver. You specify the prefix that creates an alternative stack when you start io-sock. Used only when you load a driver with mount after starting io-sock.
qnxdev=device
When Plug & Play is disabled, specifies the device instance to use. Use devinfo -v to determine the location value to use (e.g., qnxdev=ofwbus1:0x46000000).

Description:

For devs-cpsw-j742s2.so drivers, the suffix j742s2 indicates the Texas Instruments (TI) Processor SDK that was used at compilation time. For example, the devs-cpsw-j742s2.so driver is compiled against the header files from the J742S2 Processor SDK.

These drivers require the mods-fdt.so driver and don't include a PHY driver. If they need a PHY driver, they rely on io-sock's miibus framework to find it. PHY drivers are provided in mods-phy.so or mods-phy_fdt.so. In some cases, a custom PHY driver may be required.

For information on starting io-sock with a driver or loading a driver later using mount, see Starting io-sock and Driver Management in the High-Performance Networking Stack User's Guide. You cannot load devs-cpsw-j742s2.so driver using a configuration file or by using loader.config.

Devices

Support for CPSW2G_MAIN, CPSW2G_MCU devices is enabled by default. Devices can be disabled in the io-sock configuration file using tunables. For example, the following entries disable all devices except for CPSW2G_MCU:

hw.cpsw.cpsw2g_main="0"
hw.cpsw.cpsw3g="0"

The devs-cpsw-j742s2.so drivers create a device hierarchy. A cpswss device is created for each cpsw controller, and a cpsw device is created for each port.

Hardware statistics

You can use sysctl to display the hardware statistics. For example:

sysctl dev.cpswss.0.stats

The statistics are displayed using the CPSW device ALE port index. By default, many statistics are not shown. To see additional statistics, in the io-sock configuration file, set the hw.cpsw.stats tunable to 1.

Port settings and configuration

Use sysctl to examine the settings when the device is attached. For example:

sysctl dev.cpswss.0.ports

By default, all ports are configured as MAC-only ports. To change the port configuration use the io-sock configuration file. For example:

dev.cpswss.0.ports.1.mode="switch"
dev.cpswss.0.ports.2.mode="switch"
dev.cpswss.0.ports.3.mode="switch"
dev.cpswss.0.ports.4.mode="maconly"

Required libraries

In addition to the libfdt.so required by FDT network drivers, the devs-cpsw-j742s2.so drivers require the following TI libraries:

  • libti-pdk.so
  • libti-sciclient.so
  • libti-udmalld.so
  • libtiudma-usr.so

This driver also requires that the following resource managers, that are provided by the TI PSDK, be running:

  • tisci-mgr
  • tiudma-mgr
Page updated: