Note:  The IP Address or Port Number may be different if Rubix Platform is being accessed through a router or networking service with port forwarding enabled. 

1. If you are accessing Rubix Platform on a Nube-iO Rubix Compute controller try IP Address 192.168.15.10 with the ETH-2 ethernet port connected to your PC. OR connect the ETH-1 ethernet port to your router and check your router DHCP devices for the IP Address.   For further information see Connecting to a Rubix Compute.
   
2. Try to use an IP scanning tool such as Advanced IP Scanner or Angry IP Scanner to find the device's IP address.
   
3. Contact a network administrator to check the networking details for the device running Rubix Platform.
   

Note: If the username and password have not been changed, they will be the default values. The default username is admin and the default password is N00BWires 

​(note there are 2 Zeros in N00B).

Setting System Time of Rubix Platform

The Rubix Platform can be set to the local time zone of the location the devices are in, as this allows accurate reporting data and management of devices without time mismanagement.

Rubix Platform time setting is set by selecting a timezone.  There are 2 types of timezone settings in Rubix Platform, it is important to understand the differences as they have different functions. 

Customising the Rubix Platform Sidebar

Selecting Menu Items to Appear in the Sidebar

At the bottom of the Sidebar, click on the `Settings` button.   Select the `SIDEBAR SETTING` tab.  On this page is there are two tiles: Rubix tile and Rubix Flow tile.

Within these tiles there are check boxes that correspond to the elements available for display in the Sidebar.  A ticked check box means the current item will be displayed.  Check or uncheck the check box to the item you'd like displayed or hidden.  It should be noted that to enable selection of items in the Rubix Flow tile, the toggle switch next to Rubix Flow should be switched on.

Importing and Exporting Sidebar settings

The Sidebar settings can be exported and imported for easier configuration on multiple devices which share the same Sidebar configuration.  The way the Sidebar settings are imported and exported is by using a string of XML text.

Exporting Sidebar settings

To export the current Sidebar settings, click the `Export` button in the top left of the page, this will open a pop-up in which contains the raw XML formatted data of the current Sidebar settings.  Copy this text and save in a text file for future use.

Importing Sidebar settings

To import Sidebar settings, click the `Import` button in the top left of the page, this will open a pop-up in which contains a section where the required Sidebar settings XML text can be pasted. Click `Save` to import the Sidebar settings.

The Sidebar is the main method of navigating through Rubix Platform.  It is located on the left hand side of the page, and can be expanded or collapsed.  The Sidebar contains links to all of the available pages. 

1. Title, Expand/Collapse, and Lock - At the top of the Sidebar we find 'Rubix Platform' and below that the name of the Client (as configured in Device Info).  The Sidebar can be collapsed by using the left arrow button on the top right of the Sidebar, and by clicking anywhere on the collapsed Sidebar to expand again.  The Lock button, when activated (blue) will lock the Sidebar in the expanded position. 
2. Apps and Tools Links - In the middle of the Sidebar we find links to the Apps and Tools that are available.  The options shown can be modified to display only the relevant Apps and Tools: See Customising the Sidebar for details.
   
3. Current Device - At the bottom of the Sidebar, the Site Name and Device Name are shown.  Below these there is a  button which contains additional menu options;  these options will be described further below. 

 Button:  This button at the bottom of the Sidebar contains additional options for configuring Rubix Platform 

1. User and Version - Displays the currently signed in user, and the current version of Rubix Service.  
   
2. Upgrade Rubix - Access the Update Rubix Service wizard:  See Updating Rubix Service.
   
3. Device Info - Access the Device Info configuration page: See Configuring Device Info.
4. Master/Slave Configuration - Access the Master/Slave configuration page: See Configuring Master/Slave.
5. Token Update - Access the Token configuration page: See Configuring Rubix Token.
6. Configure Endpoints - Access the Endpoint configuration page: See Configuring Endpoints.
   
7. Update Password - Access the Update Password configuration page: See Updating Login Password.
8. Logout - Logout of the current Rubix Platform session: See Rubix Platform: Access and Login.

The Main Panel of Rubix Platform is where majority of the configuration and actions occur.  The Main Panels contains many elements that are specific to the type of App/Tool selected on the Sidebar.  Below are a few of the common elements that will help a user navigate the Main Panel for many of the common App/Tool pages. 

The Title of the Current Page is displayed on the top left of the Main Panel.  

Tabs are located at the top right of the Main Panel.  Tabs can be considered subsections of the App/Tool selected on the Sidebar.  The currently selected Tab is highlighted and underlined in blue.  

Tiles are located in the Main Panel.  Tiles can contain of drop-down boxes, toggle switches, buttons, text fields, and other information.  Each Tile contains elements that are grouped by a common topic.   

Tables contain rows of data with common properties (columns).  These tables display lists of items for quick referencing and configuration of each specific item.  There are buttons, checkboxes, and text shown for each item in the Table. 

Tables allow rows/items to be selected via the check-boxes at the far left of each row/item, or all rows/items in the current table page can be selected with the check box at the top left of the table.  Many Action Buttons and Property Edit Buttons will only affect selected rows/items.  

Table Column Titles show the property names.  Some Column Titles allow the rows/items to be sorted based on that property, by clicking the Column Title the sort order will be toggled between default order, ascending order, and descending order.   Column Titles with a Property Edit button (pen symbol) allow the properties of many points to be edited en-mass for all selected rows/items.  

At the bottom of the Table is a Rows Per Page option that allows the user to select how many rows are displayed in the Table above.   When selecting all rows/items (top left Table checkbox), only the rows/items currently shown in the Table will be selected.

In many cases clicking on the Name of a row will link to a new page for that specific item/row.  

Action Buttons are contextual menu buttons relevant to the current page.  They are located at the top of the page and are in different colours for easy recognition.  Action Buttons are labelled with their specific command that they perform when clicked.  These Action Buttons often act on the selected Table rows/items. 

Where applicable a Breadcrumb Path is shown near the top of the Main Panel.  The Breadcrumb Path is shown when there is a heirachy structure to the data in the Main Panel.  Starting at the left of the Breadcrumb Path is the highest of the heirachy levels, each subsequent entry (divided by '/' symbols) is another level of the heirachy structure.   Each Breadcrumb Path entry, when clicked, will link to the associated heirachy level page.  This helps the user reference their current location within the heirarchy, and to navigate back up to higher levels. 

For example: Many Apps/Tools use a Network/Device/Point heirarcy structure.  In these cases the first entry in the Breadcrumb Path will be the currently selected Network;  the second entry in the Breadcrumb Path will be the currently selected Device within that Network;  likewise the third entry in the Breadcrumb Path will be the currently selected Point within that Device.  

Apps

Apps are modular programs, made by Nube-iO, that provide specific functionalities.  The Apps required for a Rubix Controller will depend on the required functionality of the controller.

Rubix Plat (Platform)

Rubix Platform is Nube-iO’s browser-based graphical user interface, it comes pre-installed on Rubix Controllers.  All other Apps/Services are installed, updated, and managed via Rubix Platform. 

Rubix Wires

Rubix Wires is Nube-iO’s browser-based function block flow editor.  It is used for implementing custom logical programming.  Advanced pre-built function blocks provide extensive control and data processing capabilities.

Rubix Point Server

Rubix Point Server is responsible for managing the export of history logs to external databases, and for sharing point data between Rubix Controllers.  

Modbus

Modbus is a commonly used communication protocol for communicating between Modbus enabled devices.  Modbus devices can be connected via RS485 (wired), TCP/IP (networked), or LoRa (wireless via Rubix iO Modules).  Modbus functionalities are managed via the Modbus App. 

Rubix BACnet Server

BACnet is a commonly used communication protocol in the building automation industry.  The Rubix BACnet Server App allows the Rubix Compute controller to host BACnet points that can be discovered and read/written by other BACnet devices on the same network. 

LoRa Raw

LoRa is a wireless communication protocol that is utilised by Nube-iO's wireless devices.  The LoRa Raw App allows the Rubix Compute controller to receive data from Nube-iO LoRa Raw sensors (Droplets, and MicroEdge).  

Flow Framework

Flow Framework is Nube-iOs point sharing service.  This App allows points on the Rubix Compute controller to be utilized by other Rubix devices running Flow Framework.  Flow Framework manages the secure sharing of data and tracks the origin of changes to each point. 

Open VPN Client

OpenVPN is a virtual private network system that implements techniques to create secure point-to-point or site-to-site connections in routed or bridged configurations and remote access facilities.  Open VPN Client is implemented on Nube-iO devices to allow encrypted remote access to Rubix Controllers.

Services

Services are modular programs, made by third parties, that provide specific functionalities.  The Services required for a Rubix Controller will depend on the required functionality of the controller.

LoRaWAN Server Service and LoRa WAN Gateway Service

LoRaWAN Server and LoRaWAN Gateway Servies implement the LoRaWAN protocol.  This is a 2-Way communication with 3rd party LoRaWAN wireless devices.  In order to use the LoRaWAN services, the Rubix Controller must have the correct LoRaWAN hardware installed (see ordering info/options).

Mosquitto Service (MQTT)

MQTT is a lightweight Publish and Subscribe service.  MQTT is integral to communications/functionality of all Rubix Apps and Services.  The Mosquitto (MQTT) Service is a local MQTT broker that runs on the Rubix Controller.  This MQTT broker can be used for custom communications, and is required to be running for most Rubix Apps/Services.

Node-RED Service

Node-Red is another browser based flow programming service (alternative to Rubix Wires).   Node-RED is an alternative/complementary programming platform that can be used to make efficient work-flows by utilizing JavaScript programming and a wide selection of community built modules.

Apps and Services can be installed and updated via the `Rubix Apps` page.  Navigate to this page by clicking `Apps > Rubix` the Sidebar.  This page displays the status of the apps/services, the installed version, as well as the latest version available.  Additionally, there are various action buttons that are available to be performed for each app/service. 

Apps/Services can be installed by using the `Download` icon (green down arrow) on the row of the app/service required.

1. Click the green `Download` arrow button on the row of the app/service that is required to be installed.
   
2. On the opening of the `App Status` pop-up, click on the blue `CONTINUE` button after verifying that it isn't installed (`Version` should be displaying -).
   
3. Using the `Select Release Version` drop-down, select the desired version to install (usually the most recent version available) and then click the blue `DOWNLOAD` button.
   
4. Wait until the downloading is completed, and that the green `Downloading Completed` status message is displayed. Verify that the correct version required is listed, and then click the blue `INSTALL` button.
   
5. Wait for installation to be completed and for `Installation Complete` to be displayed. Click `OK` to finalise installation.
   

Updating existing apps/services is very similar to installing apps/services. The only difference is that the `Version` displayed will be the currently installed version.

1. Click the green `Download` arrow button on the row of the app/service that is required to be updated.
   
2. On the opening of the `App Status` pop-up, click on the blue `CONTINUE` button a(`Version` should be displaying the currently installed version).
   
3. Using the `Select Release Version` drop-down, select the desired version to install (usually the most recent version available) and then click the blue `DOWNLOAD` button.
   
4. Wait until the downloading is completed, and that the green `Downloading Completed` status message is displayed. Verify that the correct version required is listed, and then click the blue `INSTALL` button.
   
5. Wait for installation to be completed and for `Installation Complete` to be displayed. Click `OK` to finalise installation of the updated version.
   

To update or install multiple apps/services at once, select the check-box next to the desired apps/services to be installed/updated.  After selecting all of the desired apps/services, proceed to click the green `Download Apps` button at the top of the table. Once clicked, a `Bulk Apps | Selected Apps` pop-up will appear.  Confirm all of the desired apps/services are selected and then click the blue `CONTINUE` button.  Select the required versions of each software, usually this is the latest version available, and then proceed by clicking the `DOWNLOAD APP` button. Let the process complete, and then click confirm after verifying all required apps/services have been successfully installed by finally clicking the `INSTALL` button.

  

Apps/Services can be uninstalled and deleted using the red `DELETE` bin icon (under the `Actions` column) on the row of the app/service wishing to be removed.  Once the red `DELETE` bin icon is clicked, a confirmation window confirming deletion pops-up.  Click `YES` to delete the app/service. Wait for the process to complete, and the page will automatically refresh.  Ensure the app/service has been successfully removed.

The config file is a text file (usually in JSON format) that is used to configure apps and services ( Wires, BACnet Master and BACnet Server, Modbus Server and point server).  For details on the required content of a config file, please contact Nube-iO Support. 

The config file can be edited by clicking the blue pencil icon on the row of the app/service required to be changed, under the `Config File` heading of the table.  From the subsequent pop-up, the existing configuration can be changed/altered.  Depending on the type of app/service, the pop-up will display either a simple editor or an advanced code/json editor.  Click `Save` to update the config file, or `Cancel` to abandon changes and leave the config file unchanged. 

 

The config file can be downloaded by clicking the download icon on the row of the app/service needing to be downloaded. Depending on the app/service, the file downloaded will vary, with usual extensions being that of .txt, .ovpn, .env, .xlxs, and .json. Save the file to the required location on the computer.

Deleting the config file can be completed by clicking the red bin icon on the required app/service row. It is important to note that this will delete all of the app's/service's configured settings. It is advised to download the config file first before deleting, just in case reverting to the previous config is required.

Rubix apps/services utilise a database to store required information and configurations.  These databases can be either downloaded or deleted by using the action buttons in the `Database` column.  Deleting an app/service database (and then restarting the app/service) will reset the app to blank slate (as if it was newly installed). 

Databases can be downloaded by clicking the download button under the table heading `Database` on the required app/service row. The database can be saved to a location on the local computer or wherever desired.

Databases can be deleted by clicking the red bin icon, under the `Database` column on the required app/service row.  This will delete the database and configuration of the app/service, so it is vital to have backups of the database as there is no recovery.  Click `CONFIRM` on the pop-up to confirm deletion of the database.

Mapping LoRa Points to Rubix Points

​

Creating a Rubix (Generic) Network

First we will create a Rubix (generic) network, this is where the Rubix Points will be created later in the process.  If a generic network has not been created already, it must be done before proceeding with mapping points to Rubix.

To create a generic network, navigate to Rubix Platform:

1. Once on Rubix Platform, and using the Sidebar, click on `Driver > Rubix`.
   
2. On the `Driver > Rubix` page click the green `CREATE+` button.
   
3. On the `Create Network` pop-up that appears, enter a relevant network name. It is recommended to call it something easy to identify for future reference (such as `LoRa`).
   
4. Ensure that the check-boxes of `Enable` and `History Enable` is ticked.
   
5. Click `Save` in the bottom right hand corner to create this network.
   

Configuring LoRa Point Mapping

The next step to the point mapping process is to use the Point Mapping service to create Rubix (generic) points and link them to the LoRa points.  To do this, navigate to the `Config > Point Mapping` page on Rubix Platform. This can be found on the Sidebar of Rubix Platform.  If it is non-existent on the Sidebar, see Rubix Platform: Customising the Sidebar to display this option on the Sidebar.

1. On the `Config > Point Mapping` page, click the tab `LoRa Points <> Rubix | BACnet Points` in the top right.
   
2. The first field `LoRa Points` is where all the required LoRa devices/points can be selected.  Use `Select all` to select all devices, or individual devices and their individual points (such as voltage, rssi, temperature, etc).
   
3. On the section titled `Generic Points` select the required generic network created previously (from the dropdown labelled `Select Existing Generic Network`.  If no generic network is available, or the desired network isn't present, see the above section Creating a Rubix (Generic) Network.
   
4. On the section titled `Generic Points` toggle the switch `Auto create new device(s), point(s) and mapping(s)` to the ON position.  This will automatically generate devices and points in the Rubix (Generic) Network created previously.  The generated points can be seen the moment the switch is toggled on.  Change any required points by selecting the editing pencil next to the desired point.
   
5. Click the `ADD` button located on the bottom left of the screen.
   
6. Wait until all of the devices have been added to the port mappings.  The time it takes is dependent on how many devices/points are being mapped.
   

The `Mappings` section will automatically refresh once the devices have been successfully mapped.  If however the devices are not shown, or they are showing delayed data, the refresh button can be pressed to force a refresh of the mapping table.  This refresh button is located directly next to the blue `Sync` button above the `Mappings` table.

Editing or Deleting Existing Points

Existing points can be edited or deleted by using the `Mappings` table on the `LoRa Points <> Rubix | BACnet Points` tab of the `Config > Point Mapping` page.

Editing an Existing Point

To edit an existing point, using the search bar or scrolling on the `Mappings` table, click the edit/pencil icon next to the desired point. This will bring up an `Edit Mapping` pop-up in which details of the mapping can be changed.

Deleting an Existing Point

Single or multiple points can be deleted at once. To delete single or multiple points, select the check-boxes next to the desired points to be deleted. To select all points, make sure that the table is set to display all points, and then click the checkbox on the table titles. use the  After selecting all of the required points that would like to be deleted, click the red `DELETE` button at the top of the `Mappings` table. Confirm the deletion on the pop-up that appears. Additoonally, on individual points, the red trash can icon can be clicked and then confirm the delete on the pop-up.

Modbus Network Configuration

Rubix Platform handles the configuration and management of Modbus services. Modbus is an industry-standard communications protocol for communication between industrial devices, and is compatible with Rubix Platform.

Editing an Existing Point

Deleting an Existing Point

Writing to an Existing Point