What is Commissioner, and what is a Mapfile?

What is Commissioner, and what is a Mapfile?


The Commissioner application, installed locally on a laptop, is used by system installers for the initial setup of a new SiteWorx facility. Commissioner, in conjunction with a USB wireless adapter (DLUSB), is used to wirelessly program lighting and other sensors to create a Mapfile.

A Mapfile contains information about an end-user's building and is uploaded to SiteWorx, the cloud-based lighting control, resource monitoring, and asset tracking application.

Each Mapfile corresponds to an Area (usually one floor of a building) in SiteWorx, and each Site (a combination of buildings at a single end-user site address) can have multiple Areas (buildings, and/or building floors). In SiteWorx, users click into an Area to view, manage, and report on settings and data.

Some features of Commissioner include:

  1. Drag-and-drop tools to alter the locations of sensors on a map
  2. Wirelessly program (Sync) all types of SiteWorx-compatible sensors, to communicate with a particular network/gateway
  3. Wirelessly program lighting sensors with basic, one-time dimming settings (active level, timeout, and inactive level)
  4. Save your work as a .map file (known as a Mapfile) for upload to SiteWorx
  5. Advanced troubleshooting tools

Information in a Mapfile typically includes:

  1. Basic facility and building details, including name, address, and timezone
  2. 2D floorplan of a building - either the installer-generated lighting plan (recommended), or an end-user provided plan
  3. SiteWorx devices and their information, overlayed on the floorplan to show each device's location
      1. Devices are identified and mapped by their Serial Number, found labeled on each device and in the installer baggie attached to each device
        WarningSerial number tracking is essential during installation. Visit the Project Management Checklist for more details
      2. Wireless network information, dictating which devices connect to what gateway
      3. Basic device settings
    1. Initial Group structure, later editable in the SiteWorx Admin Console
    Once installation at an end-user facility is complete and the system is ready for commissioning, visit the Build a Mapfile Checklist page to get started.

    For more information on how to use and navigate Commissioner, visit Commissioner Navigation.

      • Related Articles

      • Mapfile Checklist

        Use this checklist to aid in commissioning a new SiteWorx facility. If you're unfamiliar with Commissioner and Mapfiles, we suggest reviewing this Overview article first. Want to expedite commissioning? Contact sales@siteworx.io about purchasing ...

      • Mapfile Background Image

        This article explains how to add and manage the background image in a mapfile. The background image is a 2D layout depicting a facility floor plan. Add a New Background Image Prepare the background image Make sure to use a high quality layout that ...

      • Mapfile Devices

        Icons on the map represent different device types and states. Use the legend on this page to identify. Device Icons Fixtures appear on the map grid as square icons. Gateways appear on the map grid as wedge icons. Optional keypads appear as boxed ...

      • Download Commissioner

        Download for Mac Download Commissioner for MacOS version 4.0.7 The first time you open Commissioner, you may receive an "unknown developer" error message. Click here for troubleshooting instructions. For help installing Commissioner, visit Installing ...

      • Install Commissioner

        Mac Installation Installation Instructions Download Commissioner, then double-click the dmg file Read the software license, then click Agree Drag the Commissioner icon to the Applications folder "Unknown Developer" Error Message The first time you ...