IoTClient Widget
· v0.3.8-upd8
About
IoTClient is an Internet of Things client - it can be used as a client for any type of HTTP-(GET/PUT/POST) (REST) controllable device like garage doors, window blinds, light switches, TV-, audio- or other home entertainment devices. As well as to fetch values from sensors like door sensors or weather stations.
It is currently designed to control up to 4 different devices. Every device can be controlled with 6 actions.
________________________
Examples:
Device: garage door
Action 1: open
Action 2: stop
Action 3: close
Action 4: stop
Device: light switch
Action 1: turn on
Action 2: turn off
________________________
Prerequisites:
Garmin device must be connected via bluetooth to a smart phone.
Garmin Connect smartphone app is running
Smartphone must be able to reach your HTTP (REST) targets. (usually must be logged in to your private wifi - test it in smartphone browser first)
HTTP URLs for every single action must be known
________________________
How to configure:
Devices and actions must be configured with the help of your Garmin Connect smartphone or desktop app .
Start your Garmin Connect Smartphone App. Connect your Garmin device via bluetooth. Go to more - Garmin devices - select your device - Connect IQApps -- Widgets - IoTClient - Settings
Device 1 Name: is the name of the device 1 (sample: GARAGE DOOR )
Device 1 action 1 URL: is the URL which triggers the 1st action of the first device (sample: http://192.168.1.1/garagedoor/open)
Device 1 action 1 Name: is the name or short description of the first action of the first device (sample: „OPEN“)
Device 1 action 1 JParam: is the Json parameter name that will be displayed after doing the request. If left blank, the response status will be displayed instead
If you want to disable a device or an action just leave the appropriate name field blank!
Parameter "switch to next action automatically" controles the widget behaviour. If checked, every time a action was fired, the widget will switch to the next action automatically. (good for window blinds or garage doors) If not checked, you have to switch to the next action by double click/double tap manually. (good for volume control or TV channel switches)
To send a JSON PUT just add the JSON as URL parameter to your to your action URL.
Parameter name must be json_put or json_post.
Example: http://bridge IP address/api/lights/..../state?json_put={on:true, sat:254, bri:254,hue:10000}
________________________
How to use:
Start the widget by pressing up or down until IoTClient widget is displayed.
If the lines above and below the texts is green, BT connection is running. If red, check your BT connection!
Push Start/Stop (or tap screen on touch screen devices like vivoactive) to trigger the current action. If "auto-switch action for device" is checked the widget will switch to the next action automatically.
Double-Push Start/Stop (or double-tap screen on touch screen devices like vivoactive) to switch to the next action without triggering the action.
Push menu (hold UP) to switch to the next device.
________________________
Support:
Please use the [contact developer] button or the following forum link.
If you have questions how to address your IoT device or if you want to share how you do control your device please use the following form link.
forum: https://forums.garmin.com/showthread.php?357432-Widget-IoTClient (use your existing Garmin Connect credentials to post in the forum)
________________________
Versions:
...
0.2.0 it now displays responses of devices or sensors if "Device n action n JParam" is configured (JSON response needed)
0.2.1 larger result font
0.3.0 added JSON PUT and JSON POST requests
What's new
0.3.8 green/red lines above and below the text indicate running/broken BT connection
0.3.7 increased max URL length to 300 characters
0.3.6 new SDK, new devices
0.3.5 enables one single valueless GET parameter (like http://192.168.01.1?valuelessparameter)
0.3.4 added forerunner 935. improved exeption handling