ZEUS AEL Embedded Linux Development Kit Quickstart Manual
Zeus Embedded Linux Development Kit Quickstart Disclaimer The information in this manual has been carefully checked and is believed to be accurate. Eurotech Ltd assumes no responsibility for any infringements of patents or other rights of third parties, which may result from its use. Eurotech Ltd assumes no responsibility for any inaccuracies that may be contained in this document. Eurotech Ltd makes no commitment to update or keep current the information contained in this manual.
ZEUS Embedded Linux Development Kit Quickstart Contents Contents Introduction ........................................................................................................................................4 Handling your board safely ....................................................................................................5 About this manual ..............................................................................................................................6 Related documents .
ZEUS Embedded Linux Development Kit Quickstart Introduction Introduction The ZEUS is an ultra low power, high functionality, EPIC-compatible Single Board Computer (SBC) based on the Intel 520MHz PXA270 XScale RISC processor. The PXA270 is an implementation of the Intel XScale micro-architecture combined with a comprehensive set of integrated peripherals including: • Intel® Wireless MMX™ designed for high-performance multimedia. • 3 high-performance UARTS. • Enhanced LCD controller.
ZEUS Embedded Linux Development Kit Quickstart Introduction Handling your board safely Anti-static handling The ZEUS and other circuit boards have CMOS devices. These could be damaged in the event of static electricity being discharged through them. Please observe anti-static precautions at all times when handling circuit boards. This includes storing boards in appropriate anti-static packaging and wearing a wrist strap when handling them.
ZEUS Embedded Linux Development Kit Quickstart About this manual About this manual This manual helps you get your ZEUS single board computer up and running as quickly as possible. It provides information about the components contained in your ZEUS Development Kit and tells you how to unpack, connect, and configure the board. Related documents This manual is supplied as part of the ZEUS Linux Development Kit. Other manuals are available on the CD-ROM that accompanies your Development Kit.
ZEUS Embedded Linux Development Kit Quickstart Symbol About this manual Explanation Jumper is not fitted. Jumper fitted on pins 1-2. Jumper fitted on pins 2-3. Typographical conventions This manual contains examples of commands that you can enter. These are shown as follows: $ make install DESTDIR=/tmp/target-install The initial symbol ($ in this case) indicates the prompt that the command is for, and should not be typed.
ZEUS Embedded Linux Development Kit Quickstart Getting started Getting started What’s in the kit? The ZEUS AEL Embedded Linux Development Kit is available with a number of options including: • Basic ZEUS Embedded Linux Development. • ZEUS Embedded Linux Development Kit with flat panel touchscreen display. • ZEUS Embedded Linux Development Kit with wireless modem / GPS receiver. • ZEUS Embedded Linux Development Kit with flat panel touchscreen display and wireless modem / GPS receiver.
ZEUS Embedded Linux Development Kit Quickstart Getting started The Development Kit may be supplied with an optional TFT flat panel touchscreen display. The extra items supplied with the touchscreen are: • NEC 6.5" flat panel (NL6448BC20-08E). • Backlight inverter module. • All associated cables. • Analog resistive 6.5" touchscreen.
ZEUS Embedded Linux Development Kit Quickstart Getting started What peripherals are supported? Linux supports the following peripherals in this release: • Seven UARTs: COM1 through to COM7 (includes the processor’s internal FFUART, BTUART and STUART, and support for the wireless modem and GPS receiver). • On-board Flash with JFFS2. • Ethernet interfaces. • Audio codec. • Flat panel display. • Battery backed SRAM. • Real time clock. • Watchdog. • PC/104 expansion bus.
ZEUS Embedded Linux Development Kit Quickstart ZEUS ‘at a glance’ ZEUS ‘at a glance’ Audio GPIO SRAM Camera PXA270 DRAM Flat panel LCD Touchscreen 4w/5w Flat panel LCD - LVDS Alternative 5v power input CAN bus Flash Reset switch JTAG Serial RS422/485 User jumpers 2x serial RS232/ 485/422 10-30V power User 2x input (optional) LEDs Ethernet 2x USB USB host client COM1 RS232 PC/104 COM2 RS232 SD/SDIO/ MMC IEEE 802.15.
ZEUS Embedded Linux Development Kit Quickstart Unpacking and connecting up Unpacking and connecting up This section guides you, step-by-step, through the process of connecting up the ZEUS for the first time and powering up the system. The ZEUS is delivered ready to run. There are no link settings or configuration switches that need to be adjusted for the board to operate; however as instructed below, you should enable the battery link so that the on-board RTC operates as expected.
ZEUS Embedded Linux Development Kit Quickstart Unpacking and connecting up To power up the ZEUS and boot AEL Embedded Linux follow these steps: 1 Remove the ZEUS CPU board and all other cables from the Development Kit box and place them on a static-free work surface. If the board shows any signs of damage during transit, please contact Eurotech Ltd before proceeding.
ZEUS Embedded Linux Development Kit Quickstart Unpacking and connecting up 8 AEL Embedded Linux on the ZEUS uses /dev/ttyS0 (COM1) as the console. Connect the supplied null-modem cable between J11 on the ZEUS ((left hand Dsub9 connector as you view the front edge) and your host PC, which should be running a terminal emulator. 9 Configure the HOST serial terminal as follows: • 115200 bit/s. • No parity. • 8 data bits. • No flow control.
ZEUS Embedded Linux Development Kit Quickstart Flat panel display Flat panel display The ZEUS board can be used to drive a whole variety of flat panels including a 6.5" NEC TFT flat panel (part number NL6448BC20-08E), as supplied in the flat panel variant of the Development Kit. For information about other flat panels supported by the ZEUS board, contact Eurotech technical support. See Appendix A - Contacting Eurotech Ltd, page 37.
ZEUS Embedded Linux Development Kit Quickstart Power supply Power supply The power supply provided in the kit is rated at 2.5A, +24V DC. This is designed to support the requirements of the ZEUS SBC, flat panel display (typically 1.5A @ 5V), as well as the wireless modem and GPS components. If additional devices are powered from the supply, please ensure that the overall current rating is not exceeded.
ZEUS Embedded Linux Development Kit Quickstart RedBoot RedBoot What is RedBoot? RedBoot is a complete bootstrap environment for embedded systems. Based on the eCos Hardware Abstraction Layer, RedBoot inherits the eCos qualities of reliability, compactness, configurability, and portability. RedBoot enables download and execution of embedded applications via serial or Ethernet, including embedded Linux and eCos applications.
ZEUS Embedded Linux Development Kit Quickstart RedBoot CPU core clock frequency and the clock command RedBoot on the ZEUS initialises the core, system bus, and memory controller clocks to 104 MHz. RedBoot provides an additional command (clock), which can be used to set the clocks to a subset of the frequencies described in section 3.5 of the PXA270 Developer’s Manual (clock implicitly sets CCCR[A], CLKCFG[B] and CLKCFG[T]).
ZEUS Embedded Linux Development Kit Quickstart AEL Embedded Linux AEL Embedded Linux What is AEL Embedded Linux? AEL Embedded Linux is a space optimised standard Linux that includes many of the standard file, shell, and text utilities. As well as the basic Linux system, the default installation includes: • OpenSSH Secure Shell. • Web server.
ZEUS Embedded Linux Development Kit Quickstart AEL Embedded Linux Setting up networking As standard, the board uses the DHCP protocol to configure the network. This requires a DHCP server to be available on your network. For details please consult your network administrator.
ZEUS Embedded Linux Development Kit Quickstart AEL Embedded Linux The file system The file system used on the on-board Flash is a compressed Journaling Flash File System (JFFS2). JFFS2 has the following advantages: • Robustness. • A power fail-safe mechanism. • No integrity scan (fsck) is required at boot time. • Flash wear levelling. • Transparent compression with a typical compression ratio of 2:1. The on-board Flash is partitioned using RedBoot FIS.
ZEUS Embedded Linux Development Kit Quickstart AEL Embedded Linux Linux kernel The version of the Linux kernel used on the ZEUS is a standard 2.6 Linux kernel tree with support for Eurotech’s boards. Source and configuration The kernel sources are installed in the host environment as /opt/arcom/src/linux-source-VERSION.tar.gz.
ZEUS Embedded Linux Development Kit Quickstart AEL Embedded Linux Wireless modem support and operation The ZEUS board can support various wireless devices such as a GSM/GPRS wireless modem, a GPS receiver, and an IEEE802.15.4 / ZigBee radio device via optional addon interface modules. The add-on modules denoted as ZEUS MODEM-1 and ZEUS MODEM-2 support different wireless modem technologies and OEM modules. Refer to the ZEUS Technical Manual for more detailed information on the individual modems supported.
ZEUS Embedded Linux Development Kit Quickstart AEL Embedded Linux Hardware and software requirements • A ZEUS MODEM-1 board fitted with the GR64 Quad band GSM/GPRS module and the supplied GSM antenna. • A SIM card from a wireless service provider that offers GPRS connections. • User name, password and Access Point Name (APN) for the GPRS service of the wireless modem service provider (MSP). This information is available on the internet or from the GPRS service provider.
ZEUS Embedded Linux Development Kit Quickstart • AEL Embedded Linux /etc/ppp/chat/gprs This is usually left unchanged, as the information provided in this file is already programmed into the SIM card. • /etc/ppp/pap-secrets Specify the user name and password for your GPRS service provider in the following format: web * password where the user name and the asterisk, and the asterisk and the password, are separated by any number of spaces or tabs.
ZEUS Embedded Linux Development Kit Quickstart AEL Embedded Linux Using PPP with ethernet If you booted the ZEUS with other interfaces active (for example eth0), you will need to use the route command to set up a static route to the IP you want to ping via the ppp0 interface (e.g. the Eurotech website IP address shown above).
ZEUS Embedded Linux Development Kit Quickstart AEL Embedded Linux Terminating the PPP connection To end the PPP connection, use the poff command: # poff gprs (alternatively use: killall –TERM pppd) To power off the modem use: # zeus-modem-off.sh Using GPS under AEL Embedded Linux For the Embedded Linux configuration, the GPS module is attached to COM7 (/dev/ttyS6). The following details show how to set up a GPS connection under AEL Embedded Linux.
ZEUS Embedded Linux Development Kit Quickstart Hardware configuration Hardware configuration Serial ports There are 7 serial ports on the ZEUS. Three ports are connected directly to the PXA270 processor and the remaining ports are provided via a quad UART.
ZEUS Embedded Linux Development Kit Quickstart PC/104 interrupt Hardware configuration ZEUS interrupt 3 160 4 161 5 162 6 163 7 164 10 165 11 166 12 167 For more information, see the section PC/104 Interface in the ZEUS Technical Manual and the PXA270 Developer’s Manual. LCD controller The LCD controller driver module (pxafb) is configured by default for the 640x480 TFT display (part number NL6448BC20-08E), which is an optional addition to the ZEUS Development Kit.
ZEUS Embedded Linux Development Kit Quickstart Hardware configuration Parameter Description Default pixclock The pixel clock, expressed in picoseconds (10-12s). This value is used in conjunction with the current memory clock rate to calculate LCCR3[PCD]. pixclock:39722 left, right, hsynclen, upper, lower and vsynclen The timing parameters. All parameters are given as a number of pixel clock ticks. The upper and lower margins should be 0 for passive (STN) displays.
ZEUS Embedded Linux Development Kit Quickstart Hardware configuration Parameter Description Default outputen Configures the polarity of the output enable signal. A value of 0 indicates an active low signal while 1 indicates active high. This parameter corresponds to the LCCR3[OEP] register. outputen:1 pixclockpol Configures the polarity of the pixel clock signal. A value of 0 indicates a falling edge while 1 indicates rising edge. This parameter corresponds to the LCCR3[PCP] register.
ZEUS Embedded Linux Development Kit Quickstart Hardware configuration The file /etc/X11/xorg.conf may not have a 320x240 display option listed so you may need to add this. It is a text file and can be edited using either the vi or nano editors that are pre-installed on the ZEUS. An example showing the required entries is shown below. Make a backup of this file before you change it.
ZEUS Embedded Linux Development Kit Quickstart Hardware configuration Touchscreen The 4/5-wire resistive touchscreen controller is integrated into the WM9712 AC’97 codec and is supported by the wm97xx-ts module. The Flat Panel Display option for the Development Kit includes a 4 wire touchscreen. Before loading the touchscreen driver, you must load the evdev module: # modprobe evdev # modprobe wm97xx-ts The wm97xx-ts module is normally loaded automatically by evdev.
ZEUS Embedded Linux Development Kit Quickstart Hardware configuration Using CompactFlash cards CompactFlash cards are auto-detected on insertion and the appropriate drivers are installed at that time. As with any storage media, you may need to umount the file system in AEL Embedded Linux first, to prevent data loss.
ZEUS Embedded Linux Development Kit Quickstart Support software Support software Target support software When building applications for ZEUS board you must use the AEL Embedded Linux host environment. This is a set of utilities that provide a cross compile environment targeting the ZEUS board. You need a cross compile environment to produce binaries that work with the libraries installed on the ZEUS. For an explanation of how to install the host environment, see the AEL Embedded Linux Technical Manual.
ZEUS Embedded Linux Development Kit Quickstart ZEUS Development Kit example programs ZEUS Development Kit example programs The Development Kit CD includes some example programs that show the use of ZEUS board. They can be found in the /examples directory in the CD. You can also use the utilities in the arcom-utils package as a reference while developing your application. This package and its source can be found in packages/arcom-utils/ directory on the CD.
ZEUS Embedded Linux Development Kit Quickstart Appendix A – Contacting Eurotech Ltd Appendix A – Contacting Eurotech Ltd Eurotech Ltd sales Eurotech Ltd’s sales team is always available to assist you in choosing the board that best meets your requirements. Eurotech Ltd 3 Clifton Court Cambridge CB1 7BN UK Tel: Fax: Email: +44 (0)1223 403410 +44 (0)1223 410457 sales@eurotech-ltd.co.uk Comprehensive information about our products is also available at our web site: www.eurotech-ltd.co.uk.
ZEUS Embedded Linux Development Kit Quickstart Index Index A D additional devices · 16 address, static IP · 19, 24 AEL Embedded Linux · 6, 19, 36 anti-static · 5 applications boot · 6 embedded · 17 audio · 10 devices, additional · 16 DHCP · 17, 19, 21, 24 display · 10 flat panel · 9 DNS · 21 documents, related · 6 domain name server · 21 download · 17 B E binaries · 36 BIOS default · 15 board diagram · 11 boot · 12 script · 6, 17 strap · 17 BOOTP · 17 embedded applications · 17 environment · 36 Et
ZEUS Embedded Linux Development Kit Quickstart Index I R image download · 17 integrated performance primitives · 36 Intel · 2, 36 PXA270 XScale RISC · 4, 11, 18, 24, 29, 30, 32 interface command line · 17 Ethernet · 10, 11, 13, 17 IP address · 19, 24 static · 21 IPP · See integrated performance primitives real time clock · 10 RedBoot · 17 FIS · 22 requirements · 9 returns · 5 ribbon cable · 13 J JFFS2 · 22 Journaling Flash File System · 22 K kernel · 6 command line · 23 Linux · 23 key · 6 kit content