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.

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.

Atmosphere supported hardware falls into two categories: development kits and custom products.

Development Kits

Development kits and boards are used for prototyping new IoT applications. Development kit project types are referenced by the kit’s name. The list of supported development kits includes:

Development Kit/Board Protocols Supported Guides
Espressif ESP32 Bluetooth Low Energy, Wi-Fi Visit Guide
Intel Curie Bluetooth Low Energy Visit Guide
NXP Rapid IoT Bluetooth Low Energy Visit Guide

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.

Custom Products

Custom products are devices developed outside of Atmosphere, allowing you to bring your own end device to enable it to communicate with Atmosphere.

Projects for custom products are created using the Custom project type. Custom projects don’t require the creation of embedded code or firmware or programming, and instead create an interface to interact with the product and have its data sent to Atmosphere.

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’sCloud Event Elementcloud event element to build the cloud connectivity. Note that the cloud event element only sends data to Atmosphere; if you want the data stored, aCloud Storage Elementcloud storage element is needed.
  • The device has its Atmosphere project programmed into it
  • The device is powered on
  • The device has a BLE connection
    • 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 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 connects to Atmosphere over Wi-Fi.

With the prerequisites setup, the device can be registered.

To register a device:

  1. On the Devices page, click theAdd Devicebutton 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 theRefreshbutton 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 theTrash Canbutton 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.