Embedded Linux Made Easy Microcross GX-Linux™ Professional Embedded Linux Development Solution User Guide Version 1.0e-20051015 © 2005 Microcross, Inc. Licensed Materials MICROCROSS PRESS Powered by GNU X-Tools™, SlickEdit® & Linux OS ii ■ GX-Linux User Guide ISBN: N/A Microcross, Inc. 104 Borders Way, Suite 100, Warner Robins, GA 31088 © 2005 Microcross, Inc. All rights reserved. This document and the GX-Linux™ Embedded Linux BSP described in it are furnished under license with Microcross, and as such, may be used or copied only in accordance with the terms of the license. The contents of this document are furnished for informational purposes only and are subject to change without notice. Microcross assumes no responsibility or liability for any errors or inaccuracies that may exist in this document. No part of this document may be reproduced, stored in a retrieval system, or transmitted in any form, without the prior written consent of Microcross. Trademarks GX-Linux™, Visual X-Tools™ and GNU X-Tools™, MICROCROSS PRESS™ and Microcross® are all trademarks of Microcross, Inc.. All other brand and product names, services names, trademarks and copyrights are the property of their respective owners. This documentation contains copyright materials and has been prepared by Microcross Technical Publications; contact the Microcross Technical Publications staff for more information: [email protected]. Disclaimer Microcross, Inc. makes no representations or warranties with respect to the contents or use of this user guide, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Microcross, Inc. reserves the right to revise this publication and to make changes to its content, at any time, without obligation to notify any person or entity of such revisions or changes. Microcross, Inc. makes no representations or warranties with respect to any Microcross software, and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. Microcross, Inc. reserves the right to make changes to any and all parts of Microcross software, at any time, without any obligation to notify any person or entity of such changes. GX-Linux™ User Guide Supports Product Part Numbers: MGXL400Lx-xxx, October 2005 Printed in USA MICROCROSS PRESS GX-Linux User Guide ■ iii Table of Contents Section 1.0 Overview and System Requirements ................................................................... 7 1.1 Overview ............................................................................................................................................................. 7 1.2 Components of the GX-Linux Standard Platform ............................................................................................... 7 1.3 Components of the GX-Linux Professional Platform .......................................................................................... 8 Section 2.0 Installation and Setup............................................................................................ 9 2.1 Standard Platform Installation and Setup on a Linux Host Workstation........................................................... 10 2.2 Professional Platform Installation and Setup on a Linux Host Workstation...................................................... 13 2.3 Application Development Platform Installation and Setup on Windows Host Workstation ............................. 16 2.4 Uninstall GX-Linux ........................................................................................................................................... 17 2.5 Uninstall GNU X-Tools Toolsuite ..................................................................................................................... 17 Section 3.0 Getting Started .....................................................................................................18 3.1 Getting Started with the Standard Platform Linux Host ................................................................................... 19 3.2 Getting Started with the Professional Platform on Linux Host......................................................................... 23 3.3 Getting Started with Application Development Platform on Windows Host..................................................... 27 3.4 MicroMonitor Boot ROM Familiarity and Tips.................................................................................................. 31 3.4.1 Manual TFTP Up-Load Procedure............................................................................................................ 31 3.4.2 Other Useful MicroMonitor Commands..................................................................................................... 32 Section 4.0 Visual X-Tools Example Application Project ..................................................... 33 4.1 Hello Example Program.................................................................................................................................... 33 Section 5.0 Making Modifications to GX-Linux ..................................................................... 35 5.1 Modifying GX-Linux Standard Platform ............................................................................................................ 35 5.1.1 Building Your Own Applications ................................................................................................................ 35 5.2 Modifying GX-Linux Professional Platform ....................................................................................................... 36 5.2.1 GX-Linux BSP Components...................................................................................................................... 36 5.2.2 Building All of the Components ................................................................................................................. 36 5.2.3 Building All Components Excluding Examples ......................................................................................... 36 5.2.4 Building Your Own Applications ................................................................................................................ 36 5.3 Changing the Kernel Configuration................................................................................................................... 37 5.3.1 Configuration Files .................................................................................................................................... 37 5.3.2 Changing the Working Configuration ........................................................................................................ 37 5.3.3 Resetting the Kernel to the Default Configuration..................................................................................... 38 5.3.4 Customizing the Kernel Configuration....................................................................................................... 38 5.4 Changing the Target File System ..................................................................................................................... 38 5.4.1 Adding Content to the Target File System ................................................................................................ 38 iv ■ GX-Linux User Guide 5.5 Putting the New System on the Target Hardware ........................................................................................... 39 5.5.1 Putting the New System on the Target Hardware .................................................................................... 39 5.6 Read-Only and Read-Write File Systems......................................................................................................... 39 5.6.1 ROMFS File System ................................................................................................................................. 39 5.6.2 NFS Mounted Root Filesystem ................................................................................................................. 39 5.6.3 Writing to On-Board Flash via a Pendrive (USB)...................................................................................... 41 5.6.4 How to Prepare a Pendrive with a Root Filesystem and Work with GX-Linux ......................................... 41 5.6.5 Writing to On-Board Flash via MMC/SD Card .......................................................................................... 42 5.6.6 Writing to On-Board Flash via a Compact Flash Card.............................................................................. 42 Section 6.0 Debugging Applications ......................................................................................43 6.1 The GDB Debugger.......................................................................................................................................... 43 6.1.1 GDB Debugger.......................................................................................................................................... 43 6.1.2 gdbserver .................................................................................................................................................. 43 6.1.3 gdbserver Communications ...................................................................................................................... 43 6.1.4 Graphical Front-Ends................................................................................................................................ 43 6.1.5 Debug-able Files......................................................................................................................................