EDS1100/2100 Linux Software Developers Kit (SDK) Quick Start Guide Part Number 900-549 Revision C June 2010
Copyright and Trademark © 2010 Lantronix. All rights reserved. No part of the contents of this book may be transmitted or reproduced in any form or by any means without the written permission of Lantronix. MatchPort and XPort are registered trademarks of Lantronix. Linux is a registered trademark of Linus Torvalds. µClinux is a registered trademark of Arcturus Networks Inc. Ubuntu is a registered trademark of Canonical Ltd. The Fedora trademark is a trademark of Red Hat, Inc.
Contents Copyright and Trademark ....................................................................................................................... 2 Contacts .................................................................................................................................................. 2 Disclaimer ............................................................................................................................................... 2 Revision History .........................
Contents List of Figures Figure 3-1. Connecting an Evaluation Board via Serial Port .........................................................................7 Figure 3-2. Connecting an Evaluation Board via Ethernet ............................................................................8 Figure 4-1. Message Prompts .................................................................................................................... 12 Figure 5-1. Configuration Profile Menu ...............................
1. Introduction This Quick Start Guide explains the basics: how to connect and set up your target on the network; how to install the SDK; and how to build the firmware images. For more detailed information, refer to the User Guide supplied with this product or our Lantronix Web site www.lantronix.com/support/downloads.
2. What’s in the Box Items included depend on which model you have. MatchPort XPort Pro The box contains the following items: The box contains the following items: Ethernet cable 10 ft Cat5e UTP RJ45M/M Ethernet cable MatchPort AR Evaluation Board XPort Universal Demo Board MatchPort AR Module (may have optional BDM connector) XPort Pro Development Board with BDM Connector Antenna – 2.4GHz 2.15 dbi reverse polarity SMA 3.3V wall-mount power supply AC/DC, 1.
3. Target Setup Connecting the Lantronix Evaluation Board This section describes how to connect the MatchPort AR evaluation board or XPort Pro demo board to your host computer and network. Connecting an Evaluation Board – Power 1. Make sure that the power switch on the evaluation or demo board is set to off. 2. Select the appropriate power plug adaptor for your geographical location. Insert it into the slot on the Universal Power Supply; then plug the power supply into an outlet. 3.
3 Target Setup Connecting an Evaluation Board – Ethernet Connect the PC to the evaluation or demo board with a cross-over cable, or a hub/switch and two regular RJ45 cables. Figure 3-2. Connecting an Evaluation Board via Ethernet Connecting the EDS1100/2100 1. Select the appropriate power plug adaptor for your geographical location. Insert it into the slot on the Universal Power Supply; then plug the power supply into an outlet. 2. Connect the output plug of the power supply to the EDS1100/EDS2100. 3.
3 Target Setup Configuring an IP Address By default, the target device (MatchPort AR, XPort Pro, or EDS1100 / 2100) will attempt to obtain an IP address via the DHCP protocol. Type the following command at the Linux shell prompt to determine the IP address: $ ifconfig eth0 The ifconfig command can also be used to set an address, but it will not persist across a reboot.
4. SDK Installation Overview Host requirements Please make sure that at least 2.5 GB of disk space is available before installation. Some operations may require root privileges. Consult the User Guide for instructions on setting up sudo access. Linux Distributions The SDK was validated on the following Linux distributions: Redhat-based distributions Fedora 9, 10, 11, 12, Fedora Core 5 & 6 CentOS 5.2, 5.3, 5.
4 SDK Installation Overview python sudo libacl1-dev tftpd or tftpd-hpa libtasn1-3-dev zlib1g-dev rsync Optional but recommended packages ssh nfs-kernel-server libncurses5-dev (for the ncurses-based configuration utility) libglade2-dev (for the GTK-based graphical configuration utility) libqt3-mt-dev (for the Qt3-based graphical configuration utility) Other Distributions OpenSUSE 11.
4 SDK Installation Overview Installation Procedure To install the SDK software on your host machine: 1. Mount the SDK CD image on your host system. The User Guide provides additional information about image mounting procedures. 2. Select and create an installation directory (replace angle bracketed items with actual values). You must have write privileges to this directory. $ mkdir –p 3. Switch into the installation directory. $ cd 4. Run the installation script.
5. Building Images with the SDK To build an image with the SDK: 1. From the development host, switch into the installation directory. $ cd 2. Source the environment file. $ . env_m68k-µClinux 3. Issue the make command. $ make 4. Select a configuration profile when prompted. NOTE If you are unsure of which configuration profile to use, begin with the DEFAULT profile. Figure 5-1. Configuration Profile Menu Configuration Profile > 1. DEFAULT (LTRX_PROFILE_DEFAULT) (NEW) 2.
5 Building Images with the SDK Figure 5-2. Configuration Prompts Default all settings (lose changes) (DEFAULTS_OVERRIDE) [N/y] (NEW) Customize Kernel Settings (DEFAULTS_KERNEL) [N/y] (NEW) Customize Application/Library Settings (DEFAULTS_VENDOR) [N/y] (NEW) Update Default Vendor Settings (DEFAULTS_VENDOR_UPDATE) [N/y] (NEW) ... NOTE The build process may take several minutes to complete. 6. Once the build process is complete, verify that the images listed below are under /linux/images/.
6. SDK Forum Information The Lantronix Linux SDK forum Web site (http://forums.lantronix.com) is the primary resource to obtain updated revisions of the SDK. The SDK and related documentation are also available via the Downloads page (www.lantronix.com/support/downloads). Please visit the Lantronix Web site or the Forums page to determine if a more current version of the SDK is available.
