node-red-contrib-google-smarthome
Version:
Lets you control Node-Red via Google Assistant or the Google Home App
65 lines (59 loc) • 5.06 kB
HTML
<!--
node-red-contrib-google-smarthome
Copyright (C) 2025 Michael Jacobsen and others.
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
-->
<script type="text/x-red" data-help-name="googlesmarthome-client">
<code>Name</code>: A name for the node.<br>
<code>Enable Node Debug</code>: If enabled, debugging information will be logged to Node-RED's log.<br>
<code>Default language</code>: The language of your project.<br>
<br>
<b>Local Authentication</b><br>
<code>Use Google login</code>: If enabled, use Google Sign-In to link your account in the Google Home App. See
<a href="https://github.com/mikejac/node-red-contrib-google-smarthome/blob/master/docs/google_signin.md"
target="_blank">the docs</a> for more information.<br>
<code>Login Client ID</code>: If Google Login is enabled, the client ID you gained from the *Google Sign-In* integration.<br>
<code>Authorized emails</code>: If Google Login is enabled, The email addresses authorized to log in.<br>
<code>Username</code> and <code>Password</code>: If Google Login is disabled, a username and password to use when
you link your account in the Google Home App.<br>
<br>
<b>Actions on Google Project Settings</b><br>
<code>Client ID</code>: The client id you entered in the <i>Actions on Google</i> project.<br>
<code>Client Secret</code>: The client secret you entered in the <i>Actions on Google</i> project.<br>
<br>
<b>Google HomeGraph Settings</b><br>
<code>Jwt Key</code>: Path to the JSON file you downloaded during setup. Can be an absolute path or a path relative
to Node-REDs user dir (where your settings.js, flows.json etc. are stored).<br>
<br>
<b>Web Server Settings</b><br>
<code>Port</code>: TCP port of your choice for incoming connections from Google. Must match what you entered in the <i>Actions on Google</i> project. If empty, it will use the same port as Node-RED.<br>
<code>URL subpath</code>: URL subpath to add to the URL. If set, the URL will change from `https://example.com:3001/check` to
`https://example.com:3001/<subpath>/check` (resp. `/<subpath>/smarthome`, `/<subpath>/oauth`, `/<subpath>/token`).<br>
<code>Use http Node-RED root path</code>: If enabled, use the same http root path prefix configured for Node-RED. Otherwise, no prefix will be used.<br>
<code>Use external SSL offload</code>: If enabled, the smarthome service will use HTTP instead of HTTPS. Check if you want to do SSL termination on a reverse proxy.
<code>Public Key</code>: Path to the file containing the public SSL key, e.g. `fullchain.pem` from Let's Encrypt. Can be an absolute path or a path relative to Node-REDs user dir (where your settings.js, flows.json etc. are stored).<br>
<code>Private Key</code>: Path to the file containing the private SSL key, e.g. `privkey.pem` from Let's Encrypt. Can be an absolute path or a path relative to Node-REDs user dir (where your settings.js, flows.json etc. are stored).<br>
<br>
<b>Local fulfillment</b><br>
<code>Scan Type</code>: The discovery protocol to use. Must match the configuration in the <i>Actions on Google</i> project.<br>
<code>Discovery Port</code>: A port number for UDP or mDNS. For UDP, it must match the "Broadcast Port" in the Google configuration.<br>
<code>HTTP port</code>: A port number to use for local fulfillment. If empty, it will use the same port as Node-RED.
If you use Node-RED's built-in HTTPS encryption or you have a httpAdminRoot set, you need to
set a port. Don't create a forwarding rule for this port!
<b>Advanced Settings</b><br>
<code>Access Token Duration</code>: The authorization token duration (in minutes) used by Google SmartHome to identify itself to node-red SmartHome plugin. Defaults is 60 min.<br>
<code>Report Interval (m)</code>: Time, in minutes, between report updates are sent to Google. Default is 60 min.<br>
<code>Request sync delay (s)</code>: Delay, in seconds, for request devices sync after a deploy, 0 or empty to disable (default value 0).<br>
<code>Set state delay (s)</code>: Delay, in seconds, for sending the set_state message after state changes, 0 or empty to disable (default value 0).<br>
<h3>References</h3>
<p><a href="https://www.npmjs.com/package/node-red-contrib-google-smarthome" target="_new">Node Information</a>.</p>
</script>