Devices

Devices

To access Devices just click on devices on the left pane after you selected the desired building.


Here you can see a list with all devices that are available in the selected building.
You can perform a search to narrow the list to desired devices or you can choose devices through filters on this page, you can filter them by Status, Type, Ontology Type, Area, Datasource, Origin Type or Devices with or without points.

After applying the desired filters, the device list automatically updates, allowing you to quickly access the devices you need.

The Batch Update Devices button is located in the top-right corner, enabling you to tag selected devices. 
On this page, a small arrow on the right side provides options for Device Referencing, Virtual Devicesand Linked Devices.

  • Devices Batch Update - Here you can update devices in a batch by selecting their type or area.

Virtual Devices - On this option you enter the virtual devices where you can view and manage the virtual 

  • devices you create or want to create.

  • Linked Devices - Here you can see devices that are linked with the devices from myMSI.

Navigating through Device Details

Device Details helps you to determine device performance, status, history and allows you to interact with devices in order to adjust their functioning with the aim of increasing optimum performance.


There are a few ways on how you can get to device details:

Via the Site Menu go to your Building > Devices > Select Desired Device > Device Details 

  1. (the same can also be achieved via floor plans)

Searching for a device by its name via the Search Function and selecting it will take you directly 

  1. to its Device Details page

  2. Via the Site Dashboard > Areas > Select Floor > Click on Device Name > Device Details


Using Device Details

In both ways you will reach the device details page which is divided into three main sections:

  • Points of the devices

  • Charts - device history

  • Right hand sidebar



In the left section you will see all points grouped by type (e.g Concentration, Pressure, Fan)  and represented visually.   You can turn the visualization on or off by selecting the    button on the left side of each point. Upon enabling, the visualization will show a trend of the point depending on the type of the point (i.e. graph, boolean, etc.) 


Hovering on points it will show  a write icon on its right side.



Selecting it (clicking over the point name) will take you to the Write Point menu where you can modify the values based on your preferences.


Device History

History will show a historical performance of the selected device. For example in the case of a HVAC device it will show the temperature history. The default time period to view the history is 2 days; however, this can be modified to longer and shorter lengths in the upper right hand corner of history.


In cases of temperature history, Outside Air Temperature can also be selected in order to show it in comparison with the temperature values provided by the device.

Hovering upon the chart will show you the name of the point, its value as well as the exact time for the given value.


Right hand sidebar

The right sidebar inside of device details has multiple options including:

Device Information -  Here you can see all relevant device information including edge device, 

  1. building, area, location, device name, type, tags, and reference

  1. References - References will show the associated devices to the selected device.

  1. Attachments - Here you can add notes and upload attachments related to the device.

  1. Active Events - View and manage all active events related to the selected device.

  1. Dashboard View - View Device Details categorized by point type as determined by the device itself.



Exporting Charts

  1. Navigate to Device Details through the steps mentioned in the first part of this article.

  2. Click on the export button on the upper right hand corner of the chart.

  3. For exporting you can select between PDF and image views.

Note: PDFs are preferred as standalone documents whereas image views are appropriate 

  1. if you need to integrate them into an existing document, presentation, etc.



Basic View

You can also switch to the dashboard view by using the  button  in the lower right corner In the dashboard view .

 


Basic View of the device details page is divided into three main sections:

  • Inputs, Variables, and Outputs for the selected device

  • History (if applicable)

  • Temperature History (if applicable)

  • Right hand sidebar

In the first three quadrants named Input, Variable, and Output, the users can interact with the device, see its actual values which are shown through sensors as well as device points status.

Inputs represent the values and feedback from physical or network connected sensors 

  • (i.e. temperature, current, status, etc.)

  • Variables are the options that you can change to your desired settings (i.e. setpoints).

  • Outputs control and display the device behavior that changes per our set variables.

Device Graphic

Device Graphic is a powerful tool for visualizing your building's HVAC system in real time. It allows you to monitor and control your AHU, VAV, and HVAC devices and their components, all from a single interface.


Overall, Device Graphic is an essential tool for building management professionals who want to keep a close eye on their HVAC systems. With its intuitive interface and powerful features, it is the perfect solution for anyone looking to improve the performance and efficiency of their building's HVAC system.


Navigate to Device Graphic

To get started simply navigate to device details. You can get to the device details in a few ways:


  1. Via the Site Homepage > Devices > search and select the desired Device from the device list.

  2. When you search for a device by name and select it, you will be taken directly to its Device Details page.

  3. The search function can be accessed by clicking on the search icon in the main navigation bar on the left.

Via the Site Dashboard > Areas > Select a Floor > from the floor plan graphic click on Device Name 

  1. (the same can also be achieved via system graphic).


To access the Device Graphic View, click on the Graphics  icon at the bottom of the right sidebar. Here, you will see a graphical representation of your building's HVAC system, with each device and component represented by a distinct icon.



Review and Monitor points from Device Graphic

In addition to monitoring your devices, you can also use Device Graphic to control them. Simply click on the relevant icon to bring up the control panel, where you can adjust settings such as temperature, fan speed, and more.


To review and monitor AHU, VAV, and HVAC devices performance from Device Graphic tool, follow these steps:


  1. Log in to your account and navigate to the Device Graphic dashboard.

  2. Look for the AHU, VAV, and HVAC devices on the graphical representation of your building's HVAC system.

Review the device's current status, temperature, pressure, and other important metrics to get a sense 

  1. of its performance.

Use the historical data and trend analysis features to track performance over time and 

  1. identify any issues or inefficiencies.

Set up alerts and notifications to be notified of any significant changes in performance, 

  1. so you can quickly address any problems.

  1. Use the control panel to adjust settings and optimize performance if necessary.



Configure Device Graphic

Upload Device Graphic

By uploading a Device Graphic, you can create a custom visualization of your building's HVAC system that is unique to your needs. This will make it easier to monitor and control your system in real time, improving its performance and efficiency.


To upload Device Graphic, follow these steps:


  1. Navigate to the Admin module from the left main navigation bar > Buildings > choose a building > Files.

  2. Click on the three dots at the top right of the Files page > from the dropdown menu select + Add Device File.

Select the file you want to upload from your computer. The file should be in a compatible format, such as 

  1. a PNG, JPEG, or SVG.

Wait for the file to upload. This may take a few moments depending on the size of the file and the speed 

of your internet connection.






Use the 3 dots icon far next to each uploaded file to update the name of the uploaded graphic or delete it 

  1. or to replace the file.



Add a Device Graphic

To add a device graphic on device details follow the below steps:


Navigate to device details via the Site Homepage > Devices > search and select the desired Device 

  1. from the device list.

  2. To access the Device Graphic View, click on the  Graphics icon at the bottom of the right sidebar.

  3. From the Graphics View click on the "Apply Template" or “+ Create New'' button. 

Selecting the "Apply Template" option you will have the chance to choose any saved device graphic template (the Device Graphic File and all the selected points/icons).



  • Selecting the “+ Create New'' option you can create a new device graphic from scratch.

    • From the “Choose File” pop-up window select the Device Graphic File, uploaded on the Admin section.

    • Place the points/icons on the graphic in the desired location.

    • Use the "Save" button to save your changes and exit edit mode.



By adding new points and icons to Device Graphic, you can customize the representation of your building's HVAC system to better reflect its unique layout and devices. This will make it easier to monitor and control your system in real time, improving its performance and efficiency.

Edit and Add Points to the Device Graphic

To edit the Device Graphic and add points and icons, follow these steps:


  1. Log in to your account and navigate to the Device Graphic dashboard.

  2. Click on the "Edit Graphic" button to enter edit mode.

  3. Clicking on the 3 dots icon at the top right of the screen on the drop down you will see three options:

    1. Change File - from here you can change the device graphic file.

Create Template - from here you can create a template using the file you have uploaded and the 

  1. points you have chosen.

  2. Delete Graphic - from here you can delete the uploaded device graphic.




  1. On the left side of your screen you will see the list of all Referenced Devices.

  2. Drag points or devices from the list on the left to add new points and icons to the graphic.

    1. You can zoom in to get more precise.

    2. You can modify the placement of the device/point by dragging on the marker triangle.

  3. Select the type of icon you want to add from the available options.

    1. To learn more about Icons and Graphic Tool check this article here.

Click on the marker or  icon to customize the appearance and settings of each point and icon, such as its name, 

  1. color, size, and associated data.

  2. Use the "Save" button to save your changes and exit edit mode.


Why are my devices down?

Where do I view my down devices?

  • Navigate to the Network Status widget on the building dashboard.

  • The yellow bar shows down devices, hovering over it will show you the number of down devices.

  • Clicking on the yellow bar will display a list of down devices.

What action should I take to resolve this?

If devices are down in the platform but online in the Jace.

  • Click into Data Sources from the main sidebar and you will see a three dots button on the page that opens up.

  • Click on the three dots button and click on the Refresh Cache option.

  • This will refresh your cache and bring the device back up.

  • The device should now be back up on the platform.


If devices are down in the platform and down in the Jace

Please, contact your temperature controls service provider to investigate the communication failure 

  • with the devices.

  • Provide the list displayed from the Network Status widget to your services provider.

What are common causes for down devices?

  • Network issue

  • Poor RS485 BACnet MSTP installation

  • Failed controller (local device)

Additional resources


    • Related Articles

    • Linked Devices

      To link devices that you have discovered in KODE OS and added in myMSI as well, follow the below instructions: Click on Devices at the site you need to link devices Go to Batch Update Devices button places on the top right corner Click on Linked ...
    • Virtual Devices

      We use Virtual Devices to separate grouped systems and devices. Virtual Devices can divide a single device into multiple parts for better use. Note: Devices should be tagged with PseudoDevices in order to be part of the Virtual Devices. How to tag a ...
    • Devices - Batch Update

      The purpose of tagging is to correctly assign the appropriate components to each piece of equipment. Follow the below steps to tag your devices. Navigate to a building of your choice through the Sites feature in the left navigation bar. Click on ...
    • Navigating to Systems - Mobile App

      In order to obtain a visual representation of device placement throughout major systems and interact with the devices directly, you can rely on the Systems module. Navigate to the building of your choice and select Systems on the Building Menu. A ...
    • Navigating to Device Details - Mobile App

      Device Details helps you to determine device performance, status, history and allows you to interact with devices in order to adjust their functioning with the aim of increasing optimum performance. There are a few ways on how you can get to device ...