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


Chipsee Embedded Industrial Computer

Angstrom User Manual


This manual provides users with a fast guide of Chipsee Embedded Industrial Computer about Angstrom OS development. Through this manual, users can quickly understand the hardware resources; users can debug Angstrom 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 Angstrom prebuilt file (to make a bootable SD card)

2. Getting started and basic tests

Notes: Use 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 you’re 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 Angstrom system.

$ sudo fdisk –l

3、Copy the file “prebuilt-angstrom-XXXXXX.tar.gz” somewhere(such as $HOME).
4、Extract the file “prebuilt-angstrom-XXXXXX.tar.gz”

$ tar zxfv prebuilt-angstrom-XXXXXX.tar.gz

5、Go to the folder “prebuilt-angstrom-XXXXXX”

$ cd ~/prebuilt-angstrom-XXXXXX

6、Flash the Angstrom OS to the SD card

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

sd<?> means the uSD card in your Linux(such Ubuntu OS). XXXXXX means the resolution of your device, such as 800480.

2.2. Start Angstrom OS

1、Insert the SD card into device
2、Switch SW8 on device 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 Angstrom desktop, like in Figure 1:

Figure 1 Angstrom 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, need to be calibrated: firstly remove the file /etc/pointercal.xinput, then click on the SystemAdministrationCalibrate Touchscreen on desktop to calibrate, more information you can find “Angstrom Resistive Touchsreen Calibration Steps.pdf”
2、 Audio test
Start terminal, then use command mplayer to test.

# mplayer FILENAME  // such as: mplayer ~/chipsee/Music/AudioTest.aac

3、 Serial test
Connect COM1 on board to PC. Use software “SecureCRT” or “Putty” or some
others in PC. Connect keyboard and mouse to the board. Then press “Ctrl+Alt+F1(or F3~F6)” to get into tty1(tty3~tty6), enter user name root, no password. Go to chipsee folder start the test, Like Figure 2.
Notes: The system is no QtE by default, follow the steps in the CD(Angstrom/Documents/Qt-Angstrom) to set the environment. The QtE in Angstrom OS is not working well, by now user only can use mouse for the Qt apps.

# cd chipsee
# ./ChipseeTest -qws

Figure 2 ChipseeTest

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 a normal serial port, follow the steps here:
a) Edit the file uEnv.txt which you can find in the boot partition.

bootargs=console=ttyO0,115200n8 root=/dev/mmcblk0p2

Change it to ttyO1, ttyO2 or ttyO4(RS232_2, RS485_1 and RS485_2), you can edit it like this:


Then you can use all the four serial ports as normal.
b) Stop the service in Angstrom

# systemctl disable serial-getty@ttyO0.service
# systemctl stop serial-getty@ttyO0.service

Now you can use the COM1 as normal serial port.
c) If you want to use COM1 as debug serial port, you need to edit the file uEnv.txt which you can find in the boot partition. And start the service:

# systemctl start serial-getty@ttyO0.service

d) Serial test: at the serial area, set Com COM2, set Baud 115200, click on “Open” It will send string “Succeed in sending message!!!” every two seconds. Click on the “SendMSG” button, it will send string “Succeed in sending message-manual!!!”. Every two seconds, it will read the received buffer, show the result to the received area.

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

4、 GPIO test
There are four inputs and four outputs. LOW is 0V, HIGH is 5V.
GPIO input terminal connected to the output connection terminal, IN1-4 are corresponding connect to OUT1-4. By setting GPIO_OUT area you will see GPIO_IN region corresponding change. Like figure 2.

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、 Networking
Click on “Network”, then click on “Ifconfig” to view the network information on board, click on “Refresh” to restart the network service, it will take five or six seconds to finish. Like Figure 3.

Figure 3 Networking

6、 Date&Time
Click the time display area “Edit” icon to set the time and date, like Figure 4

Figure 4 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
By modifying the size “Brightness” can change the brightness of the 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
a) USB webcam
If you want to use USB webcam, you need to connect the webcam to the board before power on. Then choose ApplicationSound&VideoCheese Webcam Booth to take pictures.
b) USB-Wifi module
If you want to use the USB-Wifi module in the system, you need to edit the file /var/lib/connman/wifi.config, modify the router, the login name and password, save and reboot. The system will automatically connect the next time you start, the contents are as follows:

Type = wifi
Name = chipsee  //router’s name
Security = AES  //security mode
Passphrase = 1234567890 //password

2.4. Logo modify

We provide a software to change the Logo when the OS starts. You can find the tool in the CD along with our product: ChipSee_LOGO_MOD_EN.exe.
1. Open the software: Chipsee_LOGO_MOD_EN.exe in Windows:

Figure 5 Chipsee Logo modify

Figure 6 Choose the Logo you want

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

Figure 7 Choose the u-boot.img file

3、Choose the resolution , click “Execute”.

Figure 8 Change the Logo successful

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

3. Angstrom OS Debug

3.1. View Angstrom 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 9.
4、When the system is fully booted, you can communicate with it(user: root, no password).

Figure 9 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 Angstrom
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
Was this article helpful to you? Yes No