Update FAQ.md and Commands.md (tasmota#707)

* Hostname - Info about % * Update FAQ.md Co-authored-by: tammo0 <[email protected]>
virtorgan · Apr 9, 2021 · 9acc1c2 · 9acc1c2
1 parent 0c977fa
commit 9acc1c2
Show file tree

Hide file tree

Showing 2 changed files with 3 additions and 1 deletion.
diff --git a/docs/Commands.md b/docs/Commands.md
@@ -189,7 +189,7 @@ Command|Parameters
 :---|:---
 AP<a class="cmnd" id="ap"></a>|`0` = switch to other Wi-Fi Access Point<BR>`1`= select Wi-Fi Access Point 1<BR>`2`= select Wi-Fi Access Point 2
 CORS<a class="cmnd" id="cors"></a>|`"` = disable CORS (Cross Origin Resource Sharing) (default)<BR>`*` = enable CORS for all locations<BR>`value` = Enable CORS for location. This needs to be complete url ex: `http://tasui.shantur.com`
-Hostname<a class="cmnd" id="hostname"></a>|`1` = reset hostname to `MQTT_TOPIC-<4digits>` and restart<BR>`<value>` = set hostname (32 char limit) and restart. If hostname contains `%` it will be reset to the default instead.<BR>**_If using MQTT to issue this command, if it is used with the device `GroupTopic`, the command will not be executed._**
+Hostname<a class="cmnd" id="hostname"></a>|`1` = reset hostname to `MQTT_TOPIC-<4digits>` and restart<BR>`<value>` = set hostname (32 char limit) and restart. If hostname contains `%` it will be reset to the default instead. See [FAQ](FAQ#available-characters-for-hostname) for allowed characters.<BR>**_If using MQTT to issue this command, if it is used with the device `GroupTopic`, the command will not be executed._**
 IPAddress&#60;x><a class="cmnd" id="ipaddress"></a>|Set networking IP (`XXX.XXX.XXX.XXX`) addresses<BR>`IPAddress1` = set device IP address<BR><li>`0.0.0.0` = use dynamic IP address (DHCP)</li><li>`XXX.XXX.XXX.XXX` = set static IP address</li>`IPAddress2` = set gateway IP address<BR>`IPAddress3` = set subnet mask<BR>`IPAddress4` = set DNS server IP address<BR><BR>*follow IPAddress commands with `restart 1` to apply changes*
 Password<x\><a class="cmnd" id="password"></a>|`<x>` = `1..2`<BR>`<value>` = set AP<x\> Wi-Fi password and restart<BR>`1` = reset AP<x\> Wi-Fi password to firmware default (`STA_PASS1` or `STA_PASS2`) and restart<BR>Passwords are limited to 64 characters. **Do not use special characters or white spaces in the password**.<BR>**Note that `Password` and `Password1` are equivalent commands.**
 Ping<x\> <addr\><a class="cmnd" id="ping"></a>|`<x>` = `0..8` = the number of ICMP packets to send, `0` uses the default (4)<BR>`<addr>` = address to send Ping, either in numerical format `192.168.1.200` or domain name `tasmota.com`<BR><BR>(requires `#define USE_PING`)<BR>Example `Ping4 192.168.1.203`: ```RSL: tele/tasmota_xxx/RESULT = {"Ping":{"192.168.1.203":{"Reachable":true,"Success":4,"Timeout":0,"MinTime":59,"MaxTime":167,"AvgTime":116}}}```

diff --git a/docs/FAQ.md b/docs/FAQ.md
@@ -328,6 +328,8 @@ Long answer: There is not enough time in our coders lives to take requests, if y
   - 24 chars max
   - only a..z A..Z 0..9 '-'
   - no '-' as last char
+
+Notice: Hostnames containing ```%``` will reset to ```MQTT_TOPIC-<4digits>```. It is not intended to use internal Tasmota variables here.
 
 **RFC952**  
 ASSUMPTIONS