# aTCA-6100/6150

# Wind River Linux

# Board Support Package

User's Manual

Manual Rev.: 1.00

Revision Date: June 2, 2011

Part No.: 50-1G013-2000

![The image displays a red logo resembling a stylized letter 'A' or an upward-pointing triangle with a concave bottom edge. Three horizontal white stripes traverse the middle section. A small registered trademark symbol (®) appears in the bottom right corner.](.atca-6100-6150-bsp-50-1g013-2000-100-en/8fa4d46c5cd6710ec807f539cb7650bd9494bf8bc51577cba3ee69cb60cb5d6b.jpg)

ADLINK

TECHNOLOGY INC.

Copyright © 2011 ADLINK Technology, Inc. All Rights Reserved.

This document contains proprietary information protected by copyright laws. All rights are reserved. No part of this manual may be reproduced by any mechanical, electronic, or other means in any form without prior written permission of the manufacturer.

This document is provided for informational purposes only. The manufacturer makes no representations or warranties with respect to the contents or use of this manual and specifically disclaims any express or implied warranties of merchantability or fitness for any particular purpose. The user will assume the entire risk of the use or the results of the use of this document. Further, the manufacturer reserves the right to revise this publication and make changes to its contents at any time, without obligation to notify any person or entity of such revisions or changes.

In no event will the manufacturer be liable for direct, indirect, special, incidental, or consequential damages arising out of the use or inability to use the product or documentation, even if advised of the possibility of such damages.

# Trademarks

Wind River Linux is a registered trademark of Wind River Systems, Inc. PC is a registered trademark of International Business Machines Corporation. Intel is a registered trademark of Intel Corporation. Other product names mentioned herein are used for identification purposes only and may be trademarks and/or registered trademarks of their respective companies.

Revision History

<table><tr><td>Release</td><td>Date</td><td>Supported BSP</td><td>Change</td></tr><tr><td>1.00</td><td>6/2/2011</td><td>Wind River Linux 3.0.2 BSP</td><td>Initial release</td></tr></table>

# Table of Contents

1. Introduction...... . 5
2. Development Environment ..... . 5
3. Building the BSP .. 6
4. Rebuilding the Kernel and RootFS . .. 12
5. Installing the Grub and Image ..... . 14

# 1. Introduction

This manual gives developers of the ADLINK aTCA-6100/6150 blade a simple tutorial on how to configure the Wind River Linux development environment, install the BSP, boot the system, and rebuild the kernel.

# 2. Development Environment

This development environment described in this tutorial consists of the host system and the target aTCA-6100/6150 blade.

# Host Software Requirements

The required software is as follows:

．Fedora 9 x86 64-bit
．Wind River Linux 3.0.2 with Workbench 3.2
．Project settings tar file downloaded from the ADLINK website
．A serial console program such as minicom (Linux) or HyperTerminal (Windows)

# Hardware Requirements

The following hardware setup is required for the development environment:

．An empty USB drive inserted into the host to store the BSP image
．A target aTCA-6100/6150 blade inserted into the system slot of the ATCA shelf
．COM1 of the aTCA-6100/6150 connected to the host at a baud rate of 115200 bps

# 3. Building the BSP

To build the BSP, perform the following steps:

1) Open Workbench on the host system.
2) Select the "File" tab.
3) Select the "New" button.
4) Select the "Project" button.
5) under "Wind River Linux", select "Wind River Linux Platform Project" and click "Next".

![New Project\nSelect a wizard\nCreates a new Wind River Linux platform project for a specific build spec\nWizards:\ntype filter text\nWind River Workbench Project\nGeneral\nCVS\nDesktop\nWind River Linux\nWind River Linux Application Project\nWind River Linux Kernel Module Project\nWind River Linux Platform Project\nWind River Linux User-Defined Project\nExamples\nShow All Wizards.\n( Back	Next )	Cancel	Finish](.atca-6100-6150-bsp-50-1g013-2000-100-en/d53d47baa40c8f51b827f81ef4d14516983595f7152cb248523e587706503bf6.jpg)

6) Enter a project name (e.g. "aTCA-6100\_bl") and click "Next".

![New Wind River Linux Platform Project\nProject\nCreate a new Wind River Linux platform project for a specific build spec.\nProject name: aTCA_6100bl\nLocation\n● Create project in workspace\n○ Create project at external location\nDirectory: /home/pms1234/WindRiver/workspace/aTCA_6100\nBrowse...\n( Back	Next )	Cancel	Finish](.atca-6100-6150-bsp-50-1g013-2000-100-en/0ecafd292a302c2edb50877b8b9725508e1c316c6b1d2689e11defd208556734.jpg)

7) Specify the Linux configuration options.

Board: Intel\_5500\_server

RootFS: glibc\_std

Kernel: standard

Click the "Advanced" button to reveal the Additional configure options.

![New Wind River Linux Platform Project\nConfigure Options\nSpecify the Linux configure options.\nGeneral settings\nBoard: intel_5500_server\nRootFS: glibc_std\nKernel: standard\nBuild spec: intel_5500_server-glibc_std\n(( Advanced\nAdditional configure options\nLayers:\nAdd...\nRemove\nUp\nDown\nReload\nTemplates and Profiles:\nTemplate...\nProfile...\nRemove\nUp\nDown\nDefaults See 'Layers and Sysroots' preferences\nOption Value\nAdd...\nRemove\nConfigure approved](.atca-6100-6150-bsp-50-1g013-2000-100-en/f3790251c337dac360319060e2eaf66cc5b6b1ae63e08ef18acfbacf4dc1a0ba.jpg)

8) Download the project settings file from the ADLINK website

(6100\_test\_prj.Fri\_Apr\_29\_004807\_CST\_2011.tar) and untar it to a temporary directory (e.g. "/home/user/temp").

Under Additional configure options, click the "Add" button and navigate to the directory "/home/user/temp/6100\_test\_prj.Fri\_Apr\_29\_004807\_CST\_2011".

Click "Reload" to import the required settings into the project.

![New Wind River Linux Platform Project\nConfigure Options\nPress 'Reload' to update the configuration data\nGeneral settings\nBoard: intel_5500_server\nRootFS: glibc_std\nKernel: standard\nBuild spec: intel_5500_server-glibc_std\n(( Advanced\nAdditional configure options\nLayers:\n/home/pms1234/temp/6100_test_prj.Fri_Apr_29_0\nAdd...\nRemove\nUp\nDown\nReload\nTemplates and Profiles:\nTemplate...\nProfile...\nRemove\nUp\nDown\nDefaults See 'Layers and Sysroots' preferences\nOption Value Add...\nRemove\nConfigure command\n/home/pms1234/WindRiver/wrlinux-3.0/wrlinux/configure --enable-board=intel_5500_server --enable-rootfs=glibc_std --enable-kernel=standard --enable-build=production --with-layer=/home/pms1234/temp/6100_test_prj.Fri_Apr_29_004807_CST_2011\n( Back Next ) Cancel Finish](.atca-6100-6150-bsp-50-1g013-2000-100-en/297e03568343360839e7601b9d75172e8b3dcf73ad20bbf68b39f6f36edeebca.jpg)

9) Click "Next" and then click "Finish".

10) In Project Explorer, select the project you just created and double-click "Kernel Configuration". Press "Yes" to extract the kernel source (this may take a few minutes). Click "OK" when prompted with "Can not find kernel source! Would you like to extract the kernel source now?" When the kernel source has been extracted, the screen will appear as below.

![Basic Device Development - /aTCA_6100bl - Wind River Workbench\nFile Edit Source Refactor Navigate Search Project Run Window Help\nProject Explorer\n creation.log\naTCA_6100bl\nConfiguration\nLinux Kernel Configuration for x86\nOption Name y/n/m\n64-bit kernel 64BIT y\nGeneral setup\nPersistent Memory Support\nEnable loadable module support MODULES y\nEnable the block layer BLOCK y\nProcessor type and features\nPower management options\nBus options (PCI etc.)\nExecutable file formats / Emulations\nDisabling of NMI during system operation APIC_NMI_DISABLING n\nNetworking support NET y\nDevice Drivers\nGeneric Driver Options\nConnector - unified userspace (-) kernelspace linker CONNECTOR y\nMemory Technology Device (MTD) support MTD y\nParallel port support PARPORT y\nPlug and Play support PNP y\nBlock devices BLK_DEV y\nhello_Linux (Wind River Linux Platform)\nRemote Systems](.atca-6100-6150-bsp-50-1g013-2000-100-en/9858fa2349a81d619ded44b7080658f746d658934bd297a0d44dba04d67b40f0.jpg)

11) R-click on the project in Project Explorer and click on "Build Project". This step will build the corresponding kernel, root file system and cross-compiler and only needs to be performed once. Building the project may over an hour, depending on your hardware.

![Basic Device Development - /aTCA_6100_bl\nFile Edit Source Refactor Navigate Search Project Run Window Help\nProject Explorer\ncreation.log aTCA_6100_bl\nNew\nGo Into\nCopy Ctrl+C\nPaste Ctrl+V\nDelete Delete\nRename F2\nMove...\nAttributes )\nImport...\nExport...\nProject Development Setup...\nOpen Wind River Linux Platform 3.0 Development Shell\nBuild Project Shift+Ctrl+A\nRebuild Project\nBuild Options )\nRefresh F5\nClose Project\nClose Unrelated Projects\nProject References )\nValidate\nAb3DSP (Wind)\nAB3DSP_cgl (W)\naTCA_6100 (Wi)\naTCA_6100_bl\nKernel Confi\nUser Space\nbuild-all\nexport-sysr\nfs\nkernel_build\nkernel_rebu\nIncludes\nREADMES\nconfig.log\ncreation.log\nRemote Systems](.atca-6100-6150-bsp-50-1g013-2000-100-en/9f76ddda98017f8f7e32bbc01f31dbf045a1ff9e5830dea3bb7431f4338bcfc4.jpg)

12) After building has completed, the kernel and root file system will be in the directory “/home/user/WindRiver/workspace/aTCA\_6100bl\_prj/export”

# 4. Rebuilding the Kernel and RootFS

To rebuild the kernel and rootfs, follow the steps below:

1) In Project Explorer, select your project, R-click on "kernel-rebuild", and then click "Build Target".

![Basic Device Development - /aTCA_6100_bl - Win\nFile Edit Source Refactor Navigate Search Project Run Window Help\nProject Explorer\n creation.log aTCA_6100_bl\nConfiguration\nLinux Kernel Configuration for x86\nOption\n64-bit kernel\nGeneral setup\nPersistent Memory Support\nEnable loadable module support\nEnable the block layer\nProcessor type and features\nPower management options\nBus options (PCI etc.)\nCopy Ctrl+C\nPaste Ctrl+V\nRename F2\nMove...\nDelete Delete\nOpen Wind River Linux Platform 3.0 Development Shell\nBuild Target\nBuild Project Shift+Ctrl+A\nRebuild Project\nBuild Options](.atca-6100-6150-bsp-50-1g013-2000-100-en/65c2d635852ce3c087703fdae72b383ee7b2e725fd95243ebfde99e6fddc1858.jpg)

2) In Project Explorer, select your project, R-click on "fs", and then click "Build Target".

![Basic Device Development - /aTCA_6100_bl - Wind\nFile Edit Source Refactor Navigate Search Project Run Window Help\nProject Explorer\n creation.log aTCA_6100_bl\nConfiguration\nLinux Kernel Configuration for x86\nOption Name\nY 64-bit kernel 64BIT\nGeneral setup\nPersistent Memory Support\nEnable loadable module support MODU\nEnable the block layer BLOCK\nProcessor type and features\nfs\nkernel_build\nkernel_rebuild\nIncludes\nREADMES\nconfig.log\ncreation.log\nCopy Ctrl+C\nPaste Ctrl+V\nRename F2\nMove...\nDelete Delete\nOpen Wind River Linux Platform 3.0 Development Shell\nBuild Target\nBuild Project Shift+Ctrl+A\nRebuild Project\nBuild Options )\nProperties Alt+Enter\nRemote Systems](.atca-6100-6150-bsp-50-1g013-2000-100-en/cd8ff2b0e99f925b5af98147406049fb1d0d393b0a3fec384e544b97bfd6d99d.jpg)

3) After building has completed, the kernel and root file system will be in the directory "\$WIND\_BASE\workspace\aTCA\_6100bl\_prj\export"

# 5. Installing the Grub and Image

The BSP package provides a default Wind River Linux setting. After creating and building the kernel and rootfs by the methods described in the previous section, follow the procedure below to create a boot disk and boot the aTCA-6100/6150 blade.

1) Format the USB drive to an ext2 file system.
2) Mount the USB drive to a local directory.
3) Untar the rootfs to the USB drive. (assume that the USB drive is mounted at /v) tar –jxvf intel\_5500\_server-glibc\_std-standard-dist.tar.bz2 –C /v
4) Copy the kernel to USB drive. cp –H intel\_5500\_server-bzImage-WR3.0.2ax\_standard /v/boot/bzImage
5) Install the grub to the USB drive grub-install --root-directory=/v /dev/sdb
6) Modify the grub menu file as follows (/v/boot/grub/menu.lst) serial --unit=0 --speed=115200 --word=8 --parity=no --stop=1 terminal --timeout=10 serial console default 0 timeout 3 #hiddenmenu Title Wind River Linux 3.0 for Intel 5500 Workstation root (hd0,0) Kernel /boot/bzImage ro root=/dev/sda1 console=ttyS0,115200n8 rootdelay=10 quiet
7) Unmount the USB drive
8) Insert the USB drive into the USB interface on the aTCA-6100/6150 blade. This drive should be configured as a master device in the BIOS of the aTCA-6100/6150 blade.
9) Connect the host serial port to the target aTCA-6100/6150 blade and then initiate a serial connection with a serial console application from the host to COM1 of the aTCA-6100/6150 with a baud rate of 115200 bps.
10) Power on the blade, wait for the boot loader prompt, then continue to load the image.
11) The aTCA-6100/6150 blade will then boot into Wind River Linux.
[🔗 Link to the original document](.atca-6100-6150-bsp-50-1g013-2000-100-en/atca-6100-6150-bsp-50-1g013-2000-100-en.pdf)