1. Home
  2. Docs
  3. OS Manuals
  4. Cortex-A8
  5. Debian


Chipsee Embedded Industrial Computer

Debian User Manual


This manual providea users with a fast guide of Chipsee Embedded Industrial Computer about Debian OS development. Through this manual, users can quickly understand the hardware resources; users can debug Debian OS via serial and Internet.

1. Chipsee Embedded Industrial Computer

Development Kit

(1)Chipsee Embedded Industrial Computer
(2)12V power adapter
(3)Micro SD card and card reader
(4)Common serial cable or USB to serial cable

(1)Chipsee Debian prebuilt file(to make a bootable SD card)

2. Getting started and basic tests

Notes: Using the prebuilt file we provided in the CD to test the hardware.

2.1. How to make a bootable SD card

1、Insert the SD card into your computer, if using virtual machines, please make sure the SD card mounted to the Ubuntu (or other Linux) operating system.
2、Confirm the SD card mount point, “/dev/sdX”, usually it should be “/dev/sdb”. You can use this command to find out what the “X” is in the Linux system.

$ sudo fdisk –l

3、Copy the file “prebuilt-som-v3-csrrrrrtss-v3-debian-sd-yyyymmdd.tar.gz” somewhere(such as $HOME).
4、Extract the file “prebuilt-som-v3-csrrrrrtss-v3-debian-sd-yyyymmdd.tar.gz”

$ tar zxfv prebuilt-som-v3-csrrrrrtss-v3-debian-sd-yyyymmdd.tar.gz

5、Go to the folder “prebuilt-som-v3-csrrrrrtxx-v3-debian-sd-yyyymmdd”

$ cd ~/ prebuilt-som-v3-csrrrrrtss-v3-debian-sd-yyyymmdd

6、Flash Debian OS to uSD card

$ sudo ./mksdcard.sh --device /dev/sd<?>

sd<?> means the uSD card in your Linux(such Ubuntu OS). “rrrrr” means the resolution of your device, such as 10600, it’s 1024×600, “t” means the TI CPU, “ss” means the size, such as 70, it’s 7 inch, yyyymmdd means the date.

NOTE: If you want to flash to eMMC, just use “prebuilt-som-v3-csrrrrrtss-v3-debian-emmc-yyyymmdd.tar.gz” to make a SD card. Then insert the SD card into the board, switch SW2 on board to uSD, power on the board, wait some time to flash to eMMC.

2.2. Start Debian OS

1、Insert the SD card (for SD boot) into the board.
2、Switch SW2 on the board to uSD.
3、Power on the board.
Notes: You can see the Chipsee Logo (it can be changed by using software ChipSee_LOGO_MOD_EN.exe we provided in the CD) shown on the LCD screen. It is a successful start when you see the Debian desktop like in Figure 1:

Figure 1 Debian desktop

2.3. Tests

1、 Touch screen and buzzer test
Click on the screen, the mouse arrow stays in position triggered and the buzzer sounds, indicating that touch and buzzer work properly. After working for some time resistive touch screen may not be accurate, so they need to be calibrated: choose PreferencesCalibrate Touchscreen app to recalibrate, but it only works this time, if you reboot the System, you need to do it again. You can do it this way: delete the file /etc/pointercal.xinput, then reboot. You will see the calibrate app first before you access to the system. Just calibrate, the result will saved.
2、 Audio test
Start the terminal, then use command mplayer to test.

# mplayer FILENAME  //such as: mplayer ~/Music/test.mp3

3、 Serial test
Connect COM1 on board to PC. Use software “SecureCRT” or “Putty” or some
others in PC. You will see the system information when the system start.
Note: There are four serial ports available on board, two are RS232  (COM1 and COM2), the others are RS485 (COM3 and COM4). And COM1(RS232) is used to debug the system, baud rate is 115200. The COM1(RS232) is used as debug serial port, users can communicate with the OS via it, just as Terminal did. If users want to use it as normal serial port, follow the steps here:
Edit the file /etc/inttab , at the end of the file.
T0:23:respawn:/sbin/getty –L ttyO0 115200 vt102
Change it to ttyO1, ttyO2 or ttyO4(RS232_2, RS485_1 and RS485_2), you can edit it like this:

# T0:23:respawn:/sbin/getty –L ttyO0 115200 vt102

Then you can use all the four serial ports as normal.
Serial test: Connect COM2 on board to PC. Use software “SecureCRT” or “Putty” or some others in PC, set BAUD as 9600.

# echo “This is a test” > /dev/ttyO1

You will see the string in PC, then change the ttyO1 to ttyO2/ttyO4 to test RS485.

Serial port Driver
COM1(RS232, Debug) /dev/ttyO0
COM2(RS232) /dev/ttyO1
COM3(RS485) /dev/ttyO2
COM4(RS485) /dev/ttyO4

From 1 Seial ports in system

1. GPIO test

There are four inputs and four outputs. LOW is 0V, HIGH is 5V.

OUT1 gpio49
OUT2 gpio50
OUT3 gpio51
OUT4 gpio52
IN1 gpio53
IN2 gpio54
IN3 gpio55
IN4 gpio56
USER_LED gpio19

From 2 GPIO in system

To read and write the GPIO, you can do this: gpio49.
(1) Export gpio, if there is /sys/class/gpio/gpio49/, go to step (2).

# echo 49 > /sys/class/gpio/export

(2) Write

# echo 1 > /sys/class/gpio/gpio49/value

(3) Read

# cat /sys/class/gpio/gpio49/value

5、 Network

# ifconfig –a

You can see the information of CAN0, eth0.
6、 Date and Time
Check the system time

# date

Set the system time

# date –s “2014-03-15 10:30:30”

Check RTC

# hwclock

Write RTC

# hwclock –w

Modify the time zone, such as China:

# ln -sf /usr/share/zoneinfo/Asia/Hong_Kong /etc/localtime

7、 Backlight
Modify the file /sys/class/backlight/backlight.10/Brightness to change the backlight.
range from 0 to 100, 0 means shutdown the backlight, 100 is the MAX value.

# echo 50 > /sys/class/backlight/backlight.10/Brightness

8、 Buzzer
The buzzer will sound when the screen is touched, if you want to disable it, you can do this:
Capacitive touchscreen: Edit /sys/devices/ocp.3/44e0b000.i2c/i2c-0/0-0038/buzopen
“0” means disable.

# echo 0 > /sys/devices/ocp.3/44e0b000.i2c/i2c-0/0-0038/buzopen

Resistive touchscreen: Edit /sys/devices/ocp.3/44e0d000.tscadc/tsc/buzopen
“1” means enable.

# echo 1 > /sys/devices/ocp.3/44e0d000.tscadc/tsc/buzopen

9、 USB device
USB-Wifi module: The system support USB-Wifi module (rtl8723). If you want to get USB-Wifi module to work, you need to edit file: /etc/network/interfaces like this:

#Wifi Example
allow-hotplug wlanX
auto wlanX
iface wlanX inet dhcp
wpa-ssid "Chipsee"   //Router’ name
wpa-psk "1234567890"  // Passwd

wlanX usual should be wlan0, you can use command ifconfig –a to make sure of that.

2.4. Logo modify

We provide a software to change the Logo we set at the OS start. You can find the tool in the CD along with our product: ChipSee_LOGO_MOD_EN.exe.

Figure 2 Chipsee Logo modify

Figure 3 Choose the Logo you want

2、Click the second Browse button, find the u-boot.img file

Figure 4 Choose the u-boot.img file

3、Choose the resolution , click “Execute”.

Figure 5 Change of the logo is successful

4Insert the SD card, power the board, and the logo will be replaced.

3. Debian OS Debug

3.1. View Debian system via the serial port

1、Connect the COM1 on board to PC
2、Open software “SecureCRT” or “Putty” in Windows.
3、Power on the board, you can see the serial output of information like Figure 6.
4、When the system is fully booted, you can communicate with it(user/name: debian/chipsee or root/root).

Figure 6 Serial output information

3.2. NFS

1. Install NFS in Ubuntu

$sudo apt-get install nfs-kernel-server

2. Configure the file “/etc/exports”, add this at the end of file

/qtprojects *(rw, sync, insecure, no_subtree_check)

“/qtprojects”: the shared folder in Ubuntu system;
“*”: allows all other PC to get access to this system;
“rw”: means this folder can be read and write by NFS client;
“sync”: synchronous write memory and hard disk;
“insecure”: sent message through the port above 1024;
“no_subtree_check”: no check the parent directory permissions
3. Restart NFS service

$ sudo /etc/init.d/portmap restart
$ sudo /etc/init.d/nfs-kernel-server restart

4. Test

$ showmount -e

or mount the shared folder to /mnt:

$ sudo mount -t nfs –o nolock localhost:/qtprojects /mnt

Use command df to check out the result, then umount.

$ df -h
$ sudo umount /mnt

5. Mount NFS on industrial computer Debian
Create a directory

# mkdir /nfsdir

Mount the folder /qtprojects in Ubuntu to /nfsdir on board

# mount –t nfs :/qtprojects /nfsdir

If you have an executable program like “SerialTest” under folder “/qtprojects”, you can run it directly on board.

# /nfsdir/SerialTest

4. Java for Debian

This chapter we will setup the environment of Java, and show you how to a make simple Java application.
1、Install jdk

# sudo apt-get install openjdk-6-jdk

2、Edit a simple program HelloWorld.java

import java.awt.Color;
import java.awt.Font;
import java.awt.Toolkit;
import javax.swing.JFrame;
import javax.swing.JTextField;
public class HelloWorld extends JFrame{
public HelloWorld(){
        JTextField text = new JTextField("Hello, world!");
        text.setFont(new Font("Times New Roman",Font.BOLD,60));
public static void main(String argv[]){
        HelloWorld win = new HelloWorld();
        Toolkit tk  = Toolkit.getDefaultToolkit();
		int winWidth = 512;
		int winHeight = 300;
        int Width  = tk.getScreenSize().width;
        int Height = tk.getScreenSize().height;
        win.setSize(winWidth, winHeight);
        win.setLocation((Width-winWidth)/2, (Height-winHeight)/2);

3、Compile the source

# javac HelloWorld.java

This will be very slow in Debian OS, we suggest do it in your PC, you need install jdk-1.6 first.
4、Run the program

# java HelloWorld

You will see this:

Figure 7 HelloWorld(1)

5、Adding the Java program to Quick Start
a) Make a directory

# mkdir /usr/lib/java/

b) Copy HelloWorld.class to /usr/lib/java/

# cp HelloWorld.class /usr/lib/java/

c) Edit script /usr/bin/HelloWorld.sh like this:

cd /usr/lib/java/
java HelloWorld

Change the permissions of the script

# sudo chmod a+x HelloWorld.sh

d) Edit file /usr/share/applications/javatest.desktop like this:

[Desktop Entry]
Comment=Simple test for Java  

This is the result:

Figure 8 HelloWorld(2)

6、Auto-Launch Java app

Add script 89javatest in directory /etc/X11/Xsession.d/ :

cd /usr/lib/java/
java HelloWorld

Reboot, the app HelloWorld will automatically launch.

Was this article helpful to you? Yes No