Define the Device Type

After selecting a project on the Startup window, the Profile Editor opens to the Device Type Definition window:

Device Type Definition Window

Add Your Information

  1. In the Define the Device Type section, complete the fields using the information in the table below:

    Field Description
    Device Type Name

    This name is a string; by default it assumes the name you’ve given your project and device profile, but you can change it here. Note that if you do change it here, the project name will also update to reflect the new name, but your profile name will remain the same. Here are some important things to know about “device type”:

    • In the mobile app, the default name given the device is the Device Type Name. This name will be used unless the end-user gives their device a “friendly name” when adding the device to their account, or changes the name in the Device Settings. So use a friendly name that makes sense to you and your end-users.
    • The device type is an important identifier. Once you publish a profile with a given device type, an ID is associated with the project that remains unchanged as long as the project is active. As pointed out above, you can always rename your device type using this field, but the devicetypeID will not change.
    • The device type is used by the OTA Manager to associate an MCU firmware image type with devices.
    Description This description is a string, internal only and not displayed to the end-user. Type a description that is useful to you.
    Project Folder The directory on your local file system where your project is saved. You can’t edit the location; it’s displayed for information purposes only.
    Header File Output If you are using a device that has a separate MCU, a header file containing the device description (attributes) will be generated when you publish your project. By default, the header file will be saved to your project directory, but you can use this setting to save the header file to a different directory. For example, you might wish to save the file directly into the project directory for the associated MCU code (which will rely on the header).
    Device Icon This icon will be visible to the end-user. Select a meaningful image to represent your device. Click Select to see all available icons; highlight the icon you want then click Use This One! Your selected icon will be displayed in the Preview pane to the right, to give you an idea of how it will look on a smartphone. It will also be displayed to the left of your project name in the Navigation pane.
  2. The Power Optimization section provides controls and information regarding battery power consumption.

    The Power Optimization calculations apply only to ASR-1 projects.


    • Select an Advertising Interval (in seconds) for Bluetooth. If you’re running on battery power, the shorter the interval, the more battery power is consumed. However, at higher intervals the responsiveness of the device will be negatively affected due to lag time.
    • Once you’ve selected an interval, the Daily Average Current field will display the projected average current required by ASR-1 for that interval while idle (the module is said to be idle when performing no function other than advertising).
    • Click the Show advanced power calculator link at the bottom of the pane to open the Approximate Battery Lifetime estimator. Use this calculator to estimate the runtime of an ASR-1 module based on the battery type you’re using. For a more accurate forecast of the battery life, type the number of connections per day and additional power the device may be using. You can also check what the runtimes might be for different battery capacities.

      Approximate Battery Life Calculator

  3. Once you’ve defined the device type, you’ll want to save the definition.
    • Clicking Cancel reverts any changes you made on the page.
    • Clicking Save initiates validation of the new data and, if validation is successful, the data is saved to your local project directory.

    Every time you save, your data is validated. If validation fails for any reason, an error message will appear then move to the left. Click the error description in the message to highlight the field that needs correcting.