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
