freescale TWR-LS1021A System Module User Guide

June 6, 2024
freescale

Freescale Semiconductor      Document Number: TWR-LS1021A_Demo_QS
Quick Start Rev. 0, 12/2015

QorIQ TWR-LS1021A OOBE Demo

Quick Start

1 Introduction

The new TWR-LS1021A-PB development board is the most feature rich and high performance Tower system module offered by Freescale. This board enables compatibility and interoperability with other tower expansion modules. It provides an easily accessible and interchangeable suite of capabilities and features to support rapid prototyping and software development. The TWR- LS1021A-PB board is engineered to enable a wide range of applications, from IoT Gateways to industrial controllers, Secure Access Points, and asset management systems. The module offers a high level of integration, excellent balance of performance-to-power, and robust capability delivered by the QorIQ LS1021A communications processor (which offers dual ARM Cortex-A7 cores running at up to 1 GHz delivering over 5,000 Coremarks of performance at a typical power level of under 3 watts). This platform also provides a comprehensive level of security, which includes secure boot, Trust Architecture, and tamper detection, in both standby and active-power modes.

This document describes how you can run the out-of-box-experience (OOBE) demo program, which shows the wireless networking, graphics, and audio playing functionalities of the TWR-LS1021A-PB board.

The access point features demo on LS1021A TWR platform is illustrated in the figure below.

© 2015 Freescale Semiconductor, Inc.freescale logo m1


Figure 1. Access point features demo

This document covers the following sections:

  • Features of the TWR-LS1021A OOBE demo
  • Hardware requirements for the demo
  • Preparing the board for the demo
  • Setting up the TWR board
  • Running the demos
2 TWR-LS1021A OOBE demo features

This section describes the features of wireless access point and the slideshow presentations using the TWR-LS1021A-PB board.

Wireless access point:

  • Three Ethernet ports and a Wi-Fi card – one Ethernet port as WAN and other Ethernet ports, Wi-Fi as LAN
  • DHCP client/server
  • Route and NAT (IP tables, IP route2)
  • Wireless bridging

Slideshow presentation:

  • Audio decoding/playing of MP3 at 128 kbit/s / 44.1 kHz (LAME/ALSA)
  • LS1021A product family overview
  • TWR-LS1021A overview
  • TWR-LS1021A use cases
3 Hardware requirements

For all the features to be demonstrated, the following are required:

  • TWR-LS1021A-PB board – QorIQ LS1021A Tower system module
  • SD card (included with the TWR-LS1021A-PB board)
  • HDMI display and an HDMI cable or TWR-LCD-RGB Graphical LCD Tower system module with RGB interface and the TWR-ELEV Tower system Elevator module
  • USB mouse and keyboard
  • Wired speakers with 3.5mm jack

Wireless access point-specific requirements:

  • Mini PCIe wireless access card (for example: Atheros AR9287)
  • Antennas (for example: Pulse Electronics Corporation W1038)
  • Internet connection
  • Wireless devices (for example: smart phones, laptops, and tablets)
  • Wired (Ethernet RJ45) devices

NOTE

For the Wi-Fi function, only Atheros AR9287 (mini PCIe card) is supported. And for the wired connectivity (Ethernet), RJ45 (up to 1000BaseT) is supported. Further, a maximum resolution of 1024×768 is supported on Dell displays.

3.1 Kit contents

The table below lists the standard kit contents of the TWR-LS1021A-PB board shipment:

Item number

| Description|

Quantity

---|---|---
700-28673| PWA, TWR-LS1021A-PB| 1
600-76796| Cable, USB Type A male/Type Mini B male 3 feet| 1
400-76004| Power supply (100/240V INPUT, 5V 6A output)| 1
600-76809| Cable, US AC outlet, 5 feet, BLACK ROHS| 1
600-77111| Cable, SATA power cable, 4P type connector to SATA power connector| 1
901-76758| HW accessory, universal adaptor| 1
979-28673| Packout, Standard final PDC PKG, accessories include SD Card, USB- Disk and Bracket| 1
926-28673| Quick Start Guide, TWR-LS1021A-PB| 1

4 Preparing the system for the demo

For preparing the system for the demo, you should –

  • Prepare the SD card
  • Configure the TWR-LS1021A-PB board
4.1 Preparing SD card for demo

The image files for the demo are available on the SD card shipped with the board. You should insert the SD card into the board to run the demo. However, if the SD card is not available or the image files have become corrupt, you need to prepare an SD card for the demo. For detailed instructions on formatting and preparing the SD card for the demo, see Preparing SD card for demo.

4.2 Configuring the board

To run the demos described in this guide, the SDK on the TWR-LS1021A-PB board must be re-flashed. If this has not been done earlier, see Configuring the TWR-LS1021A board for detailed instructions on flashing the board.

However, if you have already flashed the board, proceed to the next section.

5 Setting up TWR-LS1021A-PB board

This section describes setting up the TWR-LS1021A-PB board, adding other hardware for the demos, and configuring the board for the first time. This is a one-time activity that need not be done again for running any of the demos.

To set up the TWR-LS1021A-PB board:

1. Set the switch settings as described here (see the figure below for illustration).

  • For NOR flash boot:
    • Switch the SW3[5] to 0 (bank0)
    • SW2[1:8] 0x10001111, SW3[1:8] 0x01100001

  • For SD card boot:
    • Switch the SW3[1] to 0
    • Set the SW2[1:8] to 0x00101111
    • SW2[1:8] 0x00101111, SW3[1:8] 0x01100001

TWR-LS1021A - Fig. 2

Figure 2. Switch/jumper settings and console port

  1. +5V Power
  2. UART/USB Console
  3. SW2 [1:8] ON OFF OFF OFF ON ON ON ON
  4. SW3 [1:8] OFF ON ON OFF off OFF OFF ON

2. Using a USB UART cable, connect the console port to a PC as shown in the figure.
3. Configure the console port using a terminal emulation program like TeraTerm, with the following parameters:

Baud rate 115200
Data 8 bits
Parity No
Stop bit 1 bit
Flow Control None

4. Plug in the Wi-Fi Card and insert the SD card as shown in the figure below.

TWR-LS1021A - Fig. 3

Figure 3. Inserting mPCIe Wi-Fi card and SD card

  1. Mini PCIe mounting posts
  2. SD Card slot
  3. Mini PCIe

5. Add the remaining hardware as explained below:

NOTE

For this, you need the following additional hardware:

  • *       * HDMI cable to connect the monitor or the TWR-RGB-LCD display, as required. Note that you can use either the HDMI display or the LCD display at any given point of time.
    • USB keyboard and mouse
    • Ethernet cable to connect the TWR card to the Internet and the computer on LAN
  • If you want to use a HDMI monitor/TV, connect it using a HDMI cable. For an illustration of the same, see Figure 4 below.
  • If you want to use the TWR-RGB-LCD, plug it into the secondary TWR-EVEL. For an illustration of the same, see Figure 5 below.
  • Plug in the USB keyboard and mouse.
  • Plug in the WAN/Internet network cable.

The figure below shows setting up the hardware using the HDMI display.

TWR-LS1021A - Fig. 4

Figure 4. Hardware configuration using HDMI

  1. TV or Monitor
  2. Internet
  3. USB keyboard and mouse
  4. Wired speaker with 3.5mm plug

The figure below shows setting up the hardware using the LCD display.

TWR-LS1021A - Fig. 5

Figure 5. Hardware configuration using TWR-LCD-RGB

  1. TWR-LCD-RGB
  2. Internet
  3. USB keyboard and mouse
  4. Wired speaker with 3.5mm plug
6 Running the demos

To boot the system and display the main menu, run the command =>run sdboot.

You can see the main menu on the LCD/HDMI display as shown below.

TWR-LS1021A - Fig. 6

Figure 6. Main menu

The following table describes the options in the main menu:

Option Description
Wireless Hot Spot Select this option to configure the TWR-LS1021A-PB board

into a Wi-Fi Access-Point/router and view the wireless networking status or log information.
Linux Prompt| Select this option to view the steps to boot with alternative uImage, rootfs, dtb images.
Uboot Prompt| You can view instructions to flash new RCW and/or U-Boot images to the board.
Slideshow mode| You can play the corresponding slides with audio.

6.1 Wireless hotspot

This section describes the networking functionality of the demo. To do so:

1. Check and ensure that the WAN network and the wireless card are plugged in.
2. To start the network demo, click the Start button at the bottom left corner of the screen. See the figure below for reference.

TWR-LS1021A - Fig. 7

Figure 7. Wireless hotspot menu

You can see the network demo starting in the NetWork Info window on the right.

3. Wait for a few seconds. You will see netdemo start… end; This indicates that the networking functionality of the demo has started successfully.
4. To connect wireless devices such as smart phones and tablets, to the board, use the following credentials:

SSID: Freescale_LS1021A
Password: 12345678
You can see the information about the wireless devices connected to the board under Wifi Client window on the left.

5. To go back to the main menu, click the Exit button at the bottom-right corner of the screen.
6. To stop the networking activity and disconnect all the devices, click the Stop button at the bottom-left corner of the screen.

6.2 Slideshow mode

The Slideshow Mode contains the following slide shows that provide more information on the TWR-LS1021A board.

  • LS1021A features
  • TWR-LS1021A Overview
  • LS1021A Use Cases

In the slideshow mode, use the following keys to navigate between the slides:

Key/Mouse click Action
Page Down, Right Arrow, Down Arrow, Enter key, or left click on the mouse To

go to the next page
Page Up, Up Arrow, Left Arrow, or right click on the mouse| To go to the previous page
Space| To pause or resume the slide show
Home key| To go to the first page
End key| To go to the last page
Esc key| To exit playing and go back to the main menu

Appendix A Preparing SD card for demo

If you are using an SD card that was not shipped with the TWR-LS1021A-PB board, it should be formatted and prepared before it can be used for the demo. To support booting the system from the SD card, instead of NOR flash, you should preserve a given space at the beginning of SD card (for example 2 MB or 4 MB). On a Windows PC, you may use any third party tool to partition the SD- card.

To prepare the SD card on a Linux PC:

  1. Use the fdisk command to partition the SD card to a single W95 FAT32 partition, starting from sector 8192.
  2. Run the mkfs.vfat command to format the above partition
  3. Using the dd command and copy u-boot-with-spl-pbl.bin to the boot sector of the SD card.

NOTE

You can find the u-boot-with-spl-pbl.bin on the USB stick shipped with the board

See an illustration of preparing the SD card on a Linux PC below:

$sudo fdisk/dev/sdb

Command (m for help): n
Partition type:

p primary (0 primary, 0 extended, 4 free)
e extended

Select (default p):
Using default response p
Partition number 1-4, default 1):
Using default value 1
First sector (2048-15523839, default 2048): 8192
Last sector, +sectors or +size{K,M,G} (8192-15523839, default 15523839): +400M

Command (m for help): t
Selected partition 1
Hex code (type L to list codes): b
Changed system type of partition 1 to b (W95 FAT32)

Command (m for help): w
The partition table has been altered!

$sudo mkfs.vfat/dev/sdb1
$sudo dd if=u-boot-with-spl-pbl.bin of=/dev/sdb bs=512 seek=8

Insert the SD card in a Windows PC and copy all files under \OOBE-demo\SDcard\ folder of the USB stick to the root directory of the SD card. The total size of this folder is less than 100 MB.

The figure below shows the files to be copied to the SD card.

TWR-LS1021A - Fig. A-1

Figure A-1. Files to be copied to the SD card

NOTE
You can also download the images from the website http://url.freescale.net/sdk18.

This completes preparing of the SD card for the demo.

Appendix B Configuring the TWR-LS1021A board

This section explains flashing/configuring the TWR-LS1021A-PB board for the first time. To configure the board:

  1. Power on the TWR-LS1021A-PB board and stop at the U-Boot prompt by pressing any key before it boots into Linux.
  2. Configure the demo using the commands below.

NOTE

This is a one-time configuration and you can skip this step if you have already run the demo earlier.

a. To set the MAC address for each eTSEC port for Linux kernel, use the following commands:

=>setenv ethaddr xx:xx:xx:xx:xx:xx
=>setenv eth1addr xx:xx:xx:xx:xx:xx
=>setenv eth2addr xx:xx:xx:xx:xx:xx

NOTE
xx:xx above, indicates the MAC address values. See the labels on the TWR board’s eTSEC ports for the exact values.

b. To load the configuration script for setting up LP-UART console port and LCD/HDMI display, use the following commands:

  • *       * For TWR-LCD-RGB:

=>fatload mmc 0 82000000 first_cfg_lcd

  • *       * For HDMI 1920×1080 (non-Dell brand) wide screen display:

=>fatload mmc 0 82000000 first_cfg_hdmi

  • *       * For HDMI (other displays):

=>fatload mmc 0 82000000 first_cfg_hdmi_low

c. To run the configuration script:

=>source 82000000

Wait till this operation completes and the prompt returns to =>

You may now reboot the system using the reboot command and run the demo.

QorIQ TWR-LS1021A OOBE Demo Quick Start, Rev. 0, 12/2015


Freescale Semiconductor, Inc.

How to Reach Us:

Home Page:
freescale.com

Web Support:
freescale.com/support

Warranty:
Visit freescale.com/warranty for complete warranty information.

Information in this document is provided solely to enable system and software implementers to use Freescale products. There are no express or implied copyright licenses granted hereunder to design or fabricate any integrated circuits based on the information in this document. Freescale reserves the right to make changes without further notice to any products herein.

Freescale makes no warranty, representation, or guarantee regarding the suitability of its products for any particular purpose, nor does Freescale assume any liability arising out of the application or use of any product or circuit, and specifically disclaims any and all liability, including without limitation consequential or incidental damages. “Typical” parameters that may be provided in Freescale data sheets and/or specifications can and do vary in different applications, and actual performance may vary over time. All operating parameters, including “typicals,” must be validated for each customer application by customer’s technical experts. Freescale does not convey any license under its patent rights nor the rights of others. Freescale sells products pursuant to standard terms and conditions of sale, which can be found at the following address: freescale.com/SalesTermsandConditions.

Freescale, the Freescale logo, and QorIQ are trademarks of Freescale Semiconductor, Inc., Reg. U.S. Pat. & Tm. Off. All other product or service names are the property of their respective owners. ARM, Cortex, and TrustZone are registered trademarks of ARM Limited (or its subsidiaries) in the EU and/or elsewhere. All rights reserved.

© 2015 Freescale Semiconductor, Inc.

Document Number TWR-LS1021A_Demo_QS
Revision 0, 12/2015

ARM logo m1 freescale logo m1

References

Read User Manual Online (PDF format)

Read User Manual Online (PDF format)  >>

Download This Manual (PDF format)

Download this manual  >>

Related Manuals