SMART Embedded Computing COMX-P2020 BSP User manual

COMX-P2020 BSP
User Guide
P/N: 6806800L84C
December 2019

© 2019 SMART Embedded Computing™, Inc.
All Rights Reserved.
Trademarks
The stylized "S" and "SMART" is a registered trademark of SMART Modular Technologies, Inc. and “SMART Embedded
Computing” and the SMART Embedded Computing logo are trademarks of SMART Modular Technologies, Inc. All other names
and logos referred to are trade names, trademarks, or registered trademarks of their respective owners. These materials are
provided by SMART Embedded Computing as a service to its customers and may be used for informational purposes only.
Disclaimer*
SMART Embedded Computing (SMART EC) assumes no responsibility for errors or omissions in these materials. These
materials are provided "AS IS" without warranty of any kind, either expressed or implied, including but not limited to,
the implied warranties of merchantability, fitness for a particular purpose, or non-infringement. SMART EC further does
not warrant the accuracy or completeness of the information, text, graphics, links or other items contained within these
materials. SMART EC shall not be liable for any special, indirect, incidental, or consequential damages, including without
limitation, lost revenues or lost profits, which may result from the use of these materials. SMART EC may make changes to
these materials, or to the products described therein, at any time without notice. SMART EC makes no commitment to update
the information contained within these materials.
Electronic versions of this material may be read online, downloaded for personal use, or referenced in another document as a
URL to a SMART EC website. The text itself may not be published commercially in print or electronic form, edited, translated,
or otherwise altered without the permission of SMART EC.
It is possible that this publication may contain reference to or information about SMART EC products, programming, or services
that are not available in your country. Such references or information must not be construed to mean that SMART EC intends
to announce such SMART EC products, programming, or services in your country.
Limited and Restricted Rights Legend
If the documentation contained herein is supplied, directly or indirectly, to the U.S. Government, the following notice shall apply
unless otherwise agreed to in writing by SMART Embedded Computing.
Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subparagraph (b)(3) of the Rights in
Technical Data clause at DFARS 252.227-7013 (Nov. 1995) and of the Rights in Noncommercial Computer Software and
Documentation clause at DFARS 252.227-7014 (Jun. 1995).
SMART Embedded Computing, Inc.
2900 S. Diablo Way, Suite 190
Tempe, Arizona 85282
USA
*For full legal terms and conditions, visit www.smartembedded.com/ec/legal

Table of Contents
COMX-P2020 BSP User Guide (6806800L84C) 3
About this Manual ...............................................................11
1 Overview ...................................................................15
1.1 Overview ...............................................................15
2 Host Setup..................................................................17
2.1 Setting Up the Host .......................................................17
3 Get and Install the ToolKit and BSP .............................................19
3.1 Getting and Installing the ToolKit ............................................19
3.2 Getting and Installing the BSP ..............................................19
4 BSP Build Environment .......................................................23
4.1 Build U-boot ............................................................23
4.1.1 About U-boot ......................................................23
4.1.2 U-boot for COMX-P2020 .............................................23
4.1.3 Memory Map ......................................................24
4.1.4 Compile U-boot for SPI Flash .........................................24
4.1.5 Compile U-boot for SD Card ..........................................25
4.2 Build Linux Kernel and Device Tree ..........................................26
4.2.1 Configure the Linux kernel with default setting ............................26
4.2.2 Configure the Linux Kernel............................................27
4.2.3 Compile the Linux Kernel .............................................29
4.2.4 Compile Device Tree Bolb ............................................30
4.3 Build Root File System ....................................................31
4.3.1 Build rootfs-min-ext2.img .............................................31
4.3.2 Build rootfs-usr-ext2.img .............................................33
4.3.3 Build rootfs-dev-ext2.img .............................................34
4.3.4 Build rootfs-LRFS.tar.gz..............................................35
4.3.5 Build rootfs-nfs.tar.gz ................................................36
4.3.6 Build release package for COMX-P2020 .................................37

4 COMX-P2020 BSP User Guide (6806800L84C)
Table of Contents
5 U-boot Deployment...........................................................39
5.1 Switch Setting on COMX-P2020 .............................................39
5.2 Host Setup .............................................................39
5.3 Start-up U-boot ..........................................................40
5.3.1 Program SD Card...................................................40
5.3.2 Start-up U-boot from SD Card .........................................42
5.3.3 Program SPI Flash with SF100 ........................................43
5.3.4 Set the Switch .....................................................45
5.4 U-boot Command ........................................................46
5.4.1 UART ............................................................49
5.4.2 GPIO ............................................................49
5.4.3 ID EEPROM (AT24C02) .............................................51
5.4.4 Board EEPROM (AT24C02) ..........................................54
5.4.5 I2C Switch (PCA9545) ...............................................57
5.4.6 Temperature Sensor (LM75CIM-3) .....................................58
5.4.7 DDR3 SPD ........................................................58
5.4.8 M41ST85WMX6TR .................................................59
5.4.9 SPI Flash .........................................................61
5.4.10 SD Card ..........................................................62
5.4.11 USB .............................................................62
5.4.12 PCI Express .......................................................62
5.4.13 eTSEC & BCM5482 .................................................64
5.5 Configure U-boot Environment ..............................................64
5.5.1 Default U-boot environment ...........................................64
5.5.2 Configure U-boot for tftp..............................................66
5.5.3 Configuring U-Boot for Ramdisk Deployment using TFTP....................67
5.6 Upgrade U-boot for SPI Flash Using TFTP ....................................68
6 Start Linux ..................................................................71
6.1 RAMDISK Deployment Using tftp ............................................71
6.2 NFS Deployment ........................................................73
6.3 Starting Linux from USB Disk ...............................................75
6.3.1 Deploy Filesystem to the USB Disk .....................................75
6.3.2 Starting kernel with Inflated ext2FS .....................................78
6.3.3 Starting kernel with Ramdisk using FAT16 partition ........................80
6.3.4 Starting the Kernel with Ramdisk using ext2 Partition .......................81
6.4 Starting Linux from SD Card ................................................83

Table of Contents
COMX-P2020 BSP User Guide (6806800L84C) 5
6.4.1 Deploy Filesystem to the SD Card ......................................83
6.4.2 Starting Kernel with Inflated ext2FS.....................................87
6.4.3 Starting Kernel with Ramdisk Using FAT16 Partition........................89
7 Linux Deployment............................................................93
7.1 I2C Driver ..............................................................93
7.2 Detect I2C Device ........................................................93
7.3 Dump I2C Device ........................................................94
7.4 Get Registers of I2C Device ...............................................96
7.5 Get Temperature of LM75 .................................................96
7.6 Frame buffer of XGI ......................................................97
7.7 MiniGUI Example ........................................................98

6 COMX-P2020 BSP User Guide (6806800L84C)
Table of Contents

List of Figures
COMX-P2020 BSP User Guide (6806800L84C) 7
Figure 3-1 BSP Source Code Directory Tree ..................................... 20
Figure 4-1 Save Linux Kernel Configuration ...................................... 29
Figure 5-1 SPI Flash Content ................................................. 61
Figure 7-1 Output for Framebuffer Test Program ................................... 97
Figure 7-2 Output for MiniGUI Example ......................................... 98

List of Figures
8 COMX-P2020 BSP User Guide (6806800L84C)

List of Tables
COMX-P2020 BSP User Guide (6806800L84C) 9
Table 4-1 Memory Map ........................................................24
Table 5-1 Content for ID EEPROM ...............................................39
Table 5-2 GPIO Description ....................................................49
Table 5-3 Content for ID EEPROM ...............................................51
Table 5-4 Content for Board EEPROM ............................................54
Table 6-1 Partitions on USB Disk ................................................75
Table 6-2 Partitions on the SD card ..............................................83

List of Tables
10 COMX-P2020 BSP User Guide (6806800L84C)