Chipsee AM335X User manual

Industrial PC
Angstrom OS on AM335X
User Manual
For AM335X Products
Content can change at anytime, check documentation website for latest information.
www.chipsee.com

Contents
3Angstrom OS
41. Preparation
41.1. Hardware Requirements
41.2. Software Requirements
52. Getting Started and Tests
52.1. DIP Switch Conguration
52.2. Downloading Images
52.3. Prebuilt Files Package
72.4. How to make a bootable SD card
92.5. How to ash Linux to eMMC
112.6. Start Angstrom OS
122.7. Tests
122.7.1. Touch screen and buzzer test
132.7.2. Audio IO test
142.7.3. Serial test
172.7.4. GPIO test
192.7.5. Network
202.7.6. Date and Time
222.7.7. Backlight
232.7.8. USB device test
242.8. Modify OS Start up Logo
273. Angstrom OS debug
273.1. View Angstrom system via the serial port
283.2. Debug via NFS
304. Disclaimer
305. Technical Support
Chipsee IPC Page 2 of 30

Angstrom OS
Chipsee Angstrom OS User Manual
This manual provides users with a fast guide of Chipsee Industrial Computer (Abbreviated
as IPC) about Angstrom OS development. Through this manual, users can quickly
understand the hardware resources; users can debug Angstrom OS via serial and Internet.
SUPPORTED BOARDS:
CS80480T050 CS10600T070 CS10768T097
PREBUILT FILES PACKAGE:
Prebuilt les for the various industrial PCs can be found in the OS Downloads.
Below are the links to the prebuilt les for each industrial PC model.
CS80480T050
CS10600T070
CS10768T097
System Features
Revision Date Author Description
V1.0 2021-12-09 Randy Initial Version
•
•
•
Feature Comment
System Angstrom 2012
Angstrom OS on AM335X User Manual
Chipsee IPC Page 3 of 30

Preparation
You will need to prepare the following items before you can start using the Prebuilt Files
Package to re-ash the system.
Power Supply Unit (PSU) with the appropriate voltages, as follows:
Products with 5” display panel require 6V to 36V PSU
Products with 7” to 10.1” display panel and larger require 6V to 42V PSU
USB to serial cable for debugging Chipsee Industrial Embedded Computers (Chipsee
IPC)
TF Card to create a bootable storage for re-ashing the system. Use the prebuilt les
link above to re-ash the system.
Hardware Requirements
Chipsee Industrial PC
PSU according to the instructions above
USB-to-serial or other serial cable for debugging
TF Card (at least 4GB) and card reader
USB A-A cable (used only if the hardware congured as OTG)
Windows 7 PC
Software Requirements
Angstrom OS Prebuilt Files Package (from the link above)
•
•
•
•
•
•
•
•
•
•
•
•
Note
In this documentation, all the commands are executed with root user privileges.

Angstrom OS on AM335X User Manual Preparation
Chipsee IPC Page 4 of 30

Getting Started and Tests
DIP Switch Configuration
Set the boot DIP switch, as shown on the gure below, to boot the system from the external
SD Card.
Figure 781: Boot Mode Setup
Downloading Images
Chipsee IPC supports booting from an integrated eMMC or an external TF Card (also known
as the micro SD card). Booting from the external TF Card allows ashing the system OS.
Prebuilt Files Package
You can get the Prebuilt Files Package for each model from links mentioned at the
beginning of this documentation. You can also get the Prebuilt Files Package from the DVD
in /Angstrom/Prebuilds folder. However, it may be outdated so always compare the
versions (the last number in the lename is the release date).
The prebuilt package has the following content:
Note
The operator should use the prebuilt le we provided in the CD to test the hardware before re-ashing the system.

Contents Comment
boot/imx6ulipc.dtb TF Card boot dtb le
Angstrom OS on AM335X User Manual Getting Started and Tests
Chipsee IPC Page 5 of 30

Contents Comment
boot/u-boot.imx TF Card boot bootloader
boot/zImage TF Card boot kernel le
lesystem/rootfs-emmc-asher.tar.bz2 TF Card boot rootFS
mksdcard.sh Shell tools to make bootable TF Card
README Simple guidelines
S1.jpg Boot Switch Cong Figure
emmc-ash/emmc/rootfs.tar.gz RootFS in target eMMC
emmc-ash/emmc/u-boot.imx Bootloader in target eMMC
emmc-ash/emmc/zImage Kernel le in target eMMC
emmc-ash/emmc/imx6ul-eisd.dtb dtb le in target eMMC
emmc-ash/mkemmc.sh Shell tools to download images
Table 219 Prebuilt Files Package
Note
The default zImage and imx6q-sabresd.dtb les support ‘keep the logo from uboot to kernel’ but do not support
framebuer. Chipsee provides zImage_framebuffer and imx6q-eisd.dtb_framebuffer le versions that support
the framebuer function but do not support the ‘keep the logo from uboot kernel’ feature. If you need the framebufer,
just rename these two les to zImage and imx6q-eisd.dtb .

Angstrom OS on AM335X User Manual Prebuilt Files Package
Chipsee IPC Page 6 of 30

How to make a bootable SD card
The Prebuilt Files Package has a shell tool that can help create a bootable SD card using a
Linux platform (such as desktop PC or Virtual Machine running Ubuntu 14.04 distribution).
Use the SD Card to download the bootable system image onto the Linux platform and
follow the steps below to create a bootable SD card:
Copy the Prebuilt Files Package to a Linux environment (such as Ubuntu 14.04).
Insert the SD card into your computer. If you are using virtual machines, please ensure
the SD card is mounted to the Linux operating system.
Conrm the SD card mount point, /dev/sdX e.g., /dev/sdc or /dev/sdb , be sure
to use the right one). In a Linux system, you can use the command below to nd
out what X is.
Copy the prebuilt-angstrom-XXXXXX.tar.gz to somewhere(such as $HOME).
Extract the prebuilt-angstrom-XXXXXX.tar.gz
Go to the folder
Use the following command to ash the Angstrom OS to the SD card
The bootable SD Card is now ready. Power OFF the industrial PC and insert the SD Card.
Set the DIP switch to uSD BOOT mode. (refer to DIP Switch Conguration above)
Connect the industrial PC to PC via COM1. Power ON the IPC.
1.
2.
3.
$ sudo fdisk –l
4.
5.
$ tar -xzvf prebuilt-angstrom-XXXXXX.tar.gz
6.
$cd ~/prebuilt-angstrom-XXXXXX
7.
$ sudo ./mksdcard.sh --device /dev/sd<?>
Note
sd<?> means the SD card mount point, (e.g., /dev/sdc or /dev/sdb ) in Ubuntu system.
The recommended SD card should be Sandisk Class4 level SD card or above.

•
•
8.
9.
10.
Angstrom OS on AM335X User Manual How to make a bootable SD card
Chipsee IPC Page 7 of 30

After 20 minutes, if the LED on industrial PC stays lit, ashing is completed. Using COM1,
you can also nd this message >>>>>>> eMMC Flashing Completed <<<<<<< which
indicates that the system image was downloaded correctly to the eMMC.
Power OFF the IPC and set the DIP switch to eMMC BOOT mode. (refer to DIP Switch
Conguration above)
11.
12.
Angstrom OS on AM335X User Manual How to make a bootable SD card
Chipsee IPC Page 8 of 30

How to flash Linux to eMMC
The Prebuilt Files Package has a shell tool that can help create a bootable SD card using a
Linux platform (such as desktop PC or Virtual Machine running Ubuntu 14.04 distribution).
Follow the steps below to create a bootable SD card:
Copy the Prebuilt Files Package to a Linux environment (such as Ubuntu 14.04).
Insert the SD card into your computer. If you are using virtual machines, please ensure
the SD card is mounted to the Linux operating system.
Conrm the SD card mount point, /dev/sdX e.g., /dev/sdc or /dev/sdb , be sure
to use the right one). In a Linux system, you can use the command below to nd
out what X is.
Copy the prebuilt le prebuilt-som-v3-csxxxxxtxx-v3-ezsdk-emmc-yyyymmdd.tar.gz to
somewhere(such as $HOME).
Extract the prebuilt le
prebuilt-som-v3-csxxxxxtxx-v3-ezsdk-emmc-yyyymmdd.tar.gz
Go to the folder prebuilt-som-v3-csxxxxxtxx-v3-ezsdk-emmc-yyyymmdd
Use the following command to ash the Angstrom OS to the SD card
The bootable SD Card is now ready. Power OFF the industrial PC and insert the SD Card.
Set the DIP switch to SD BOOT mode. (refer to DIP Switch Conguration above)
Connect the industrial PC to PC via COM1. Power ON the IPC.
1.
2.
3.
$ sudo fdisk –l
4.
5.
$ tar -xzvf prebuilt-som-v3-csxxxxxtxx-v3-ezsdk-emmc-yyyymmdd.tar.gz
6.
$cd ~/prebuilt-som-v3-csxxxxxtxx-v3-ezsdk-emmc-yyyymmdd
7.
$ sudo ./mksdcard.sh --device /dev/sd<?>
Note
sd<?> means the SD card mount point, (e.g., /dev/sdc or /dev/sdb ) in Ubuntu system.
The recommended SD card should be Sandisk Class4 level SD card or above.

•
•
8.
9.
10.
Angstrom OS on AM335X User Manual How to ash Linux to eMMC
Chipsee IPC Page 9 of 30

After 20 minutes, if the LED on industrial PC stays lit, ashing is completed. Using COM1,
you can also nd this message >>>>>>> eMMC Flashing Completed <<<<<<< which
indicates that the system image was downloaded correctly to the eMMC.
Remove the SD card and Power OFF the IPC.
Set the DIP switch to eMMC BOOT mode (refer to DIP Switch Conguration above) and
Power ON the IPC.
11.
12.
13.
Angstrom OS on AM335X User Manual How to ash Linux to eMMC
Chipsee IPC Page 10 of 30

Start Angstrom OS
The rst time you start Angstrom OS on the industrial PC will take a little time. But after the
rst time, Angstrom OS will start quickly. When the Angstrom OS starts up, you will see the
Chipsee Logo on the LCD screen. It is a successful start if you see the Angstrom OS desktop
such as the one shown in the gure below:
Figure 782: Angstrom OS start-up screen
Angstrom OS on AM335X User Manual Start Angstrom OS
Chipsee IPC Page 11 of 30

Tests
Touch screen and buzzer test
Click on the screen, the mouse arrow stays in a position that triggers the buzzer sounds,
indicating that touch and buzzer work properly.
After working for some time, the resistive touch screen may not be accurate. The user must
run a touch screen calibration test.
Firstly delete the le /etc/pointercal.xinput using the command below.
Click on the System–>Administration–>Calibrate Touchscreen app on desktop to recalibrate.
Reboot the system. You will see the calibrate app upon boot up before you access the
system. Just calibrate, the result will be saved.
The buzzer will sound when the screen is touched, if you want to disable it, you can do this:
On capacitive touchscreen:
On resistive touchscreen:
where:
0 = disable
1 = enable
$ sudo rm /etc/pointercal.xinput
•
# echo 0 > /sys/devices/ocp.3/44e0b000.i2c/i2c-0/0-0038/buzopen
•
# echo 1 > /sys/devices/ocp.3/44e0d000.tscadc/tsc/buzopen
•
•
Angstrom OS on AM335X User Manual Tests
Chipsee IPC Page 12 of 30

Audio IO test
Start the terminal, then use the mplayer command to play an audio le.
# mplayer FILENAME //such as: mplayer ~/Music/test.mp3
Angstrom OS on AM335X User Manual Tests
Chipsee IPC Page 13 of 30

Serial test
There are four serial ports on the Chipsee IPC: 2 X RS232 and 2 X RS485. The COM1(RS232)
is used as the debug serial port. Users can communicate with the OS via COM1. Refer to the
table below for the available serial device nodes.
Run a serial test:
Install SecureCRT or Putty software on a Windows 7 PC and use it to perform
the serial port testing.
Connect keyboard and mouse to the IPC. Then press Ctrl+Alt+F1 or F3~F6) to
get into tty1tty3~tty6). Enter username: :substitution-code: |user| , no
password.
Launch the ChipseeTest app by using the commands below.
Ports Device Node
COM1(RS232, Debug) /dev/ttyO0
COM2(RS232) /dev/ttyO1
COM3(RS485) /dev/ttyO2
COM4(RS485) /dev/ttyO4
Table 220 Serial Ports Nodes on the System
1.
•
•
Note
Notes: The system is not 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
Angstrom OS on AM335X User Manual Tests
Chipsee IPC Page 14 of 30

Figure 783: ChipseeTest
If you want to use COM1 as a normal serial port, you can re-congure the port by
following these steps:
Open and edit the uEnv.txt le which can be found in the boot partition with
any text editor.
At the end of the le, edit this line bootargs=console=ttyO0,115200n8 root=/
dev/mmcblk0p2 to
This will change ttyO0 (COM1) to ttyO1, ttyO2 or ttyO4(RS232_2, RS485_1 and
RS485_2) and makes it possible to use all the four serial ports as normal serial
ports.
Stop the service in Angstrom.
2.
•
bootargs=console=ttyO0,115200n8 root=/dev/mmcblk0p2
•
bootargs=root=/dev/mmcblk0p2
•
•
# systemctl disable [email protected]
# systemctl stop [email protected]
Angstrom OS on AM335X User Manual Tests
Chipsee IPC Page 15 of 30

Now you can use the COM1 as normal serial port.
If you want to use COM1 as debug serial port, you have to edit the uEnv.txt le
which you can nd in the boot partition. And start the service by running this
command:
From the ChipseeTest app, search for the serial area then congure the following
settings, as shown on the gure below.
set Com to COM2
set Baud to 115200
click on the Open button
It will send the string Succeed in sending message!!! every two seconds through
the serial port to the Windows 7 PC.
Click on the SendMSG button to send the string Succeed in sending message-
manual!!!.
Every two seconds, it will read the received buer and show the result to the
received area.
1.
# systemctl start [email protected]
2.
•
•
•
•
•
•
Angstrom OS on AM335X User Manual Tests
Chipsee IPC Page 16 of 30

GPIO test
There are (4) four input and (4) four output pins. LOW is 0V, HIGH is 5V.
The GPIO input terminals connect to the GPIO output terminals, respectively. IN1-4
corresponds to OUT1-4.
As a result, if you set the GPIO_OUT area, you will see the GPIO_IN region change as well.
You can control the LED light on the industrial PC by setting the LED ON or OFF.
You can read and write the GPIO by following the steps below. For this example, we are
going to use gpio49 (OUT1).
Use this command to export gpio.
Use this command to check if the directory /sys/class/gpio/gpio49/ exist before
writing to it
Use this command to write gpio
Use this command to read gpio
GPIO GPIO In System
OUT1 gpio49
OUT2 gpio50
OUT3 gpio51
OUT4 gpio52
IN1 gpio53
IN2 gpio54
IN3 gpio55
IN4 gpio56
USER_LED gpio19
Table 221 GPIO Nodes on the System
•
# echo 49 > /sys/class/gpio/export
•
# find /sys/class/gpio/gpio49/
•
# echo 1 > /sys/class/gpio/gpio49/value
•
Angstrom OS on AM335X User Manual Tests
Chipsee IPC Page 17 of 30

# cat /sys/class/gpio/gpio49/value
Angstrom OS on AM335X User Manual Tests
Chipsee IPC Page 18 of 30

Network
To view the network information on the industrial PC, follow these steps:
Click on the Network tab, then click the Ifcong button to view the network
information on the industrial PC.
Click on the Refresh button to restart the network service which will take ve or six
seconds to nish.
The gure below is an illustration of the network information on the industrial PC.
Figure 784: View Network Information
•
•
Angstrom OS on AM335X User Manual Tests
Chipsee IPC Page 19 of 30

Date and Time
Click the Edit icon at the time display area to set the time and date, as shown on the gure
below.
Figure 785: Set Date and Time
Check the system time
Set the system time
Check RTC
Write RTC
Modify the time zone to a dierent timezone, such as China
•
# date
•
# date –s "2014-03-15 10:30:30"
•
# hwclock
•
# hwclock -w
•
Angstrom OS on AM335X User Manual Tests
Chipsee IPC Page 20 of 30