Connecting Devices to Atmosphere

Atmosphere makes it easy to connect your end devices to it. Any device with Atmosphere firmware installed is capable of being connected to Atmosphere.

Once connected to Atmosphere, the end device can be viewed, configured, have its data displayed and analyzed, and more.

The number of devices you can register on your account is based on your plan:

Plan Device Limit Cloud Storage
Developer 5 10MB/device
Professional 25 100MB/device
Business Unlimited Unlimited
Enterprise Unlimited Unlimited

On Developer and Professional plans, you’ll receive a system notification when you’ve reached your account’s device limit. Once your device limit is met, you can’t register any new devices until one is removed from your account first. For instructions on removing a device, see the Removing Devices section below.

If you find yourself reaching your device and/or storage limits easily and want to get more out of your Atmosphere account, consider upgrading your plan to increase your account limits! Visit the Atmosphere Pricing Packages page on the Atmosphere IoT website for information on Atmosphere plans and what they include.

Supported Hardware

Supported hardware refers to any end device that is compatible with Atmosphere. These devices also have a corresponding Atmosphere project type. After you create a project for and program its embedded firmware into that device, the device is able to be registered to Atmosphere. Hardware natively supported by Atmosphere primarily consists of development kits and boards used for prototyping new IoT applications. Development kit project types are referenced by the kit’s name.

For information on the wide selection of hardware used in Atmosphere, visit Supported Devices.

If a development kit is used in combination with additional hardware to expand its functionality such as a sensor shield, it may be used if the additional hardware in question is also compatible with Atmosphere. Such hardware is available to be developed with in Atmosphere through importing dedicated sensor elements into the Element Toolbox.

For more information on the available sensor elements, visit Element Types.

Registering Devices

Registering a device enables it to be viewed on Atmosphere. Once registered, you can see the device, interact with it through its interface, and see its data on Atmosphere.

There are a few prerequisite conditions for registering a device:

  • The device has an Atmosphere project made for it
  • Its Atmosphere project uses Studio’s Cloud Event Element cloud event element to build the cloud connectivity. Note that the cloud event element only sends data to Atmosphere; if you want the data stored, a Cloud Storage Element cloud storage element is needed.
  • The device has its Atmosphere project programmed into it
  • The device is powered on
  • The device either has a BLE connection, or is connected to your computer via a UART connection (available COM port) and the Atmosphere IoT Agent is running.
    • Devices are initially registered via a BLE connection, and must be within Bluetooth range in order to appear on the list of available devices when adding a new device. In the case of devices that support BLE and Wi-Fi (such as an ESP32), a device is initially registered via BLE, and then you can enter Wi-Fi network credentials. Once network settings are added, the device remains connected to Atmosphere over Wi-Fi.
    • If the device connects via Wi-Fi or cellular, the Atmosphere IoT Agent is used in collaboration with your computer to register the device. The agent assists in connecting the device to Atmosphere by searching your computer for any compatible device connected to it from an available communication port. While the agent is running, a device with Atmosphere firmware installed on it can be registered to Atmosphere directly without the assistance from an additional connection like BLE or Wi-Fi. This process is also referred to as “UART registration.”

With the prerequisites setup, the device can be registered.

To register a device:

  1. On the Devices page, click the Add Device button in the top-right to display the Register Devices window. When the window opens it will automatically begin scanning for available devices within range.
    • Only supported hardware with Atmosphere firmware installed will be displayed.
    • Ensure your end device is within range from the device you are attempting to register from, otherwise it may not appear.
  2. The list of available devices appears in the table. This includes the device type, project name, signal strength, and supported protocols. Select the device you want then click Register.
    • If the device you’re looking for is not displayed, no devices were found, or you want to refresh the list, click the Refresh button to rescan for devices.
    • If the device supports Wi-Fi, you can configure Wi-Fi network settings at this point. If Wi-Fi settings are entered, the device will connect to Atmosphere over Wi-Fi and remain connected as long as the Wi-Fi connection is maintained.
  3. The device is registered to Atmosphere and displayed on your Devices page.

Removing Devices

Removing a device unregisters it from Atmosphere, making it unavailable within the platform. This includes removing it from the Devices page, and also stopping any data being shown from it on the Dashboard page.

To remove a device:

  1. On the Devices page, select the device you want to remove in the table by clicking on its checkbox.
  2. Click the Trash Can button beneath the table. You’ll be prompted to confirm you want to remove the device. Click Remove to confirm.

The device is then unregistered from Atmosphere. It can be registered again at any time.

If a device that is registered is re-programmed with new firmware, it needs to be unnregistered and then registered again for the firmware updates to take effect.