Cloning an Existing BSP

  • Article

Cloning a BSP is the most convenient way to create a new BSP for your software development board (SDB) using Platform Builder. When you clone a BSP, your new BSP is modeled after an existing BSP in Platform Builder. When you complete the following procedure with the BSP Wizard, you will have a cloned BSP and it will be integrated into the IDE Catalog.

Note   The BSP files are not copied to your BSP directory until step 3 in the second procedure of this topic.

For information about creating a BSP definition for an existing BSP with the BSP Wizard, see Creating a New BSP Definition.

To illustrate the procedure better, you will clone an existing National Geode BSP in Platform Builder, and create a MyGeode BSP in the following steps.

To clone an existing BSP

  1. From the Platform menu, choose BSP Wizard, and then choose Next.

  2. In the Choose Your Task dialog box, select the Clone an existing BSP check box, and then select a sample BSP from the list that closely matches the microprocessor and microprocessor companion chip on your hardware, if applicable.

    For example, choose National Geode: x86 for the BSP to clone.

  3. Choose Next.

  4. In the New BSP dialog box, in the New BSP name field, type the name of your new BSP.

    For example, type MyGeode for the name.

  5. In the Vendor field, type your company's name, and then in the Version field, type the version number for your BSP.

  6. In the Description field, type a description for your new BSP, and then choose Next.

    This value is shown in the Catalog when you move the pointer over the BSP name.

  7. In the CPU and BSP Platform Directory dialog box, in the BSP directory field, choose the exact directory name where the BSP files are stored under the %_WINCEROOT%\Platform directory.

    For example, type MyGeode, because the files are located at %_WINCEROOT%\Platform\MyGeode.

  8. In the CPU field, select the CPUs that you want your BSP to support, and then choose Next.

    Note   The BSP Wizard preselects the CPU based on the BSP you cloned. Only the CPUs that are installed within Platform Builder are listed in the CPU field.

  9. In the Catalog Feature (.cec) File Information dialog box, in the Catalog feature (.cec) file name field, type any name for the .cec file that will define your BSP in the Catalog.

    - or -

    Choose the default name.

    For example, choose the default, which is MyGeode.

  10. In the Catalog feature (.cec) file directory field, type any directory name on a local drive.

    - or -

    Choose the Browse button to select a directory where the .cec file should be stored.

    - or -

    Choose the default directory location provided by the BSP Wizard.

  11. To advance to the BSP Customization dialog box, choose Next.

The BSP Customization dialog box shows a graphical view of the BSP with components such as drivers and boot loaders. You now have the choice to add, delete, or edit the included components.

To customize the BSP and complete the wizard

  1. In the BSP Customization dialog box, add, delete, or edit the included components you want, and then choose Next.

    Note   The BSP files have not been copied to your BSP directory yet. Microsoft recommends that you add drivers only after you have created the BSP.

  2. In the Default Drivers dialog box, select the drivers for each device type that you want to include by default when the New Platform Wizard creates a platform with your BSP, and then choose Next.

    Default drivers are drivers that are already integrated into the Catalog. These are preselected for each device type that is included by default when the New Platform Wizard creates a platform using this BSP. You can change the selection of default drivers for any device type. If you do not select a default driver for a device type, Platform Builder prompts you for a device driver at build time.

  3. In the Congratulations dialog box, choose the Finish button to complete the process and close the BSP Wizard.

    Note   You can import two or more BSPs that have the same name into the IDE Catalog, but the IDE does not support adding two or more BSPs that have the same name to a sample platform.

You have successfully created a new BSP that is a clone of the existing BSP.

Note   If the cloned BSP contains duplicated build methods, you can remove them by editing the .cec file in the BSP Editor or in a text editor. If you had previously added the .cec file to the Catalog, you must remove it by using the Manage Catalog Features dialog box from the File menu. You can then use the same dialog box to import the edited .cec file again.

See Also

BSP Wizard Overview | Creating a New BSP Definition | Adding a Driver to an Existing BSP | Adding a Boot Loader to a BSP Definition

 Last updated on Friday, October 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.