Timesys Getting Started Guide for Lantronix PremierWave XC HSPA+


Contents

Introduction

This document will describe in detail the procedures for booting a Linux kernel image and root file system on the Lantronix PremierWave HSPA+.

Prerequisites

Host Requirements

To properly boot Lantronix PremierWave HSPA+ using software from Timesys, your host machine must meet the following requirements:

  • Modern GNU/Linux Distribution. While you can use nearly any modern Linux distribution released in the last 24 months, Timesys recommends one of the following:
    • Ubuntu (Most recent release or LTS)
    • Fedora (Most recent release)
  • An internet connection on the Development Host.
  • Root or sudo permission on the Development Host.
  • An available serial port on your Development Host.

You will also need a Windows XP machine with a WiFi adapter, running with the Lantronix Device Installer software loaded onto it.

Installing the Lantronix Device Installer

Install the Lantronix DeviceInstaller host utility and follow the PremierWave XN Quick Start Guide in order to get the Premierwave XN connected to the Windows XP host. These can be downloaded from the following Lantronix links:

DeviceInstaller requires a personal computer running Microsoft Windows. Refer to the DeviceInstaller documentation for more specific requirements.

Target Requirements

To boot the Lantronix PremierWave HSPA+, you will need the following items:

  • Lantronix PremierWave HSPA+ Board
  • Serial NULL Modem Cable
  • Wi-Fi adapter
  • Lantronix DeviceInstaller utility and a Windows workstation
  • Kernel and RFS images for the Target Board downloaded from Factory. These are found in the output directory of your online build, or in the directory build_armv5l-timesys-linux-<libc>/images/ on the command line.
    • premierwave-7_3_0_1R4.rom - Single combined image
  • u-boot.rom - Optional, only needed if you wish to update the U-Boot image.

Once you have all of the necessary components, you should perform the following steps:

  1. Connect the SERIAL 1 port of the board to the serial port of your Windows workstation using the null modem cable. This connection will be used to transfer the boot images.
  2. Connect the power supply to your board.

Preparing the Target

Configuring Telnet Communication

The PremierWave XC HSPA+ uses Telnet to communicate with the host machine.

The commands discussed in this section are meant to be performed by a privileged user account. This requires the root login or prepending each command with sudo.

Using Telnet

To quickly connect to a board using Telnet, execute the following:

# telnet <IP Address of Board>

For more information about using telnet, please consult the man page.

Installing u-boot

PremierWave XC HSPA+ comes with u-boot preflashed. In order to flash a new u-boot image you must have the following:

  • u-boot.rom - ROM image of u-boot
  • Windows machine with DeviceInstaller (Serial Flasher) v4.3.0.2 or later

Flashing u-boot

The following steps describe how to flash the u-boot image to the PremierWave XC HSPA+ using the DeviceInstaller application.

  1. Start DeviceInstaller, e.g. Start -> All Programs -> Lantronix -> DeviceInstaller
  2. Press F8, or navigate to Tools -> Recover Firmware
  3. For Port on PC, select the COM port connected to the Serial 1 port of the PremierWave XC HSPA+
  4. For Device Model, select PremierWave XC HSPA+ P6
  5. Check the Erase All Flash box
  6. For firmware file, select u-boot.rom
  7. Click OK to start flashing
  8. Reset or power cycle the device when prompted

Flashing the Kernel and RFS

The images available for flashing are described in the following table:

Image File Description
premierwave-7_3_0_1R4.rom combined kernel and UBIFS rom image

The following steps describe how to flash the Kernel and RFS images to the PremierWave XC HSPA+ using the DeviceInstaller application.

  1. Start DeviceInstaller, e.g. Start -> All Programs -> Lantronix -> DeviceInstaller
  2. Press F8, or navigate to Tools -> Recover Firmware
  3. For Port on PC, select the COM port connected to the Serial 1 port of the PremierWave XC HSPA+
  4. For Device Model, select PremierWave XC HSPA+ P6
  5. UNCheck the Erase All Flash box
  6. For firmware file, select premierwave-7_3_0_1R4.rom
  7. Click OK to start flashing
  8. Reset or power cycle the device when prompted

Preparing the Host

As the Lantronix PremierWave HSPA+ is designed to boot from flash, no additional Linux host setup is necessary.

Booting the Board

The PremierWave XC HSPA+ is configured to boot automatically. No additional steps are needed.

Additional Information

Important note for older versions of Device Installer

Some versions of DeviceInstaller use the incorrect recovery image for the PremierWave XC HSPA+. If you experience timeout issues, please perform the following steps before attempting to transfer the file.

  1. In the Device Installer Firmware Recovery window, click Advanced
  2. For Recovery Loader, select C:\Program Files\Lantronix\DeviceInstaller4.3\RecovLoader_at9g25.rom
  3. Click OK to start flashing
  4. Reset or power cycle the device when prompted

Factory Documentation