This article provides how to allow the USB2.0/USB3.0 device controller act as a serial port device on SP7350 platforms.

Table of Contents

Kernel Setup

Enter the kernel configuration by running the following command in the top directory of project.

# make kconfig

1. Select submenus for USB 2.0 controller : Device Drivers > USB support > USB Gadget Support > USB Peripheral Controller. Select <*> for “Sunplus USB 2.0 Device Controller“.

2. Select submenus for USB 3.0 controller : Device Drivers > USB support. Select <*> for “DesignWare USB3 DRD Core Support“ and select “Dual Role mode“ for “Deware USB3 DRD Core Support“.

3. Select submenus for USB Gadget configfs : Device Drivers > USB support > USB Gadget Support. Select <M> for “USB Gadget functions configurable through configfs“. Select [*] for “Generic serial bulk in/out”, “Abstract Control Model (CDC ACM)“ or “Object Exchange Model (CDC OBEX)“.

4. Execute the make command to build the Linux image.

ConfigFS (CDC ACM)

Configure serial gadget through configfs saved as a file named setup_serial.

#!/bin/sh

KERNEL_PATH=/lib/modules/`uname -r`/kernel
GADGET_PATH=$KERNEL_PATH/drivers/usb/gadget
FUNCTION_PATH=$GADGET_PATH/function

COMPOSITE=$GADGET_PATH/libcomposite.ko
U_SERIAL=$FUNCTION_PATH/u_serial.ko

insmod $COMPOSITE
insmod $U_SERIAL

# disable debug message
echo 0 > /sys/module/sunplus_udc/parameters/dmsg

mkdir -p /sys/kernel/config
mount -t configfs none /sys/kernel/config

# USB2.0 configurations
cd /sys/kernel/config/usb_gadget

# create gadget folder
mkdir g1
cd g1

# setup gadget 1
echo 64 > bMaxPacketSize0
echo 0x200 > bcdUSB

# composite class
echo 0x02 > bDeviceClass

mkdir -p configs/c.1
mkdir -p configs/c.1/strings/0x409
echo "USB2.0 Serial Console" > configs/c.1/strings/0x409/configuration

mkdir strings/0x409
echo "1234" > strings/0x409/serialnumber
echo "Sunplus" > strings/0x409/manufacturer
echo "SP7350" > strings/0x409/product

mkdir functions/acm.gs0
ln -s functions/acm.gs0 configs/c.1

# bind UDC
echo "f8102800.usb" > UDC

# USB3.0 configurations
cd /sys/kernel/config/usb_gadget

# create gadget folder
mkdir g2
cd g2

# setup gadget 2
echo 64 > bMaxPacketSize0
echo 0x300 > bcdUSB

# composite class
echo 0x02 > bDeviceClass

mkdir -p configs/c.1
mkdir -p configs/c.1/strings/0x409
echo "USB3.0 Serial Console" > configs/c.1/strings/0x409/configuration

mkdir strings/0x409
echo "5678" > strings/0x409/serialnumber
echo "Sunplus" > strings/0x409/manufacturer
echo "SP7350" > strings/0x409/product

mkdir functions/acm.gs1
ln -s functions/acm.gs1 configs/c.1

# bind UDC
echo "f80a1000.dwc3" > UDC

Test (CDC ACM) Configuartions

Use sh setup_serial command to configure USB 2.0 and USB3.0 device controllers as serial gadgets.

# sh setup_serial

ttyGS0 and ttyGS1 in /dev are represented for USB2.0 serial gadget and USB3.0 one.

In Device Manager of Windows PC, “USB Serial Device (COM17)“ (USB2.0 serial gadget) and “USB Serial Device (COM18)“ (USB3.0 serial gadget) will show up in “Ports (COM & LPT)”.

Serial Device Test

Use the communication tool of Putty for the test with a Windows PC.

TX Test for USB2.0 Serial Gadget

1. Use the following command to transfer characters of “SP7350 USB2.0 Serial Gadget TX Test“ to COM17 through ttyGS0 (USB2.0 serial gadget).

# echo "SP7350 USB2.0 Serial Gadget TX Test" > /dev/ttyGS0

2. The characters will be received by COM17 open in Putty.

TX Test for USB3.0 Serial Gadget

1. Use the following command to transfer characters of “SP7350 USB3.0 Serial Gadget TX Test“ to COM18 through ttyGS1 (USB3.0 serial gadget).

# echo "SP7350 USB3.0 Serial Gadget TX Test" > /dev/ttyGS1

2. The characters will be received by COM18 open in Putty.

RX Test for USB2.0 Serial Gadget

1. Use the following command to receive characters transferred from COM17 through ttyGS0 (USB2.0 serial gadget).

# cat /dev/ttyGS0

2. Input the characters of “SP7350 USB2.0 Serial Gadget RX Test" in Putty with COM17 and press “Enter”. The characters will be received by COM4 (console) open in Putty.

RX Test for USB3.0 Serial Gadget

1. Use the following command to receive characters transferred from COM18 through ttyGS1 (USB3.0 serial gadget).

# cat /dev/ttyGS1

2. Input the characters of “SP7350 USB3.0 Serial Gadget RX Test" in Putty with COM18 and press “Enter”. The characters will be received by COM4 (console) open in Putty.