Developer Portal

Open a Project

When you launch the Afero Profile Editor, the Startup window appears:

Open a Project

In the upper-left of the Startup window, you’ll see a personal greeting with your username. Below your name, you’ll see links to developer documentation, including this Profile Editor User Guide. In the lower-left you’ll see a link for signing out.

In the center of the Startup window, you’ll see a group of icons. You will use these to open, create, and import projects, as well as access the developer documentation:

New Icon

New Project. After selecting this option, you’ll first be asked to select which Afero board/module you are using for your project. Then give your new profile a name and navigate to the local working directory holding your Profile Editor projects. You can either use the operating system to create a new, empty folder for your project in the selected working directory, or you can select the Create subfolder using Profile Name checkbox to have a folder created for you using your new profile name.

New Device Profile

When you’re ready, click Create. The Define the Device Type window opens.

Project Icon

Open Existing Project. If you’ve previously saved any profiles, they will be shown in the “cards”, holding the icons you assigned; e.g., Modulo-2 icons, thermostat, chair, car, wearable device, robot, or lamp icons in the illustration above. If you haven’t assigned an icon yet, a question mark No Icon Assigned for Project will display. Click an icon to open the associated project.

Clone Existing Project. If you have a project you’d like to use as a starting point for another, first open the project you want to clone. Then go to the operating system menu bar and select File > Clone Project. The Clone Device Profile window opens; proceed as you would when creating a new project.

Open Icon

Open/Import Local Project. Click this button to open any Afero project that was not saved by your local Profile Editor (typically this means another developer has shared a project with you by sending you a copy).

Documentation Icon

Quick Links. Click a link in the left-hand pane to open the developer documentation and other links in a browser window.

Once you’ve opened a project, you’ll see the Device Type Definition window, described further in Define the Device Type.

Profile Editor User Interface

Before going to the next section, let’s do a quick tour of the Profile Editor UI:

  • The system menu bar contains a few items worth noting. Select:

    • File > Open Project to navigate to and open a saved project.
    • File > Clone Project to make a copy of your open project.
    • View > Account Info to see information about your account: first name, last name, username, and authentication information. This includes your OAuth Client ID and OAuth Client Secret, which you’ll need when working with Afero Cloud API endpoints.
    • Tools > Sample Projects to download some zipped projects. You can use these as starting points.
    • Help > Collect Anonymous Usage Data to toggle this option on or off. Any data collected is anonymous and used only to help us improve the Profile Editor based on how you use it.
    • With a Profile Editor project open:User Interface
      • The leftmost section of the Profile Editor window is the Navigation pane. We’ll be working our way down the pane as we create a Profile. To close your current project, simply select Close Project at the bottom of the Navigation pane.

      • The rightmost section, below the Discard and Save buttons, is the Preview/Example pane. Depending on what is displaying in the center pane of the window, you may see example views of the mobile app UI, the Modulo board, or UI elements you’re working with.

      • You can hide/show the Navigation pane on the left and the Preview pane on the right by clicking the arrows located at the top inside corners of the panes: . They work as toggles, showing/hiding the associated pane.

      • In the upper-right of the window, you’ll see the Discard and Save buttons. These always act on the values in the currently-visible window.

      • Selected checkboxes and radio buttons are partially filled with orange; deselected checkboxes and radio buttons are filled with dark grey.

      • Selected options have an orange background (“INPUT” in the example); deselected options have a black background.