Difference between revisions of "ESPEasy Command Reference"

From Let's Control It
Jump to navigation Jump to search
Line 74: Line 74:
 
| Direct control of output pins
 
| Direct control of output pins
 
| See:[[GPIO]]
 
| See:[[GPIO]]
|-
 
 
| Password
 
| style="background: red; color: white;" | Internal
 
| Set the password of the unit
 
| Password <new password>
 
|-
 
 
| Pulse
 
| style="background: orange; color: black;" | Plugin
 
| Send short pulses
 
| See:[[GPIO]]
 
|-
 
 
| Servo
 
| style="background: orange; color: black;" | Plugin
 
| Servo motor control
 
| See:[[GPIO]]
 
|-
 
 
| Tone
 
| style="background: orange; color: black;" | Plugin
 
| Play tone via speaker or piezo
 
| See:[[Buzzer (RTTTL)]]
 
|-
 
 
| Rtttl
 
| style="background: orange; color: black;" | Plugin
 
| Play melody via speaker or piezo
 
| See:[[Buzzer (RTTTL)]]
 
 
|-
 
|-
  
Line 122: Line 92:
 
| Set the name of the unit
 
| Set the name of the unit
 
| Name <new name>
 
| Name <new name>
 +
|-
 +
 +
| Password
 +
| style="background: red; color: white;" | Internal
 +
| Set the password of the unit
 +
| Password <new password>
 
|-
 
|-
  
Line 152: Line 128:
 
| Reset config to factory default
 
| Reset config to factory default
 
| Reset
 
| Reset
 +
|-
 +
 +
| Tone
 +
| style="background: orange; color: black;" | Plugin
 +
| Play tone via speaker or piezo
 +
| See:[[Buzzer (RTTTL)]]
 +
|-
 +
 +
| Rtttl
 +
| style="background: orange; color: black;" | Plugin
 +
| Play melody via speaker or piezo
 +
| See:[[Buzzer (RTTTL)]]
 
|-
 
|-
  

Revision as of 14:50, 23 October 2017

ESP Easy offers a set of commands to control hardware devices and provide some basic local control using rules. There are several ways to launch commands on ESP Easy:

Protocol Syntax Extra information
HTTP http://<espeasyip>/control?cmd=<command> Send commands over the HTTP protocol.
MQTT <MQTT subscribe template>/cmd with payload: <command> Send commands over the MQTT protocol. As of current status this is obeyed only for the first controller in the list.
Serial (TTL) <command> Send commands using serial (RX/TX). Just type the <command>
UDP SendTo <unit nr>, <command> Send commands from one ESP Easy unit to another. Setup UDP peer-2-peer first.
Rules <command> Internally within ESP Easy. Just enter the <command> within an event block or conditional block.

Commands are divided into several classes:

Internal - Can be run from serial and rules engine
Rules -  Can be run from serial and rules engine
Plugin - Can be run from serial, rules engine, HTTP, MQTT
Special - This can be used from any source

If you want to use internal or rules commands using HTTP/MQTT, setup an event within the rules section and remotely launch the "event" command.

Command Class Purpose Syntax
Debug Internal Change Serial port debug level Debug <1-4>
Delay Rules Delay rule processing Delay <delay in milliSeconds>
Event Special Create an event event,<event>
GPIO Plugin Direct control of output pins See:GPIO
IP Internal Change IP address IP <IP address>
LongPulse Plugin Direct pulse control of output pins See:GPIO
Name Internal Set the name of the unit Name <new name>
Password Internal Set the password of the unit Password <new password>
Pulse Plugin Direct pulse control of output pins See:GPIO
Publish Rules Send command using MQTT broker service Publish <topic>, <value>
PWM Plugin Direct PWM control of output pins See:GPIO
Reboot Internal Reboot the ESP Reboot
Reset Internal Reset config to factory default Reset
Tone Plugin Play tone via speaker or piezo See:Buzzer (RTTTL)
Rtttl Plugin Play melody via speaker or piezo See:Buzzer (RTTTL)
Save Internal Save config to persistent flash memory Save
SendTo Rules Send command to other ESP (using UDP) SendTo <unit nr>, <command>
SendToHTTP Rules Send command to other network device using HTTP SendToHTTP <IP address>, <Portnumber>, <command>
SendToUDP Rules Send command to other network device using UDP SendToUDP <IP address>, <Portnumber>, <command>
Servo Plugin Direct control of servo motors See:GPIO
Settings Internal Show settings on serial terminal Settings
Status Plugin Show status on previously controlled pins Status <device>,<pin>
TaskValueSet Rules Set values on a Dummy Task device TaskValueSet <task nr>,<value nr>,<value/formula>
TimerSet Rules Start a timed event TimerSet <timernr>,<timeInSeconds>
Unit Internal Set the unit number Unit <unit number>
WifiAPKey Internal Change AP WPA key WifiAPKey <WPA key>
WifiConnect Internal Connect to configured wireless network WifiConnect
WifiDisconnect Internal Disconnect from wireless network WifiDisconnect
WifiKey Internal Change WPA key for primary WiFi WifiKey <Wifi WPA key>
WifiKey2 Internal Change WPA key for secondary WiFi WifiKey2 <Wifi WPA key>
WifiScan Internal Scan Wireless networks WifiScan
WifiSSID Internal Change SSID to connect as primary WiFi WifiSSID <SSID>
WifiSSID2 Internal Change SSID to connect as secondry WiFi WifiSSID2 <SSID>