This is a short introduction to the Sensirion MyAmbience app for iOS and Android devices. MyAmbience is used together with the official Sensirion Demonstrators which can be found on the Sensirion website as well as 3rd party do-it-yourself demonstrators.
The Manual refers to MyAmbience version 3.6 and newer.
Most of the following demonstrators are not publicly available for sale. We do however sell and hand out some demonstrators during our marketing events and at trade fairs. Visit us at our next trade fair near you. Go to our website to check our upcoming events.
The following Demonstrators are currently supported:
Learn more about the SCD4x and the SCD4x CO2 Gadget at our website
Learn more about the SHT43 and the SHT43 DemoBoard at our website
Learn more about the SHT4x and the SHT4x SmartGadget at our website
This is deprecated but still compatible with the MyAmbience app. Learn more about the SHT3x and the SHT31 SmartGadget at our website
Learn more about Nubo at our website
You can create your own demonstrators and connect them to MyAmbience! Learn how to create your own on our Github page!
You can download the iOS MyAmbience app through the official Apple App Store through the following link or QR code:
You can download the Android MyAmbience app through the official Google Play Store through the following link or QR code:
The following permissions need to be set so that MyAmbience can detect surrounding demonstrators:
- Bluetooth on your device needs to be enabled and the app needs to have permissions for bluetooth.
- On Android devices location permissions need to be given in addition. We do not store location information, however this is required by the bluetooth functionality since on some Android versions these are coupled.
- In case you would like to get notifications when you download data from the demonstrators devices and export data, please allow notifications for MyAmbience.
- The gadget needs to be in a range of 10-15 meters from the mobile. This varies between devices, however, this is the typical operating distance of bluetooth devices.
MyAmbience is divided into three main screens:
The main screen of MyAmbience offers an overview of all the nearby active gadgets. Normally gadgets within a 10-15m radius can be found.
Each gadget has its own "card" which shows an overview of all the available sensor signals. The colors of the signals vary depending on the value and how "high or low" this is, as you see in the screen above.
The gadgets are generally listed in an alphabetical order, where Favorite ♥ gadgets and gadgets receiving live data get precedence. The user can scroll down to see all of the available gadgets.
The gadgets marked as favorite ♥ get loaded on app start regardless if they are currently nearby or not. In case you have no favorite gadgets defined, the three gadgets with most data get loaded on app start. If the gadget is not nearby, this is visualized by a overlaid disconnected icon. An example of special cards (Gadget not nearby, SHT43 DemoBoard in Privacy Mode, SHT31 SmartGadget needing a connection) on the dashboard is shown below:
If you have the Privacy Setting switched on in the Device Settings, the live data advertisement is switched of. Thus, you will not see the recent measurements on the dashboard card. This state is visualized by a overlaid lock icon.
To receive live data updates for a SHT31 SmartGadget, you need to connect to the gadget. You can do this by pressing the "Connect" Button on the Dashboard Card. Once a connection is established, you see the recent measurement on the dashboard card. Please note that you can only connect from one phone at a time to a SHT31 SmartGadget. In the device settings you can disconnect if needed.
If you want to focus only on one gadget, you can tap on the card and a focused view emerges which shows the available values for each gadget. Tapping on a value card opens the plot for this signal. Additionally, there is a set of statistics for the latest 24 hours of data such as minimum and maximum value as well as an average.
For gadgets not getting live data updates, the reason is visualized in a banner. The data visuaLized is the latest data stored for this gadget. For gadgets having no data collected yet, the details screen is not available.
An example of the focused view is shown in the image below:
MyAmbience allows you to mark "Favorite" gadgets. Favorite gadgets will always show on the top of the gadget list. Further, your favorite gadgets get loaded on app start regardless if they are nearby or not. The favorite settings are persistent even if your gadget is not in reach.
To favorite a gadget, simply tap the heart icon on the bottom right of each gadget card as shown in the picture below:
You can configure certain aspects of your device! By tapping the cog wheel icon next to the favorites icon on the bottom right you go into the settings view. An example is shown below for the SHT43 Demo Board:
Through the settings view you can:
- Update the firmware of your device. The app will automatically detect a firmware which needs to be updated and will allow you to start the update.
- Change the name of your device.
- (SHT43 Demo Board) The name is stored on the board, thus the name is shared with other users paired to this demo board.
- (CO2 Gadget, SHT4x Smart Gadget, SHT31 Smart Gadget) The name is stored locally on your phone and thus not shared with other users of those gadgets.
- See the battery percentage, the available logging memory and adjust the logging interval
- (SHT43 Demo Board Only) Download the calibration certificate for the SHT43 sensor.
- (SHT43 Demo Board Only) Switch privacy mode. In Privacy Mode, no live data updates are sent.
- (CO2 Gadget Only) Adjust the LED Brightness.
- Turn on/off the LED by tapping on the light bulb on the bottom right.
- (CO2 Gadget Only) Perform a Forced Recalibration.
The SHT43 DemoBoard needs to be paired before we can connect to it over Bluetooth to query and update settings. Pairing needs to be established only once when you connect the first time to a SHT43 DemoBoard from your phone. Upon starting a download as described above, the system should show you a pairing request. Check that the number you see on the gadget and the phone match. Then confirm the pairing on your phone and on the gadget by pressing the white button on the left.
It can take a few seconds until the system shows the pairing request. You can also press the "Try again" button after a while if the request did not arrive. It might also help to stop and start Bluetooth on your phone if you missed or canceled a pairing request on the phone.
Note that even though you see live values on the dashboard for a SHT43 DemoBoard, it is not necessarily paired yet as those live updates are sent out in the Bluetooth Advertisement which do not need the DemoBoard to be paired.
The plot view is very useful to understand the historical data from your environment. For example how the CO2 concentration is when you sleep at night with closed doors and windows or what the relative humidity is in the summer versus the winter.
To see the plot for a gadget you can select it from the buttons in the bottom of the app. Selected gadgets show in green.
Please note: By default a single tap on a gadget adds it in the list of the gadgets. If you would like to focus on the plot of only one gadget you have to long press the gadget button.
In addition, you can navigate to a plot of a certain signal by tapping on the value of that signal in a gadgets details card.
The plot interaction is intuitive and simple to allow the users to focus on the signal values.
The x axis of the plots always show the time that the data was captured by the gadget. By using two finger gestures and pinching you can zoom in/out in the x axis while the y axis is automatically adjusted so that the whole signal(s) is in the view.
In case of multiple selected gadgets both plots are shown and the y axis is automatically adjusted so that it fits both plots.
By using the signal buttons above the plot area you can switch between the various signals and see their values.
MyAmbience gives you the ability to quickly jump between different time ranges by tapping the relevant button below the plot area. This is particularly useful when you want to contrast data between multiple days or weeks to identify patterns in your indoor environment.
The live mode will automatically move the plot to always show the new values and it will retain the current time range. As soon as you manually move the plot, the app goes out of live mode and allows the user to see the previous measurements. To activate it, press the "live" button. This button is only available if any of the gadgets currently selected receives live data updates.
Depending on the X-Axis range selected the original data is down sampled. This allows for performant plotting. You can disable the data down sampling for the plot in the App Settings.
You can optionally enable vertical grid lines. to do so check out the App Settings.
The full screen mode is useful to focus only on the plot at hand. By tapping the arrow button just below the plot you enter the fullscreen mode as shown in the image below:
While the app is active, live data is captured and stored for all gadgets in range. However, most of the gadgets have internal memory which allows them to log the data and send it to MyAmbience upon request. The logging interval on the gadget device can be changed in the Device Settings.
There are two ways to initiate a data download:
- In the Plot screen, press the download icon on the top right which will take you to the download view and start fetching data for all selected gadgets.
- In the Dashboard, press the download icon on the gadget card. This will take you to the download view and start fetching data for this gadget.
The app needs to firstly connect to the gadget and then download the previously recorded data.
It is recommended that you are in close proximity of the gadget when trying to fetch the data.
On the download screen, you are informed about the download in progress. To cancel a running download, swipe the card to the left. Any data already downloaded is discarded.
As the download of data might take some time, you can leave the download view and the data download will continue in background. You are informed about the download progress with a notification. Additionally, the download state is visualized with an icon in the bottom right of the gadgets's dashboard card. You can go back to the download view by tapping on that button at any time or by using the download button in the Plot screen.
When a download is finished, the download view shows you the number of samples downloaded and their time range. You can explore the data in the Plot screen.
When a download failed or was interrupted due to lost or weak Bluetooth Connection, it is visualized in the download view. You can retry the download by pressing the refresh button on the right of a download card.
If you do no longer want to keep the download card in the list, you can dismiss the card by swiping to the left or removing all downloads not in progress anymore with the "Dismiss finished" button in the bottom right corner of the screen.
The SHT43 DemoBoard needs to be paired before we can connect to it over Bluetooth to download data. Refer to Pairing for SHT43 DemoBoard.
You can export the stored data from your gadgets.
To select the data to export, you have two options:
Use the share button on the top right in the Plot screen to export data for all selected gadgets.
Go to the Manage Gadgets Menu, select one or more gadgets and choose the export option.
Once you have started a export, the Share exported data screen will open and show the progress of the export. You can leave this screen and the export will continue in the background. You will be notified once the export is finished. To navigate back to the export screen, use the Share exported data menu.
Once the export is finished, you can share your data by tapping on the share button on the card.
The exported data persists until you dismiss it by swiping the entry to the left or you close the app.
The data is exported in an EDF file format. The EDF format is CSV compatible which means you can open it with Excel or any other editor capable of handling CSV. The EDF files are compatible with ControlCenter and Dataviewer (Sensirion Evaluation Software), so that you can plot your gadget data in Dataviewer.
The timestamps are displayed in your local time. If you want to have timezone offsets included with your timestamps, you can enable this in the app settings. However, this makes it more difficult to display the data in Excel as it can't handle offsets automatically.
For more information about EDF files please visit the ControlCenter Manual.
In the app settings you can adjust the general settings of MyAmbience:
- Adjust the measurement system from measuring in degrees Celsius or degrees Fahrenheit or Kelvin
- Select which computed signals will be displayed if the measured signals are available. To learn more about the computed signals for the SHT4x SmartGadget visit the link here.
- Select whether you want timezone offsets added to the timestamps in the exported data.
- Select whether you want to down sample live data before storing to the data base, see Live data down sampling for details.
- Select whether the data displayed in the plot is down-sampled for better performance. Down sampling rate depends on the currently selected X-Axis range.
- Select whether vertical grid lines should be shown on the plots.
- Opt in/out in our analytics
- Connect to a Nubo device
Depending on the gadget, the live data updates every few seconds. As usually there is no such high data resolution needed for the history data, this options allows you to down sample the live values before persisting. Activating the down-sampling reduces storage consumption and also helps to keep the app performant. The persisted data is used for statistic in Single Gadget Focus view, plot Plots and data export Data Export. Note that the plot shows the full resolution for the live data that was traced in the current app session.
The down sampling resolution is set with following logic:
- If a gadget supports data logging, the data logging interval set on the gadget is used as down sampling interval. It is limited to a maximum of 10 minutes. See in the Device Settings to check if your gadget supports data logging. The currently set logging interval is fetched from the gadgets upon discovery and cached in the app.
- Default down sampling interval is 1 minute. This is applied if the gadget does not support data logging.
The Manage gadgets area allows you to see all the previously detected gadgets and perform certain actions with their data. Actions include:
- Load the gadget as an offline device to visualize the data
- Delete the gadget and its data
- Delete the data of the gadget
- Select multiple gadgets
- Export data of the gadget
There are two different states a gadget can be:
- Loaded (you can see the gadget on the dashboard): Denoted in green color
- Not Loaded (but there is data for that gadget in the database): Denoted in grey color
For more details about how to start a data export, please refer to Export and Share data section.
This screen can be used if a Firmware Update for a SHT43 DemoBoard failed and the DemoBoard only shows a blank screen. If a DemoBoard is around that is stuck in this so called over-the-air update mode it is listed on this screen and you can try again to install the firmware from here.
A really important aspect of our mindset at Sensirion is to actively solve problems of our users, therefore gathering feedback and supporting our users is of outmost importance to us.
If you request any type of additional support please do not hesitate to contact us by filing an issue on our developer support page mentioning MyAmbience as a product.
This privacy policy outlines details about the data processing in relation to the Sensirion Smart Gadget (“Device”) and the Sensirion MyAmbience mobile application thereto (“App”). In addition, we adhere to the general, Sensirion Privacy Notice, and you have all rights mentioned therein.
The Device allows tracking of environmental data, such as temperature, humidity and carbon dioxide. These data are saved locally onto the Device. The Device has a Bluetooth Low Energy (BLE) module which — when switched on — allows other Bluetooth enabled devices in the vicinity to connect to the Device and show current measured values as well as download saved data.
The Sensirion App allows the user to connect a mobile phone or tablet to the Device and show current measured values as well as download saved data.
The use of MyAmbience (by Sensirion AG) requires that we, Sensirion AG, collect, process, and store certain information about you and, as the case may be, your company. This includes information you provide to us, information we collect automatically, and information we receive from other sources. Such information may include personal data protected under data protection laws.
Please see the full Sensirion Privacy Notice located at https://sensirion.com/legal-notice/privacy-notice/ for the detailed Sensirion data privacy policy.
This Myambience Privacy Notice is in addition to the Sensirion Privacy Notice and highlights what we consider most relevant for you to know regarding the use of MyAmbience:
Information you provide to us, this includes Information from actions you take. We collect information about your use of and activities on the services. This includes the type of sensors you connect, the measurement duration, and other related actions. Other information you provide directly to us. You may have the option to submit additional information as you use MyAmbience. For example, you may participate in surveys where you can provide feedback on the product, which requires that you provide additional information about your device, yourself or your company. Information we collect automatically, this includes Information about your device. We collect information about the device you are using to access the services. This includes information like operating system information, screen size and browser information. Information about your use of the apps or websites. We collect log and event information related to how and when you use our services (such as the sensors connected). Information we receive from other sources, including third parties, and combine that information with the other information we have about you. We use Mixpanel Analytics, an analytics service provided by Mixpanel Inc. (“Mixpanel”). For more information on how Mixpanel uses this data, please visit Terms of Use | Legal | Mixpanel. In order to collect the above mentioned information, we rely on the default services provided by the Android and iOS operating systems.
We use your information for the following purposes:
To provide customer service. We use your information to respond to your questions about our products and services, and to investigate bugs or other issues. To report on our company’s performance. We use your information to track the fundamental metrics of our business, to perform financial reporting, to respond to regulatory obligations, and to debug billing issues. To improve our services. We use your information to help us understand how users interact with our services, what features or products users may want, or to otherwise understand and improve our services. This includes information about how you use our services. As discussed in the ”How to control your privacy” section below, you can control whether your data is used for these purposes. With your consent We may also collect and use personal information with your consent. You can revoke your consent at any time (mostly through our services directly), though note that you might not be able to use services or features that require collection or use of that personal information.
You can restrict our ability to use your data to improve our products. If you turn off the “Send Usage Statistics” setting under settings, we will stop collecting and using certain event and log information to help us understand how users use our services, what features or products they may want, or to otherwise improve our services. You can request for your data to be deleted by sending an email to privacy@sensirion.com and by supplying your anonymous identifier found under the application settings Please see the full Sensirion Privacy Notice located at https://sensirion.com/legal-notice/privacy-notice/ for an overview of the rights you have as a data subject.
Aggregated or de-identified information. We may share information about you that has been aggregated or anonymized such that it cannot reasonably be used to identify you. For example, we may share aggregated user statistics in order to describe our business to partners or the public.