Page 1
VIPER / VIPER-Lite AEL Embedded Linux Development Kit Quickstart Manual...
Page 2
Fedora Core Linux distribution. This media is not a product of Red Hat, Inc. or the Fedora project and is not endorsed by Red Hat, Inc. or the Fedora project. It is a product of Eurotech Ltd and we have no relationship with Red Hat, Inc.
VIPER / VIPER-Lite AEL Embedded Linux Dev. Kit Quickstart Contents Contents Introduction ............................4 Handling your board safely ....................4 About this manual ..........................5 Related documents ........................5 Conventions ...........................6 Getting started ...........................7 What’s in the kit?........................7 What else do I need? ......................8 What peripherals are supported?...................9...
Real time clock (RTC). • Multiple serial ports. The VIPER / VIPER-Lite board offers many features that make it ideal for power- sensitive embedded communications and multimedia applications. The AEL Embedded Linux Development Kit provides a ready-to-run platform for Linux application development and deployment.
Embedded Linux. It lists the items you should find in your kit, and tells you how to unpack, connect and configure the board. AEL Embedded Linux for VIPER / VIPER-Lite is based on the standard v2.6 kernel and includes the essential features for embedded communication and display solutions.
Caution - proceeding with a course of action may damage your equipment or result in loss of data. Indicates that a feature is not available on the standard VIPER-Lite configuration. Eurotech Ltd can provide custom configurations (subject to a minimum order quantity) for the VIPER-Lite populated with this feature.
What’s in the kit? The VIPER / VIPER-Lite Development Kit includes: • VIPER-M64-F32, VIPERL-M64-F32 or VIPERL-M64-F16. • Optional GPIO based VIPER-I/O board (technical manual included on CD)*. • Standard serial port breakout cable (up to five ports). • RS-232 serial cable (2m).
In addition, the following information and equipment may be useful: • Networking details for the VIPER. If your network does not have a DHCP server, ask your network or system administrator for the following: - IP address and subnet mask (netmask).
This section guides you, step-by-step, through the process of connecting up the VIPER / VIPER-Lite for the first time and powering up the system. The VIPER / VIPER-Lite is delivered ready to run. There are no link settings or configuration switches that need to be adjusted for the board to operate.
Page 11
For all connections, the red wire on the cable is pin 1. Pin 1 on each connector is marked on the board. The VIPER I/O board can be attached above the main VIPER / VIPER-Lite board once all connections to the main board are complete.
Page 12
8 data bits. • No handshaking. Switch on the VIPER / VIPER-Lite board once the terminal emulator is set up on the host PC. The Linux operating system is loaded from the on-board Flash memory, and the board displays a Linux prompt. For a description of AEL Embedded Linux see page 16 of the Technical Manual, which is in the /manuals/ folder on the Development Kit Such as ‘minicom’...
The AC Power Supply Unit (PSU) supplied in the kit is rated at 4A @ +5V DC. This is designed to support the requirements of the VIPER / VIPER-Lite and VIPER-I/O. If additional devices are powered from this supply, ensure that the overall current rating is not exceeded.
Reference Manual, which is in the /manuals/ folder on the Development Kit CD. Default boot script The default boot script on the VIPER / VIPER-Lite is configured to load a Linux kernel from the JFFS2 file system and execute it. The default boot script for VIPER-Lite is as follows: clock –l 27 –m 2 –n 10...
Page 15
RedBoot The only difference is that the default boot script initialises the clock to 400MHz for VIPER and to 200MHz for VIPER-Lite. Refer to following section for more details on ‘clock’ command. %{FREEMEMLO} is a predefined alias for the lowest address of available memory.
Starting OpenBSD Secure Shell Server: sshd. Starting periodic command scheduler: cron. Arcom Embedded Linux (ttyS0) viper login: Logging in You can login to the VIPER / VIPER-Lite as root (the superuser or administrator) using the following details: Login name: root Default password: arcom...
DHCP server to be available on your network. For more information, please consult your network administrator. To configure the VIPER / VIPER-Lite to use a static IP address, follow these steps: Log in to the VIPER / VIPER-Lite by entering the following log in details:...
VIPER / VIPER-Lite AEL Embedded Linux Dev. Kit Quickstart AEL Embedded Linux The file system The file system used on the VIPER / VIPER-Lite Flash memory is a compressed Journaling Flash File System (JFFS2). JFFS2 has the following advantages: •...
VIPER / VIPER-Lite AEL Embedded Linux Dev. Kit Quickstart AEL Embedded Linux Linux kernel The version of the Linux kernel used on the VIPER / VIPER-Lite is a standard Linux 2.6 kernel tree with patches to provide support for Eurotech Ltd’s boards. Source and configuration The kernel sources are installed in the host environment as /opt/arcom/src/linux- source-VERSION.tar.gz.
AEL Embedded Linux Hardware configuration PC/104 bus The PC/104 bus on the standard VIPER option is implemented via the second PCMCIA controller built into the PXA255 processor. The PC/104 I/O address space is mapped at physical address 0x30000000 and virtual address 0xF1000000.
Page 22
AEL Embedded Linux CPU clock frequency scaling The PXA255 processor used on the VIPER / VIPER-Lite can scale the core clock frequency from 100 to 400MHz, allowing an application to dynamically trade off performance against power consumption. This functionality is exposed in Linux via special files in the /sys system.
Page 23
VIPER / VIPER-Lite AEL Embedded Linux Dev. Kit Quickstart AEL Embedded Linux The default on the VIPER is to use the performance governor with a maximum frequency of 400MHz. The maximum frequency on the VIPER-Lite is limited to 200MHz by passing a command line parameter to the Linux kernel. Please refer to the...
Page 25
The driver module should be loaded using the normal modprobe command: # modprobe pxafb This Development Kit is supplied with a VIPER FPIF-CRT interface module. For best results the display controller can be configured for 640x480-16 VGA mode using: modprobe pxafb options=mode:640x480-16 Correspondingly the Screen section from /etc/X11/xorg.conf file needs to be modified...
Page 26
VIPER / VIPER-Lite AEL Embedded Linux Dev. Kit Quickstart AEL Embedded Linux Parameter Description Default The pixel clock, expressed in picoseconds (10 pixclock:157500 pixclock This value is used in conjunction with the current memory clock rate to calculate LCCR3[PCD]. left, right, The timing parameters.
Page 27
VIPER / VIPER-Lite AEL Embedded Linux Dev. Kit Quickstart AEL Embedded Linux Parameter Description Default Configures the polarity of the output enable signal. outputen:1 outputen A value of 0 indicates an active low signal while 1 indicates active high. This parameter corresponds to the LCCR3[OEP] register.
Software configuration Software configuration If you are using a VIPER-Lite you need to carry out some additional configuration. This primarily involves informing the Linux kernel of the reduced CPU speed. The VIPER-Lite is a reduced power VIPER derivative based around the 200MHz PXA255 processor.
The Development Kit includes an example program, which demonstrates how to use the VIPER I/O board. This can be found in examples/c/ directory on the CD. It demonstrates how to access and manipulate many of the capabilities provided by the VIPER I/O board.
Target support software Target support software When building applications for the VIPER / VIPER-Lite board, you must use the AEL Embedded Linux host environment. This consists of a set of utilities that provide a cross-compile environment targeting the VIPER / VIPER-Lite board. A cross-compile environment is required in order to produce binaries for the XScale processor.
VIPER / VIPER-Lite AEL Embedded Linux Dev. 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...
Need help?
Do you have a question about the VIPER and is the answer not in the manual?
Questions and answers