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