Resources | developer.brewmp.com Resources | developer.brewmp.com

Developer

resources

Packages and installation

On most systems, software installation is done through a packager and installer. On Windows® systems, the package and installation mechanism is typically an .exe-based installer or an .msi file.

Legacy Brew required that users adding modules to the system copy files individually to the device, then reboot the device. Using Connect, packages can be created and installed to devices, and the package can be run immediately after installation.

The .brewmp package file contains one or more modules packaged in the ONEDIRMOD. The .brewmp file is authored with the Brew MP Packager tool. Once created, packages can be passed into Connect, either using the CT or through Click-2-Run functionality embedded into Visual Studio.

Note: .brewmp files are specially formatted .tar files. They can be viewed and unpacked with the GNU tar utility.

The Packager tool

The Brew MP Toolset contains the Packager tool (bmppackager.exe) designed to create the .brewmp files used by Connect-based tools. Packager is called with an argument of the directory containing files to be packaged, and the output is a .brewmp file. The packager tool also does some sanity checking to ensure that the candidate for packaging is a valid module or set of modules.

The packager can take the following three types of directory layouts, shown in the examples below:

ONEDIRMOD SIMULATOR-STYLE LEGACY BREW
hansel\
  • hansel.mod1
  • hansel.bar
  • hansel.mif

grettle\

  • grettle\
  • grettle.mif
  • grettle.mod1
hansel.mif

grettle.mif

hansel\

  • hansel.mod1
  • hansel.bar

grettle\

  • grettle.mod1

mif\

  • hansel.mif
  • grettle.mif

mod\

  • hansel\
    • hansel.mod1
    • hansel.bar
  • grettle\

    • grettle.mod1

In all of the examples above, the following command would generate a file called hanselgrettle.brewmp:

bmppackager -o hanselgrettle.brewmp directory_containing_structure

If the -o option is not specified and there is only one module, the name of the .brewmp file will be the name of the module itself.

Further help for the Packager can be obtained by invoking the brewmppackager with no arguments. The package is in the following location in the Brew MP SDK: <%BREWMP_TOOLSET%\bin\bmppackager.exe>.