Create your first Meshbot (tutorial)
- Open EZlogic then click ‘Meshbot Automation’ > ‘Create New Meshbot’ > ‘Create’:
Choose ‘Local’ for now. This creates a meshbot associated with a hub on your network. See Global vs Local Meshbots if you want to know more about the difference at this point.
The next screen shows the interface to add triggers and actions to your meshbot/scene. Type a name for your meshbot in the space provided and choose the type of meshbot you want to create:
- Device – The meshbot will run the action when a device changes status. For example, if the temperature changes, or a door opens, or motion is detected. See the Device page if you need more help with this.Some devices have capabilities that let you set a custom value:
- Expression – An expression is a piece of code which is capable of housing various values. You can reference these values in a meshbot and use it to trigger an action. See the Expressions page if you need more help with this.
- Value – Enter a specific integer or state that you want to use to activate the trigger. Values may be boolean (true/false) or an integer (a number, scale or percentage) depending on the requirements of the device capability.
- Variable – A variable is a user-created item used to house a specific piece of data. For example, you could use a variable to store the ‘on/off’ state of a switch, or the temperature from your thermostat, or some data from an external resource such as a website. See the Variables page if you want more information
- Date and Time – The meshbot will activate according to a schedule of your choice, be that hourly, daily, weekly, monthly, at certain intervals, between specific times, or at sunrise/sunset. See the Date and Time page if you need more help with this.
- Meshbot – The meshbot will run based on the outcome of the actions of another meshbot. See the Meshbot page if you want more help with this.
- House Mode – A house mode is a collection of device settings that let you set the status of a range of devices with a single click. Each mode is preconfigured to arm devices and take actions in accordance with typical user needs during that time. For example, ‘Night Mode’ will arm all of your sensors and alarms and lock all of your doors. See the House Modes page for more information.
- NOT – This means ‘if the reverse of the named condition is true then proceed’. If we clicked ‘NOT’ in the example above then it would trigger the action when the sensor did not detect motion. Similarly, if we chose ‘Wednesday’ as the trigger day, then clicked ‘NOT’, it would execute the action on all days except Wednesday.
You can apply NOT to individual conditions and trigger groups, but cannot use it to establish the connection between individual conditions.
- AND – Executes the action when the conditions of all linked triggers are met. For example, ‘When the motion sensor detects movement’ AND ‘The time is between 11 PM and 6.30 AM’:
- OR – Executes the action when any of the conditions in the linked triggers are met. For example, ‘When the motion sensor detects movement’ OR ‘The ambient noise goes above a certain level’:
- XOR – Executes the action only if exactly one of the conditions is true and all other conditions are not true. This does have its uses, but they are quite niche/advanced.
- See Operators/logic gates if you want more help with the ‘XOR’ operator.
- Device – Commands a device to perform an action if the conditions of your triggers are met. See the Controllable Devices page if you want more help with devices in an action.
- Meshbot — Activates a different meshbot if the conditions of your trigger become ‘true’. For example, you might want your trigger to activate your ‘I’ve left the house’ meshbot. Think of running a meshbot in your actions as like running a subroutine in a program. See the Meshbot as an Action page if you want more help with this.
- Notification – Lets you send email alerts and push notifications to selected recipients if the conditions of your trigger are met. See the Notifications page if you want more help with this feature.
- Lua Script – Runs a Lua script to implement an action if the conditions of your triggers are met. You can find some sample scripts in a community post here. Advanced users and developers can learn more about scripts in our API documentation here.
- NuCAL – Send a command or a request for data to one of EZlogic’s integrated services. For example:
- Create an action to update your Prospectio CRM when a customer makes a purchase from your website
- Automatically create a Shipday delivery to a customer when your CRM registers that your business has fulfilled an order.
- Pull today’s forecast from Accuweather and put this data in a tile on your dashboard.
- HTTP Request – Send a HTTP command to retrieve information from a server or implement a custom action. See the Http Request page to learn more about this type of controllable.
- House Mode – Activate or deactivate one of your house modes if the trigger becomes true. See the House Modes page if you want to learn more about house modes.
- Exceptions – Exceptions are additional triggers that you can add to specific actions in an action group. For example, you want to implement a device action unless the house-mode is ‘Away’ or ‘Vacation’. Click here if you want to learn more about exceptions.
FALSE – This tab contains actions that you want to implement if the trigger is not true, or ceases to be true. For example, you set up a rule to turn on your closet dimmer light at 50% whenever the closet door is opened after sunset. This is your ‘TRUE’ action, but the light would remain on unless you specify otherwise. In the ‘FALSE’ tab you can set an action that sets the light to ‘Off’ if any of your trigger conditions are not met. In this example, these are if the door is not open (you closed the door) OR it is not after sunset.
See True / False actions if you want to learn more on this.
You can select one ‘TRUE’ and/or one ‘FALSE’ device action per row. You can specify multiple responses to a trigger by clicking the ‘Add Action’ button. For example, ‘Enable motion sensors’ AND ‘Enable Alarms’ AND ‘Enable Security Cameras’ after 11 PM.
Active – Use this switch to enable or disable the meshbot. Newly saved bots are active by default, so remember to disable them if you don’t want them to run just yet.
Run Once – Assumes all trigger conditions are true and runs the actions in your meshbot one time. This runs regardless of whether the bot is ‘Active’.
Edit – Opens the meshbot editor and allows you to make modifications to the bot.
Columns – Specify what information is shown on this page. All columns are shown by default except the internal meshbot ID.
Filters – Create commands that specify which meshbots are shown in the list. For example, you can create a filter to show only bots which are active, or of the bot type ‘Cloud’, etc. You can add and activate multiple filters at once. This feature is especially useful if you have a large number of bots.
Density – Simple layout options which control how much white space is shown between each meshbot in the list. The more dense, the more meshbots are shown on a single page.
Export – Generates a .csv file of the meshbots you have listed on the current screen. The .csv reflects any filters you have applied and any modifications to the list columns.