Chipsee IMX6UL User manual

Debian 8.10
Chipsee IMX6UL Debian8.10 User Manual
Revision Date Author Description
1.0 2018-4-14 Madi Initial
Supported Board
CS10600U070-V1.0
Supported Prebuilt Images
prebuilt-xxxx-20180410.tar.gz and later
Table of contents
1 Prepare
1.1. Hardware
1.2. Software

2 Debug
2.1. Serial Debug
2.2. SSH Debug
2.3. VNC Debug
3 Downloading images
3.1. Booting switch configuration
3.2. Prebuilt file package
3.3. Downloading images with TF Card
4 System Resource
4.1. TF Card/USB
4.2. Network
4.2.1. Wired Ethernet
4.3. Sound
4.4. Serial Port
4.5. CAN
4.6. GPIO
4.7. Buzzer
5 Development
5.1. Set Environment
5.2. Prepare Packages Source
5.3. Build & Run
System Features
Feature Comment
Kernel Kernel version: 3.14.52
Bootloader Uboot 2015.04
System Debian8.10
Python Python version: 2.7.9
Qt Need install
Desktop lxde
user/password [root/root] or [chipsee/chipsee]
1. Prepare

1.1. Hardware
• Chipsee Industrial Embedded Computer
• 6V ~ 36V Power Adapter (7”) / 15V ~ 36V Power Adapter(10” and other bigger
size)
• USB to serial cable or other serial debug cable
• TF Card( at least 4GB)
You need to prepare the Power Adapter by yourself. 7” products need a 6V ~
36V Power Adapter, 10” and other bigger size products need a 15V ~ 36V Power
Adapter. USB to serial cable is used to debug the Chipsee Industrial Embedded
Computer. The TF card is used to make bootable card and reflash the system.
1.2. Software
• Prebuilt Images Package
• Xshell or other terminal emulation software
• Cross-toolchain
• VNC-Viewer
You can use the Prebuilt Images Package to reflash the system. You can find
it in DVD/Debian8.10/Prebuilts directory. You can use Xshell to debug Chipsee
Industrial Embedded Computer in Windows. You can use VNC-Viewer to remote
control Chipsee Industrial Embedded over Ethernet. The cross-toolchain can
compile program for Chipsee Embedded Computer.
2. Debug
This document uses Xshell to debug Chipsee Industrial Embedded Computer, you
also can use other tools, like SecureCRT and Minicom.

2.1. Serial Debug
You can reference CAN+RS485+RS232 Connector in Chipsee_UxEC-Manual – V1.0.pdf
（such as 7” Chipsee_U7EC-Manual – V1.0.pdf）to understand the serial ports of
the computer, the debug serial port of Chipsee Industrial Embedded Computer
is the first RS232 port, you need to use RS232_1_TXD,RS232_1_RXD,GND.
Please reference How_To_Connect_Board_By_Serial.pdf to connect your PC and
Chipsee Industrial Embedded Computer over Serial cable. Setting the Xshell
like figure 2-1 and figure 2-2.
Figure 2-1 Add Session

Figure 2-2 Session Properties
Figure 2-3 Serial Debug

2.2. SSH Debug
Connect the Chipsee Industrial Embedded Computer to the Internet, get the ip
address. Then config Xshell or use ssh tool in Linux PC directly.
We will introduce Xshell ssh debug. First we need to add one new session,
like in figure 2-1. Second, we need to set the session like in figure 2-4.
Figure 2-4 SSH Setting

Figure 2-5 SSH Debug
2.3. VNC Debug
You can use VNC-Viewer in Windows to control the Chipsee Industrial Embedded
Computer over Ethernet.
• Use xShell Serial or SSH connect to Chipsee Industrial Embedded Computer,
login by chipsee. Use the following command. Note: user/password is
chipsee/chipsee
$ x11vnc -storepasswd
- -set password for VNC-Viewer access--
$x11vnc -display :0 -forever -bg -rfbauth /home/chipsee/.vnc/passwd -rfbport
5900 -o /home/chipsee/.vnc/x11vnc.log
• Use VNC-Viewer in Windows to control it over Ethernet. Like figure 2-6,
2-7, 2-8.

Figure 2-6 Vnc-Viewer Connect
Figure 2-7 authentications

Figure 2-8 VNC Desktop
3. Downloading images
3.1. Booting switch configuration
Chipsee Industrial Embedded Computer supports the SD boot and eMMC boot, like
in Figure 3-1. If you want to flash the system, you can use the TF Card.

Figure 3-1 Boot Mode
3.2. Prebuilt file package
You can get the prebuilt file package from DVD/Debian8.10/Prebuilts. Like
prebuilt-cs10600u070v1-debian-emmc-20180410.tar.gz, the package has the
following contents. Like in table 3-1.
Table 3-1 Prebuilt file package
Contents Comment
boot/imx6ulipc.dtb TF Card boot dtb file
boot/u-boot.imx TF Card boot bootloader
boot/zImage TF Card boot kernel file
filesystem/rootfs-emmc-flasher.tar.bz2 TF Card boot rootfs
mksdcard.sh Shell tools to make bootable TF Card
README Simple Guide
S1.jpg Boot Switch Config Figure
emmc-flash/emmc/rootfs.tar.gz rootfs in target emmc
emmc-flash/emmc/u-boot.imx bootloader in target emmc
emmc-flash/emmc/zImage kernel file in target emmc
emmc-flash/emmc/imx6ul-eisd.dtb dtb file in target emmc
emmc-flash/mkemmc.sh shell tools to download images
Note：The default zImage and imx6q-sabresd.dtb support keep the logo from
uboot to kernel which doesn’t support framebuffer. We also provide

zImage_framebuffer and imx6q-eisd.dtb_framebuffer which support Framebuffer
function, but it doesn’t support keep logo from uboot to kernel feature. If
you need it, just rename them to zImage and imx6q-eisd.dtb.
3.3. Downloading images with TF Card
The prebuilt file package has one shell tool to help you to make one bootable
TF Card in Linux Platform (Like Real PC or Virtual Machine with Ubuntu14.04).
Then use the TF Card to download images. It’s one another quick and easy way
to download images.
• Copy the prebuilt file to linux environment, like ubuntu1404.
• Insert the TF card in ubuntu1404, check the device node, such as /dev/sdc.
Or like /dev/sdb, please be carefully to confirm it.
• Untar prebuilt package. Do the following command.
$ sudo ./mksdcard.sh --device /dev/sdc
• Now you get one bootable TF card, insert it in the Chipsee board, change
the switch S1 to SD boot mode, you can reference 3.1 Booting switch
configuration.
• Power on, when you see the following message, it indicates that you have
downloaded the image in emmc.
>>>>>>> eMMC Flashing Completed <<<<<<<
• Power off and switch S1 to eMMC boot mode, you can reference 3.1 Booting
switch configuration.
4. System Resource
4.1. TF Card/USB
The TF card USB storage supports hot plug. They will be automatically mounted
on /media/chipsee/, like in figure 4-1. The TF card and USB support the NTFS

and Fat32 format.
Figure 4-1 TF Card
4.2. Network
This system uses the Wicd Network Manager to control Ethernet.
4.2.1. Wired Ethernet
You can get the IP address from DHCP, you also can set static IP. After you
set the static IP, please reboot to enable it. Like figure 4-2 and figure
4-3:

Figure 4-2 Ethernet
Figure 4-3 Ethernet Static IP
4.3. Sound

• You can use the following command to record sound. The -d parameter
indicate interrupt after # seconds, follow is 18 seconds
$ arecord -N -M -r 44100 -f S16_LE -c 2 -d 18 test.wav
• You can use the following command to playback the recorded sound above.
$ aplay -N -M test.wav
4.4. Serial Port
There are 5 serial ports, 2 RS232, and 3 RS485. The default hardware config
is 2 RS232 and 3 RS485. For the device node in system, please reference the
table 4-1:
Table 4-1 serial port device node
Ports Device Node
RS232_1 /dev/ttymxc0
RS232_2 /dev/ttymxc1
RS485_3 /dev/ttymxc2
RS485_4 /dev/ttymxc3
RS485_5 /dev/ttymxc4
You can install “cutecom” to test the serial port:
$ sudo apt-get install cutecom
Only root user and use the serial port:
$ sudo cutecom
NOTE: All RS485 signals don’t mount on the 120Ohm Matched Resistance.
4.6. CAN
There are two-channel CAN buses, the system has integrated the can units. You
can use them to test CAN, you also can use the HT application to test them.

But you must add one 120ohm resistor between CAN_H and CAN_L on one of the
two Boards. Like figure 4-4:
NOTE: All CAN signals don’t mount on the 120Ohm Matched Resistance.
Figure 4-4 CAN connect
Here is an example with which to test CAN by using can units.
• Set the bit-rate to 50Kbits/sec with triple sampling using the following
command (use ROOT user)
# ip link set can0 type can bitrate 50000 triple-sampling on
• Bring up the device using the command
# ip link set can0 up
• Transfer packets
a. Transmit 8 bytes with standard packet id number as 0x10
# cansend can0 010#1122334455667788
b. Transmit 8 bytes with extended packet id number as 0x800
# cansend can0 800#1122334455667788
• Bring down the device
# ip link set can0 down
• Receive packets
#candump can0

4.6. GPIO
There are 8 GPIOs, check the GPIO chapter in Chipsee_U7EC-Manual – V1.0.pdf
to know the detail port define. You also can check the following table 4-2
Table 4-2 CS10600F070 – V1.0 P23 Port
Pin Number Definition
1 VDD_24v
2 GND_ISO
3 /dev/chipsee-gpio1(out)
4 /dev/chipsee-gpio2(out)
5 /dev/chipsee-gpio3(out)
6 /dev/chipsee-gpio4(out)
7 /dev/chipsee-gpio5(in)
8 /dev/chipsee-gpio6(in)
9 /dev/chipsee-gpio7(in)
10 /dev/chipsee-gpio8(in)
Use following command to test GPIO easily
• Set GPIO1 high
# echo 1 > /dev/chipsee-gpio1
• Set GPIO2 low
# echo 0 > /dev/chipsee-gpio2
• Check GPIO5 vlue
# cat /dev/chipsee-gpio5
4.7. Buzzer
Control the buzzer with the following command easily:
• Enable the buzzer
# echo 1 >/dev/buzzer

• Disable the buzzer
# echo 0 >/dev/buzzer
5. Development
In this chapter, you can learn how to set up QT development environment, and
develop the first QT application on CS10600U070-v1.0.
5.1. Set Environment
There is no Qt environment and build environment in this system. If you want
to build and run Qt applications, you need install Qt environment and build
environment first. Is as follow:
$ sudo apt-get update
$ sudo apt-get install build-essential git libudev-dev
$ sudo apt-get install qt5-default // or qt4-default if you want to use qt4
$ sudo apt-get clean
5.2. Prepare Packages Source
There are some QT packages source demo in DVD/Debian8.10/QT/, use ssh to put
them to Chipsee Board.
5.3. Build & Run

We chose hardwaretest_serial_ok_20170223.tar.gz to demonstrate. This demo
needs an installed qtserialport support first. Is as follow:
$ cd ~
$ git clone git://code.qt.io/qt/qtserialport.git
$ cd qtserialport
$ git checkout 5.3 // for qt4 is “git checkout qt4-dev”
$ cd ../
$ mkdir qtserialport-build
$ cd qtserialport-build
$ qmake ../ qtserialport/ qtserialport.pro
$ make
$ sudo make install
Use SSH or USB Storage to put hardwaretest_serial_ok_20170223.tar.gz to
Chipsee Board. Now we are in Chipsee Board Debian system console:
Use the following command to build the Qt application:
$ tar zxvf hardwaretest_serial_ok_20170223.tar.gz
$ cd hardwaretest_serial
$ qmake
$ make
Modify the permission of serial ports device node
$ sudo chmod 666 /dev/ttymxc*
Run the hardwaretest_serial:
$ cd hardwaretest_serial
$ export DISPLAY=:0
$ ./hardwaretest_serial