Module 3: Configuring and Building with Platform Builder

Chia sẻ: Thu Xuan | Ngày: | Loại File: PDF | Số trang:32

Thêm vào BST

Báo xấu

129
lượt xem 14
download

Download Vui lòng tải xuống để xem tài liệu đầy đủ

Platform Builder provides you with several different vertical device configurations ranging from a Residential Gateway that features only the kernel functionality to a Media Appliance configuration that includes many graphical features and many applications.

Chủ đề:

Bình luận(0) Đăng nhập để gửi bình luận!

Lưu

Nội dung Text: Module 3: Configuring and Building with Platform Builder

Module 3: Configuring and Building with Platform Builder Contents Overview 4 Introduction to Platform Builder 5 Platform Development Cycle 7 Configuring the Platform 9 Building the Platform Image 18 Downloading the Image 25 Demonstration: Configuring, Building and Downloading 32 Review 33
Information in this document, including URL and other Internet Web site references, is subject to change without notice. Unless otherwise noted, the example companies, organizations, products, domain names, e-mail addresses, logos, people, places, and events depicted herein are fictitious, and no association with any real company, organization, product, domain name, e-mail address, logo, person, places or events is intended or should be inferred. Complying with all applicable copyright laws is the responsibility of the user. Without limiting the rights under copyright, no part of this document may be reproduced, stored in or introduced into a retrieval system, or transmitted in any form or by any means (electronic, mechanical, photocopying, recording, or otherwise), or for any purpose, without the express written permission of Microsoft Corporation. Microsoft may have patents, patent applications, trademarks, copyrights, or other intellectual property rights covering subject matter in this document. Except as expressly provided in any written license agreement from Microsoft, the furnishing of this document does not give you any license to these patents, trademarks, copyrights, or other intellectual property.  2001 Microsoft Corporation. All rights reserved. Microsoft, MS-DOS, Windows, Windows NT, Visual Studio are either registered trademarks or trademarks of Microsoft Corporation in the U.S.A. and/or other countries. The names of actual companies and products mentioned herein may be the trademarks of their respective owners.
Module 3: Configuring and Building with Platform Builder 1 Overview Introduction to Platform Builder Platform Development Life Cycle Configuring the Platform Building the Platform Image Downloading the Image In this module, you learn how to use Platform Builder to configure a platform, build a Windows CE image and download a Windows CE image. After completing this module, you will be able to: Identify the features of Platform Builder. Describe the life cycle of platform development. Identify how to configure a platform in Platform Builder. Describe the process of building a platform. Describe how a Windows CE-device is setup and how an image is downloaded using Ethernet.
2 Module 3: Configuring and Building with Platform Builder Introduction to Platform Builder Windows CE operating system configurations Embedded Windows CE development tools Compilers IDE-based debugger Windows CE remote tools Export SDK Integrated Development Environment (IDE) Run-Time libraries Sample code Windows CE Operating System Configurations Platform Builder provides you with several different vertical device configurations ranging from a Residential Gateway that features only the kernel functionality to a Media Appliance configuration that includes many graphical features and many applications. Embedded Windows CE Development Tools There are different types of embedded Windows CE development tools used by Platform Builder to create and debug a Windows CE Image: Compilers Platform Builder provides you with compilers for all supported processors. IDE-Based Debugger The kernel debugger allows you to debug against different targets even with different processors. The debugging method is the same for all processors. Windows CE Remote Tools Developers can debug the Windows CE target platform as they do in Microsoft Windows NT®/95. Platform Builder contains all the tools that are present in Microsoft Visual Studio. The following tools are adapted for remote environment: • Windows CE Spy++ provides tools to display information about windows and their messages. • Windows CE Registry Editor allows you to view the registry of the remote platform. • Windows CE Process Viewer provides information about processes, threads, and memory on the remote device.
Module 3: Configuring and Building with Platform Builder 3 • Windows CE Heap Walker displays contents of system memory. • Windows CE Remote Object Viewer displays information about objects on the remote device. Export SDK The Export SDK tool helps you to export a custom software development kit that can be used with the Windows CE Toolkit for Microsoft Embedded Visual C++®. Integrated Development Environment Platform Builder 4.0 provides a complete IDE that includes a wizard and toolbar that you can use to build and debug your Windows CE image. Run-Time Libraries Platform Builder provides support for the following run-time libraries: Active Template Library (ATL) for Windows CE Microsoft Foundation Class (MFC) Visual Basic for Windows CE Microsoft ActiveX Data Object for Windows CE (ADOCE) Sample Code Platform Builder provides sample code for platform-dependent applications such as drivers and OAL. It also provides sample code for platform- independent applications such as graphic user interface, shell components, and various communications and networking configurations. Platform-dependent components like drivers and OAL, which make up a BSP, can be found under the \Wince400\Platform tree. Platform-independent components and the sample drivers provided by Microsoft can be found under the \Wince400\Public tree, specifically under the ..\common\oak directory. Note For more information about the build tree, see Module 1, “Advanced Building of a Windows CE Image” in Course 2535A, Developing a Board Support Package for Microsoft Windows CE .NET and Course 2540A, Developing Embedded Solutions for Microsoft Windows CE .NET.
4 Module 3: Configuring and Building with Platform Builder Platform Development Cycle Configure Platform Build Download •Create Platform •Make Platform •Connect via •Modify Platform Headers Ethernet, Parallel, •Bootloader •Compile or JTAG •OAL •Link •Copy NK.BIN to •Device Drivers •Make Image device •Configuration Files (NK.BIN) •Start Windows CE •Applications Debug Monitor •Add catalog components •Debug •Localize •Export SDK Iterative Process This diagram illustrates the iterative process at the core of the platform development cycle. Configure the Platform Before you create the Windows CE image, you must first configure the platform. In Platform Builder, the term platform implies: A set of core Windows CE modules and components provided by Microsoft. A complete OEM Adaptation Layer (OAL). A set of drivers for your targeted platform. Optionally, additional components you choose to add. Depending on which configuration you select, certain modules and components will be included in your platform. Typically, you choose one of the given reference configurations and then customizing it. Customizing a platform can involve adding or removing features from the Catalog, adding projects, adding a board support package (BSP), creating an OEM adaptation layer (OAL), creating a boot loader, localizing the platform, and exporting a software development kit (SDK). You can customize a platform by adding or subtracting projects. A project is a group of related functions that implement a particular feature of your customized platform. You can create a project using a project wizard, and the project is given has an associated .pbp file. The .pbp file contains source file names and locations, and builds settings. Build the Platform Image After you have configured your platform, you can build a platform using the Platform Builder integrated development environment (IDE). The Platform
Module 3: Configuring and Building with Platform Builder 5 Builder build process produces a target Windows CE image for your platform with the components you have chosen. Note The IDE and command-line environments are independent of each other. Environment variables that you set in one environment may have a different setting in the other environment. Do not combine IDE and command-line methods when you build a platform. Once you have built a platform, you can just remake the operating system image by selecting the Make Image command in the Platform Builder IDE. After you have built the platform, you may change the parameter files, such as Project.bib and Platform.reg. You can access the parameter files from the ParameterView window in the Platform Builder IDE, and then modify the files. Then you need to build the platform again instead of just remaking the operating system image in order to incorporate these changes into the operating system image. Download and Debug Image To transfer a platform to a target device, use the Microsoft® Platform Builder integrated development environment (IDE) to transfer an operating system image, Nk.bin, over either an Ethernet or a parallel port connection. Before you can transfer an operating system image to a target device, you must configure a connection from the development workstation to the target device. Next, you download the image to the targeted platform and run it. With the Platform Builder debugging tools, you can debug the OAL, device drivers, or modules.
6 Module 3: Configuring and Building with Platform Builder Configuring the Platform The Platform Wizard Platform Configurations Available BSPs Configuration Variants Application and Media Networking and Communications Finish In this section, you will learn about the process of configuring a platform using the Platform Wizard.
Module 3: Configuring and Building with Platform Builder 7 The Platform Wizard C B D New Platform Wizard: Allows you to select a base operating system configuration for your platform Select some initial operating system features Select a preconfigured BSP Sets up the environment with files that support the operating system configuration you have selected You can configure your platform using the New Platform Wizard. Through a series of interactive dialog boxes, the New Platform Wizard allows you to select a base operating system configuration for your platform, choose some initial operating system features, and choose a preconfigured BSP. After you have chosen your initial settings, the New Platform Wizard sets up the environment with files that support the operating system configuration you have selected. The Windows CE features included in your platform depend on the operating system configuration that you select. You can build a system with little more than a kernel, a system with a complex graphical user interface (UI) and preinstalled applications, or any type of system in between. To create a new platform: • On the File menu, click New Platform. This opens the New Platform Wizard.
8 Module 3: Configuring and Building with Platform Builder Available BSPs C B D A BSP represents the basic OAL and drivers set which will communicate directly to a specific Standard Development Boardhardware platform When you create a BSP, you specify a collection of features that, as a package, offer a default level of functionality for a platform If you want to integrate your BSP into the New Platform Wizard, you must use the BSP Wizard Next, you must select from the list of available BSPs. A BSP represents the basic OAL and drivers set which will communicate directly to a specific Standard Development Boardhardware platform. You can create your own BSP and add it to a platform. For example, you might want to create a BSP to support a specific hardware configuration. When you create a BSP, you specify a collection of features that, as a package, offer a default level of functionality for a platform. If you want to integrate your BSP into the New Platform Wizard, you must use the BSP Wizard. The BSP Wizard also creates a Catalog feature file (.cec) file and imports your BSP into the Catalog.
Module 3: Configuring and Building with Platform Builder 9 Platform Configurations C B D Select a base configuration with the New Platform Wizard. You select one of the configurations provided with the IDE to base your new platform on. A unique name is required to identify the platform itself and the location of the files associated with it. The Platform Wizard will create a directory structure under the \Wince400\Public tree with the same name as your platform. When you create your platform, you must select a base configuration with the New Platform Wizard. You select one of the configurations provided with the IDE to base your new platform on. A unique name is required to identify the platform itself and the location of the files associated with it. This name is typically representative of the name of the product you are releasing to market. The Platform Wizard will create a directory structure under the \Wince400\Public tree with the same name as your platform. This is where Platform Builder will create your Windows CE image. The New Platform Wizard offers a variety of configurations. These configurations implement a wide selection of possible feature sets upon which to base your device. Once created, you are able to add and remove standard features. You can also add projects and resources of your own design that will be included in the final operating system image. There are several basic configurations included with Platform Builder. They are listed below: • Cell Phone or Smart Phone • Custom Device • Digital Imaging Device • Industrial Automation Devices • Internet Appliance • PDA or Mobile Handheld
10 Module 3: Configuring and Building with Platform Builder • Residential Gateway • Retail Point-of-Sale Device • Set-Top Box • Tiny Kernel • Web Pad • Windows Thin Client
Module 3: Configuring and Building with Platform Builder 11 Configuration Variants C B D Configuration variants determine which features it should include by default while it goes through the steps of creating the platform The Platform Wizard uses configuration variants to determine which features it should include by default while it goes through the steps of creating the platform. For example, Internet Appliance is a specific kind of device but with two variants depending on whether you want to include WordPad, e-mail, and ActiveSync functionality. The refinement of which functionality will be included in the final operating system image is accomplished by selecting variations of the base configuration. Note Variants are not available for all base configurations but only for that base configuration which is too general to define the kind of device it will be used on.
12 Module 3: Configuring and Building with Platform Builder Applications and Media C B D Dependent on the configuration you based your platform on Features selected by default are based on the configuration variant Choose to add or remove any of the listed applications and media features by checking or clearing them When it is appropriate for the target device, the New Platform Wizard provides you with a list of applications and media features available for the platform you have created. This step is dependent on the configuration you based your platform on. For example, if you base your platform on the Network Device configuration, this step would not appear in the New Platform Wizard. Applications such as, Pocket Word or Internet Explorer are not typically associated with this kind of device. The features selected by default are based on the configuration variant that you choose. These defaults are a starting point, not a mandatory configuration for your platform. You may choose to add or remove any of the listed applications and media features by checking or clearing them in the New Platform Wizard, or manually making these changes from the Catalog.
Module 3: Configuring and Building with Platform Builder 13 Networking and Communications C B D Dependent on the configuration you based your platform on Features selected by default are based on the configuration variant Choose to add or remove any of the listed applications and media features by checking or clearing them In most cases, the New Platform Wizard provides you with a list of additional networking and communications features that are available for the platform that you have created. Like application and media features, the inclusion of this list of features is dependent on the configuration you based your platform on. The features selected by default are based on the configuration variant that you chose. These defaults are a starting point, not a mandatory configuration for your platform. You may choose to add or remove any of the listed networking and communications features by checking or clearing them in the New Platform Wizard, or manually making these changes in the Catalog.
14 Module 3: Configuring and Building with Platform Builder Finish C B D Contains links to specific help items which can help you in the build process Click Done if familiar with the environment and wish to simply begin building Platform Builder generates the workspace for your new platform The final step in configuring the platform using Platform Wizard contains links to specific help items which can help you in the build process. You should click Done if you are already familiar with the environment and wish to simply begin building. Clicking Done will remove the html help file, then Platform Builder will generate the workspace for your new platform.
Module 3: Configuring and Building with Platform Builder 15 Building the Platform Image Components of the IDE Status Monitor The Build Menu Build Complete The Windows CE Image In this section, you will be introduced to the Platform builder Integrated Development Environment. You will learn how to use the Build menu to build a CE Image. You will learn how to verify what state the IDE build and debugger connections are in. Finally, you will see what the output of the build environment consists of.
16 Module 3: Configuring and Building with Platform Builder Components of the IDE Platform Builder Workspace: Platform vs. Project FeatureView ParameterView Catalog Output Window Text editor Platform Settings Platform Builder Workspace Under the Platform Builder workspace, you can view the entire platform and individual projects inserted into a platform. Platform The platform shown by the FeatureView tab represents building the entire platform. This is the whole operating system image including any application projects. Refer to the slide. Here, MYPLATFORM features is a platform. Project An individual project inserted into the platform workspace can be seen under User features. To manipulate this project, use the ClassView, ResourceView and FileView tabs which become visible when the project is inserted. These views are same as in the Visual Studio environment. Refer to the slide. Here, helloworld.pbp is a project FeatureView tab The FeatureView tab shows all of the features that make up your platform. Once you have created a Microsoft® Windows® CE platform, you can modify it by adding and deleting features. You can create and add your own custom features. You can also add features from third-party vendors and from Catalog. ParameterView Tab The ParameterView tab allows you to view and edit the source configuration files of the platform including the following files: Binary image builder files (.bib) File system files (.dat)
Module 3: Configuring and Building with Platform Builder 17 Database files(.db) Registry files(.reg) ParameterView displays the source configuration files in the Common, Hardware Specific and Project Specific directories. Common files apply to the entire platform, whereas hardware specific and project specific files apply only to the hardware development platform or the current workspace respectively. If your workspace supports CPUs from multiple WINCE roots, each root will be displayed with its own set of configuration files. Catalog Window The Catalog window contains drag and drop build entries for all of the Microsoft® Windows® CE operating system configurations, BSPs, transport layers, reference hardware drivers, and run-time libraries. You can import additional features into the Catalog and add projects to your platform. Note For information about specific modules and features, see Catalog Features in Platform Builder Help. Use FeatureView and the Catalog window together to view and modify your platform. Always move items from the Catalog to FeatureView rather than the other way around. Output Window The Output window of both the Platform and Project views reports information pertaining to your build. It will show errors and warnings. The Output window also displays the runtime debug messages coming from your target platform. Text Editor Platform Builder has built in text editing capabilities. You can open all your configuration files and source files by either double clicking them from the parameter or project views, or by clicking Open on the File menu. Platform Settings Window The Platform Settings window is accessed from the toolbar by selecting Platform and then Settings. This window stores information relating to your Platform Build. Here you can control whether you wish a retail or a debug build, set some build options and manually control environment variables used in your build.
18 Module 3: Configuring and Building with Platform Builder Status Monitor C B D Shows the current state of various tools The status bar of the IDE displays icons that show whether the IDE is currently building or not Shows the status of the Debugger connections for CESH, CETerm and kernel debugger The status monitor of the Platform Builder IDE is used to show the current state of its various tools. The status bar of the IDE displays icons that show whether the IDE is currently building or not. Status of the Debugger connections for CESH, CETerm and the kernel debugger are shown here as well. Status of the download connection can also be viewed. This tool is very useful to novice builders. The different states of the status monitor connections are as follows: Target Control (CESH) Stopped, Running, Waiting, and Timed Out Target Messages (CETerm) Stopped, Running, and Waiting Debugger Stopped, Running, Waiting, and Breaking Download Waiting to Download, Downloading, and Not Downloading Build Building and Not Building Connection Not Connected, Waiting to Connect, and Connected