Berto Cloud

The Berto Cloud driver is the master driver for all other Berto drivers. The driver provides integration services to MQTT brokers that is used by other Berto drivers and also sending of simple email messages, including attachments, using the Berto Mail service.

In order to see all available drivers and gain additional features you need to create a Berto account which your system is linked to. To create an account you must first enter your email address in the Email Address property then take the "Create or Verify account" action from the Actions tab. This will generate a Link Code which is emailed to your email address. Enter code in the "Enter Link Code" action. If you do not have an account one will be created for you automatically otherwise your existing account will be found using your email address.

Linking your system to an account is optional but required to use some fo the free Berto services such as simple email messaging. When you system is linked to an account the Menu property will be available which, at base service level, provides a Service menu.

The Service menu provides 8 additional options :-

System Check In - Login in to the Berto Cloud service to retrieve the drivers available for your system along with your service and subscription levels.
List Installed Drivers - List all installed drivers for you system.
List Available Drivers - List all available drivers and the download URL.
Validate All Drivers - Validate all Berto installed drivers and remove no longer supported versions.
Upgrade All Drivers - Upgrade all Berto installed drivers to the latest release.
In Place Upgrade - Upgrade all Berto installed drivers using direct download. Requires a reboot to reload drivers.
Restart Director - Restart Director process.
Reset Remote Access - Reset OpenVPN Server configuration. (Service Level 1 or above only).

You can also setup an OpenVPN server on your system and can then set individual clients up to access your network using the Berto_Profile driver. The OpenVPN server listens on UDP port 2194 so you will need to configure a port forward NAT on your router to point to your this port on your system. To enable the OpenVPN server you need to upgrade to Service Level 1 and then create a configuration using the Reset Remote Access option under Menu property. Once the configuration has been created it can be enabled and disabled from the Enable Remote Access property or the UI button on any Navigator screen.

The driver also allows use of the following proxy functions from other third party drivers :-

SMTP_SENDMAIL - Send email messages using the mail settings provided or defined in the Cloud driver or if not set then the default Berto Cloud service. The response from the SMTP server is sent back to the SMTP_RESPONSE command callback.
MQTT_CONNECT - Connect to an MQTT Broker and subscribe to topics. Messages received from the MQTT broker are sent to the MQTT_RECEIVED command callback.
MQTT_DISCONNECT - Disconnect from the MQTT Broker.
MQTT_PUBLISH - Publish a message on a topic to the MQTT Broker.

See the Berto SDK driver for example source code.

Properties

System Id - System Identification address used when setting up external services such as IFTTT and Google Assistant.
Service Level - System service level which defines the features active across the Berto platform for your system.
Email Address - Email address used as From address when sending emails and also by the account registation service.
Account - Account code associated with the system. Configured from the Actions tab.
Subscription Plan - Subscription plan that system is on.
Subscription Level - Subscription level associated with the system (Basic or Premium).
Subscription Expiry - Date the systems subscription is due to expire. (Premium only).
Notification - System notification messages.
Enable Berto Dynamic DNS - Creates a berto.io hostname entry in the Berto DNS for use with the OpenVPN server in the event you do have not a static IP address or your own dynamic DNS service. The hostname created will be used in the OpenVPN client configurations.
Berto Dynamic DNS Hostname - Display only field showing the Berto DNS hostname created.
Hostname - The external hostname or IP address to be used for the OpenVPN server if not using the Berto Dynamic DNS service.
Remote Access Network - This is the subnet used by the OpenVPN server. Clients are issued IP addresses from this subnet when they connect. Requires Service Level 1 or above.
Enable Custom Mail Server - Enable use of your oen mail server.
Mail Server - The mail server address.
Username - Mail server account username.
Password - Mail server account password.
Friendly Name - From display name.
Enable Remote Access - Start/Stop the Remote Access Server. (Service Level 1+ only).
Enable Watchdog - Starts a watchdog timer in background that monitors the system specifically the state of the "director" process and in the event that the system becomes unresponsive the "director" is restarted. (Service Level 1+ only).
Release Branch - Driver download source, can be either Production or Beta.
Menu - Provides additional features based on the Service and Subscriptions Levels of the system. You need to create an account and link you system to it for the menu to be available.

Actions

Create Or Verify Account - Start an account verification with the Berto Cloud services. A 4 digit link code with be sent to the email address setup in Properties which is to be used in the Enter Link Code action.
Enter Link Code - Entering the link code received in the email verification will associate the system to your account.
Test Mail - Send a test email using the Berto mail server or your own mail server if enabled.

Programming

Events

Selected - Event triggered when the UI button is selected from any Navigator screen

Commands

EXECUTE_COMMAND - Allows the execution of any system command on the local controller eg. reboot to reboot or halt to shutdown system.
SEND_MAIL - Sends a simple email message using the Berto mail server or your own mail server if enabled.

Release Notes

v1.00 - 2020-03-15

Initial Release.

v1.10 - 2020-03-29

Auto Update changed to be managed via the Auto Update Time specified in the Berto Cloud driver.

v1.11 - 2020-04-17

Added Console option to Debug Mode property to allow for external logging output.

v1.12 - 2020-05-15

Added Release Branch property to add support for selection of Production or Beta development branch.

v1.13 - 2020-05-27

Fixed issue with Update All option using Production branch even when set to Beta.

v1.14 - 2020-05-31

Added support to send attachments from a URL location.

v1.15 - 2020-06-05

Added support to use your own custom mail server replacing the need for the Berto Mail driver.

v1.16 - 2020-06-30

Added support for multiple production environments in preparation for Alexa integration.
Fixed issue with dynamic ip sometimes not getting set on WAN update.

v1.17 - 2020-09-07

Fixed issue where watchdog time could get started twice.

v1.18 - 2021-01-20

Added feature to embed device variable values in email subject and message contents.

v1.19 - 2021-02-18

Increase time to register system from 1 to 5 minutes.

v1.20 - 2021-03-30

Fixed issue with re-connecting to Beta branch after switch to Production.

v1.21 - 2021-04-02

Fixed issue with Premium subsription expiry date timezone mismatch.

v1.22 - 2021-04-05

Fixed issue with certain Google email addresses being rejected by Google.

v1.23 - 2021-08-06

Added MQTT_KEEPALIVE_MISSED event to detect when disconnection occurs from the MQTT Broker and restart services from programming if required.

v1.24 - 2021-08-14

Added support for third party drivers to access the SMTP and MQTT functions from their own drivers. Note that you will also need to update the Berto_IOTGatewy, Berto_Camera and Berto_WebServer drivers if you use them.

v1.25 - 2021-09-12

Added programming command to restart all running services.
Added programming command to do a clean restart of the controller.