370 likes | 388 Views
WatchM Application User Manual. Ilan Pollack & Guy Terem . V1.0 – February 27 th , 2019. 2 . Introduction. The WatchM app has both iOS and Android versions. Although almost identical, small differences may be noticed in speed and response time.
E N D
WatchM Application User Manual Ilan Pollack & Guy Terem V1.0 – February 27th, 2019
2. Introduction • The WatchM app has both iOS and Android versions. Although almost identical, small differences may be noticed in speed and response time. • Bluetooth and location services must be always enabled for the WatchM app to operate correctly. • The WatchM app opens with a splash-screen and then proceeds to the log-in screen. • Permissions: After first time installation, each operating system will require users to grant access to local storage (files) and location; these must be granted. When users want to take a profile picture, the app will also ask for permission to access the camera. • In this manual, the acronym MS is for MultiSense, Cellocator’s wireless sensor unit (as shown on the next slide).
3. MS compatibility table MS unit Compatibility table of MS units: * Internal data logging of up to 3000 samples by the MS is available
4. Sign in screen • There are two sign-in methods: • Demo Mode – Local usage, credentials not needed. Up to 10 MS units are supported. • Server Mode – Information is synced with the server, using a pre-registered account and secured credentials. See here. • Signup is done by tapping the button. • Once an account is created, each individual user receives their credentials. • Should the user forget their password, they can tap the button to regenerate a new password.
5. Apply For Account User can apply for an account to safely store all of their MS devices information on Pointer’s secured servers; add the following information to create an automated application for an account: • First Name • Surname (family name) • Organization • Email • Mobile number – including Area Code, for example +1515495495825 • Set a password
6. Watch List Screen (in Demo mode) Clears listed MS from the application, including previous logs Opens the Event Log page Opens the Main Settings page (Global settings) Search window, acts as a filter on the MAC address or on the MS alias text In each listed MS section, you can also find the following information: • or dots: If the dot is displayed, the MS has the functionality of an internal logger. If it is green, the logger is activated; if it’s red the logger is disabled (it can be enabled/disabled from the settings). • (MultiSense alias): This text can be changed by the user in the Settings screen. The text is displayed in red if there is a violation; the text is displayed in black if there are no violations. • : MultiSense MAC address.
7. Watch List Screen (in Demo mode) • Indication of the last logger download status, displayed only when the logger is supported and enabled: • While downloading: Black circle and text, with running percentage counter. • After successful download: Green checkmark (=100%). • If the process failed: Red text and circle with the already downloaded logger percentage. • MS sensor icon indicators: • Green icon indicates that the sensor is within defined limits (set per each MS).e.g. The battery is full with a 100% charge. • Red icon indicates that the sensor is out of defined limits (set per each MS).e.g. The temperature is 24.7 C° and is out of the defined range. • Grey icon indicates sensor is inactive or not usable. e.g. The Humidity sensor does not exist (it is only available in the TH model). • Orange background icons indicate intermediate reception signal strength. Only applicable for BLE signal strength or estimated distance. • Note that by default the app will prevent the screen from locking while application is in WatchList, Monitoring or Settings screens. Opens the Add MultiSenses screen
8. Scanning • When the WatchM application is not being used, or the screen is turned off, a background scanning agent is automatically activated. In Android systems it will also appear in the notification area.This means that the agent will continue scanning and the app will process the received data at all times, utilizing a small portion of the battery charge (typically a few % per day). • In order to prevent this, you can turn off the application by: • Killing the app from the OS of the smartphone. In iOS double click on the button, then slide the app image upwards. In Android press the ≡ button and then slide the app image to the side (or press the X). • When in the app in Android (in the foreground), tapping “back” and clicking “Yes” in the “Are you sure that you want to exit?” prompt. • Using the “Close” option on the notification area scanner agent. • Logging out from the app, as explained in slide #34 below. • The disabling of battery optimization is needed in some Android devices for long-term background scanning (including when the screen is off). For example Xiaomi phones running MIUI 10, see screenshots in this page:
9. Add MultiSenses screen • In order to add a MS, BT communication must be enabled on the phone. • To add a MS, perform the following steps: • Press the MS button briefly. The LED will blink. • By default, the MS units you pressed are selected automatically. • Tap the Add button in the WatchM app to add the MS.
10. Event Log Allows the filtering of the History tab information according to: MultiSense, Sensor, Date & Time parameters Clears history readings Future feature (Event log export) • Specific History readings can be removed by dragging on a row to the left and then tapping the trash icon on the same line. • Each line provides a full description of a sensor reading, according to: • MAC address • Sensor type • Date & time • Tapping on another tab will display the specific sensor reading/status on all the MultiSenses in the system.
11. Settings Allows the user to add a profile photo to the application. Allows the user to add personal details. Allows the user to set his technical preferences (global for all MS) such as: • Length units – Metric / Feet • Temperature units - C° / F° • Monitoring mode – Sensors / Location / Sensors & Location Readings [Default] • Signal Strength reading – in dBm or length units * • Distance Limit – readings with Signal Strength which correlate to more than this distance will be filtered out and not processed by the app • Lost Alert Timer – Sends an alert if an individual MS did not transmit info for more than the defined time (global setting) • Prevent Screen Auto Lock – Prevents the screen from locking while application is in WatchList, Monitoring or Settings screens Buy MS screen Opens the Terms and Conditions page on the web Allows the user to log out from the application * Will be displayed in “WatchList Screen”
12. Buy MultiSense Screen Users can notify us by automated email if they want to purchase MS units; users enter the amount of required MS (of each kind) and add their information, making sure to add their country’s phone area code, as in the example below.
13. Individual MS Upon entering an individual MS, users can access a number of options: Enables users to edit the MS’s alias (free text) • Monitoring tab - provides the last readings of all of the MS’s sensors. • Tapping on the black arrow, or anywhere in its block/row expands a graph reading of the Temperature & Humidity readings. Tap again to close it. • Settings tab - enables the user to configure and receive settings of the specific MS, including: • MS Info • Set Transmission Level • Define Sensors • Set Transmission Policy • Set Proximity thresholds • Push notifications
14. Individual MS settings Upon entering an individual MS settings, users can modify a number of MS features MS Info: Set Transmission Level: Define Sensors: • Name • MAC address • Filter [Not utilized] • FW Version • HW Version • Monitoring Mode • Battery Level • Scrambling* • Data Logger enable/disable • Enable/disable and configure various MS sensors: • Temperature • Humidity (if exists) • Light • Magnetic • Accelerometer • Button press • Allows the user to set the transmission level from the MS to a smartphone * If the transmissions from the MS are scrambled (a kind of proprietary encryption) or not.
15. Individual MS settings Set Transmission Policy Set Proximity Thresholds: • Periodic Sensor Recording:Defines the interval time of sample recordings from the MS when both temperature and humidity are within their defined limits. • Periodic Sensor Recording during Violation: Defines the interval time of sample recordings from the MS while either the temperature or humidity are out of their defined limits (in violation). • Periodic Log Transmission Attempt:Defines the interval time of transmissions from the MS. • Transmission upon violation:If this is enabled, every violation of any sensor will create a single and immediate transmission attempt. • Defines the distance threshold (between the MS and the Smartphone) which will trigger a distance violation. Push Notifications: • Allows the user to manage the push notifications coming from the app to the phone OS. For more details click here
16. Watch List Screen (in Demo mode) • Distance Sensor – Distance indication between the MS and the smartphone, determined according to the dBm value (it can be displayed in meter units or dBm units). • Magnetic Sensor – An ON-OFF sensor triggered by its proximity to an external magnet; OFF when a magnet is not detected by the sensor, and ON when a magnet is detected. • Battery Level – An indication of the battery status (translated from voltage to percentage). • Temperature Sensor – A sensor which indicates the status of the temperature in C° or F ° units.When there is a violation of the temperature range it will show a red icon accompanied with the current temperature reading. Otherwise the current temperature is displayed with a green icon. • Humidity Sensor - A sensor which indicates the status of the humidity in % units.When there is a violation of the humidity range it will show a red icon accompanied with the current humidity reading. Otherwise the current humidity is displayed with a green icon.
17. Watch List Screen (in Demo mode) • Button Status – Indicates when the MS push button is briefly pressed. • Orientation Sensor – A sensor which indicates the current Pitch and Roll angles of the MS in (Degrees)° units. • Light Sensor – A sensor which distinguishes between two statuses, “Dark” and “Bright”, according to the predefined lux threshold. • Impact sensor – A sensor which indicates if there was impact with a magnitude of more than the predefined g threshold. • Movement Sensor - A sensor which indicates if there was movement according to the predefined g threshold.
18. Individual MS settings – Temperature Sensor Users can enable and set specific threshold values that provide the triggering conditions for different alerts; these values are set for each individual MS, under Settings> Define Sensors. Define Sensors: • If the MS has the data-logger capability (from FW version 4v67 and up), the Data logger option switch is displayed. Enable/disable as required. • See the next slide for the different options for “Set transmission policy” screen, depending on whether the logger is enabled/disabled.
19. Individual MS settings – Set transmission policy No Logger available or Logger disabled and “Transmission upon violation” = ON No Logger available or Logger disabled and “Transmission upon violation” = OFF
20. Individual MS settings – Set transmission policy No Logger available or Logger disabled and “Transmission upon violation” = OFF • When the temperature and humidity are both within the defined limits, the “Periodic transmission rate” determines both the sampling and transmission rates. • When either the temperature or the humidity are violating the defined thresholds, the “Transmission rate during violation" determines both the sampling and transmission rates. No Logger available or Logger disabled and “Transmission upon violation” = ON • “Periodic transmission rate” is the internal sampling rate only, when the temperature and humidity are both within limits. • “Transmission rate during violation" is the sampling and transmission rate at the same time, when either the temperature or the humidity are violating defined thresholds. • “Keep-alive message interval” is a protective transmission rate for keep-alive messages when there are no violations.
21. Individual MS settings – Set transmission policy Logger enabled and “Transmission upon violation” = ON Logger enabled and “Transmission upon violation” = OFF
22. Individual MS settings – Set transmission policy Logger enabled and “Transmission upon violation” = OFF • “Periodic sensor(s) recording” is the internal sampling and logging rate when there are no temperature or humidity violations. • “Periodic sensor(s) recording during violation” is the internal sampling and logging rate when either the temperature or the humidity thresholds are violated. • “Periodic log transmission attempt” is the transmission rate. Logger enabled and “Transmission upon violation” = ON • All the above, except asynchronous events such as magnet state change, light state change, impact or movement are also transmitted in real-time. For a table that summarizes the details, click here:
23. Individual MS settings – Temperature Sensor Define Sensors: • Enable or disable Temperature Sensor: • Set Maximum and Minimum threshold values. • Set a pre-warning offset parameter to send a warning by Push notification when close to one of the thresholds. • The values should be set according to the specific use-case; for example, normal refrigerators would be 2-8°C, freezers are typically -25 to -10°C.
24. Individual MS settings – Humidity Sensor Define Sensors: • If the MS is not the MS-TH version (with Humidity sensor), the Humidity sensor switch will be grayed out. • Enable or Disable Humidity Sensor: • Set Maximum and Minimum threshold values. • Set a pre warning offset parameter to send a warning by Push notification when close to one of the thresholds.
25. Individual MS settings – Light Sensor Define Sensors: • Enable or Disable Light Sensor: • Define the relevant threshold between Dark and Bright. • The recommended value is 12 Lux (which is also the minimum).
26. Individual MS settings – Magnetic Sensor Define Sensors: • Enable or Disable Magnetic sensor: • The magnetic sensor indicates if a magnet is present or not, which is usually used for detecting if a window/door is opened or closed. • For optimal detection it is recommended to place the magnet within a range of 1–3 cm from the sensor in the MS, which is marked by the magnet icon, where the triangle indicating north is pointed towards the MS.
27. Individual MS settings – Accelerometer Sensor Define Sensors: • Enable or Disable the Accelerometer Sensor: • Define the Orientation Change threshold using degrees as units to trigger an alert. • Define the Operation Mode as Impact Detection or Movement Detection. • Set the sensitivity threshold of the Accelerometer sensor, in g units. • Recommended values: • For Impact mode: 2-4 g • For Movement mode: 0.7-0.9 g
28. Individual MS settings – Button Press Sensor Define Sensors: • Enable or Disable Button Press Sensor: • Enable or disable MS turn-off mode. • Enable or disable button’s press alert capability in events log and push notifications.
29. Individual MS settings – Push Notifications Push Notifications - These settings enable the user to: • Push alerts from server • [Currently not utilized] • App local notifications • Enables or disables notifications from the smartphone OS. • Battery alerts • Define a threshold for when the app considers the battery as low. It will then create a violation and send a push notification, if enabled.
30. Individual MS settings – Saving changes • The app provides a confirmation message if one of the MS sensors settings is modified; upon any successfully saved change, a toast message is displayed, as shown below: • This message is displayed when: • Modifying any of the MS settings – in the following screens: • Set Transmission Level • Define Sensor • Set Transmission Policy • Exiting one of the above mentioned screens, and going back to the main Settings screen or any other screen. • Pressing the red button of the MultiSense briefly (if possible - or alternatively wait for its next periodic transmission).
31. Individual MS settings – Saving changes • If for some reason the configuration change wasn’t received or accepted by the MS within 1 minute, the app will display the following toast message, repeating it every 1 minute until it succeeds:
32. Individual MS settings – Set Proximity Thresholds Distance Limit (Global) • The Distance Limit, which is set globally for the entire app, represents an area where the application will process transmissions that will come from one or more paired MS devices. Beyond that area the application will ignore the signals (Max value = Default = 100m). • The Transmission Proximity Threshold represents the area where the application will send alerts if an individual MS moves out of it. • Warning: To receive proximity notifications correctly it is mandatory to set [Distance Limit] > [Transmission Proximity Threshold]. • All Distance parameters are converted from dBm units (according to a conversion table derived from empiric measurements we did) and then all decisions are executed according to these converted values. Distance Alert Threshold Smartphone WatchM
33.Transmissions as a function of modes • There are two toggle buttons in the application which govern the system: • Data Logger – located in: [Tap on individual MS] [Settings] Define Sensors • Tx-on-Violation Mode – located in: [Tap on individual MS] [Settings] [Set Transmission Policy] Transmission Upon Violation • Below is a table of operation modes of transmission as a function of the Data logger and Tx-on-Violation modes. ***It is recommended that P<V<R***
34. Server mode • Server Mode – Information is synced with the Cellocator IoT server, using a pre-registered account and secured credentials. • The user can use their credentials on the following platforms: • The WatchM application • The WatchM web portal (Link) • To enter Server Mode, enter your email and password and tap the “SIGN IN” button. • If you want to switch from Demo to Server Mode (or vice versa), tap the cogwheel icon (in the WatchList screen) and then “Log Out”.
35. Server mode description • When logging into Server Mode, additional icons are visible that are not shown in the Demo Mode: • There are two WatchM servers which manage the WatchM operations – if one of the servers (or both of them) are not operational, the link icon changes to red ; if both of them are operational then a green icon will appear . • Users can access the WatchM portal in two ways: • The WatchM application using the icon * • The WatchM web portal (Link) * This provides a “lite” view compared to the website portal and is more suitable for mobile apps.
36. WatchM website • The IoT portal provides the following functions: • A location map of your devices • Graphs and charts of measurements • Reports • History logs