├── _devices.php
├── README.md
├── index.html
└── govee-device-handler.groovy


/_devices.php:
--------------------------------------------------------------------------------
 1 | <?php
 2 | 	/*
 3 | 	print '<div align="left"><pre>';
 4 | 	print_r($_REQUEST);
 5 | 	print '</pre></div>';
 6 | 	die;
 7 | 	//*/
 8 | 	
 9 | 	$curl = curl_init();
10 | 
11 | 	curl_setopt_array($curl, array(
12 | 		CURLOPT_URL => 'https://developer-api.govee.com/v1/devices',
13 | 		CURLOPT_RETURNTRANSFER => true,
14 | 		CURLOPT_ENCODING => '',
15 | 		CURLOPT_MAXREDIRS => 10,
16 | 		CURLOPT_TIMEOUT => 0,
17 | 		CURLOPT_FOLLOWLOCATION => true,
18 | 		CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
19 | 		CURLOPT_CUSTOMREQUEST => 'GET',
20 | 		CURLOPT_HTTPHEADER => array(
21 | 			'Govee-API-Key: ' . trim($_REQUEST['Govee-API-Key']),
22 | 		),
23 | 	));
24 | 
25 | 	$response = curl_exec($curl);
26 | 
27 | 	curl_close($curl);
28 | 	
29 | 	header('Content-Type: application/json; charset=utf-8');
30 | 	print json_encode($response);
31 | 	exit;
32 | ?>


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | # smartthings-govee-led-lights
 2 | Govee LED Light Strips integration for Samsung SmartThings
 3 | 
 4 | ## UPDATED AS OF 2022-10-04
 5 | Govee has began limiteding the number of API calls an account is allotted to have. This happened back in May 2022, however it is being fully implemented now and is affecting users with multiple Govee devices accessing the API.
 6 | So this release (v2) updates with a parameter setting that allows the user to set their own "polling" time (in seconds).
 7 | 
 8 | ### Pre-requisites
 9 | Must have a Samsung SmartThings account setup (https://account.smartthings.com)
10 | Govee LED Light Strips
11 | Govee API Key (generated from the Govee mobile app)
12 | 
13 | ### To integrate this into SmartThings, you'll follow these steps:
14 | ![#f03c15](https://via.placeholder.com/15/f03c15/000000?text=+) To properly integration into Samsung SmartThings, please go to the following URL: https://www.deanberman.com/govee/smartthings/
15 | This page will provide you step-by-step procedures on add the device and device type handlers into your SmartThings account.  You provide it your Govee API Key and it will retrieve the list of device ids, names, and models for the device preferences.
16 | 
17 | If you are more comfortable running the file(s) locally and have a webservice and php enabled locally, then you may download the index.html and the \_devices.php file and implement them locally (just update the index.html file for the URL reference location).
18 | 
19 | #### The following list of model numbers are currently supported (according to Govee API document):
20 | Lights, Plugs, Switches:
21 | H6160, H6163, H6104, H6109, H6110, H6117, H6159, H7022, H6086,
22 | H6089, H6182, H6085, H7014, H5081, H6188, H6135, H6137, H6141,
23 | H6142, H6195, H7005, H6083, H6002, H6003, H6148, H6052, H6143,
24 | H6144, H6050, H6199, H6054, H5001, H6154, H6072, H6121, H611A,
25 | H5080, H6062, H614C, H615A, H615B, H7020, H7021, H614D, H611Z,
26 | H611B, H611C, H615C, H615D, H7006, H7007, H7008, H7012, H7013,
27 | H7050, H6051, H6056, H6061, H6058, H6073, H6076, H619A, H619C,
28 | H618A, H618C, H6008, H6071, H6075, H614A, H614B, H614E, H618E,
29 | H619E, H605B, H6087, H6172, H619B, H619D, H619Z, H61A0, H7060,
30 | H610A, H6059, H7028, H6198, H6049, H7031, H7032, H61A1, H61A2,
31 | H61B2, H7061, H6067, H6066, H6009, H7041, H7042, H604A, H6173,
32 | H615E, H604B, H6091, H7051, H7062, H618F, H605D, H6046, H601A,
33 | H61A3, H610B, H6047, H7065, H61E1, H6057, H604C, H6065, H605C,
34 | H705A, H705B, H7055, H61A5, H6078, H604D, H6168, H6601, H70B1,
35 | H61A8
36 | 
37 | Appliances:
38 | H7121, H7122, H7123, H7120, H7141, H7142, H7130, H7131, H7132,
39 | H7150, H7160, H7101, H7111
40 | 
41 | ### DEBUGGING/TROUBLESHOOTING
42 | If you edit the device type handler in your Samsung SmartThings account, search for the "refresh()" function and enable debugging by setting the following:  
43 | ```groovy
44 | set_DEBUG("off")
45 | ...to...
46 | set_DEBUG("on")
47 | ```
48 | 
49 | ### DTH DISCLAIMER
50 | After further testing, the API call for getting the device state may not work for all supported Govee models listed above.  Determing if it's a problem with the Govee API or if it's not supported due to the nature of the device model.
51 | 
52 | ### DISCLOSURE
53 | I am not SmartThings developer, I just did this because I wanted to be able to integrate my multiple Govee LED Light strips into my Smart home network, so I created this myself.  It works well for me and this isn't for sale, so feel free to use it, tweak it, whatever you want!
54 | Just a heads up, this isn't perfect by any means, so feel free to provide me some input and updates, I'll be happy to make them!
55 | 
56 | ### SPECIAL THANKS
57 | Those who have downloaded the DTH and are testing with it, thanks so much and please reach out to me with any questions or comments, I'm using this DTH daily so updating it will make me very happy with new features!
58 | 
59 | And an even more thanks to **@jc73uk** for your contribution to the app integration!  Your support will help further the development and integration of this DTH and other devices which may/may not be supported as of yet with Govee!
60 | 
61 | Enjoy!
62 | 
63 | 


--------------------------------------------------------------------------------
/index.html:
--------------------------------------------------------------------------------
  1 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
  2 | <html>
  3 | 	<head>
  4 | 		<meta http-equiv="Expires" content="Fri, Jan 01 1900 00:00:00 GMT">
  5 | 		<meta http-equiv="Pragma" content="no-cache">
  6 | 		<meta http-equiv="Cache-Control" content="no-cache">
  7 | 		<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
  8 | 		<meta http-equiv="Lang" content="en">
  9 | 		<meta name="author" content="Dean Berman - DB Development">
 10 | 		<meta http-equiv="Reply-to" content="db@deanberman.com">
 11 | 		<meta name="generator" content="PhpED 8.0">
 12 | 		<meta name="description" content="Govee LED Lights device configuration page">
 13 | 		<meta name="keywords" content="">
 14 | 		<meta name="creation-date" content="11/09/2020">
 15 | 		<meta name="revisit-after" content="15 days">
 16 | 		<title>Govee LED Lights - Device Configuration</title>
 17 | 		
 18 | 		<!-- Latest available jQuery v3.5.1 -->
 19 | 		<script src="https://ajax.googleapis.com/ajax/libs/jquery/3.5.1/jquery.min.js"></script>
 20 | 		
 21 | 		<!-- Latest compiled and minified CSS -->
 22 | 		<link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap.min.css" integrity="sha384-BVYiiSIFeK1dGmJRAkycuHAHRg32OmUcww7on3RYdg4Va+PmSTsz/K68vbdEjh4u" crossorigin="anonymous">
 23 | 		
 24 | 		<!-- Optional theme -->
 25 | 		<link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/css/bootstrap-theme.min.css" integrity="sha384-rHyoN1iRsVXV4nD0JutlnGaslCJuC7uwjduW9SVrLvRYooPp2bWYgmgJQIXwl/Sp" crossorigin="anonymous">
 26 | 		
 27 | 		<!-- Latest compiled and minified JavaScript -->
 28 | 		<script src="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.7/js/bootstrap.min.js" integrity="sha384-Tc5IQib027qvyjSMfHjOMaLkfuWVxZxUPnCJA7l2mCWNIpG9mGCD8wGNIcPD7Txa" crossorigin="anonymous"></script>
 29 | 		
 30 | 		<script type="text/javascript">
 31 | 			$(document).ready(function() {
 32 | 				$('#config-btn').bind('click', function() {
 33 | 					var apikey = $('#apikey').val();
 34 | 					
 35 | 					if(apikey == '') {
 36 | 						alert('Missing API Key. Please enter it in and try again.');
 37 | 						return false;
 38 | 					}
 39 | 					
 40 | 					$('#config-results').html('Loading, please wait...');
 41 | 					
 42 | 					$.ajax({
 43 | 						url: 'https://www.deanberman.com/govee/smartthings/_devices.php',
 44 | 						type: 'GET',
 45 | 						data: {
 46 | 							'Govee-API-Key': apikey
 47 | 						},
 48 | 						success: function(data) {
 49 | 							var resp = '';
 50 | 							
 51 | 							data = JSON.parse(data);
 52 | 							
 53 | 							if(data.code != '200' || data.message != 'Success') {
 54 | 								alert('There was a problem getting your Govee devices. Please confirm your Govee API Key and try again.');
 55 | 								return false;
 56 | 							}
 57 | 							
 58 | 							if((data.data.devices).length == 0) {
 59 | 								alert('You have no accessible devices setup within your Govee account at this time.');
 60 | 								return false;
 61 | 							}
 62 | 							
 63 | 							resp += '<div class="row"><div class="col-xs-12">&nbsp;</div></div>';
 64 | 							resp += '<div class="row">';
 65 | 								resp += '<div class="col-xs-3"><strong>Device Name</strong></div>';
 66 | 								resp += '<div class="col-xs-2"><strong>Model</strong></div>';
 67 | 								resp += '<div class="col-xs-7"><strong>Device ID</strong></div>';
 68 | 								
 69 | 								//	Now to loop throught the devices and print accordingly...
 70 | 								for(var a = 0; a < (data.data.devices).length; a++) {
 71 | 									resp += '<div class="col-xs-3">' + data.data.devices[a].deviceName + '</div>';
 72 | 									resp += '<div class="col-xs-2">' + data.data.devices[a].model + '</div>';
 73 | 									resp += '<div class="col-xs-7">' + data.data.devices[a].device + '</div>';
 74 | 								}
 75 | 							resp += '</div>';
 76 | 							resp += '<div class="row"><div class="col-xs-12">&nbsp;</div></div>';
 77 | 							
 78 | 							resp += '<div class="row">';
 79 | 								resp += '<div class="col-xs-12">Please use the list below to populate the Samsung SmartThings Device preferences page (see setup steps for <strong>Device</strong>).</div>';
 80 | 							resp += '</div>';
 81 | 							
 82 | 							$('#config-results').html(resp);
 83 | 						},
 84 | 						error: function(xhr, ajaxOptions, thrownError) {
 85 | 							alert('There was an error with your Govee API Key. Please confirm and try again.');
 86 | 							return false;
 87 | 						}
 88 | 					});
 89 | 				});
 90 | 			});
 91 | 		</script>
 92 | 	</head>
 93 | 	<body>
 94 | 		<div class="container" style="padding-top:25px;">
 95 | 			<h2>Govee LED Lights - Device Configuration</h2>
 96 | 			<h4>DB Development - Dean Berman</h4>
 97 | 			<h6>Created/Last Updated: 2020-11-09</h6>
 98 | 			<br />
 99 | 			
100 | 			<div class="alert alert-danger">IMPORTANT: This is not sponsered or paid for or supported by Govee, this was generated to help anyone else [other than just myself] to get the amazing WiFi Govee LED Lights into Samsung SmartThings for integration, automation, smart panels, ActionTiles, SharpTools, etc.</div>
101 | 			<br />
102 | 			
103 | 			<ul class="nav nav-tabs" role="tablist">
104 | 				<li role="presentation" class="active"><a href="#home" role="tab" data-toggle="tab">Home</a></li>
105 | 				<li role="presentation"><a href="#config" role="tab" data-toggle="tab">Configuration</a></li>
106 | 				<li role="presentation"><a href="https://github.com/uncdubdiver/smartthings-govee-led-lights" target="_blank">GitHub</a></li>
107 | 			</ul>
108 | 			
109 | 			<div class="tab-content">
110 | 				<div id="home" class="tab-pane fade active in">
111 | 					<div class="panel panel-default">
112 | 						<div class="panel-body">
113 | 							The Govee LED Lights SmartThings Device Type Handler was generated to fill a need with accessing the WiFi connected Govee LED Lights.
114 | 							<br /><br />
115 | 							The Device Type Handler is built to handle any of the existing WiFi connected Govee LED Lights that are accesible through their API.
116 | 							<br /><br />
117 | 							The following list of model numbers are currently supported:
118 | 							<ul>
119 | 								<li>H6160</li>
120 | 								<li>H6163</li>
121 | 								<li>H6104</li>
122 | 								<li>H6109</li>
123 | 								<li>H6110</li>
124 | 								<li>H6117</li>
125 | 								<li>H6159</li>
126 | 								<li>H7021</li>
127 | 								<li>H7022</li>
128 | 								<li>H6086</li>
129 | 								<li>H6089</li>
130 | 								<li>H6182</li>
131 | 								<li>H6085</li>
132 | 								<li>H7014</li>
133 | 								<li>H5081</li>
134 | 								<li>H6188</li>
135 | 								<li>H6135</li>
136 | 								<li>H6137</li>
137 | 								<li>H6141</li>
138 | 								<li>H6142</li>
139 | 								<li>H6195</li>
140 | 								<li>H6196</li>
141 | 								<li>H7005</li>
142 | 								<li>H6083</li>
143 | 								<li>H6002</li>
144 | 								<li>H6003</li>
145 | 								<li>H6148</li>
146 | 							</ul>
147 | 							<br />
148 | 							To get your Govee LED Lights device setup properly within Samsung SmartThings, please follow the steps below.
149 | 							<br />
150 | 							<h4>Govee API Key</h4>
151 | 							<ol>
152 | 								<li>Open the Govee Home app on your mobile device.</li>
153 | 								<li>In the navigation, go to the <em>user/profile</em> page by clicking on the user icon.</li>
154 | 								<li>In the <em>My Profile</em> page, select <em>About Us</em>.</li>
155 | 								<li>In the <em>About Us</em> page, select <em>Apply for API Key</em>.</li>
156 | 								<li>Fill in the form on the <em>Apply for API Key</em> page to retrieve a unique API key for your Govee user account.</li>
157 | 								<li>
158 | 									Click [Submit] to apply.
159 | 									<br />
160 | 									<em>You will receive an email from Govee soon with your unique API key.</em>
161 | 								</li>
162 | 							</ol>
163 | 							
164 | 							<h4>Device Type Handler</h4>
165 | 							<ol>
166 | 								<li>
167 | 									Login to the Samsung SmartThings account management interface:
168 | 									<a href="https://account.smartthings.com/login" target="_blank">https://account.smartthings.com/login</a>
169 | 								</li>
170 | 								<li>In the <em>SmartThings Groovy IDE</em>, navigate to the <em>My Device Handlers</em> link/page.</li>
171 | 								<li>In the <em>Device Handlers</em> page, click the [+ Create New Device Handler] button.</li>
172 | 								<li>In the <em>Create New Device Handler</em> page, select the <em>From Code</em> tab.</li>
173 | 								<li>From the DB Development Govee LED Strips (DBDEV) GitHub page, copy-and-paste in the code for the Device Type Handler in this form/page.</li>
174 | 								<li>Click [Create] to save and continue.</li>
175 | 							</ol>
176 | 							
177 | 							<h4>Device</h4>
178 | 							<ol>
179 | 								<li>
180 | 									Login to the Samsung SmartThings account management interface:
181 | 									<a href="https://account.smartthings.com/login" target="_blank">https://account.smartthings.com/login</a>
182 | 								</li>
183 | 								<li>In the <em>SmartThings Groovy IDE</em>, navigate to the <em>My Devices</em> link/page.</li>
184 | 								<li>In the <em>Devices</em> page, click the [+ New Device] button.</li>
185 | 								<li>
186 | 									In the <em>Create Device</em> page, setup the following settings:
187 | 									<ul>
188 | 										<li>Name: <em>Setup your device name accordingly</em></li>
189 | 										<li>Label: <em>I usually just use the same Name</em></li>
190 | 										<li>Zigbee Id: <em>&lt;leave blank&gt;</em></li>
191 | 										<li>Device Network Id: <em>Use something that is only characters and dashes or underscores (something unique)</em></li>
192 | 										<li>Type: <em>Select Govee LED Strips (DBDEV) from the dropdown list</em></li>
193 | 										<li>Version: <em>Select Self-Published</em></li>
194 | 										<li>Location: <em>Select Home (or whatever your location name is)</em></li>
195 | 										<li>Hub: <em>Select SmartThings Hub (or whatever your hub name is)</em></li>
196 | 										<li>Group: <em>&lt;leave blank&gt;</em></li>
197 | 									</ul>
198 | 									Once completed, click [Create].
199 | 								</li>
200 | 								<li>Once the page reloads, in the left column, for <em>Preferences</em>, click <em>edit</em>.</li>
201 | 								<li>
202 | 									In the edit preferences page, 3 form fields will be preset. Set each of these form fields accordingly below:
203 | 									<ul>
204 | 										<li><strong>Govee API Key - Designated Govee API Key for accessing their system</strong> - this value is given to you by Govee from their app (should be found on the Configuration tab)</li>
205 | 										<li><strong>Govee KED Device ID - Device ID for the Govee LED Lights</strong> - can be found on the Configuration tab</li>
206 | 										<li><strong>Govee LED Model - Model number of the Govee LED Lights</strong> - can be found on the Configuration tab</li>
207 | 									</ul>
208 | 								</li>
209 | 								<li>Once completed, click [Save].</li>
210 | 							</ol>
211 | 						</div>
212 | 					</div>
213 | 				</div>
214 | 				<div id="config" class="tab-pane fade">
215 | 					<div class="panel panel-default">
216 | 						<div class="panel-body">
217 | 							The following form/details below will allow you to confirm your Samsung SmartThings Device preferences accordingly.
218 | 							<br /><br />
219 | 							<label>Govee API Key:</label> <input type="text" name="apikey" id="apikey" class="form-control">
220 | 							<small><em>Designated Govee API Key for accessing their system</em></small>
221 | 							<br /><br />
222 | 							<button name="config-btn" id="config-btn" class="btn btn-sm btn-info">Get Configuration</button>
223 | 							<div id="config-results"></div>
224 | 						</div>
225 | 					</div>
226 | 				</div>
227 | 			</div>
228 | 		</div>
229 | 	</body>
230 | </html>
231 | 


--------------------------------------------------------------------------------
/govee-device-handler.groovy:
--------------------------------------------------------------------------------
  1 | /**
  2 |  *  Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
  3 |  *  in compliance with the License. You may obtain a copy of the License at:
  4 |  *
  5 |  *      http://www.apache.org/licenses/LICENSE-2.0
  6 |  *
  7 |  *  Unless required by applicable law or agreed to in writing, software distributed under the License is distributed
  8 |  *  on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License
  9 |  *  for the specific language governing permissions and limitations under the License.
 10 |  *
 11 |  */
 12 | metadata {
 13 | 	definition (
 14 | 		name: "Govee LED Strips (DBDEV)",
 15 | 		version: "v2",
 16 | 		namespace: "dbdevelopment",
 17 | 		author: "Dean Berman",
 18 | 		description: "Govee LED Strips Integration",
 19 | 		category: "My Apps",
 20 | 	) {
 21 | 
 22 | 		capability "Switch Level"
 23 | 		capability "Actuator"
 24 | 		capability "Color Control"
 25 | 		// capability "Power Meter"
 26 | 		capability "Switch"
 27 | 		capability "Refresh"
 28 | 		capability "Sensor"
 29 | 
 30 | 		command "setAdjustedColor"
 31 | 		command "reset"
 32 | 		command "refresh"
 33 | 	}
 34 | 
 35 | 	tiles(scale: 2) {
 36 | 		multiAttributeTile(name:"switch", type: "lighting", width: 6, height: 4, canChangeIcon: true) {
 37 | 			tileAttribute ("device.switch", key: "PRIMARY_CONTROL") {
 38 | 				attributeState "on", label:'${name}', action:"switch.off", icon:"st.lights.philips.hue-single", backgroundColor:"#00A0DC", nextState:"turningOff"
 39 | 				attributeState "off", label:'${name}', action:"switch.on", icon:"st.lights.philips.hue-single", backgroundColor:"#ffffff", nextState:"turningOn"
 40 | 				attributeState "turningOn", label:'${name}', action:"switch.off", icon:"st.lights.philips.hue-single", backgroundColor:"#00A0DC", nextState:"turningOff"
 41 | 				attributeState "turningOff", label:'${name}', action:"switch.on", icon:"st.lights.philips.hue-single", backgroundColor:"#ffffff", nextState:"turningOn"
 42 | 			}
 43 | 			tileAttribute ("device.power", key: "SECONDARY_CONTROL") {
 44 | 				attributeState "power", label:'Power level: ${currentValue}W', icon: "st.Appliances.appliances17"
 45 | 			}
 46 | 			tileAttribute ("device.level", key: "SLIDER_CONTROL") {
 47 | 				attributeState "level", action:"switch level.setLevel"
 48 | 			}
 49 | 			tileAttribute ("device.color", key: "COLOR_CONTROL") {
 50 | 				attributeState "color", action:"setAdjustedColor"
 51 | 			}
 52 | 		}
 53 | 
 54 | 		multiAttributeTile(name:"switchNoPower", type: "lighting", width: 6, height: 4, canChangeIcon: true) {
 55 | 			tileAttribute ("device.switch", key: "PRIMARY_CONTROL") {
 56 | 				attributeState "on", label:'${name}', action:"switch.off", icon:"st.lights.philips.hue-single", backgroundColor:"#00A0DC", nextState:"turningOff"
 57 | 				attributeState "off", label:'${name}', action:"switch.on", icon:"st.lights.philips.hue-single", backgroundColor:"#ffffff", nextState:"turningOn"
 58 | 				attributeState "turningOn", label:'${name}', action:"switch.off", icon:"st.lights.philips.hue-single", backgroundColor:"#00A0DC", nextState:"turningOff"
 59 | 				attributeState "turningOff", label:'${name}', action:"switch.on", icon:"st.lights.philips.hue-single", backgroundColor:"#ffffff", nextState:"turningOn"
 60 | 			}
 61 | 			tileAttribute ("device.level", key: "SLIDER_CONTROL") {
 62 | 				attributeState "level", action:"switch level.setLevel"
 63 | 			}
 64 | 			tileAttribute ("device.color", key: "COLOR_CONTROL") {
 65 | 				attributeState "color", action:"setAdjustedColor"
 66 | 			}
 67 | 		}
 68 | 
 69 | 		multiAttributeTile(name:"switchNoSlider", type: "lighting", width: 6, height: 4, canChangeIcon: true) {
 70 | 			tileAttribute ("device.switch", key: "PRIMARY_CONTROL") {
 71 | 				attributeState "on", label:'${name}', action:"switch.off", icon:"st.lights.philips.hue-single", backgroundColor:"#00A0DC", nextState:"turningOff"
 72 | 				attributeState "off", label:'${name}', action:"switch.on", icon:"st.lights.philips.hue-single", backgroundColor:"#ffffff", nextState:"turningOn"
 73 | 				attributeState "turningOn", label:'${name}', action:"switch.off", icon:"st.lights.philips.hue-single", backgroundColor:"#00A0DC", nextState:"turningOff"
 74 | 				attributeState "turningOff", label:'${name}', action:"switch.on", icon:"st.lights.philips.hue-single", backgroundColor:"#ffffff", nextState:"turningOn"
 75 | 			}
 76 | 			tileAttribute ("device.power", key: "SECONDARY_CONTROL") {
 77 | 				attributeState "power", label:'The power level is currently: ${currentValue}W', icon: "st.Appliances.appliances17"
 78 | 			}
 79 | 			tileAttribute ("device.color", key: "COLOR_CONTROL") {
 80 | 				attributeState "color", action:"setAdjustedColor"
 81 | 			}
 82 | 		}
 83 | 
 84 | 		multiAttributeTile(name:"switchNoSliderOrColor", type: "lighting", width: 6, height: 4, canChangeIcon: true) {
 85 | 			tileAttribute ("device.switch", key: "PRIMARY_CONTROL") {
 86 | 				attributeState "on", label:'${name}', action:"switch.off", icon:"st.lights.philips.hue-single", backgroundColor:"#00A0DC", nextState:"turningOff"
 87 | 				attributeState "off", label:'${name}', action:"switch.on", icon:"st.lights.philips.hue-single", backgroundColor:"#ffffff", nextState:"turningOn"
 88 | 				attributeState "turningOn", label:'${name}', action:"switch.off", icon:"st.lights.philips.hue-single", backgroundColor:"#00A0DC", nextState:"turningOff"
 89 | 				attributeState "turningOff", label:'${name}', action:"switch.on", icon:"st.lights.philips.hue-single", backgroundColor:"#ffffff", nextState:"turningOn"
 90 | 			}
 91 | 			tileAttribute ("device.power", key: "SECONDARY_CONTROL") {
 92 | 				attributeState "power", label:'The light is currently consuming this amount of power: ${currentValue}W', icon: "st.Appliances.appliances17"
 93 | 			}
 94 | 		}
 95 | 
 96 | 		valueTile("color", "device.color", inactiveLabel: false, decoration: "flat", width: 2, height: 2) {
 97 | 			state "color", label: '${currentValue}'
 98 | 		}
 99 | 
100 | 		standardTile("reset", "device.reset", inactiveLabel: false, decoration: "flat", width: 2, height: 2) {
101 | 			state "reset", label:"Reset Color", action:"reset", icon:"st.lights.philips.hue-single", defaultState: true
102 | 		}
103 | 		standardTile("refresh", "device.switch", inactiveLabel: false, decoration: "flat", width: 2, height: 2) {
104 | 			state "refresh", label:"", action:"refresh.refresh", icon:"st.secondary.refresh", defaultState: true
105 | 		}
106 | 
107 | 		main(["switch"])
108 | 		details(["switch", "switchNoPower", "switchNoSlider", "switchNoSliderOrColor", "color", "refresh", "reset"])
109 | 	}
110 | }
111 | 
112 | preferences {
113 | 	section("Govee LED Device") {
114 | 		// TODO: put inputs here
115 |         input("apikey", "apikey", title: "Govee API Key", description: "Designated Govee API Key for accessing their system", required: true)
116 |         input("deviceID", "deviceid", title: "Govee KED Device ID", description: "Device ID for the Govee LED Lights", required: true)
117 |         input("modelNum", "modelnum", title: "Govee LED Model", description: "Model number of the Govee LED Lights", required: true)
118 |         input("refreshTimeSec", "refreshTimeSec", title: "Polling/Refresh Time", description: "Number of seconds between refreshing (minimum 300)", required: true)
119 | 	}
120 | }
121 | 
122 | // parse events into attributes
123 | def parse(description) {
124 | 	log.trace "Executing 'parse($description)'..."
125 | 	
126 | 	def results = []
127 | 	def map = description
128 | 	if (description instanceof String)  {
129 | 		log.debug "Hue Bulb stringToMap - ${map}"
130 | 		map = stringToMap(description)
131 | 	}
132 | 	if (map?.name && map?.value) {
133 | 		results << createEvent(name: "${map?.name}", value: "${map?.value}")
134 | 	}
135 | 	results
136 | }
137 | 
138 | // handle commands
139 | def on() {
140 | 	log.trace "Executing 'on()'..."
141 | 	
142 | 	callURL('devicecontrol-power', "on")
143 | 	
144 | 	sendEvent(name: "switch", value: "on")
145 | }
146 | 
147 | def off() {
148 | 	log.trace "Executing 'off()'..."
149 | 	
150 | 	callURL('devicecontrol-power', "off")
151 | 	
152 | 	sendEvent(name: "switch", value: "off")
153 | }
154 | 
155 | def nextLevel() {
156 | 	log.trace "Executing 'nextLevel()'..."
157 | 	
158 | 	def level = device.latestValue("level") as Integer ?: 0
159 | 	if (level <= 100) {
160 | 		level = Math.min(25 * (Math.round(level / 25) + 1), 100) as Integer
161 | 	}
162 | 	else {
163 | 		level = 25
164 | 	}
165 | 	setLevel(level)
166 | }
167 | 
168 | def setLevel(percent, rate = null) {
169 | 	log.trace "Executing 'setLevel($percent, this)'..."
170 | 	
171 | 	sendEvent(name: "level", value: percent)
172 | 	def power = Math.round(percent / 1.175) * 0.1
173 | 	
174 | 	callURL('devicecontrol-brightness', percent)
175 | 	
176 | 	// sendEvent(name: "power", value: power)
177 | }
178 | 
179 | def setSaturation(percent) {
180 | 	log.trace "Executing 'setSaturation($percent)'..."
181 | 	
182 | 	sendEvent(name: "saturation", value: percent)
183 | }
184 | 
185 | def setHue(percent) {
186 | 	log.trace "Executing 'setHue($percent)'..."
187 | 	
188 | 	sendEvent(name: "hue", value: percent)
189 | }
190 | 
191 | def setColor(value) {
192 | 	log.trace "Executing 'setColor($value)'..."
193 | 	
194 | 	if (value.hue) { sendEvent(name: "hue", value: value.hue)}
195 | 	if (value.saturation) { sendEvent(name: "saturation", value: value.saturation)}
196 | 	if (value.hex) { sendEvent(name: "color", value: value.hex)}
197 | 	if (value.level) { sendEvent(name: "level", value: value.level)}
198 | 	if (value.switch) { sendEvent(name: "switch", value: value.switch)}
199 | 	
200 | 	def rgb
201 | 	// state.staged << value.subMap("hue", "saturation") // stage ST hue and saturation attributes
202 | 	def hex = colorUtil.hsvToHex(Math.round(value.hue) as int, Math.round(value.saturation) as int) // convert to hex
203 | 	log.trace "HEX=${hex}"
204 | 	// state.staged << [color: hex] // stage ST RGB color attribute
205 | 	rgb = colorUtil.hexToRgb(hex) // separate RGB elements for zwave setter
206 | 	callURL('devicecontrol-rgb', rgb)
207 | }
208 | 
209 | def reset() {
210 | 	log.trace "Executing 'reset()'..."
211 | 	
212 | 	setAdjustedColor([level:100, hex:"#90C638", saturation:56, hue:23])
213 | }
214 | 
215 | def setAdjustedColor(value) {
216 | 	log.trace "Executing 'setAdjustedColor($value)'..."
217 | 	
218 | 	if (value) {
219 | 		log.trace "setAdjustedColor: ${value}"
220 | 		def adjusted = value + [:]
221 | 		adjusted.hue = adjustOutgoingHue(value.hue)
222 | 		// Needed because color picker always sends 100
223 | 		adjusted.level = null
224 | 		setColor(adjusted)
225 | 	}
226 | }
227 | 
228 | def installed() {
229 | 	log.trace "Executing 'installed()'.."
230 | 	refresh()
231 | }
232 | 
233 | def updated() {
234 | 	log.trace "Executing 'updated()'.."
235 | 	refresh()
236 | 	
237 | 	// unschedule()
238 | 	// runEvery1Minutes(refresh)
239 | 	// runIn(2, refresh)
240 | }
241 | 
242 | def poll() {
243 | 	log.trace "Executing 'poll()'..."
244 | 	
245 | 	refresh()
246 | }
247 | 
248 | def refresh() {
249 | 	log.trace "Executing 'refresh()'..."
250 | 	
251 | 	def ret = callURL('devicestate', '')
252 | 	
253 | 	// Handling the power state
254 | 	def power = ret.data["properties"][1]["powerState"]
255 | 	// log.debug "POWER=${power}"
256 | 	sendEvent(name: "switch", value: power)
257 | 	
258 | 	// Handling the brightness level
259 | 	def brightness = ret.data["properties"][2]["brightness"]
260 | 	// log.debug "BRIGHTNESS=${brightness}"
261 | 	sendEvent(name: "level", value: brightness)
262 | 	
263 | 	// Handling the color
264 | 	def rgb = [ret.data["properties"][3]["color"]["r"], ret.data["properties"][3]["color"]["g"], ret.data["properties"][3]["color"]["b"]]
265 | 	// log.debug "RGB=${rgb}"
266 | 	def hex  = colorUtil.rgbToHex(rgb[0], rgb[1], rgb[2])
267 | 	// log.debug "HEX=${hex}"
268 | 	sendEvent(name: "color", value: hex)
269 | 	
270 | 	// unschedule()
271 | 	// Set it to run every 5 minutes
272 | 	// runEvery5Minutes(refresh)
273 | 	// Set it to run once a minute (continuous polling)
274 | 	// runEvery1Minute(refresh)
275 | 	
276 | 	unschedule()
277 | 	// Set it to run once a minute (continuous polling)
278 | 	if(get_DEBUG() == "on") { log.debug "[refresh()] ---- Polling/Refresh every ${settings.refreshTimeSec}" }
279 | 	runIn(settings.refreshTimeSec as int, refresh)
280 | }
281 | 
282 | def adjustOutgoingHue(percent) {
283 | 	log.trace "Executing 'adjustOutgoingHue($percent)'..."
284 | 	
285 | 	def adjusted = percent
286 | 	if (percent > 31) {
287 | 		if (percent < 63.0) {
288 | 			adjusted = percent + (7 * (percent -30 ) / 32)
289 | 		}
290 | 		else if (percent < 73.0) {
291 | 			adjusted = 69 + (5 * (percent - 62) / 10)
292 | 		}
293 | 		else {
294 | 			adjusted = percent + (2 * (100 - percent) / 28)
295 | 		}
296 | 	}
297 | 	log.info "percent: $percent, adjusted: $adjusted"
298 | 	adjusted
299 | }
300 | 
301 | 
302 | 
303 | 
304 | 
305 | 
306 | 
307 | 
308 | 
309 | 
310 | 
311 | 
312 | // TODO: implement event handlers
313 | def callURL(apiAction, details) {
314 | 	log.trace "Executing 'callURL($apiAction, $details)'..."
315 | 	
316 | 	// log.trace "[SETTINGS] APIKEY=${settings.apikey}, ID=${settings.deviceID}, MODEL=${settings.modelNum}"
317 | 	
318 |     def params
319 | 	if(apiAction == 'devices') {
320 |         params = [
321 |             method: 'GET',
322 |             uri   : "https://developer-api.govee.com",
323 |             path  : '/v1/devices',
324 | 			headers: ["Govee-API-Key": settings.apikey, "Content-Type": "application/json"],
325 |         ]
326 | 	} else if(apiAction == 'devicestate') {
327 |         params = [
328 |             method: 'GET',
329 |             uri   : "https://developer-api.govee.com",
330 |             path  : '/v1/devices/state',
331 | 			headers: ["Govee-API-Key": settings.apikey, "Content-Type": "application/json"],
332 | 			query: [device: settings.deviceID, model: settings.modelNum],
333 |         ]
334 | 	} else if(apiAction == 'devicecontrol-power') {
335 |         params = [
336 |             method: 'PUT',
337 |             uri   : "https://developer-api.govee.com",
338 |             path  : '/v1/devices/control',
339 | 			headers: ["Govee-API-Key": settings.apikey, "Content-Type": "application/json"],
340 | 			contentType: "application/json",
341 | 			body: [device: settings.deviceID, model: settings.modelNum, cmd: ["name": "turn", "value": details]],
342 |         ]
343 | 	} else if(apiAction == 'devicecontrol-brightness') {
344 |         params = [
345 |             method: 'PUT',
346 |             uri   : "https://developer-api.govee.com",
347 |             path  : '/v1/devices/control',
348 | 			headers: ["Govee-API-Key": settings.apikey, "Content-Type": "application/json"],
349 | 			contentType: "application/json",
350 | 			body: [device: settings.deviceID, model: settings.modelNum, cmd: ["name": "brightness", "value": details]],
351 |         ]
352 | 	} else if(apiAction == 'devicecontrol-rgb') {
353 |         params = [
354 |             method: 'PUT',
355 |             uri   : "https://developer-api.govee.com",
356 |             path  : '/v1/devices/control',
357 | 			headers: ["Govee-API-Key": settings.apikey, "Content-Type": "application/json"],
358 | 			contentType: "application/json",
359 | 			body: [device: settings.deviceID, model: settings.modelNum, cmd: ["name": "color", "value": ["r": details[0], "g": details[1], "b": details[2]]]],
360 |         ]
361 |     }
362 |     
363 | 	/*
364 |     log.debug params
365 |     log.debug "APIACTION=${apiAction}"
366 |     log.debug "METHOD=${params.method}"
367 |     log.debug "URI=${params.uri}${params.path}"
368 |     log.debug "HEADERS=${params.headers}"
369 |     log.debug "QUERY=${params.query}"
370 |     log.debug "BODY=${params.body}"
371 | 	//*/
372 | 	
373 | 	try {
374 | 		if(params.method == 'GET') {
375 | 			httpGet(params) { resp ->
376 | 				//log.debug "RESP="
377 | 				//log.debug "HEADERS="+resp.headers
378 | 				//log.debug "DATA="+resp.data
379 | 				
380 | 				log.debug "response.data="+resp.data
381 | 				
382 | 				return resp.data
383 | 			}
384 | 		} else if(params.method == 'PUT') {
385 | 			httpPutJson(params) { resp ->
386 | 				//log debug "RESP="
387 | 				//log.debug "HEADERS="+resp.headers
388 | 				//log.debug "DATA="+resp.data
389 | 				
390 | 				log.debug "response.data="+resp.data
391 | 				
392 | 				return resp.data
393 | 			}
394 | 		}
395 | 	} catch (groovyx.net.http.HttpResponseException e) {
396 | 		log.error "callURL() >>>>>>>>>>>>>>>> ERROR >>>>>>>>>>>>>>>>"
397 | 		log.error "Error: e.statusCode ${e.statusCode}"
398 | 		log.error "${e}"
399 | 		log.error "callURL() <<<<<<<<<<<<<<<< ERROR <<<<<<<<<<<<<<<<"
400 | 		
401 | 		return 'unknown'
402 | 	}
403 | }
404 | 


--------------------------------------------------------------------------------