The Knut App for iOS allows you to:
- View data and graphs from your Knut
- Set up a Knut for the first time
- Modify basic and advanced settings for multiple Knuts and multiple sensors
- Configure settings whenever you add a new sensor
- Add an account to the Knut App
- Add a Knut to the Knut App
- Remove a Knut from the Knut App
- Add a sensor
- Arrange sensors in the App
- View sensor data on the graph
Modify settings for Knut
- General: recording intervals, rules, alerts
- Email: alert email recipients and Knut email account
- Connectivity: Wi-Fi network settings
- Global: time zone, units
- Sensors: name, enable, logging
Add an account to the Knut App
The Knut App works by fetching data from your Knut’s email account, storing this data on your iPhone or iPad, and displaying the data on the App’s home page and graphs. When you first launch the Knut App for iOS, you will need to add an account to your App. This account is the email address that you created for your Knut, and the password is the password for that email account. You can add additional accounts to an App at any time.
Once you give the App access to this email box, the App can download Knut’s data to your iPhone or iPad. Note that neither your data nor your account information is ever sent to Amperic–data is stored only in your Knut’s email account and on any devices on which you install a Knut App.
For most common email servers, the IMAP and SMTP server information will be autofilled by the App.
Once you add an account, the Knut App will download data for all of the Knuts associated with this account. Each Knut will be listed on the home screen of the App, below the account with which the devices are associated.
When you tap on the name of one of the Knuts, a list of attached sensors and their latest data report appears below that device.
Add a Knut to the Knut App
Once you have added at least one account to the App, you can choose which of your Knuts you would like to see listed in the App. On the home screen, tap the ‘Edit’ button in the upper left hand corner. This transforms the home screen into an editing/managing screen with several options for managing your Knuts and the App.
A ‘+’ button will appear in the upper right hand corner of the screen. Tap the ‘+’ to add a Knut. You will need to select the account that this Knut is using, and then the name of the device. When you are finished adding Knuts to the App, tap the ‘Done’ button to return to the home screen.
Removing a Knut from the App purges that Knut’s data in the App and in its email account
The feature for removing a Knut is intended for use when a Knut’s data is no longer valuable to you (or you have downloaded and stored it elsewhere), and you do not wish to see additional data from that Knut in the App. Deleting a Knut from the App will delete all data from that Knut, on your iOS device, and will also delete all emails related to that Knut from that Knut’s email account. (If you have multiple Knuts on one email account, other Knuts will not be affected.) Note that this does not disable the Knut itself: the Knut will continue to function as it was previously, and send data to its account and any other Apps your have configured with that Knut. If you wish to stop a Knut from recording, you should remove its batteries.
From the home screen, tap the ‘Edit’ button in the upper left hand corner. A delete symbol will appear next to any Knuts on the App. Tap the ‘-’ to remove a Knut from the list in the App. A warning message will appear, to help ensure that you do not delete Knuts from the App by accident. Confirm if you wish to proceed.
When you are finished adding or removing devices, tap the ‘Done’ button to return to the home screen.
Add a sensor
Knut will automatically detect any change to its array of sensors, whenever it wakes up to check the status of its sensors. To ensure that Knut detects a new sensor (or a sensor removed) immediately, first add/change the sensor plugged into Knut, then tap the black button on Knut. This prompts Knut to wake up, check its sensors, and send the updated sensor information to its account (and thus to any Apps, too). Any new sensors will now appear in the Knut Apps, and any sensors that you removed will disappear from the Knut Apps. To add rules or thresholds related to a new sensor, you will need to modify settings for that Knut, as described below. To learn more about settings for Knut, see our Settings page.
Arrange sensors in the App
All sensors connected to a Knut are automatically detected by the App and will appear in an expandable list below their respective Knut. The status of the sensor at the top of this list will be displayed on the home screen when the sensor list is collapsed. You can modify the order of the sensors to put your favorite sensor on top. When the sensor list is expanded, tap the ‘Edit’ button in the upper left hand corner of the home screen. Rearrangement icons will appear next to the sensors. Sensors can now be dragged and rearranged below a Knut. When you are finished rearranging sensors, tap the ‘Done’ button.
View sensor data on the graph
Visualize data from your Knuts using the graphing feature of the Knut App. You can add one or more sensors to the graph, to view both current and past data. To select a sensor to graph, first expand the sensor list for one of the Knuts. Tap on a sensor, and a colored box will appear next to the sensor. This is the color that will be used on the graph to denote this sensor. To add more than one sensor to the graph, tap an additional sensor. The color selection is random, so to change a color simply tap a sensor repeatedly until you find a color that you like. When you are ready to view the graph, tap the ‘Graph’ button in the upper right corner of the home screen.
A key for the graph will appear in the upper right hand corner of the graph, to remind you which color corresponds to which sensor. The zoom level can be set by tapping one of the timeframe buttons at the base of the graph. You can set the width of the graph to cover either one minute, hour, day, month or year. The x axis is labeled with the date and time, and the y axis is labeled in unit-less numbers. Note that all sensor values are plotted on the same scale, regardless of their units. Remember, units for each sensor are listed on the home screen.
You can tap the graph to view the time and sensor values at a given point. The App will show you data for the sensor most recently added to the graph. To view the data, tap a data point on the graph. A dialogue bubble will appear with the x and y values for the data point closest to the point you tapped.
To remove a sensor from the graph, tap the name of the sensor on the home screen. The colored square will disappear and the sensor values will be removed from the graph.
Modify settings for Knut
Nearly all of the configuration settings for Knut can be modified at any time using the Knut App. Note that updated settings may not be received by Knut immediately. This depends on the prior settings for the Knut. To edit settings, tap the ‘Edit’ button in the upper left hand corner of the home screen. Then tap the name of the Knut whose settings you would like to view or modify. If you make any changes to the settings, you will have the option to ‘Send’ these new settings or ‘Cancel’ the changes, when you exit the settings page. New settings will only be sent to Knut if you confirm and ‘Send’ the changes!
General: recording intervals, rules, alerts
The first tab of the settings page controls general settings for the Knut. Here you can modify:
- Device name: edit the name of the device, as you would like it to appear in all of the Apps
- Time per recording: set the interval between times that Knut samples data from all of its sensors, in HH:MM:SS
- Readings per transmission: set the number of data samples Knut should take, before transmitting data to its online account
- Edit Rules: enter the rules editor to view and set alert thresholds, and make advanced rules
- View Log: see the on seconds (data transmission times) and any errors encountered by this Knut. Scroll to the log for other days using the ‘-’ and ‘+’ buttons
Email: Alert email recipients and Knut email account
Add recipients for alert and info emails from Knut. This should be an email account you check regularly, or one for an acquaintance who has requested to receive alerts from Knut. To receive an SMS text message alert, enter your phone number at your cell phone carrier’s domain (eg email@example.com).
Knut can send alerts to an IFTTT account, to enable IFTTT-directed actions. This may include making a phone call to a landline or cell phone, sending an email, updating the status on your social media sites, etc.
Set the email account that this Knut uses for data storage and transmission. Remember, this should be an account designated for Knut, and not a personal email account. For Knut’s email account you will need to specify the address and password. Server settings are automatically filled in for most common email servers. For private email servers you will need to specify the IMAP and SMTP ports and servers. Values for these settings can be provided by your IT department or in the instructions for configuring your email to work with a desktop email client (et Mail, Outlook).
Select whether to use SSL for Knut’s communications with its email account. Using SSL will decrease Knut’s battery life, but it will also keep Knut’s password encrypted when it logs into its email account. We recommend using SSL if your email servers offers this option, especially if the Knut is controlling any outputs.
Connectivity: Wi-Fi network settings
Connectivity settings in the App are read-only, as these are configured permanently during the initial setup. View the name and password for the Wi-Fi network that Knut is configured to use. To move Knut to a different Wi-Fi network, or if your Wi-Fi settings change, you will need to set up the Knut again, from the beginning, with new network settings. In this case, all settings on the Knut will be erased, including the name of the email account it was using, passwords, rules, sensor names, etc. This is for security purposes, to ensure that your network passwords and Knut email account information cannot be extracted from Knut.
If you re-set-up Knut with a new Wi-Fi network, you can still enter the same Knut email account, sensor names, recording intervals, etc that you used previously. In the Knut App, this will appear as the identical Knut and data collected on the new Wi-Fi network will be continuous with data collected on the prior Wi-Fi network.
Global: time zone, units
- Time zone: set the time zone you would like to use for this Knut
- Clock advanced method: choose whether Knut should follow regional clock changes such as summer time or daylight savings time
- Date format: select the date format to be used in alert emails, the App and on the graph
- Clock type: select the clock format to be used in alert emails, in the App and on the graph
- Temperature units: select units to display in all emails, in the App and on the graph
Sensors: name, enable, logging
From the sensors tab you can view all sensors attached to a given Knut, including the internal temperature sensor and the battery (ie battery life indicator). Tap one of the sensors to view its configuration. Note that the recording interval, thresholds and rules are not accessible through this menu. Rules can be edited through the ‘General’ tab, described above.
- Name: The name you gave to this sensor, which can be edited here. This is the name that will represent this sensor in the App and in any Alert emails
- Enabled: ’On’ means that Knut will check this sensor as part of its regular function, as specified in the recording settings and any rules you defined. Most likely you will want your sensor enabled. ’Off’ means that Knut will not check the status of this sensor, ever.
- Record this sensor: ’On’ means that Knut will create a data point each time it checks this sensor–essentially data logging. ’Off’ means that Knut will not create a data point, except for when the sensor value is outside of an acceptable range as specified by any rules you have created. If you are interested in alerts but not in data logging for this sensor, you could leave the sensor ‘Enabled’ so that Knut will check the status of this sensor, but turn the ‘Record this sensor’ to ‘Off’ so that data will not be saved on a regular basis.
- Mode: this tells you how the sensor has been configured (probably by the manufacturer), and cannot be edited. ’Digital’ means that the sensor can only detect two states (eg wet and dry, or open and closed). ’Analog’ means that the sensor can detect changes along a gradient (eg temperature and humidity).
- Analog: If this sensor is in fact an analog one, then the units and calibration coefficients (M=slope and B=intercept in a linear regression) are displayed and can be edited.
- Digital: If this sensor is in fact a digital one, then you can edit the words used to define the two states.
Rearrange Knuts and Sensors on the home screen
You can edit several features of this home screen using the ‘Edit’ button in the upper left hand corner. When all of the Knuts in the list are collapsed, ‘Edit’ will allow you to delete a Knut from this list so that it no longer appears in the App (see above). When one or more of the Knuts is expanded to show its associated sensors, ‘Edit’ will allow you to change the order of the sensors for that Knut. The sensor at the top of the list should be the one most important to you: the status of this sensor is displayed next to the name of the Knut, when the sensor list is collapsed.
Get the Knut App for iOS: Download