Developer Portal

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, displayed to the end-user if they haven’t given their device a “friendly name” when adding the device to their account. Use a friendly name that makes sense to you.
    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 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 another 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.