TOC PREV NEXT



15.1 Customizing Your pRISM+ Tools

In this chapter you learn how to customize your pRISM+ tools. You will learn how to customize your toolbar and how to customize your project.

15.1.1 Customizing Your Toolbar

In this sample you are going to customize the pRISM+ Manager toolbar so you are able to list all the files in a pRISMSpace directory.

  1. From the pRISM+ Manager menu bar, click Tools > Customize. The pRISM+ Tools dialog is displayed. See Figure 15-1.
  2. In the pRISM+ Tools dialog, click on the Custom tab.
  3. In the Custom page, click the Add button. A default title of New Tool Entry appears. Delete this entry and enter List pRISMSpace Files as the tool name.


    FIGURE 15-1 pRISM+ Tools Dialog

  4. In the Command field, enter ls to list the contents of a directory.
  5. Click the arrow next to the Initial Directory field.
  6. Select pRISMSpace Directory. The proper environment variable, $(PrismDir), is placed in the field.
  7. Click the Add to Menu, Add to Toolbar, and Redirect Output to Log Window options.

    By selecting the Add to Toolbar option your custom tool will display bitmaps icons on the pRISM+ Manager toolbar. Of course you need to specify which bitmaps the pRISM+ Manager will use for the toolbar.

  8. Specify which bitmap files to display:
    1. To specify which bitmap files to display in the pRISM+ toolbar, fill the file names in the Large Image and Small Image fields.
    2. Click the Browse button next to the Large Image and/or Small Image fields and select any of the bitmaps included with pRISM+, or your own bitmaps. If you do not care which icons are used, leave both or either of the fields blank. The pRISM+ Manger, by default, will use a hammer icon.
    3. If you wish to use your own bitmaps, note the following:
      • The format should be .bmp files, not X11 bitmaps.
      • Large bitmaps should be 32 x 32 pixels; small bitmaps should be 15 x 16 pixels.
      • Specify no more than 16 colors.
      • Make sure that the system has read access to your .bmp file(s). You can use the Browse button to direct the system to your bitmaps.
    4. Click OK in the Open dialog after selecting the bitmaps.
  9. Click OK on the pRISM+ Tools dialog.

    Notice that a new icon appears for your tool on the right end of the toolbar, and that a Tool Tip string appears with the title of the tool when you mouse over the icon. Notice also that an entry for the tool appears when you click the Tools menu on the pRISM+ toolbar.

  10. Open a project and click on the List pRISMSpace Files icon.
  11. The pRISM+ Log Window appears and provides the listing.

15.1.2 Incorporating a Custom BSP for pSOSystem

In this section we will learn how to incorporate your custom BSP into an existing application. There are two methods you can use to incorporate your custom BSP into an existing project; you can copy your custom BSP into the bsps directory, or you can reference your custom BSP.

Copying the BSP
  1. Copy the directory that contains your custom BSP into the following directory: $PSS_ROOT/bsps
  2. Launch orbixd and pRISM+. Refer to Chapter 3, Quick Start with a Tutorial.
  3. From the pRISM+ Manager, open your pRISMSpace project, where Project_Name is the name of your existing application you created with the pRISM+ Editor or SNiFF+.
  4. From the pRISM+ Manager, click pRISMSpace > Settings. The Project Settings dialog is displayed.
  5. In the Project Settings dialog, use the drop-down button next to the Board Support Package field to locate and select your BSP.
  6. Click the OK button to accept the changes.
  7. You must completely rebuild your application. Use the project editor to rebuild. For example perform a psosmake clean and a psosmake all for the pss_main.shared project AND for the bsp_src.shared project.
Referencing the BSP
  1. Launch orbixd and pRISM+. Refer to Chapter 3, Quick Start with a Tutorial.
  2. From the pRISM+ Manager, open your pRISMSpace project.
  3. Select an existing application you created with the pRISM+ Editor or SNiFF+.
  4. From the pRISM+ Manager, click pRISMSpace >Settings. The Project Settings dialog is displayed.
  5. In the Project Settings dialog, type in the full path and name of your custom BSP in the Board Support Package field. You can use the Browse button to locate the BSP directory.
  6. Click the OK button to accept the changes.
  7. You must completely rebuild your application. Use the project editor to rebuild. For example perform a psosmake clean and a psosmake all for the pss_main.shared project AND for the bsp_src.shared project.

NOTE:   SNiFF+ users need to place the bsp at $PSS_ROOT/bsps/<BSP_name>. To prepare the BSP for usage within SNiFF+, call the script plugins_create_bsp. For further details refer toSection 6.7.4, Integrating a Custom Board Support Package into pRISM+ on page 6-82 and Appendix E.7.


TOC PREV NEXT