Home » Support » Software » Search » BSP-WES7-LUNA-R1.00 » ReadMe

ReadMe: BSP-WES7-LUNA-R1.00

Windows Embedded Standard 7 (WES7) BSP for the Intel Luna Pier (Atom D425/D525) Platform

Boards Supported Iguana (VL-EPIC-25)
Expansion Modules Supported EPM-NET-100
PCM-225-1
PCM-3640
VL-EPM-E2
VL-EPMs-E1
VL-EPMs-U1
OS Version Windows Embedded Standard 7 (SP1 Build 7601)
IDE/Platform Image Configuration Editor (ICE)
ICE Version 1.1.0222.0
LUNA Intel Luna Pier (Atom D425/D525) Platform
Quick Login Instructions
Admin
User Administrator
Password Administrator
User
User user
Password user

Warning!By default, the Administrator ID is disabled. To enable it, you must log on as a user and in a command prompt issue the command:

net user administrator /active:yes

HelpIf you are new to Windows Embedded Standard 7, we highly recommend reviewing the "Migration to WES7 in Embedded Applications" white paper [1].

TABLE OF CONTENTS

  1. Legal Disclaimer
  2. Purpose
  3. Package Contents
  4. Prerequisites
  5. Hardware Tested
  6. Build Instructions (Advanced Method)
  7. Quick Prototype (Express Method)
  8. USB Installation
  9. Expansion Modules
  10. Important Notes
  11. Known Issues
  12. References

1.0 LEGAL DISCLAIMER

VersaLogic is making no claims of usability, efficacy or warranty. Information in this document is provided in connection with VersaLogic products. No license, express or implied, by estoppel or otherwise, to any intellectual property rights is granted by this document. VersaLogic assumes no liability whatsoever, and VersaLogic disclaims any express or implied warranty relating to the sale and/or use of VersaLogic products, including liability or warranties relating to fitness for a particular purpose, merchantability or infringement of any patent, copyright or other intellectual property right. VersaLogic products are not intended for use in life-saving or life-sustaining applications.

VersaLogic disclaims all warranties and liabilities for the use of this document and the information contained herein, and assumes no responsibility for any errors which may appear in this document, nor does VersaLogic make a commitment to update the information contained herein. VersaLogic reserves the right to make changes to this document at any time without notice.

2.0 PURPOSE

This package contains Windows Embedded Standard 7 (WES7) support files for use with VersaLogic's Iguana (VL-EPIC-25) embedded computer.

3.0 PACKAGE CONTENTS

The BSP-WES7-LUNA zip file contains the following items:

  1. WES7Data\LunaPier\: This folder contains the TAP files for the board(s) supported by this package:
    →TapFiles\EPIC-25\EPIC-25.pmq
  2. WES7Data\LunaPier\: This folder contains the ICE project file AutoUnattend.xml. This file can be loaded into ICE (Image Configuration Editor) to generate WES7 images that can then be copied to the target device:
    →ProjectFiles\AutoUnattend.xml

    HelpSee Section 6.0 for more details.

  3. WES7Data\LunaPier\Images: This folder will contain your target device setup/installation files created by ICE. These are just empty sample folders. You can choose any folder/path to use based on the media you will be using to install WES7:
    →IBWImage
    →ISO
  4. WES7Data\Utils: This folder contains utilities to create a bootable USB Flash Drive (UFD) and bootable DVDs which can be used to install a WES7 (SP1) image on your target device:
    →make-ufd.bat
    →make-iso.bat
  5. Program Files\Windows Embedded Standard 7\DSSP1\: This folder contains all of the drivers not natively supported by the WES7 (SP1) Distribution Share (DS):
    1. Drivers for on-board IDT audio codec (setup.exe method), scripts and utilities to install drivers and set background images:
      →$OEM$\Custom Files\$OEM$\$1\LunaPier\Drivers\Audio\IDTCodec
      →$OEM$\Custom Files\$OEM$\$1\Images\Background
      →$OEM$\Custom Files\$OEM$\$1\Images\Logo
      →$OEM$\Custom Files\$OEM$\$1\Images\Wallpaper
    2. Drivers for add-on cards (non-CPU):
      →3rdParty\Ethernet
    All of the above drivers are configured to be included in your WES7 image if you use the sample project file supplied in this package.
  6. $OEM$ Folders: These folders contain some background images, logos and wallpapers:
    →Custom Files\$OEM$\$1\Images\Background
    →Custom Files\$OEM$\$1\Images\Logo
    →Custom Files\$OEM$\$1\Images\Wallpaper
  7. C:\LunaPier\README_BSP-WES7-LUNA-R1.00.txt: The ReadMe text file for BSP-WES7-LUNA-R1.00.
  8. C:\LunaPier\CHANGELOG_BSP-WES7-LUNA.txt: A brief history and summary of the version releases for this package.

4.0 PREREQUISITES

In order to build the image, you first need to set up your development environment as follows:

Host (Development Machine)

  1. 1 GHz (min.) processor with Windows 7/Vista installed
  2. 1 GB RAM (min.)
  3. Image Configuration Editor (ICE) installed using the WES7 (SP1) Toolkit DVD
  4. 7 GB (min.) of free hard drive space (depends upon the packages that you select to include in your image) on the development computer

Target (Embedded CPU Board)

  1. USB keyboard and mouse
  2. Target boot media (4 GB min.)
    1. PATA device - Hard drive/DOM
    2. -- or --

    3. USB device - Hard drive or Jump drive
  3. Installation media
    1. USB flash drive (2 GB min.)
    2. -- or --

    3. DVD drive and DVD-ROM
  4. Display device
    1. VGA monitor
    2. -- or --

    3. Flat Panel Display (FPD)

5.0 HARDWARE TESTED

  1. Mouse/keyboard
  2. Video (VGA and LVDS up to 1280 x 800 resolution)
  3. Ethernet
  4. PATA hard drives and CD/DVD-ROM
  5. Serial ports (8,N,1@115200 bps)
  6. USB 2.0 devices - flash drives, hard drives, CD/DVD-ROM
  7. Audio (if applicable)

6.0 BUILD INSTRUCTIONS (Advanced Method)

Following is an overview of the steps required to build a WES7 image from the contents of this package:

Warning!We are assuming (and it is highly recommended) that you install WES7 (SP1) development tools at their default location specified by the setup program, which is:

C:\Program Files\Windows Embedded Standard 7

If this is not the case, you will need to substitute the proper path as per your customized setup in step (a) below.

  1. Unzip Package: With an Administrator-type account, unzip the supplied zip package (BSP-WES7-LUNA-R1.00.zip) directly to the root of your C:\ directory and NOT to C:\BSP-WES7-LUNA-R1.00. Using the application WinRar is recommended.
  2. Launch ICE: From your development system, launch ICE by going to Start→All Programs→Windows Embedded Standard 7→Image Configuration Editor.
  3. Select DSSP1: Most likely this should be set up automatically to 32-bit for you if you only installed the 32-bit DSSP1.
  4. Load Answer File: Go to File→Open Answer file and browse to the AutoUnattend.xml file [see Section 3.0.2]. Optionally, you can create your own Answer file by first importing the TAP file [see Section 3.0.1].
  5. Customize: You can now customize the Answer file if you have custom hardware or you want your image to behave in a specific way.
  6. Validate: Now validate your Answer file by going to Validate→Validate Only. Add any packages that are missing and re-validate your Answer file until there are no errors.
  7. Generate Setup/Installation Files: Go to Tools→Create Media→Create IBW Image From Answer File and select a target folder where the setup files will be copied. You can select the existing IBWImage folder [see Section 3.0.3].
  8. Prepare Installation Media: There are two options at this point:
    1. You can create a bootable USB Flash Drive (UFD), which will act as your installation media
    2. -- or --

    3. Create a bootable ISO image, which you can then burn to a DVD and install from

    UFD Method

    There is an inherent risk of formatting your data if you use the following script, since your computer setup may be different. If you would not like to run the script, you can perform the script's tasks manually by running appropriate programs like Disk Management and Copy/Paste commands.
    1. Attach a USB flash drive on your Windows 7/Vista development workstation. Make sure that there is NO other USB device connected to your system, otherwise you might LOSE all of your data!
    2. (Optional) Launch the Windows PE Tools Command Prompt by going to Start→All Programs→Windows Embedded Standard 7→Windows PE Tools Command Prompt.
    3. Execute the following command [see Section 3.0.4] at the command prompt:
      C:\WES7Data\Utils\make_ufd.bat
      This will format your UFD, make it WES7 bootable and assign it the drive letter U:\. If you are already using this drive letter, you need to edit the script and specify the appropriate drive letter by setting the variable ufd_root. Next, it will copy the contents from C:\WES7Data\LunaPier\Images\IBWImage to the root (U:\) of your USB drive.
    For more details on creating USB installation media, please refer to [2].

    DVD ISO Method

    1. Insert a blank DVD into your development system's CD/DVD-ROM drive.
    2. Launch the Windows PE Tools Command Prompt by going to Start→All Programs→Windows Embedded Standard 7→Windows PE Tools Command Prompt.
    3. Execute the following command [see Section 3.0.4] at the command prompt:
      C:\WES7Data\Utils\make_iso.bat
    4. Now burn the ISO image generated (as a result of the above step) in the following folder on your DVD:
      C:\WES7Data\LunaPier\Images\ISO\LunaPier.iso
    For more details on creating a bootable CD/DVD installation disc, please refer to [3].
  9. Install on Target Device: Now boot your bootable UFD or bootable DVD-ROM on your target device and the unattended installation will automatically start. You need to have your target media (i.e., SATA/IDE hard drive or another USB hard drive) on which WES7 will be installed attached to your target device. See Section 8.0 if you are installing WES7 on a USB device (target media).

    If everything goes well, you will see a WES7 desktop in approximately 30–45 minutes.

7.0 QUICK PROTOTYPE (EXPRESS METHOD)

A separate ISO image (BSP-WES7-LUNA-R1.00-Express.iso) is available via the download section of this package. This ISO image can be used to burn a bootable DVD. When a target board is booted using this DVD, it will install WES7 automatically in an unattended mode. This method is only recommended if you want to demonstrate a quick prototype of WES7. You can download the ISO image from:

https://www.versalogic.com/software/Software_Download.asp?s=71

Warning!If you use the uanttended project file and/or ISO image supplied by us, they will WIPE the entire contents of your target media. It will create an NTFS single partition (with maximum size) automatically without prompting. You have been warned!

8.0 USB INSTALLATION

The contents of this package support installation of WES7 on a USB device. However, there are certain important points that need to be considered:

  1. The Auto-Unattended installation method just looks for the first USB device (target media) on your system and will install on it without any prompts. We highly recommend only attaching to your target system the USB device (target media) on which you will be installing WES7.
  2. Make sure that this device is seen by the BIOS as USB Hard Drive 0. If not, try plugging the USB device (target media) into different USB slots until this device is assigned as USB Hard Drive 0 in the BIOS and your bootable UFD (installation media) is seen as USB Hard Drive 1.
  3. Also, make sure that your USB device (target media) is listed/declared in the BIOS BBS 4, otherwise the Windows partition manager won't be able to see your USB device and your installation will fail. You don't need to list your bootable UFD (installation media) in the BBS.

9.0 EXPANSION MODULES

  1. Drivers for the EPM-NET-100 and VL-EPM-E2 are included in this package. See Section 3.0.5(c).
  2. Drivers for the VL-EPMs-E1 and PCM-225-1 are included in the default WES7 (SP1) DS. Typical drivers for some popular PC Card and CardBus adapters are included in this package. See Section 3.0.5(c).
  3. The VL-EPMs-U1 and PCM-3640 are serial port cards and do not require additional drivers. To configure and use these serial ports, please see Section 7 at [5]. These settings are for Windows XP Embedded, but they should work for WES7, too.

10.0 IMPORTANT NOTES

  1. WES7 packages have long file names, therefore you need to be careful while copying WES7 installation files from a network share or a local computer to a location which has a long path name. The maximum path name limitation is 255 characters.
  2. The final installation size of the image (created using the supplied project file) is approximately 2 GB, including all the drivers. However, the target boot media should have at least 3 to 4 GB of free space available for installation because WES7 needs extra space to copy and expand the compressed packages.
  3. If you would like to free some additional disk space, once the installation finishes and all drivers are working fine, simply delete the driver folders located at C:\LunaPier\Drivers.
  4. (If applicable) To enable the Audio Input recording function:
    1. Go to Start→Control Panel→Hardware and Sound→Sound and click on the Recording tab.
    2. Right-click the Microphone device and select Properties.
    3. Click on the Listen tab and check the box Listen to this device and then click Apply.

11.0 KNOWN ISSUES

  1. IRQ sharing for on-board serial ports does not work under Windows 7. Make sure each serial port is assigned a unique IRQ.
  2. Some CompactFlash cards utilizing PIO mode behave unpredictably under Windows 7—please use CompactFlash cards capable of utilizing UDMA mode to avoid this.

12.0 REFERENCES

[1] https://versalogic.com/mediacenter/whitepapers/wp_wes7_migration.asp

[2] http://msdn.microsoft.com/en-us/library/ff795043%28WinEmbedded.1001%29.aspx

[3] http://msdn.microsoft.com/en-us/library/ff793723%28WinEmbedded.1001%29.aspx

[4] EPM-24 Tiger CMOS Setup Reference#Boot

Copyright © 2012 VersaLogic Corp. All rights reserved.