AEL Embedded Linux Technical Manual
Total Page:16
File Type:pdf, Size:1020Kb
AEL Embedded Linux Technical Manual AEL Embedded Linux Technical Manual Definitions Arcom is the trading name for Arcom Control Systems Inc. Disclaimer The information in this manual has been carefully checked and is believed to be accurate. Arcom assumes no responsibility for any infringements of patents or other rights of third parties, which may result from its use. Arcom assumes no responsibility for any inaccuracies that may be contained in this document. Arcom makes no commitment to update or keep current the information contained in this manual. Arcom reserves the right to make improvements to this document and/or product at any time and without notice. Warranty This product is supplied with a 3 year limited warranty. The product warranty covers failure of any Arcom manufactured product caused by manufacturing defects. The warranty on all third party manufactured products utilized by Arcom is limited to 1 year. Arcom will make all reasonable effort to repair the product or replace it with an identical variant. Arcom reserves the right to replace the returned product with an alternative variant or an equivalent fit, form and functional product. Delivery charges will apply to all returned products. Please check www.arcom.com/support for information about Product Return Forms. Trademarks Linux is a registered trademark of Linus Torvalds. Red Hat is a registered trademark of Red Hat, Inc. ARM and StrongARM are registered trademarks of ARM, Ltd. Intel and XScale are trademarks or registered trademarks of Intel Corporation or its subsidiaries in the United States and other countries. X Window System is a trademark of X Consortium Inc. All other trademarks and copyrights referred to are the property of their respective owners. This product includes software developed by the University of California, Berkeley and its contributors. Revision history Manual PCB Date Comments Issue A 12th July 2002 Combined Quickstart and Technical Manual. Issue B 8th July 2003 Minor editorial changes Issue C 3rd February 2004 Major changes for V3I5 Development Kit. Issue D 14th June 2004 Minor changes for V316 Development Kit. Issue E 3rd August 2004 Major updates and layout changes. Issue F 4th May 2005 Updates for V4I1. Issue G 22nd March 2006 Updates for V4I2. Issue H 15th September 2006 Updates for V4I2b. Issue I 16th October 2007 Minor updates. © 2007 Arcom Control Systems Inc. For contact details, see page 65. AEL Embedded Linux Technical Manual Contents Contents Introduction ........................................................................................................................................5 Licensing AEL Embedded Linux components........................................................................6 Handling your board safely ....................................................................................................6 About this manual ..............................................................................................................................7 Related documents ................................................................................................................7 Specific terms.........................................................................................................................8 Conventions...........................................................................................................................8 Development Kit CD contents..........................................................................................................10 File system layout ............................................................................................................................11 Journaling Flash file system.................................................................................................11 RAM file system...................................................................................................................12 Configuring AEL Embedded Linux...................................................................................................13 Default passwords ...............................................................................................................13 Keyboard mapping...............................................................................................................13 Serial port configuration.......................................................................................................13 System startup scripts..........................................................................................................16 Making an application run automatically at boot ..................................................................17 Network configuration ..........................................................................................................17 Wireless network configuration ............................................................................................20 Configuring and loading kernel modules..............................................................................21 System recovery and single user mode...............................................................................22 Calibrating touchscreens .....................................................................................................23 Secure Shell (SSH)..........................................................................................................................24 Introduction to SSH..............................................................................................................24 Using SSH commands.........................................................................................................25 Public key authentication methods ......................................................................................27 Further information about SSH ............................................................................................28 Package management .....................................................................................................................29 Removing packages ............................................................................................................29 Adding packages .................................................................................................................29 The X Window System.....................................................................................................................30 Window manager.................................................................................................................30 Using a touchscreen ............................................................................................................30 Developing software for AEL Embedded Linux................................................................................31 Host system requirements ...................................................................................................31 Installing the AEL Embedded Linux host environment.........................................................34 Installing additional packages into the host environment.....................................................35 Obtaining help......................................................................................................................36 Cross compiling applications and libraries...........................................................................36 Cross compilation example..................................................................................................40 Debugging applications on the target ..................................................................................42 Compiling a kernel ...............................................................................................................44 Common embedded software development tasks...............................................................47 © 2007 Arcom Issue I 3 AEL Embedded Linux Technical Manual Contents RedBoot ...........................................................................................................................................55 The RedBoot command line ................................................................................................55 Configuring and using RedBoot ...........................................................................................55 Loading images into RAM....................................................................................................57 Managing images in Flash...................................................................................................60 Executing an image .............................................................................................................63 Appendix A - Contacting Arcom .......................................................................................................65 Appendix B - Software sources........................................................................................................66 Appendix C - Reference information................................................................................................67 Appendix D - Acronyms and abbreviations ......................................................................................68 Index ................................................................................................................................................69 © 2007 Arcom Issue I