# Knowledge Base
How to use Motion.cloud
This **knowledge base** is our continually evolving place for sharing with you all the most useful information for making the most of Motion Platform, Motion Hubs, and more.
If you are looking for API documentation, check out our [API docs](https://api-docs.motion.cloud/) instead.
To learn more about Motion generally, visit our website at [motion.cloud](https://motion.cloud).
# Installation
Each Motion Hub comes with a Hub ID and an activation code in the box.
Two steps are necessary to set up a new Motion Hub:
1. Supply power and connect to your network
2. Activate the hub in Motion Platform
## Physical Setup
Motion Hub simply needs to be plugged into an outlet using the supplied power adapter and connected to the network to which the controls with which it will communicate are also connected.
If your Motion Hub has two ethernet ports on it, *either* port can be used to connect to your network. Only one port should, however, ever be connected to a network. (The second port is only for backup purposes when reconfiguring static IP addresses.)
For more on networking, see our [Networking](/motion-hub-hardware/networking/motion-hub-networking) article.
## Activation
Activation is the process of associating a Motion Hub with any Motion account, which becomes the *owner* of that Motion Hub.
Activation can take place with or without connecting the hub to the internet, but for all hub features to work, the hub will need to be connected to the internet.
To activate a hub, navigate to the **Controls** > **Hubs** view in Motion Platform. Then click **Add Hubs** and follow the prompts shown:
# Networking
# Motion Hub Networking
## Overview
In this article, we'll talk about some of the basics of ensuring your Motion Hub can talk to the various devices that are connected to the same network.
## Firewalls
This part should be simple, as Motion Hub is designed to easily connect itself to the cloud once it is provided internet access.
### Inbound Rules
Motion Hub does *not* require any **inbound** ports to be opened to connect to the cloud. For security, never deliberately route any public internet-facing traffic/ports to Motion Hub.
### Outbound Rules
Outbound communication to the cloud typically "just works", but networks with stricter policies may need to be configured to allow these **outbound** traffic rules.
#### Ports
| Port | Protocol | Direction |
| ----- | -------- | ------------- |
| `80` | UDP | Outbound only |
| `443` | TCP | Outbound only |
#### Hosts
Motion Hub must be able to talk to these hosts:
| Host | Required For |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `*.motion.cloud` |
Motion Cloud services, such as:
Live data
Alarms
Software updates
Remote support services
|
| `*.nr-data.net` |
Remote support services
|
| `*.newrelic.com` |
Remote support services
|
### MTU
By default, Motion Hub is configured for an MTU value of `1380`.
## Local Network
### Physical Ports
Motion Hubs with two networking ports are shipped with both ports enabled and configured for DHCP address assignment. Either port can be used.
### IP Address Assignment
By default, Motion Hub will receive its local IP address from a local DHCP server.
One static IP address per hub can be configured by submitting a support ticket at this time.
### Routing Considerations
Your Motion Hub must be able to communicate with relevant devices on your network, such as those communicating over Modbus TCP or BACnet/IP.
Basic networks will often be small enough and lack routing restrictions, enabling communication right out of the box.
For more advanced network configurations that are more restrictive by default (e.g. larger enterprise environments), you (or your IT/networking engineers) must ensure any given Motion Hub has a route to communicate with the devices the Motion Hub needs to reach.
Special consideration may be needed for BACnet devices. [Learn more here](/motion-hub-hardware/networking/bacnet-ip-networking).
### IPv4 vs. IPv6
Motion Hub is tested on IPv4 and dual-stack (IPv4 + IPv6) networks only. IPv6-only networks are not officially supported, although Motion Hub may work without issue on IPv6-only networks.
# BACnet/IP Networking
## Overview
Motion Hub is fine-tuned for performant communication with your BACnet devices. As an older protocol, however, BACnet can present a few unique challenges. But armed with the right information, you should be able to get up and running with little to no trouble at all.
## BACnet Considerations
### MSTP Support
BACnet MSTP devices must be connected to a BACnet router with which Motion Hub can communicate.
### Ports
As of this writing, Motion Hub supports BACnet/IP communication over port `47808` (`0xBAC0`), the default port for BACnet/IP communication.
### Broadcast + Device Discovery
BACnet device discovery relies on broadcast communication, which could be deliberately blocked by some local routers or other network equipment.
Fortunately, while broadcast-based discovery operations may be blocked on larger, more complex networks, there are alternative ways to add devices without broadcast communication support.
Here are some things to keep in mind if you're having trouble with device discovery:
* Devices connected to subnets other than that to which the Motion Hub is connected are generally prevented from being discovered using automatic device discovery, even if there is a route configured for Motion Hub and those devices to communicate.
* Device discovery is a very "chatty" operation; keep this in mind when performing device discoveries on older, congested networks to avoid interrupting other communications.
* Device discovery failure does not indicate that any other operation will fail or be impacted. In fact, networks that block broadcast-based operations like device discovery are likely better tuned for performance, which can end up enhancing reliability for all other BACnet operations.
* Device discovery through a BACnet router is supported, but is still subject to the broadcast operation limitations described above.
# Modbus TCP Networking
Networking for Modbus TCP is very straightforward. The Motion Hub must simply be able to communicate with the IP address of the given Modbus TCP device over the network to which the Motion Hub is connected.
Unlike other protocols, Modbus does not provide discovery mechanisms, and so you must manually obtain the IP address of the Modbus device with which you want to communicate via Motion.
# Powering On & Off
## Power On
The Motion Hub is designed to power on automatically when it is supplied power.
If you manually shut down the Motion Hub using the power button, you can power it back on either by pressing the same power button or by removing the power source and replacing it.
## Power Off
*Optimally*, you should power off the Motion Hub by pressing (but not holding) the power button and waiting up to 30 seconds for the power light to turn off, indicating that the Motion Hub has successfully shut down. At that point, it is safe to remove the power.
Nonetheless, the Motion Hub is designed to withstand sudden power loss events, but recently collected data could be lost if the Hub is not shut down properly first.
# Apps
# What are "Apps"?
{% hint style="info" %}
Heads up! This article is about **Apps that exist *****inside***** Motion Platform**.
If you are looking for info about our smartphone/tablet mobile apps, [look here instead](/motion-platform-software/accessing-the-platform/mobile-apps-ios+android).
{% endhint %}
A Motion app is simply a container for your [tiles](/motion-platform-software/tiles/whats-a-tile) to be viewed and used by your end users.
Some Motion app [*types*](/motion-platform-software/apps/app-types) are highly curated (e.g. the Property Manager and Tenant Portal app types, which offer unique functions and *useful* limitations), while others will be incredibly versatile and up to you to dream up the possibilities (e.g. the Mosaic app type, which helps you build custom dashboards with no limits).
Each Motion app:
* Has a [*type*](/motion-platform-software/apps/app-types)
* Can be shared between users
* Can be linked to tiles (so that those tiles appear in the app)
You can create multiple apps of any app *type*.
# App Types
{% hint style="info" %}
Heads up! This article is about **Apps that exist *****inside***** Motion Platform**.
If you are looking for info about our smartphone/tablet mobile apps, [look here instead](/motion-platform-software/accessing-the-platform/mobile-apps-ios+android).
{% endhint %}
App types determine what features will be available to end users when they open an app.
Here are the current app types:
| Type | Description |
| ---------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Mosaic™ | Build fully customizable dashboards containing any combination of tiles. |
| Property Manager | Manage your tenants' abilities throughout your property, giving them just enough control over their spaces and giving you the ability to easily manage access and manage public and vacant spaces for energy cost savings. |
| Tenant Portal | Use the Motion mobile app or web app to control climate, schedules, and more in your own space. |
# Creating a Mosaic App
### **Step 1:** Navigate to "Add Apps" view
| Steps | Screenshots |
| ----------------------------------------------------------------------------------------------------- | -------------------------------- |
| In the Apps view, click on "Manage Apps" |  |
| In the "Manage Apps" view, click on the "Add Apps" option at the top-right hand portion of the screen |  |
### **Step 2:** Choose from the type of App that you want to create
You are now in the "Add Apps" view. You will be given the option to create one of three Motion Apps. Each one of the Motion Apps can be described in this [article](https://help.motion.cloud/hc/en-us/articles/8920821241997). The three types of apps that you can create are:
1. Mosaic App
2. Property Manager App **(coming soon)**
3. Tenant App **(coming soon)**
In this article, we will discuss how to create a Mosaic App.
| Steps | Screenshots |
| -------------------------------------------------------------------- | -------------------------------- |
| Click the green "Create App" button in the "Mosaic by Motion" window |  |
### **Step 3:** Input a name for the newly created Mosaic App
After clicking "Create App", you will be directed to a "New App" pop-up window and the user will input the unique name the App. This is the name that will appear on the Apps view, and can be renamed if needed.
| Steps | Screenshots |
| ---------------------------------------- | -------------------------------- |
| Input an App name and click "Create App" |  |
You have now successfully created a Mosaic App.
# Configuring a Mosaic App
## Prerequisites
Before configuring a Mosaic App, the following perquisites must be satisfied:
1. You've already added a Mosaic App to configure
2. You have discovered or added device points to the Cloud
3. The device you added supports BACnet
4. The BACnet device is connected to the same local area network as the Motion Hub with which it is associated
## **Configuring App Settings**
### **Step 1:** Open the Mosaic App that you wish to configure
Using the search bar, type in the name of the Mosaic App you have already added. Users can find a Mosaic App in two separate views:
1. Apps
2. Manage Apps
| Views | Screenshots |
| ------------------------------------------------------------------------- | -------------------------------- |
| Search for the Motion App you'd like to configure in the Apps view |  |
| Search for the Motion App you'd like to configure in the Manage Apps view |  |
### **Step 2:** Click the Configuration menu option
| Steps | Screenshots |
| ------------------------------------------------------------------------------------------------ | -------------------------------- |
| Click the "Configuration" option on the left-hand vertical menu to access the Configuration view |  |
### **Step 3:** Input details in App Settings
Click the "App Settings" view. You are able fill in the following inputs:
1. Name
2. Subtitle
3. Weather Postal Code
4. App Image
| App Setting Windows | Screenshots |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------- |
|
Name
Input the desired name of the App to easily identify it.
This will be the name that you see appear in the Motion Apps view.
Click "Save"
|  |
|
Subtitle
If desired, input a subtitle to further identify the App
This will be the subtitle that you see appear on the Motion Apps view
Click "Save"
|  |
|
Weather Postal Code
A user's Motion App can have a weather postal code associated with it if desired (Figure 6). This will link the app with local weather information.
Input the postal code associated with the site location
Click "Save"
|  |
|
App Image
If desired, give the Mosaic App an image which will be displayed in the Apps view.
Save image file to desktop
Click "Upload File" button
Locate and open image from saved files
|  |
## **Configuring Tiles & Tile Groups**
### **Step 1:** Click on "Tile Groups" to configure dashboard layout
These configuration settings allows you to organize and group Motion Tiles in a way that is preferred by the user. In the steps below, we are going to discuss the following dashboard configuration options/topics:
1. Ungrouped Tiles
2. Creating a new Tile Group
3. Adding Ungrouped Motion Tiles to a newly created Tile Group
4. Relocating a Motion Tile from one Tile Group to another Tile Group
5. Repositioning Motion Tiles within a single Tile Group
6. Shuffling Tile Groups around
### **Step 2:** Identify Ungrouped Tiles
When a new Motion Tile is created and linked to a Motion App, the Motion Tile will, by default, display at the top of the Mosaic Dashboard. These are considered **"Ungrouped Tiles".** They do not have a group name assigned to it.
In the same manner, new Motion Tiles will, by default, display at the top of the "Tile Group" view in the configuration settings as "Ungrouped tiles".
These ungrouped Motion Tiles will stay ungrouped until they are assigned to a tile group.
| Ungrouped Tiles | Screenshots |
| --------------------- | -------------------------------- |
| Mosaic Dashboard view |  |
| Tile Groups view |  |
### **Step 3:** Create a new Tile Group
In the steps below, we will show users how to create a new Tile Group to group the ungrouped Motion Tiles discussed above. In this example, we are going to name this new Tile Group "Refrigeration".
| Steps | Screenshots |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| To create a new Tile Group, locate and click the green "Add Group" button at the top of the page |  |
|
When this button is clicked, a new Tile Group will appear at the bottom of the Tile Group list. The default name of the tile group you created reads "New Group"
Locate the newly created Tile Group at the bottom of the view (red box)
Give the Tile Group a name (lime green box)
|  |
### **Step 4a:** Add Motion Tiles to a Tile Group
*Preliminary Assumption: You are grouping Motion Tiles that have already been linked to this Mosaic App.*
Next to each Motion Tile, you will identify the blue chocolate bar icon*.*
| Steps | Screenshots |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
|
Click the blue chocolate bar icon (red box), and drag the Motion Tile into a Tile Group of your choice. Repeat for all other tiles that need to be grouped.
NOTE: You can use this same method to move individual Motion Tiles from one Tile Group to another.
Click the "Save" button at bottom of page to save your configuration changes.
|  |
|
In this example, we added all eight of the ungrouped tiles to the newly created Tile Group, which we have labeled "Refrigeration".
As you can see, there exist no tiles to click and drag from the "Ungrouped Tiles" at the top of the page (Figure 13)
|  |
### **Step 4b:** Add Motion Tiles to a Tile Group from another Mosaic App
*Preliminary Assumption: You are grouping Motion Tiles that have already been created but do **NOT** exist in this Mosaic App*
Alternatively, you can add Motion Tiles from another Mosaic App to a Tile Group by clicking the "Add Tiles" button that appears at the bottom left corner of each Tile Group.
| Steps | Screenshots |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
|
Click "Add Tiles" button (red box)
Type in the tile name or tile ID in the pop-up search window that appears (lime green box)
|  |
### **Step 5 (Optional):** Follow instructions for additional configuration options
You have successfully created a Tile Group and added the ungrouped Motion Tiles to this Tile Group. Now, you can select from additional configuration settings for the Mosaic dashboard.
1. Repositioning tile groups
2. Deleting tiles from Mosaic App
3. Ungrouping tiles
#### Repositioning Tile Groups
For organizational preferences, you may want to reposition the order of the Tile Groups. The order of the Tile Groups from top-to-bottom in this configuration view will be reflected in the order of the Tile Groups that are displayed from top-to-bottom on the Mosaic Dashboard view.
| Steps | Screenshots |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------- |
|
Locate the Tile Group you wish to reposition
Click the black chocolate bar icon next to the title of the Tile Group (red box)
Click and drag the selected Tile Group to a placement of your liking
Click the "Save" button at bottom of page
|  |
#### Deleting Motion Tiles from Mosaic App
You have the option to delete individual Motion Tiles completely from the Mosaic App. This will unlink the Motion Tile from this Mosaic App.
| Steps | Screenshots |
| ---------------------------------------------------------- | -------------------------------- |
| At the right hand side of the view, click the red "X" icon |  |
#### Ungrouping Motion Tiles
Users have the ability to delete a Tile Group. This consequently ungroups each individual Motion Tile that was in that deleted group. After deleting a Tile Group, the ungrouped tiles will reappear at the top of the view.
| Steps | Screenshots |
| --------------------------------------- | -------------------------------- |
| Locate and click the red Group "X" icon |  |
### **Step 8:** Save Configuration Changes
Your changes will not be reflected in the Mosaic Dashboard view unless you save them.
| Steps | Screenshots |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------- |
| When your configuration settings are complete, click the save button at the bottom of the view *(lime green box)* |  |
| NOTE: If you accidentally made configuration changes that were not meant to be saved, you can start over by clicking the "Revert" button at the bottom of the page *(red box)* |  |
# Deleting an Existing Motion App
In this article, we will instruct users on how to delete an existing Motion App.
### **Step 1:** Navigate to "Manage Apps" view
In the Apps view, you will see "Home" and "Manage Apps" in the platform's left-hand vertical menu.
| Steps | Screenshots |
| ----------------------------------------------------------------- | -------------------------------- |
| Click on "Manage Apps" in the platform's left-hand vertical menu. |  |
### **Step 2:** Identify the Motion App you wish to delete
| Steps | Screenshots |
| ----------------------------------------------------------------------------------------------------------- | -------------------------------- |
|
Locate the App that you wish to delete, and locate the blue hamburger bar next to its name.
|  |
### **Step 3:** Type "DELETE" in the warning window
As a safety precaution, users will need to manually input the word **"DELETE"** in the pop-up window that appears when clicking the "delete" option from the "Manage Apps" view.
| Steps | Screenshots |
| ------------------------------------------------ | -------------------------------- |
| Type in "DELETE" and hit the red "submit" button |  |
# Tiles
# What's a "Point"?
A point is any specific **piece of data** or **user-controllable setting** that can be *read from*—and possibly *written to* (i.e. controlled)—a [device](/motion-platform-software/devices/what-are-devices).
While all points can be read, not all can be written to. What determines *writability* (i.e. whether a point can be written to) is whether a point logically could/should be controllable by users. For more information, see our explanation of [read-only vs. read+write](/motion-platform-software/tiles/tiles-read-only-vs.-read+write) tiles.
What's most important to understand is that with Motion, points are used to create [tiles](/motion-platform-software/tiles/whats-a-tile).
{% hint style="info" %}
**Important Distinction: Points vs. Tiles**
Your typical end users (including installers and engineers, post-installation) will never deal with points directly. Instead, they will interact with **tiles**, which encapsulate, enhance, and secure the functionalities of points. Hence points, in Motion Platform, are primarily a configuration-stage concept only, while day-to-day utilization of points actually happens by interacting with [tiles](/motion-platform-software/tiles).
{% endhint %}
Another way to think about points is that points are created by the manufacturer of the device, while [tiles](/motion-platform-software/tiles/whats-a-tile) are the software magic Motion provides to wrap around those points.
Points can be *many* different things, such as:
* Temperatures
* Humidity levels
* Set points for temperatures and humidity
* Lighting controls
* Pressure gauges
* Leak sensor statuses
* Contact closures (e.g. is the garage door open or closed?)
* Relay-based switches
* Occupancy/motion sensors
* Air handler statuses
Motion supports reading from and writing to points from any [supported protocol](/motion-platform-software/devices/supported-protocols).
Motion also enables [treating writable points as read-only points](/motion-platform-software/tiles/tiles-read-only-vs.-read+write) when configuring tiles.
# What's a "Tile"?
A "Motion Tile", as you will see, is commonly referred to as a "tile" in our support articles.
A tile is the platform's visual representation of a single [point](/motion-platform-software/tiles/whats-a-point) on a device. Every tile communicates real-time device point data to Motion's cloud.
{% hint style="warning" %}
Tiles are not the same as points. Read our [article about points](/motion-platform-software/tiles/whats-a-point) for more info.
{% endhint %}
Additionally, every tile comes packed with UX software features that give meaningful value to that specific device point. Motion baked in these tile software features to turn normal device data into a meaningful tool to optimize building device management.
These software features include:
1. Appearance customization
2. Easy schedule configuration
3. Configurable alarm conditions & push notification alerts
4. Live and historical data charts
5. Remote device control capabilities
# Tile Types
Learn about numeric, multi-choice, toggle, folder, and Canvas tile types.
Motion tiles take data sourced using any [supported protocol](/motion-platform-software/devices/supported-protocols) and distills them into **consistent**, useful types.
## Types
### Numeric
A numeric tile is a **point-based** tile that displays a number at all times.
The underlying raw data is also numeric, and often requires transformation of some kind to be presented to the user in a way that makes sense to a typical end user. Some examples of transformations:
* A thermostat provides current room temperature in degrees Celsius, but the end user lives in a region where degrees Fahrenheit is the common temperature unit.
* A water loop temperature sensor outputs the current temperature as an integer (i.e. no decimal points) that actually includes float information (i.e. digits that come after a decimal point).
* For example, the device may output the value `10275` to indicate a temperature of `102.75`
Numeric tile configuration provides tools to accommodate these and many more types of transformations, and allows you to customize how units are displayed to the end user (e.g. "°F" instead of "degreesFahrenheit").
Numeric tiles can also be configured to only permit an end user to set values within a particular range, which can help prevent innocent but costly errors, or even simply help enforce energy savings goals.
### Multi-Choice
A multi-choice tile is a **point-based** tile that always has a finite list of possible values, any one of which can represent the current state. If the tile is read-only, then the current state displayed on the tile will only be one of the values in the finite list. If the tile is read+write, the end user can change the state to any of the choices in the finite list.
Different protocols may have different names for this concept. For example, BACnet points that follow this concept are referred to as "multistate" points in the BACnet protocol. Although different protocols may have different names for this concept, Motion will always refer to tiles with such choices as *multi-choice*.
A classic example of a multi-choice tile is one which controls the current HVAC mode in a thermostat. The possible states could be:
* Heating mode
* Cooling mode
* Crossover (automatic) heating/cooling
* Fan only
* Off
While the Motion tile will present user-friendly verbiage for each state, the underlying raw value is always an integer (i.e. a number with no decimal point). So while the user may see "Unoccupied" on the tile, the actual value being send and received in the background that *represents* cooling mode will be a number, such as `2`. The tile configuration is where the installer manages these value mappings:
Multi-choice value mappings
### Toggle
A toggle tile is a **point-based** tile similar to multi-choice, but with a few key differences:
1. There are only ever two possible states, whose text representations (i.e. what end users will see) are fully customizable. For example: "On" and "Off"
2. The underlying raw value behind each state is only ever `false` or `true` (which can also be thought of as `0` and `1`)
### Folder
A tile folder is one type of **SuperTile™** that is actually rather simple. Like a folder on your computer or smartphone/tablet home screen, it's just a tile that contains other tiles. It is used to categorize tiles that have some commonality within a single [app](/motion-platform-software/apps/what-are-apps).
{% hint style="info" %}
A tile folder is itself a tile, so it can be shared and is configured similar to the other tile types. When a tile folder is shared, its contents are shared automatically.
{% endhint %}
### Canvas
A Canvas tile is a type of SuperTile™ that lets you place supported Motion Tiles and tile folders on top of an uploaded image.
Canvas Tiles can turn a floor plan, site map, equipment diagram, or photograph into an interactive view of live data. Users can navigate the image, select individual tiles to view more information, group nearby tiles using Canvas Clustering, and use Motion Replay to review values from an earlier point in time.
For instructions on creating, configuring, and using a Canvas Tile, see [Canvas Tiles](https://kb.motion.cloud/motion-platform-software/tiles/tile-types/canvas-tiles).
# Canvas Tiles
Create interactive floor plans, equipment diagrams, and visual site maps by placing live Motion Tiles on an uploaded image.
Canvas Tiles let you place live Motion Tiles on top of an uploaded image, creating an interactive visual representation of a physical space, system, or piece of equipment.
For example, you can upload a floor plan, site map, equipment diagram, or photograph and position relevant tiles directly where the associated devices or sensors are located. Users can then view live values, navigate the Canvas, open tile details, group nearby tiles with Canvas Clustering, and use Motion Replay to review values from an earlier point in time.
Canvas Tiles display at full width within a linked Mosaic App and are fully supported on desktop and mobile.
### Common uses for Canvas Tiles
Canvas Tiles are especially useful when the physical location of a device or sensor provides important context.
Common examples include:
* Data center floor plans
* Building and room layouts
* Mechanical and electrical diagrams
* Equipment or system photographs
* Sensor deployment maps
* Site plans
* Mobile troubleshooting and inspection workflows
Instead of navigating a large dashboard containing hundreds of individual tiles and tile folders, users can locate and review data within a visual representation of the actual environment.
### Before you begin
Before creating a Canvas Tile:
1. Create the tiles that you want to place on the Canvas.
2. Prepare the image that will be used as the Canvas background.
3. Create or identify the Mosaic App where the Canvas will appear.
Canvas supports the following image formats:
* `.png`
* `.jpg`
* `.jpeg`
* `.webp`
The following tile types can be placed on a Canvas:
* Numeric tiles
* Toggle tiles
* Multi-choice tiles
* Tile folders
Other SuperTiles cannot be placed on a Canvas, and a Canvas Tile cannot be placed inside another Canvas Tile.
For more information about supported tiles, see Tile Types. To create the underlying tiles first, see [Creating Point-Based Tiles](https://kb.motion.cloud/motion-platform-software/tiles/creating-point-based-tiles?utm_source=chatgpt.com).
### Creating a Canvas Tile
#### Step 1: Open the Tiles area
Navigate to the **Tiles** area of the Motion Platform and select the option to add a new tile.
Select **Canvas** from the available SuperTile options.
#### Step 2: Configure the Canvas Tile
Enter the standard configuration information for the Canvas Tile, including its name, display name, profile, facets, tags, appearance, and linked Mosaic App.
Canvas Tiles use many of the same standard configuration options as other Motion Tiles. For more information, see [Configuring Motion Tiles](https://kb.motion.cloud/motion-platform-software/tiles/configuring-motion-tiles?utm_source=chatgpt.com).
#### Step 3: Upload the Canvas image
In the Canvas configuration view, upload the image that will be used as the Canvas background.
The uploaded image may be a floor plan, diagram, site map, photograph, or another visual that helps users understand where each tile belongs.
### Adding tiles to the Canvas
After uploading the image, you can place existing Motion Tiles on the Canvas.
#### Steps
1. Move your cursor over the desired location on the Canvas.
2. A small **+** icon appears at the selected location.
3. Select the **+** icon.
4. Search for and select the tile you want to add.
5. Repeat these steps to add additional tiles.
6. Select **Save** when you have finished configuring the Canvas.
The tile appears at the location selected on the image.
The same underlying tile can remain as a standalone tile in an app and can also be used on multiple Canvas Tiles.
#### Placing multiple tiles in the same location
Multiple tiles can be placed at the same Canvas location. When necessary, their display order can be adjusted from the tile’s configuration options.
### Removing or repositioning a tile
To remove a tile from the Canvas:
1. Open the Canvas configuration.
2. Select the placed tile.
3. Select the option to remove it.
4. Select **Save**.
Placed tiles cannot currently be dragged to a new position. To reposition a tile, remove it and add it again at the desired Canvas location.
### Linking a Canvas Tile to a Mosaic App
A Canvas Tile must be linked to a Mosaic App before it appears on an app dashboard.
You can link the Canvas during configuration by selecting the applicable app in the **Apps** section.
Select **Save** to apply the Canvas configuration and app linkage.
For more information about Mosaic Apps, see [Creating a Mosaic App](https://kb.motion.cloud/motion-platform-software/apps/creating-a-mosaic-app?utm_source=chatgpt.com) and [Configuring a Mosaic App](https://kb.motion.cloud/motion-platform-software/apps/configuring-a-mosaic-app?utm_source=chatgpt.com).
### Viewing and navigating a Canvas
Canvas Tiles display at full width within the linked Mosaic App.
From the Canvas, users can:
* View current tile values
* Zoom in or out
* Pan across the uploaded image
* Open details for an individual tile
* Enable Canvas Clustering
* Review historical values with Motion Replay
The icon and color used for each placed tile come from the configuration of the underlying Motion Tile.
When a tile does not yet have a current value, the Canvas displays a loading indicator until a value becomes available.
### Opening tile details
Select an individual tile on the Canvas to open its details in the tile drawer at the bottom of the screen.
The drawer displays the full tile information associated with the selected Canvas marker.
Select outside the drawer or close it to return to the full Canvas view.
### Alarm Badges on Canvas Tiles
When a tile displayed on a Canvas enters an alarm state, its mini tile displays a badge indicating whether the alarm is acknowledged or unacknowledged.
This makes it easier to identify active alarm states directly from the floor plan. Select the mini tile to display the expanded tile below the Canvas, where you can review the current alarm state and access the available tile actions.
For more information about viewing and managing alarms, see [Current Alarms](/motion-platform-software/alarms/current-alarms) and [Clearing/Acknowledging Alarms](/motion-platform-software/alarms/clearing-acknowledging-alarms).
### Using Canvas Clustering
Canvas Clustering makes it easier to navigate Canvas Tiles that contain many closely positioned data points.
To enable Canvas Clustering, select the **layer** icon in the Canvas navigation controls.
When clustering is enabled:
* Individual tiles are grouped when the Canvas is zoomed far enough out.
* Each numbered cluster shows how many tiles are contained within that area.
* Clusters automatically separate into smaller groups or individual tiles as you zoom in.
* Clustering adjusts dynamically based on tile location and the current zoom level.
For example, a cluster containing 21 tiles may separate into two clusters containing 8 and 13 tiles as the user zooms further into the Canvas.
#### Viewing the tiles in a cluster
Select a numbered cluster to open the tile drawer.
The drawer displays the tile details for all tiles included in the selected cluster.
Zoom in to return to the individual tile markers within that area.
### Using Motion Replay
Motion Replay lets users view the Canvas and its tile values as they appeared at an earlier point in time.
The Motion Replay controls include:
| Control | Description |
| ---------- | ---------------------------------------------------------------------------- |
| **Older** | Moves backward through historical Canvas values. |
| **Newer** | Moves forward through historical Canvas values. |
| **Step** | Determines how far backward or forward the Canvas moves with each selection. |
| **Latest** | Returns the Canvas to the latest available values. |
#### Steps
1. Select the desired **Step** value.
2. Select **Older** to move backward through historical values.
3. Continue selecting **Older** or **Newer** to navigate through time.
4. Select **Latest** to return to current values.
Motion Replay updates the values shown across the Canvas, making it possible to review how conditions appeared throughout a physical environment at a previous point in time.
### Using Canvas Tiles on mobile
Canvas Tiles are fully supported in the Motion mobile experience.
Mobile users can:
* View the full Canvas
* Zoom and navigate around the uploaded image
* Select individual tiles
* Open tile details
* Interact with Canvas Clustering
* Use Motion Replay
This makes Canvas Tiles especially useful for technicians, engineers, and other users who need to review live data while physically moving through a building, site, or equipment area.
### Editing an existing Canvas Tile
An existing Canvas Tile can be configured from either the app dashboard or the Tiles area of the Platform.
#### From the app dashboard
1. Open the Mosaic App containing the Canvas.
2. Open the Canvas Tile options.
3. Select **Configure**.
#### From My Tiles
1. Navigate to **Tiles**.
2. Locate the Canvas Tile under **My Tiles**.
3. Open the tile menu.
4. Select **Configure Tile**.
From the configuration view, you can:
* Add tiles
* Remove tiles
* Change tile order
* Replace the background image
* Update the Canvas appearance
* Link or unlink apps
### Replacing the background image
You can replace the Canvas background image from the Canvas configuration view.
When the image is replaced, Motion preserves the existing tile coordinates as closely as possible. However, tile placement may appear different if the new image has different dimensions, proportions, or content.
Review the placement of existing tiles before saving the new image.
Select:
* **Save** to apply the changes.
* **Revert** to return to the previously saved Canvas configuration.
### Image best practices
For the clearest Canvas experience:
* Use an image with enough detail to identify important locations.
* Crop unnecessary whitespace or content before uploading.
* Use a consistent image orientation.
* Use an image that remains readable when viewed on both desktop and mobile.
* Compress unusually large image files while preserving the necessary detail.
* When replacing an existing image, use similar dimensions and proportions when possible to help preserve tile placement.
### Related articles
* [Creating Point-Based Tiles](https://kb.motion.cloud/motion-platform-software/tiles/creating-point-based-tiles?utm_source=chatgpt.com)
* [Configuring Motion Tiles](https://kb.motion.cloud/motion-platform-software/tiles/configuring-motion-tiles?utm_source=chatgpt.com)
* [Creating a Mosaic App](https://kb.motion.cloud/motion-platform-software/apps/creating-a-mosaic-app?utm_source=chatgpt.com)
* [Configuring a Mosaic App](https://kb.motion.cloud/motion-platform-software/apps/configuring-a-mosaic-app?utm_source=chatgpt.com)
# Tiles: Read-Only vs. Read+Write
As explained in the [Points article](/motion-platform-software/tiles/whats-a-point), device *points* can be either read-only or both readable and writable (we sometimes call the latter simply "writable" since all points are readable).
But in Motion Platform, users do not typically interact with points directly. Instead, they should interact with tiles, which act as wrappers around points and therefore provide multiple layers of functionality and security around points.
So how do you prevent a Motion user from *writing* values to a point that is writable?
Since end users use tiles, not points, in day-to-day interaction with Motion, you have the ability to configure a read-only tile in Motion even if its underlying point supports writing values, thus giving end users the ability to see the current state of any given tile (and by extension, the point it represents) while also preventing them from making any changes.
To accomplish this, change the **Writability** setting to "**Read-Only**" in the tile configuration:
The writability setting for this set point tile is set to "Read-Only" and therefore prevents users from changing the current value.
Conversely, while Motion Platform will *let* you set the **Writability** setting to "**Read+Write**" for a tile whose underlying point is a read-only point (determined by the device manufacturer and, often, simple logic—for example, it wouldn't make sense for a point that represents the current humidity reading of a room to be writable), writing to such points will be rejected by the device and have no effect.
# Creating Point-Based Tiles
# Discover BACnet Points (& Creating BACnet Tiles)
In this article, you will perform a "Point Discovery" on an existing BACnet/IP device. Each point will then be converted into a Motion Tile.
## Prerequisites
Before attempting to discover BACnet points, make sure:
1. You've already [added your BACnet device](/motion-platform-software/devices/add-a-bacnet-device) to Motion
2. The device you added supports BACnet/IP or uses a BACnet router to be bridged to a BACnet/IP network
3. The BACnet device is connected to the same local area network as the Motion Hub with which it is associated
## Discover BACnet Points
### **Step 1**: Navigate to Devices view
Follow these steps to initiate a BACnet point discovery:
| Steps | Screenshots |
| -------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| From anywhere in the Motion Platform, click "Controls" on the left-hand side vertical menu *(red box)* |  |
|
Under the "Controls" drop down menu, select the "Devices" option.
This will direct you to the Devices view.
|  |
### **Step 2**: Identify devices to perform a Point Discovery
You are now in the "Devices" view. This view contains all of the devices that you have added at any earlier point in time.
| Steps | Screenshots |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
You can search for already-added devices in the top right hand "Search Bar"
After clicking the preferred device, you will be able to perform a "Point Discovery". You will click the "Discover Points" button
|  |
### **Step 3**: Start Point Discovery
You are now on the "Point Discovery" view, which contains three inputs:
1. Device
2. Timeout
3. Start Discovery / Abort
| Inputs | Screenshots |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
Device
Only the BACnet/IP devices you've already added or which another user has shared with you appear here
Click the drop down menu to locate the device you wish to discover points on.
The timeout setting defines the amount of time before the Motion Hub will stop waiting for a response from a device when attempting the point discovery. Some devices require more time than others to return their sets of discoverable points due to several factors including point quantity and link speed.
Click the appropriate timeout setting to accommodate the respective factors.
After the above options are selected, click "Start Discovery" to discover points on the preferred device.
|  |
### **Step 4**: Convert Discovered Points into Motion Tiles
After clicking "Start Discovery", a list of "Points Found" will appear. Out of this list, you will be able to convert individual device points into tiles.
| Details | Screenshots |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
Total Points Found
In the example here, there are "113 Points Found" from that single point discovery.
Locate the point that you wish to convert into a Motion Tile.
Click the "Make Tile" button
Depending on the point's data type (binary, multistate, or analog), you will be presented with one to three options:
Create numeric tile
Create multistate tile
Create toggle tile
Choose the appropriate tile type.
|  |
# Configuring Modbus TCP Points (and creating Modbus Tiles)
## Prerequisites
Before attempting to configure Modbus TCP points, make sure:
1. You've already [added your Modbus device](/motion-platform-software/devices/add-a-modbus-device) to Motion
2. The device you added supports Modbus TCP
3. The Modbus device is connected to the same local area network as the Motion Hub with which it is associated
## Configure Modbus TCP Points
Follow these steps to initiate point discovery:
### **Step 1**: Navigate to "Devices" view
Follow these steps to initiate point discovery:
| Steps | Screenshots |
| -------------------------------------------------------------------------------------------------- | -------------------------------- |
| From anywhere in the Motion Platform, click "Controls" on the left side vertical menu *(Figure 1)* |  |
| Under the "Controls" drop down menu, select the "Devices" option |  |
### **Step 2**: Identify Modbus device to configure points on the device
| Steps | Screenshots |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| In the "Devices" view, quickly identify the Modbus devices that have been added to Motion by simply typing "Modbus" in the search bar |  |
| Now, identify the correct Device Name for which you would like to configure points for (far left column in dashboard), and click the "Configure Points" button |  |
### **Step 3:** Add Modbus TCP point
In the "Point Configuration" view, you will see two windows:
1. Point Configuration
2. Known Points
#### Point Configuration
This window shows the specific Modbus TCP device you are accounting for. Make sure the device is correct. If not, you can choose another Modbus TCP device from the dropdown menu.
#### Known Points
This window displays every point that has been configured on this device and added to Motion.
It also contains a green "Add Point" button that will allow you to add additional Modbus points.
| Steps | Screenshots |
| --------------------------------------------------- | -------------------------------- |
| To add a Modbus point, click the "Add Point" button |  |
### **Step 4:** Configure Modbus TCP point
After clicking "Add Point", you will be directed to the "Configure Point" view. In this view, you will input/select details about that point inside the following sections:
1. Name
2. Address *(Manufacturer Manual Specification)*
3. Data Type
4. Functions *(Manufacturer Manual Specification)*
5. Byte Order *(Manufacturer Manual Specification)*
| Inputs | Screenshots |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------- |
|
Name
Give the point a name that you will use to identify it.
|  |
|
Address
Refer to the manufacturer's manual specifications to identify the desired point's address.
|  |
|
Functions
Motion supports both "Read-Only" and "Read/Write" points. Refer to the manufacturer's manual specifications to determine if the desired point is "Read-Only" or "Read/Write."
Click the drop down menu to select the correct point function
|  |
|
Data Type
As of now, Motion supports 16-bit value data type. Additional data types are coming soon. The correct data type, by default, will be determined by the point's function that you identified and selected above. Therefore, no action is needed here.
If the function is "Read-Only", the default data type will be "16-bit Integer" (also referred to as "Input Register")
If the function is "Read/Write", the default data type will be "16-bit Integer" (also referred to as "Holding Register")
| |
|
Byte Order
(insert description)
|  |
### **Step 5:** Save configuration details
| Steps | Screenshots |
| --------------------------------------------------------------------------------------- | -------------------------------- |
| Confirm all Modbus point configuration options are correct, and click the "Save" button |  |
# Creating Formula Tiles
Create Formula-Based Numeric Tiles that calculate values from existing tile inputs using predefined formulas, custom formulas, and CSV bulk creation.
## Creating Formula-Based Numeric Tiles
Create a Numeric Tile whose value is calculated from one or more existing tile values.
### Formula-Based Numeric Tiles
Formula-based Numeric Tiles allow Motion to calculate a tile value from other available data points.
This is useful when a value is not coming directly from a device, but can be calculated from one or more existing tile values.
For example, a Formula Tile can calculate dew point from temperature and humidity inputs, or calculate a simple average from two temperature tiles.
Formula Tiles are Numeric Tiles. They are intended for calculated numeric values.
### When to use a Formula Tile
Use a Formula Tile when you need to:
1. Calculate a value from one or more existing tile values
2. Create an indoor air quality or building operations metric that is not directly reported by a device
3. Use a predefined formula, such as dew point
4. Create a simple custom formula from existing values
5. Display the calculated value as a Motion Tile
### What Formula Tiles do not do
Formula Tiles calculate values from the current or latest available inputs.
They do not calculate values over a period of time.
For example, a Formula Tile can calculate a dew point value from temperature and humidity inputs. It cannot calculate the average PM2.5 value over the last 30 days.
### Permissions
Formula Tiles can be created or updated by:
1. Administrators
2. Managers/System Owners
Viewers can view Formula Tiles, but cannot create or update them.
If you do not see the formula options described below, contact your Motion account administrator.
### Before creating a Formula Tile
Before creating a Formula Tile, make sure the source values are already available as configured tiles in Motion.
A source tile does not need to be linked to an app to be used in a formula, but the source value must be available in Motion before it can be selected as a formula input.
Formula inputs may come from supported device data sources such as BACnet, Modbus, or LoRaWAN.
### Formula Tile options
Motion supports predefined formulas and custom formulas.
Current predefined formulas include:
1. Dew Point °C
2. Dew Point °F
3. Dew Point Spread °C
4. Dew Point Spread °F
Custom formulas can also be created for simple numeric calculations.
### Step 1: Navigate to Add Tiles
Steps
1. Navigate to Controls
2. Click Tiles
3. Click Add Tiles
4. In the Point-Based Tiles section, select Numeric
### Step 2: Select Use formula
In the Create Numeric Tile screen, choose the data source for the tile.
Steps
1. Find the Data Source section
2. Select Use formula
3. Open the formula dropdown
Use device data shows a value from a selected device point.
Use formula calculates a value using a formula.
### Step 3: Select a predefined formula
To use a predefined formula, select the formula from the dropdown.
Steps
1. Click Select a formula
2. Choose the formula you want to use
3. Motion will display the required inputs for that formula
For example, Dew Point formulas require temperature and humidity inputs.
### Step 4: Select input values
After selecting a predefined formula, select the source values for each required input.
Steps
1. Choose the Device Name for the first input
2. Click Select Device Point
3. Select the device point or tile value to use
4. Repeat for each required input
5. Review any conversion, multiplier, or calibration offset fields
6. Continue when all required inputs are complete
The selected inputs are used by Motion to calculate the Formula Tile value.
### Step 5: Review formula validation
Motion validates formulas inline.
If a formula is valid, the formula field appears valid and Motion can calculate the value.
If a formula is not valid, the formula field will show a red border and the formula must be corrected before the tile can be created.
Steps
1. Review the formula field
2. Correct any highlighted issues
3. Confirm that all required inputs are selected
4. Continue to the tile configuration screen
### Step 6: Configure the tile
After the formula is configured, continue to the Configure Tile screen.
Steps
1. Enter the Tile Name
2. Enter the Display Name
3. Configure color, icon, and data display settings
4. Configure alarms if needed
5. Link the Formula Tile to any apps if needed
6. Save the tile
After the tile is saved, it behaves like other Numeric Tiles in Motion.
### Custom formulas
Custom formulas can be used for simple numeric calculations.
A custom formula uses variables. Each variable represents a source value that must be selected and configured.
For example:
```
(temp1 + temp2) / 2
```
This formula could be used to calculate the average of two temperature tiles.
Another simple example:
```
pm25 * 1.1
```
This formula could be used to apply a simple adjustment factor to a PM2.5 tile.
Custom formulas are intended for straightforward calculations. They are not intended to replace advanced analytics, historical reporting, or time-based calculations.
### Creating a custom formula
Steps
1. In the formula dropdown, select Create Custom Formula
2. Enter the custom formula
3. Add variables to represent each source value
4. Select the source device point or tile value for each variable
5. Review inline validation
6. Continue when the formula is valid
### Custom formula basics
Custom formulas can use standard arithmetic operators.
Common operators include:
1. Addition: +
2. Subtraction: -
3. Multiplication: \*
4. Division: /
5. Parentheses: ( )
Supported functions may include:
1. abs()
2. ceil()
3. floor()
4. log()
5. round()
Use the operators and functions shown in the formula builder. Unsupported formulas or invalid variable names will be shown inline.
### Editing Formula Tiles
Formula Tile attributes can be edited after the tile is created.
This includes settings such as:
1. Tile Name
2. Display Name
3. Color
4. Icon
5. Data display settings
6. Alarms
7. Linked apps
The formula itself cannot be changed after the tile is created.
If the formula needs to change, create a new Formula Tile.
This helps keep the tile’s historical data consistent.
### Creating Formula Tiles with CSV Bulk Tile Creation
Formula Tiles can also be created through [CSV Bulk Tile Creation.](#creating-formula-tiles-with-csv-bulk-tile-creation)
Use the Formula CSV template from the Bulk Tile Creation workflow and follow the same upload process used for other bulk tile creation workflows.
For more information, see the CSV Bulk Tile Creation page.
### Best practices
1. Use predefined formulas when they match the calculation you need.
2. Use custom formulas for simple calculations only.
3. Make sure all source values are already available as configured tiles in Motion.
4. Use clear variable names that describe the source value.
5. Keep formulas easy to read and maintain.
6. Use the Display Name to clearly identify what the Formula Tile represents.
7. Do not use Formula Tiles for time-based averages, trends, or historical calculations.
8. Create a new Formula Tile if the formula itself needs to change.
### Troubleshooting
#### I do not see the Use formula option
Confirm that you are creating a Numeric Tile. Formula Tiles are Numeric Tiles.
If you still do not see the option, contact your Motion account administrator.
#### I cannot select the source value I need
Make sure the source value is already available as a configured tile in Motion.
A source tile does not need to be linked to an app, but it must be available in Motion before it can be used as a formula input.
#### The formula is highlighted as invalid
Review the formula for missing inputs, unsupported operators, unsupported functions, or invalid variable names.
Use the operators and functions shown in the formula builder.
#### The Formula Tile value does not look correct
Check the source values, conversion, multiplier, calibration offset, and data display settings.
Also confirm that the selected source tiles are reporting current values.
#### I want to change the formula after saving the tile
The formula itself cannot be changed after the Formula Tile is created.
Create a new Formula Tile if the calculation needs to change.
#### I want to calculate an average over time
Formula Tiles do not calculate historical averages or time-based values.
Use Formula Tiles for calculations based on the current or latest available input values.
# Bulk Creating and Updating Motion Tiles with CSV Files
Create and update multiple Motion Tiles at once by downloading CSV templates, uploading completed files, and exporting existing tile configurations for bulk edits.
### Bulk Tile Creation
Bulk Tile Creation allows Administrators and Managers/System Owners to create or update multiple Motion Tiles at one time using a CSV file.
This is useful when adding a large number of similar tiles, configuring point-based tiles across many devices, or updating existing tile settings without configuring each Motion Tile one at a time.
Bulk Tile Creation supports CSV templates for different tile and point types. The available template options may vary depending on the type of Motion Tile being created.
### When to use Bulk Tile Creation
Use Bulk Tile Creation when you need to:
1. Create multiple Motion Tiles at the same time
2. Add similar point-based tiles across one or more Motion Devices
3. Update existing Motion Tile configurations in bulk
4. Export current tile configurations, make changes in a CSV, and upload the updated CSV back into Motion
{% hint style="info" %}
For copying one or more existing tiles through the Motion Platform, see [Cloning Motion Tiles](/motion-platform-software/tiles/cloning-motion-tiles). Use CSV Bulk Tile Creation when you need to create or update a larger number of tiles or edit configuration values in a spreadsheet.
{% endhint %}
### Permissions
Bulk Tile Creation is available to:
1. Administrators
2. Managers/System Owners
If you do not see the bulk creation options described below, contact your Motion account administrator.
### Step 1: Navigate to the Tiles view
Steps
1. Navigate to Controls
2. Click Tiles
3. Click Add Tiles
### Step 2: Open Bulk Tile Creation
In the Add Tiles view, locate the Bulk Creation section.
Steps
1. Find the Bulk Create tile
2. Click Bulk Create
3. The Bulk Tile Creation window will open
### Step 3: Download the correct CSV template
In the Bulk Tile Creation window, download the CSV template that matches the type of Motion Tile you want to create.
There are separate template options for Numeric Tiles and Toggle Tiles. Within each tile type, select the point source or tile source that matches the tiles you are creating. Examples include BACnet, Modbus, LoRaWAN, and Formula where applicable.
Steps
1. Under Download CSV Templates, choose the correct template type
2. Select the point source or tile source from the dropdown
3. Download the CSV template
### Step 4: Complete the CSV file
Open the downloaded CSV template and complete the required fields.
The CSV template is the source of truth for the required headers for that tile type. Do not remove or rename CSV headers.
For the most up-to-date definitions, accepted values, and formatting rules, use the tile term glossary linked from the Bulk Tile Creation window.
Common fields include:
1. Motion Device ID
2. Point configuration fields
3. Tile Name
4. Display Name
5. Tile Writability
6. Color
7. Icon
8. Linked App IDs
9. Linked Super Tile IDs
10. Alarm settings
11. Tags and facets
The exact fields will depend on the tile type and point source selected.
### Step 5: Upload the completed CSV file
After completing the CSV file, return to the Bulk Tile Creation window.
Steps
1. Under Upload CSV File, click the upload area
2. Select your completed CSV file
3. Confirm that the file has been uploaded
4. Click Create Tiles
The maximum CSV file size is 5MB.
### Step 6: Review processing results
After the CSV is uploaded, Motion will process the tile rows in the file.
The processing window shows the results of the upload, including:
1. Total tiles
2. Queued tiles
3. Processing tiles
4. Completed tiles
5. Warnings
6. Errors
Motion also displays tile details such as Display Name, Type, Color, Icon, linked Apps, and linked SuperTiles.
If the CSV cannot be processed, Motion will display row-level error messages to help identify what needs to be corrected in the CSV.
Steps
1. Review the processing results
2. If errors are shown, correct the CSV file
3. Upload the corrected CSV file again
4. Click Done when processing is complete
#### Exporting processing results
After the CSV has finished processing, select Export Results to download a CSV containing the results for every row in the original upload.
Each row in the exported file includes its processing status:
* Success
* Warning
* Error
Rows with warnings or errors also include the related details so you can identify what needs to be reviewed or corrected before uploading the file again.
{% hint style="info" %}
The exported results include every row from the original CSV, including rows that completed successfully and rows with warnings or errors.
{% endhint %}
### Updating existing Motion Tiles with a configuration CSV
Motion also allows you to download a configuration CSV from existing Motion Tiles. This is useful when you want to edit tile settings in bulk instead of configuring each tile individually.
You can download the existing configuration, edit values in the CSV, and upload the CSV through Bulk Tile Creation.
### Step 1: Select existing tiles
Steps
1. Navigate to Controls
2. Click Tiles
3. In the My Tiles tab, select one or more existing Motion Tiles
After one or more tiles are selected, additional bulk actions will appear.
### Step 2: Download the configuration CSV
Steps
1. Select the Motion Tiles you want to export
2. Click Download Configuration CSV
3. Open the downloaded CSV file
The downloaded CSV includes the current configuration values for the selected Motion Tiles.
### Step 3: Edit the configuration CSV
Update the values that you want to change.
Do not remove or rename CSV headers.
Be careful when editing Tile ID values. Tile ID is the unique identifier for the Motion Tile.
Motion uses Tile ID to determine whether a CSV row updates an existing tile or creates a new tile.
1. If a row includes an existing Tile ID, Motion updates that existing Motion Tile.
2. If a row includes a new Tile ID, Motion creates a new Motion Tile.
If you are only trying to update existing Motion Tiles, keep the existing Tile ID values unchanged.
### Step 4: Upload the edited configuration CSV
After editing the configuration CSV, upload it through the Bulk Tile Creation workflow.
Steps
1. Navigate to Controls
2. Click Tiles
3. Click Add Tiles
4. Click Bulk Create
5. Upload the edited configuration CSV
6. Click Create Tiles
7. Review the processing results
### Best practices
1. Download a fresh CSV template before creating a new set of tiles.
2. Use the tile term glossary for the latest accepted values and field definitions.
3. Do not remove or rename CSV headers.
4. When updating existing tiles, keep the Tile ID values unchanged.
5. Make a copy of the exported configuration CSV before making large edits.
6. Upload a small test file first when making a large or high-impact change.
7. Review warnings and errors before considering the upload complete.
### Troubleshooting
#### CSV upload fails
If the CSV upload fails, review the error message shown in Motion. The error message may identify the row and field that needs to be corrected.
Common causes include:
1. Missing required values
2. Invalid Motion Device ID
3. Incorrect point configuration
4. Invalid accepted value
5. Missing Tile ID when updating an existing tile
6. Removed or renamed CSV headers
#### Tiles were updated instead of created
Check the Tile ID column. If the CSV row includes an existing Tile ID, Motion will update the existing Motion Tile.
#### New tiles were created instead of existing tiles being updated
Check the Tile ID column. If the Tile ID does not match an existing Motion Tile, Motion will create a new Motion Tile.
#### Values are not displaying as expected
Check the tile term glossary for the accepted format of display units, decimal places, transformation formulas, multiplier, calibration offset, alarms, tags, and facets.
# Configuring Motion Tiles
## **Steps to Configure a Motion Tile**
### **Step 1:** Navigate to "Configure Tile" view
There are several ways to access the "Configure Tile" view for any given Motion Tile.
1. Controls > **Tile view**
2. Mosaic Dashboard
#### Tile View
The Tile view is accessible from the Controls view. This view shows a list of all Motion Tiles that have been added to the platform.
| Steps | Screenshots |
| --------------------------------------------------------------------------------------------------------- | -------------------------------- |
|
Identifying the Motion Tile you would like to configure
Click the "Configure Tile" button
|  |
#### Mosaic Dashboard
For tiles that have been linked to a Mosaic App, you can access the tile configuration view directly from the Motion Tile itself in the Mosaic Dashboard view.
Steps
Screenshots
In the Mosaic Dashboard, locate the Motion Tile you wish to configure
At the top of the Motion Tile, click the tile icon to choose from additional options
In the pop-up menu that appears, click "Configure"
#### **Overview: Configuration settings**
In the configuration view, you will have the option to input settings in the following windows:
1. Basics
2. Color
3. Data Display
4. Alarms
5. Icon
6. Apps
### **Step 2:** Input Basics settings
In this window, you will:
1. Input name of Motion Tile
2. Assign the writability of the Motion Tile
#### Tile Name
| Steps | Screenshots |
| --------------------------------------------------------------- | -------------------------------- |
| Give Motion Tile a name that you will use to identify it in App |  |
#### Writability
This setting determines whether users should have the ability to change the tile's value—for example, changing the value for a thermostat setpoint tile. This setting does not define whether the underlying point actually supports writing values; rather, it merely determines whether the Motion Platform will allow a user to attempt to change the value.
Hence it is possible for a tile to be connected to a read-only device point that can never actually be physically changed by an end user (e.g. current room humidity, which is merely a reading of a current condition, not a settable value) but for this setting to be incorrectly set to "Read+Write". If this situation occurs, attempts to change the value will simply fail.
But it is also possible for the tile to be connected to a writable device point, while setting this setting to "Read-Only". This can be valuable in situations where you simply do not want an end user to have control over that point, but you want the end user to be able to monitor the current and historical values.
| Steps | Screenshots |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| If it is a "Read-Only" Tile, click the following option |  |
|
If it is a "Read+Write" tile, you will select from the following additional configuration options in the lime green box:
BACnet Priority Level
Increment +/-
Minimum Writable Value
Maximum Writable Value
|  |
### **Step 3:** Assign the tile a color combination
These color combinations for individual Motion Tiles will be displayed on the user's Mosaic dashboard. Customize the color to your liking.
| Steps | Screenshots |
| --------------------------------------- | -------------------------------- |
| Select the color combination you prefer |  |
### **Step 4:** Input data output settings
This feature will display the data in the unit specified. You can also customize the amount of decimal places. In this configuration section, you will configure the following items:
1. Data Units
2. Decimal Places
| Steps | Screenshots |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| The point on the BACnet device will be given the default data display. This, however, can be customized for display purposes. Insert the data unit that will be displayed on the Motion Tile *(Figure 6)* |  |
| Insert the amount of decimal places that you want displayed on the Motion Tile *(Figure 8)* |  |
### **Step 5:** Input data transformation settings
This configuration setting becomes necessary when a manufacturer device only displays points in a specific unit. If the unit needs to be converted, you will utilize this setting.
In this configuration section, you will configure the following items *(Figure 9)*:
1. Conversion Formula
2. Multiplier
3. Calibration Offset
| Steps | Screenshots |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
|
Conversion Formula: Input the type of data conversion that is needed (if applicable).
C to F
F to C
kPa to psi
psi to kPa
I/s to CFM
CFM to I/s
|  |
| In this section, you can choose from the following conversion formulas |  |
| In this section, you can choose from the following conversion formulas |  |
### **Step 6:** Enable/Disable Tile Alarm Conditions
#### Alarm Conditions
Alarms are a highly desired software feature provided by Motion. For every Motion Tile, you will be able to configure up to four alarm conditions*.*
| Steps | Screenshots |
| --------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
|
Choose up to four alarm conditions:
High Critical
High Warning
Low Warning
Low Critical
|  |
| To enable an alarm, click the purple toggle button ON/OFF for each condition as needed *(red boxes)* |  |
#### Auto-Clear Alarms
This feature was engineered for alarm management purposes.
1. **Never:** Alarm will not clear until user manually "clears" it. Alarm timestamp will be logged in Alarms view.
2. **Only When Acknowledged:** Alarm will not clear until the user "acknowledges" or "clears" the alarm. Alarm timestamp will be logged in Alarms view.
3. **Always:** Alarm will automatically clear when the tile is not longer in an alarm state. Alarm timestamp will still be logged in Alarms view. View the example provided here:
* *EXAMPLE: A user configures a tile with a high warning alarm state when the room temperature reaches/exceeds 75 degrees. Therefore, the threshold is configured for at-or-above 75 degrees. When the room temperature reaches 75 degrees, the Motion Tile will enter an alarm state and the user will be notified. In this example, assume the user selected "Always" in the Auto-clear Alarms menu. The room temperature in this area of the building reached 75 degrees, but then dropped below 75 degrees. The Motion Tile will automatically clear the alarm without the user needing to manually clear it.*
| Steps | Screenshots |
| --------------------------------------------------------------------------------------------------------------- | -------------------------------- |
|
Click from the dropdown menu and choose one of the three options discussed above (red box):
|  |
### **Step 7:** Configure Alarm Condition Settings
When the alarm condition is enabled, you will be able to select from additional alarm condition configuration options and criteria:
1. When Value is: Enter the value and operator that will trigger the alarm condition.
2. Delay Alarm For: Enter the number of seconds the value must remain continuously outside the configured threshold before the alarm is triggered. If the value returns within the acceptable range before the delay period ends, the alarm will not trigger.
3. Play Sound: Enable a sound notification that will play when the alarm condition is triggered.
4. Show Message: Enter a custom message or instructions that will appear when the alarm condition is triggered.
5. Show Icon: Select the icon that will appear when the alarm condition is triggered.
| Steps | Screenshots |
| ---------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| Input the above alarm condition settings |  |
{% hint style="info" %}
The alarm delay is entered in seconds. The tile value must remain continuously outside the configured threshold for the entire delay period before the alarm is triggered.
{% endhint %}
### **Step 8:** Choose a Tile Icon for your Motion Tile
For each tile, you can customize the Tile Icon for display purposes.
| Steps | Screenshots |
| ------------------------------------------------- | -------------------------------- |
| Select the icon that you wish the tile to display |  |
### **Step 9:** Link Motion Tile to one or more Motion Apps
*Preliminary Assumption: you have created a Motion App(s) that can be linked to the Motion Tile.*
For each Motion Tile you create, you will link it to one or more Motion Apps for which you want the Motion Tile to appear in.
| Steps | Screenshots |
| ----------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
|
Click the "Manage Apps" apps button which will take you to a list of all active Motion Apps (Mosaics) on your dashboard
|  |
| Search for and select one (or more) Motion Apps for which you want to link the Motion Tile to |  |
{% hint style="info" %}
Need to create a copy of an existing tile? See [Cloning Motion Tiles](/motion-platform-software/tiles/cloning-motion-tiles) for instructions on cloning Numeric, Toggle, and Multi-Choice Tiles.
{% endhint %}
# Object Tagging with Tags and Facets
Organize Motion Tiles and Folder Tiles with tags, facets, and profiles so tiles can be grouped, searched, and structured without overloading tile names.
## Object Tagging with Tags and Facets
Create a cleaner structure for Motion Tiles and Folder Tiles by using tags and facets instead of putting every detail into the tile name.
### Object Tagging
Object Tagging allows Administrators and Managers/System Owners to organize Motion Tiles and Folder Tiles using tags and facets.
This is useful when working with large numbers of tiles across customers, buildings, locations, equipment types, rows, or other shared groupings.
Instead of relying on long tile names that include every possible attribute, tags and facets give Motion a more structured way to organize, search, and maintain tile information.
### When to use tags and facets
Use tags and facets when you need to:
1. Group related Motion Tiles or Folder Tiles
2. Organize tiles by location, equipment, room type, row, customer, or other shared context
3. Search and filter tiles using structured information
4. Avoid long tile names that contain too many attributes
5. Improve data consistency across a large deployment
### Permissions
Tags and facets can be created or updated by:
1. Administrators
2. Managers/System Owners
Viewers can see tags and facets, but cannot create or update them.
If you do not see the tagging options described below, contact your Motion account administrator.
### Tags vs. facets
Tags and facets are related, but they are not the same.
#### Tags
Tags are flexible labels that can be added to a Motion Tile or Folder Tile.
Use tags for general grouping or association. For example, a tile may have tags such as Critical, Legacy, Humidity, or IAQ.
Tags are useful when the association does not need to follow a strict structure.
#### Facets
Facets are structured fields that become available after a Profile is selected.
Use facets for common attributes that should be tracked consistently across similar tiles. For example, data center tiles may need structured values for City, Building, Location, Equipment, Row or Room Type.
Facets help keep important tile context organized without forcing all of that context into the tile name.
#### Profiles
A Profile determines which facets are available for a tile.
A Profile must be selected before facet fields will appear.
The currently available profile is Data Center. The Data Center profile currently includes these facets:
1. City
2. Building
3. Location
4. Equipment
5. Row
6. Room Type
Available profiles and facets may change as Motion adds support for additional use cases.
### How tags and facets appear in Motion
Tags and facets can be used to organize and search Motion Tiles and Folder Tiles.
Facets appear on the actual tile in the app.
Tags do not appear on the actual tile in the app.
This means facets should be used for structured information that needs to be visible on the tile itself, while tags should be used for flexible grouping and search/filtering.
### Step 1: Open the tile configuration
Steps
1. Navigate to Controls
2. Click Tiles
3. Find the Motion Tile or Folder Tile you want to configure
4. Open the tile configuration
### Step 2: Select a Profile
In the tile configuration, find the Tags section.
Steps
1. Open the Profile dropdown
2. Select the appropriate Profile
3. After a Profile is selected, the available facet fields will appear
A Profile must be selected before facets can be configured.
### Step 3: Add facet values
After selecting a Profile, complete the facet fields that apply to the tile.
For the Data Center profile, available facets currently include City, Building, Location, Equipment, Row, and Room Type.
Steps
1. Click into a facet field
2. Select an existing value, or type a new value
3. If the value does not already exist, create the new value
4. Repeat for any other facets that apply
Facet values are organized by facet. For example, a Building value is separate from a Row value, even if the same text appears in both places.
### Step 4: Add tags
Tags can be added in the Tags field.
Steps
1. Click into the Tags field
2. Select an existing tag, or type a new tag
3. If the tag does not already exist, create the new tag
4. Add any other tags that apply
Use tags for flexible grouping. Use facets for structured fields that should be consistent across similar tiles.
### Step 5: Save the tile configuration
After adding the Profile, facets, and tags, save the tile configuration.
Steps
1. Review the selected Profile
2. Review facet values
3. Review tags
4. Save the tile configuration
### Adding tags and facets to Folder Tiles
Tags and facets can also be added to Folder Tiles.
The workflow is the same as configuring a standard Motion Tile.
Steps
1. Navigate to Controls
2. Click Tiles
3. Open the Folder Tile configuration
4. Select a Profile
5. Add facet values
6. Add tags
7. Save the Folder Tile configuration
### Searching and filtering with tags and facets
Tags and facets can be used to search and filter tiles.
Use the specific tag or facet filter fields to find tiles that match a tag or facet value.
Keyword search currently searches tile names. To search by tag or facet, use the tag or facet filter field directly.
Steps
1. Navigate to Controls
2. Click Tiles
3. Open the search or filter menu
4. Select the tag or facet field you want to search
5. Select or enter the value
6. Review the filtered tile list
### Naming best practices
Tile Name and Display Name still exist and should still be used.
The difference is that names should not be overloaded with every attribute about the tile.
Use Tile Name as the internal tile identifier.
Use Display Name as the user-facing label that makes the tile easy to recognize.
Use facets for structured information such as City, Building, Location, Equipment, Row, and Room Type.
Use tags for flexible grouping, labels, or associations.
For example, instead of creating a very long display name that includes building, location, equipment, row, and measurement type, use a shorter Display Name and add the structured details as facets.
### Best practices
1. Select a Profile before trying to add facets.
2. Use facets for structured values that should stay consistent across similar tiles.
3. Use tags for flexible grouping or labels.
4. Keep Display Names readable and concise.
5. Avoid putting every location, equipment, customer, or row detail into the tile name.
6. Reuse existing tags and facet values when possible.
7. Create new tags and facet values only when a new value is actually needed.
### Troubleshooting
#### I do not see facet fields
Select a Profile first. Facet fields only appear after a Profile is selected.
#### I do not see the Profile, Tags, or Facets fields
You may not have permission to create or update tags and facets. Contact your Motion account administrator.
#### I searched for a tag or facet value and did not find the tile
Keyword search currently searches tile names. Use the specific tag or facet filter field to search by tag or facet value.
#### A tag does not appear on the tile
Tags do not appear on the actual tile in the app. Facets appear on the tile.
#### A facet value does not appear on the tile
Confirm that a Profile is selected, the facet value has been added, and the tile configuration has been saved.
#### I need to create a new tag or facet value
Type the new value into the tag or facet field and create it if it does not already exist.
# Cloning Motion Tiles
Copy existing Numeric, Toggle, and Multi-Choice Tiles to a selected destination device while reviewing and updating the cloned tile names.
## Cloning Motion Tiles
Create copies of existing Motion Tiles without rebuilding each tile configuration manually.
### Cloning Motion Tiles
Clone Tiles allows you to copy one or more existing tiles to a selected destination device.
Cloning is useful when similar devices require the same tile configuration or when an existing tile provides a starting point for a new tile.
Clone Tiles is available through the bulk-select workflow in the Tiles view.
### Supported tile types
Clone Tiles currently supports these standard tile types:
1. Numeric
2. Toggle
3. Multi-Choice
Formula Tiles and Canvas Tiles cannot currently be cloned.
### Step 1: Select tiles
Steps
1. Navigate to Controls
2. Click Tiles
3. Open the action menu for a tile
4. Select Bulk Select
5. Select each tile you want to clone
After at least one supported tile is selected, the bulk-action bar appears at the bottom of the Tiles view.
### Step 2: Open Clone Tiles
Steps
1. Review the selected tiles
2. Click Clone Tiles in the bulk-action bar
The Clone Tiles workflow opens.
### Step 3: Choose the destination device
The Devices section shows the source device associated with the selected tile or tiles.
Steps
1. Review the source device
2. Under Destination, click Choose Device
3. Select the device that should receive the cloned tiles
When multiple tiles are selected, the same destination device is used for all clones.
### Step 4: Review the cloned tile names
Each selected tile appears in the Tile Names section.
The Original field shows the current tile name. The Clone field shows the name that will be used for the new tile.
Steps
1. Review each proposed clone name
2. Update individual names as needed
3. To update multiple names at once, enter values in Find text and Replace with
4. Click Apply to Clones
Find and replace applies the naming change across all selected clones.
### Step 5: Complete or cancel the clone
Steps
1. Review the destination device
2. Review the cloned tile names
3. Click Clone Tile or Clone Tiles to create the copies
To leave the workflow without creating the clones, click Cancel.
The clone button reflects the number of tiles that will be created.
### What is copied
The cloned tile receives the configuration from the original tile, including its tile settings, data display configuration, alarms, tags, and facets.
Linked Apps are not copied. After cloning, link each new tile to the appropriate App manually.
Each clone is created as a new Motion Tile with a new Tile ID.
Historical values and alarm history from the original tile are not copied.
### Notes and limitations
1. Clone Tiles is available only through Bulk Select.
2. A single destination device is used for all tiles selected in one cloning workflow.
3. Linked Apps must be configured manually after cloning.
4. Formula Tiles cannot currently be cloned.
5. Canvas Tiles cannot currently be cloned.
# Tile History
View, filter, graph, and export historical values for Motion Tiles using Show History.
## Show History
The **Show History** feature lets you view historical values for a Motion Tile. Use Show History to review how a tile’s value changed over time, compare up to five tiles in a single graph, adjust the reporting interval, select a specific date and time range, and export historical tile data.
### Opening Show History
You can open Show History from a tile on a Mosaic Dashboard.
#### Steps
1. Navigate to the Mosaic Dashboard that contains the tile you want to review.
2. Select the tile icon to open the tile options menu.
3. Select **Show History**.
***
### Viewing historical tile values
After selecting **Show History**, Motion displays a graph of historical values for the selected tile.
From this view, you can:
1. View the tile’s historical values on a graph.
2. Compare up to five tiles in a single graph.
3. Move to an older or newer time period.
4. Select a specific date and time range.
5. Choose how values are displayed.
6. Adjust the value interval.
7. Export historical values as a CSV.
***
### Selecting a date and time range
Use the date range selector to choose the time period shown in the graph. You can select both the date and time for the beginning and end of the reporting window.
This is useful when you need to review a specific time period, such as overnight sensor values.
#### Example
To view Particulate Matter (PM2.5) readings from *3:00 AM on July 1* through *6:00 PM on July 2*, select:
1. Start date/time: **July 1, 3:00 AM**
2. End date/time: **July 2, 6:00 PM**
The graph updates based on the selected date and time range.
***
### Moving to older or newer values
Use **Older** and **Newer** to move backward or forward through historical values.
#### Steps
1. Select **Older** to view an earlier time period.
2. Select **Newer** to move forward again.
The graph updates based on the selected direction and current date range.
***
### Comparing multiple tiles in one graph
Show History can display historical values for multiple tiles in a single graph. This is useful when you want to compare related tile values over the same time period, such as temperature, humidity, set point, IAQ, flow, or other sensor readings.
You can stack or overlay up to **five tiles** in one graph.
#### Steps
1. Open **Show History** from the first tile you want to review.
2. Select additional tiles from the dashboard to add them to the graph.
3. Repeat until the tiles you want to compare are shown.
4. Use the graph legend to identify each tile’s values.
5. Adjust the date/time range or interval as needed.
#### Layout options
| Option | Description |
| -------------------------------- | ---------------------------------------------------- |
| **Show One Tile at a Time** | Displays one tile’s historical values at a time. |
| **Stack Multiple Tiles’ Values** | Displays multiple tile values together in one graph. |
Use **Stack Multiple Tiles’ Values** when you want to compare several related tile readings across the same time period.
#### Notes
* Up to five tiles can be shown in the same graph.
* Each tile appears as a separate line in the graph.
* The graph legend identifies which line belongs to each tile.
* Date/time range and interval settings apply to the graph view.
***
### Changing the value interval
The interval controls how many historical values are shown in the graph.
#### Interval options
| Option | Description |
| --------------------------------------- | --------------------------------------------------------- |
| **Every Recorded Value** | Shows every value recorded for the selected time range. |
| **First Value Stored Every 5 Minutes** | Shows the first stored value for each 5-minute interval. |
| **First Value Stored Every 15 Minutes** | Shows the first stored value for each 15-minute interval. |
| **First Value Stored Every ½ Hour** | Shows the first stored value for each half-hour interval. |
| **First Value Stored Every Hour** | Shows the first stored value for each hourly interval. |
| **First Value Stored Every 4 Hours** | Shows the first stored value for each 4-hour interval. |
#### Steps
1. Select the interval option.
2. Choose the interval you want to use.
3. Review the updated graph.
Use a shorter interval when you need more detail. Use a longer interval when you want a simpler view over a larger time range.
***
### Exporting historical values
Select **CSV** to export historical tile values.
There are two export options:
| Export option | Description |
| ------------------------------ | ----------------------------------------------------------- |
| **Currently shown values** | Exports the values currently displayed in the graph. |
| **All values in a date range** | Downloads all values available for the selected date range. |
Use **currently shown values** when you only need the data visible in the graph. Use **all values in a date range** when you need the full dataset for a selected reporting window.
***
### Notes
* The values shown in Show History depend on the selected date/time range and interval.
* If multiple tiles are being reviewed, the selected layout determines how the values are displayed.
* Exported CSV files can be used for offline review, reporting, or sharing with other teams.
# Devices
# What are "Devices"?
Because Motion is designed to be compatible with multiple protocols (the list of supported protocols will continue to grow with time), we needed a generic term to represent, generally, all of the controllers, controls, sensors, data gatherers, thermostats, lights, HVAC units, widgets, etc. that we might be controlling and/or monitoring. To represent the entire spectrum of possible *things* with which a Motion Hub might communicate, we use the word **device** to represent any single one of those *things*.
To be specific, **devices** are the physical items that have readable and/or writable data/control points. For example, a BACnet thermostat can be a device because it has points that we can use BACnet to manage and monitor a temperature zone, like set point, current temperature, fan status, etc. But more complicated items like entire BASes (building automation systems using BACnet—think Tridium, Siemens, Trane, etc.\*) may be considered **devices** in Motion Platform as well since they, too, can have sets of readable and writable points (even if those points are representative of points belonging to *other* equipment).
Here are some examples of items in a building that become **devices** in Motion Platform:
* Thermostats
* Boiler controllers
* Refrigeration controllers
* Relay-controlled lighting
* Rooftop HVAC units
* Variable air volume components (VAVs)
* Existing building automation systems (BASes) with BACnet modules enabled
*\* Motion is not affiliated with any of the brands mentioned on this page. Those brands simply represent some of the brand-name systems with Motion is frequently integrated.*
# Supported Protocols
Any Motion Hub can communicate with devices that support any of these protocols:
* BACnet/IP
* BACnet MSTP via a BACnet router
* Modbus TCP
NOTE: More protocols are in the works. When new protocols are ready for production, all Motion Hubs will be updated automatically to support them.
# Viewing Your Devices
## Summary of the "Devices" View
In the "Devices" view, you will be able to look at all devices (active or inactive) that were discovered and added to the platform. Here is where you will perform a point discovery for BACnet devices. There are several components in this view that will provide details of that device, and allow you to execute a point discovery.
1. Search Bar (top right-hand part of view)
2. Name
3. ID
4. Network Address
5. Protocol Address
6. Protocol
7. Motion Hub
### **Step 1:** Navigate to "Devices" view
In order to view all of your devices, click the "Controls" option on the left-hand side vertical menu.
| Steps | Screenshots |
| ------------------------------------------------------------------------------------------- | -------------------------------- |
| When in the "Controls" view, click the "Devices" option on the left-hand side vertical menu |  |
### **Step 2:** View the Data Displayed on the devices dashboard
| Device View Columns | Screenshots |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
|
Name
The customized name of the added device is found in this column and can be sorted in alphabetical order.
|  |
|
ID
Every Device that is added is given an ID #
|  |
|
Network Address
Depending on the protocol, this may be simply a local IP address or it could be a more complex value.
You can identify the Network Address in this column (Figure 4)
|  |
|
Protocol Address
tbd (Figure 5)
|  |
|
Protocol
This indicates the type of network protocol the device data communicates on
|  |
|
Motion Hub
Every device and its points are linked to an active Motion Hub.
This column identifies the Motion Hub that the device sits on
|  |
# Add a BACnet Device
## Prerequisites
To successfully add your BACnet devices into Motion, make sure:
* You've already activated a Motion Hub with which you want to associate your BACnet device
* The Motion Hub and the BACnet device are connected to the same local area network and the network is not blocking communication between the Motion Hub and the BACnet device
## Two Methods to Add a BACnet Device
There are two methods to add a BACnet device to Motion:
1. BACnet device discovery
2. Manual device entry
Both methods are described next. To access these methods, you must first navigate to "Add Devices" (described next).
### **Step 1**: Navigate to the "Add Devices" view
| Steps | Screenshots |
| ------------------------------------------------------------------------------------- | -------------------------------- |
| From anywhere in the Motion Platform, click "Controls" on the left side vertical menu |  |
| Under the Controls menu, click "Devices" on the left side vertical menu |  |
| Click on "Add Devices" |  |
### **Step 2**: Choose a method for adding your BACnet device
You can add BACnet devices by clicking one of the two options. View below:
| BACnet Options | Screenshots |
| ---------------------------------------------------------------------------------------------------- | -------------------------------- |
|
Discover Devices (Lime Green Box)
Manual Entry (Red Box)
|  |
### **Step 3a**: Discover Devices
In this view, you will search and select the desired Motion Hub to discover devices. You will then select the time needed to discover that device. The "Device Discovery" view is broken down into three sections:
1. Motion Hub
2. Timeout
3. Start Discovery / Abort
#### Motion Hub
| Steps | Screenshots |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
|
Search and/or select a Motion Hub connected to the same network as the BACnet/IP devices you want to find via device discovery
Click the drop menu in the Motion Hub section
|  |
| Search for and/or click the desired Motion Hub that appears in the pop-up menu |  |
#### Timeout
The timeout setting defines the amount of time before the Motion Hub will stop waiting for a response from BACnet/IP devices when attempting the device discovery. Some devices require more time than others to respond, due to factors such as device age and link speed.
| Steps | Screenshots |
| ---------------------------------------------------------------- | -------------------------------- |
| Click the appropriate timeout setting to accommodate those cases |  |
#### Start Discovery
When the above settings have been selected, you are ready to discover devices on the active Motion Hub.
| Steps | Screenshots |
| ----------------------- | -------------------------------- |
| Click "Start Discovery" |  |
### **Step 3b**: Add Device Manually
In this view, users can add a device manually in the event that the Motion Hub is not identifying the device. This view is broken down into seven sections which you will input device details into:
1. Motion Hub
2. Name
3. Local IP Address
4. Protocol
5. BACnet Instance ID
6. BACnet MS/TP Network Number (optional)
7. BACnet MS/TP MAC Address (optional)
| Manual Entry Inputs | Screenshots |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
|
Motion Hub
Search and/or select a Motion Hub connected to the same network as the BACnet/IP devices you want to find via device discovery
Click the "Motion Hub" Menu to select the desired Motion Hub
|  |
|
Name
Give your new device a name that will make it easily identifiable throughout Motion platform.
Type the Name in the appropriate section
|  |
|
Local IP Address
Input the correct local IP Address inside of this section
|  |
|
Protocol
For BACnet/IP, this will always be a default option.
No action is required in this section
|  |
|
BACnet Instance ID
Type in the BACnet Instance ID below
|  |
|
BACnet MS/TP Network Number (if applicable)
This is only required for MS/TP devices bridged to an IP network with a BACnet router. If provided, a MAC address is required.
If applicable, type the MAC address the in section below
|  |
|
BACnet MS/TP MAC Address (if applicable)
This is only required for MS/TP devices bridged to an IP network with a BACnet router. If provided, a network number is required.
If applicable, type the network number in the section below
|  |
|
Save/Revert
Make sure to double check all information that been manually entered is correct.
Then click "Save"
|  |
# Add a Modbus Device
## Prerequisites
To successfully add your Modbus TCP devices into Motion, make sure:
* You've already activated a Motion Hub with which you want to associate your BACnet device
* The Motion Hub and the BACnet device are connected to the same local area network and the network is not blocking communication between the Motion Hub and the BACnet device
## Adding a Modbus TCP Device
Every Modbus TCP Device will need to be manually entered. Every Modbus TCP device requires an IP Address and a Slave ID, and in the steps below we will instruct users on how to do this.
### **Step 1**: Navigate to "Add Devices" view
| Steps | Screenshots |
| ------------------------------------------------------------------------------------------ | -------------------------------- |
| From anywhere in the Motion Platform, click "Controls" on the left-hand side vertical menu |  |
| Under the Controls menu, click "Devices" |  |
| Click "Add Devices" tab |  |
### **Step 2**: Navigate to "Add Device Manually" view
| Steps | Screenshots |
| --------------------------------------------------------------------------- | -------------------------------- |
| Click on the "Manual Entry" option, located inside of the Modbus TCP window |  |
### **Step 3**: Input Modbus TCP device details
You are now in the "Add Device Manually" view for a Modbus TCP device. You will now input the following information in the following sections:
1. Motion Hub
2. Name
3. Local IP Address
4. Protocol
5. Modbus Slave ID
6. Save/Revert
| Inputs | Screenshots |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
|
Motion Hub
Select the Motion Hub associated with the device to be added.
Click on the Motion Hub section to view the pop-up menu of connected Motion hubs
Search for or click on the preferred Motion Hub that will read this device
|  |
|
Name
Give your new device a name that will make it easily identifiable on the platform
Input the desired name in the section below
|  |
|
Local IP Address
Locate the Local IP address provided by the device manufacturer.
Input the Local IP address in the appropriate section
|  |
|
Protocol
Make sure the protocol name reads "Modbus TCP".
If not, click on this section and choose "Modbus TCP"
|  |
|
Modbus Slave ID
Locate the Modbus Slave ID which will be provided by the device manufacturer in the user manual.
Input the Modbus Slave ID in the section below
|  |
|
Save/Revert
Make sure everything is correct, and click the "Save" button
|  |
# Alarms
# Alarms View
## Alarms View Overview
The Alarms view in the Motion platform allows users to monitor and manage all current (and past) Motion Tiles that have satisfied alarm criteria from a single dashboard. Below we will discuss general details of this view, followed by articles that discuss several important components of the Alarms view.
### **Step 1**: Navigate to the "Alarms" view
From anywhere in the platform, you can locate the red "Alarm Icon" on the top of the left-hand side vertical menu.
| Steps | Screenshots |
| ------------------------------------------------------ | -------------------------------- |
| Click the red "Alarm Icon" navigate to the Alarms View |  |
#### Overview
Within the Alarms view, you will be able to easily manage all of your alarms in one place and view additional alarm details for each event.
| Views | Screenshots |
| --------------------------------------------------------------------------------------------- | -------------------------------- |
|
Alarms view contains two additional subviews:
Current
History
|  |
# Current Alarms
## Current Alarms
Below we will look at a complete overview of the Current Alarms view. In this view, you will see all of the Motion Tiles that have entered an alarmable state at some point in time, but have yet to be cleared by the user(s). You will see that this view has two main components:
1. Unacknowledged Alarms & Acknowledged Alarms
2. A dashboard with three columns for identifying basic Motion Tile information to locate the tile that is in its alarm state.
### Unacknowledged & Acknowledged Alarms
1. **Unacknowledged Alarms:** Alarms that have not been acknowledged nor cleared
2. **Acknowledged Alarms:** Alarms that have been acknowledged but ***not cleared***
| Details | Screenshots |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
|
In this screenshot, you will see a running total of current (active) alarms that have been:
Unacknowledged Alarms
Acknowledged Alarms
|  |
### Dashboard Columns
Below you are able to organize the following columns in order by clicking the up/down arrows next to the following column names:
| Columns | Screenshots |
| ---------------------------------------------------------------------------------------------------------- | -------------------------------- |
|
Subject: Lists the name of and tile ID # of the Motion Tile
|  |
| **Status:** Lists whether the alarm for the respective Motion Tile has been acknowledged or unacknowledged |  |
| **Start Time:** Displays the date/time of when the alarm condition was satisfied (triggered) |  |
### Navigating to "Alarm Details" View
The Alarm Details view will give you more details about the individual alarm tied to a Motion Tile. There are three methods to access the Alarm Details view for any individual Motion Tile:
1. Kebab Icon
2. "View Details" button
3. Mosaic Dashboard *(this will be discussed in another article)*
| Methods | Screenshots |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------- |
|
Kebab Icon
The blue "Kebab Icon" gives you multiple actions to take on your current alarm, depending on the alarm state that the Motion Tile is in.
Click "View Details" from the menu.
|  |
|
Click "View Details" Button
As another option, you can simply click the "View Details" button located directly on the dashboard for its respective Motion tile
|  |
# Alarm History
## Alarm History
Below we will look at the Alarm History view in the Motion Cloud Platform. In this view, users can view all Motion Tiles that have entered an alarm state, regardless of whether or not the alarm was cleared. It is meant to be used as a reference database that users can access at any time.
### Dashboard Columns
There are three columns in the "Alarm History" view that make up the dashboard.
1. Subject
2. Status
3. Last Status Change
| Columns | Screenshots |
| ------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| **Subject:** Lists the name of and tile ID # of the Motion Tile |  |
| **Status:** Lists whether the alarm for the respective tile has been acknowledged, unacknowledged, or cleared |  |
| **Last Status Change:** Displays the date/time of when the last action of the alarm took place |  |
# Alarm Details
## Alarm Details
As described in the previous articles, the Current Alarms view and Alarms History view will allow you to navigate to an Alarm Details view. This view gives more exact details about a Motion Tile that satisfied alarm criteria at any given time. This view is broken down into five windows:
1. Current State
2. Times
3. People
4. Live Data Stream
5. Logged Time Recording
### Current State
This shows the current state of the Motion Tile. It is very important to note that the current state of the Motion Tile may not reflect the previous alarm state that the tile was in. However, because the alarm has yet to be cleared, this til is still logged in the Current Alarms view. Please view an example here to better understand a scenario that reflects this:
{% hint style="info" %}
*EXAMPLE: In this scenario, a user enabled a "High Critical" alarm condition for room temperature that exceeds 80 degrees Fahrenheit. Let's assume that the room temperature at some point in time exceeded the 80 degree threshold (triggering the alarm) and the user has not cleared the alarm. Let's assume the room temperature dropped back down below this threshold to 75 degrees. At 75 degrees, the current state of the Motion Tile is not in an alarm state. However, because the alarm was triggered AND was never cleared, it will remain logged in the "Current Alarms" view until cleared by the user.*
{% endhint %}
| Details | Screenshots |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
|
In the screenshot to the right, we are looking at the current state of a Motion Tile that monitors relative humidity from a thermostat device (red box)
This tile is currently in a warning alarm state as reflected by the "GOLD" color of the tile
This Motion Tile has been "acknowledged" (lime green box) but it has not been "cleared".
Therefore, it still appears in our "Current Alarms" view
|  |
### Times
In this window, Motion logs the exact date/time of ***when***:
1. the alarm criteria was satisfied (when alarm was triggered)
2. the user acknowledged this alarm (if applicable)
3. the user cleared this alarm (if applicable)
| Details | Screenshots |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
|
In the screenshot to the right, the alarm started on 08/30/22 at 11:55AM.
The user acknowledged the alarm on 08/30/22 at 7:00pm.
The user has yet to clear the alarm, as indicated by the "N/A" message.
|  |
1. **Started:** The exact date/time that the alarm was triggered
2. **Acknowledged:** The exact date/time that the alarm was acknowledged
3. **Cleared:** The time date/time alarm was cleared *(Figure 10 demonstrates that the user has NOT cleared the alarm, thus why the alarm remains in the Current Alarms view)*
### People
This window gives you details of ***who*** took action on the alarm and when.
| Details | Screenshots |
| ---------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| In the screenshot to the right, "Motion\_Admin" acknowledged the alarm, and this user has yet to clear the alarm |  |
1. **Acknowledged By:** A recorded log of which account user acknowledged the alarm (if any)
2. **Cleared By:** A recorded log of which account user cleared the alarm (if any)
### Live Data Stream
The live data stream window you the most recent values logged for this alarm data.
| Details | Screenshots |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| Users will be able to see in real-time how the most recent point data is trending |  |
| Users can also click the "Show History" button on the top right-hand corner of the Live Data Stream section to view a historical data chart in different time intervals |  |
### Time Log
In the "Time Log" window, you will find a date/time log of all recorded alarm violations in list form
1. **Time Recorded:** Date/time of the alarm being triggered
2. **Alarmable Value:** The data output that satisfied the alarm condition
3. **Value UUID:** A unique ID is generated for every recorded value that satisfies an alarm condition.
# Clearing/Acknowledging Alarms
## Methods for Managing Alarms
There are several views in which you can clear/acknowledge an alarm:
1. Mosaic Dashboard view
2. Current Alarms view
3. Alarm Details view
4. Auto-clear Alarms (discussed [here](/motion-platform-software/alarms/auto-clear-alarms) in other article)
## Managing Alarms in Mosaic Dashboard view
Below, we will instruct users on how to manage alarms in the Mosaic Dashboard view.
### **Step 1:** Navigate to Motion App to access Mosaic Dashboard
In the example scenario described below, we are going to be managing alarms for multiple Motion Tiles that have satisfied alarm conditions and are in an alarm state.
| Steps | Screenshots |
| -------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| Scroll through the Apps view to identify appropriate Motion App, or search for the Mosaic App in the search bar on the top right-hand corner |  |
### **Step 2:** Identify Motion Tiles that are in an alarm state
In the Mosaic Dashboard view, any Motion Tile that has satisfied alarm criteria - but has not been cleared - can be easily identified. It is important to note that, **regardless of the current alarm state of the Motion Tile,** the alarm details will be logged at the time the alarm was triggered. Unless the alarm is **cleared** by a user, you will see the following buttons at the top right hand corner of the individual Motion Tile*:*
| Details | Screenshots |
| --------------------------------------------------------------------------------------------------------- | -------------------------------- |
|
Unacknowledged (lime green box)
Acknowledged (light blue box)
|  |
#### Acknowledged
An acknowledged alarm will always contain a **GOLD** "acknowledged" button at the top right-hand corner of that Motion Tile. This indicates that the user has manually acknowledged that the alarm satisfied alarm criteria. The user, however, has yet to clear the alarm. Therefore, the **GOLD** "Acknowledged" button will still appear on this Motion Tile until the alarm is cleared.
| Steps | Screenshots |
| ------------------------------------------------------------------------------------------------------------------ | -------------------------------- |
| To clear this alarm, click the GOLD "acknowledged" button to open a pop up menu |  |
| Click the "Clear Alarm" option within the pop-up menu |  |
#### Unacknowledged
An unacknowledged alarm will always contain a **RED** "unacknowledged" button at the top right-hand corner of that Motion Tile. This indicates that the user has yet to acknowledge that the alarm satisfied alarm criteria. The user also has yet to clear the alarm. Therefore, the **RED** "unacknowledged" button will still appear on this Motion Tile until the alarm is cleared.
| Steps | Screenshots |
| ----------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| To acknowledge or clear this alarm, click the RED unacknowledged button to open a pop up menu |  |
| To acknowledge the alarm, click the "Acknowledge" option within the pop-up menu |  |
| To clear the alarm, click the "Clear Alarm" option in the pop-up menu |  |
## Managing Alarms in "Current Alarms" View
### **Step 1**: Navigate to the "Current Alarms" view
From anywhere in the platform, you can locate the red "Alarm Icon" at the top of the left-hand side vertical menu.
| Steps | Screenshots |
| -------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
|
Click the red "Alarm Icon" navigate to the Alarms View
This will direct you to the "Current Alarms" view
|  |
In the "Current Alarms" view, you will have the ability to view every single Motion Tile (regardless of the alarm state) that has satisfied alarm criteria and has **NOT** yet been cleared. This page gives users an overview of all the alarms that need managed. There are several ways to clear/acknowledge an alarm:
### **Step 2**: Click the "Kebab icon" next to the Motion Tile ID
| Steps | Screenshots |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
|
Locate the blue kebab icon that appears directly left to the Motion Tile ID
When clicking the kebab icon, a pop-up window will appear.
|  |
|
For alarms that have been acknowledged, you can clear the alarm in this pop-up window
For alarms that are unacknowledged, you can clear/acknowledge that alarm in this pop-up window
|  |
## Managing Alarms in "Alarms Details" View
### **Step 1**: Navigate to the "Current Alarms" view
From anywhere in the platform, you can locate the red "Alarm Icon" at the top of the left-hand side vertical menu.
| Steps | Screenshots |
| --------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
|
Click the red Alarm Icon to navigate to the Alarms View
This will direct you to the "Current Alarms" view
|  |
### **Step 2**: Locate and click the "View Details" button
In the current alarms view, locate the blue "View Details" button for the Motion Tile that you wish to manage alarms for.
| Steps | Screenshots |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
|
Click the "View Details" button
This will direct users to the "Alarm Details" view, which gives users a breakdown of in-depth alarm details for that tile
|  |
### **Step 3**: Locate and click the "Acknowledged" or "Unacknowledged" button
At the top right-hand portion of this view, users will see a window for the current state of the alarm. In the example scenario below, we are going to manage the alarm for condenser loop supply temperature.
The current state of this Motion Tile, as indicated by the user-configured color combination of the tile (white/black), reflects that the tile is no longer in a critical or warning alarm state. If the tile is in a critical state (high or low), the color of the tile would appear RED. If the tile is in a warning state (high or low), the tile would appear GOLD.
Regardless of the current state of the tile, this alarm has yet to be acknowledged or cleared. Therefore, you will see a RED unacknowledged button at the top right-hand corner of the tile (similar to Mosaic Dashboard view).
| Steps | Screenshots |
| --------------------------------------------------------------------------- | -------------------------------- |
| Locate and click the "unacknowledged" button in the "Current State" window |  |
| Click the "clear" or "acknowledge" option in the pop-up window that appears |  |
# Auto-Clear Alarms
## Managing Alarms with "Auto-Clear Alarms" Setting
To configure auto-clear alarm settings for a specific Motion Tile, you will need to navigate to a Motion Tile and select the configuration view to apply auto-clear settings. Note, that the Motion tile does not need to be in an alarm state to apply these settings. You will have the option to apply these settings right when the Motion Tile is created.
### **Step 1:** Navigate to "Configure Tile"
There are several ways to access the "Configure Tile" view for any given Motion Tile.
1. Controls > "Tile" view
2. Mosaic Dashboard
#### Tile View
The tile view is accessible under the Controls view. This view shows a list of all Motion Tiles that have been added to the platform.
| Steps | Screenshots |
| ----------------------------------------------------------------------------------------------------------- | -------------------------------- |
|
Identify the Motion Tile you would like to configure
Click the "Configure Tile" button
|  |
#### Mosaic Dashboard
For Motion Tiles that have been linked to an app, you can access the tile configuration view directly from the tile itself.
| Steps | Screenshots |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
|
In that Mosaic, locate the Motion Tile you wish to reconfigure
At the top of the Motion Tile, locate and click the icon that appears to choose from additional options
|  |
| In this pop-up menu, locate and click "Configure" |  |
### **Step 2:** Select an option from the auto-clear alarms window
| Steps | Screenshots |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
|
In the tile configuration view, you will locate the auto-clear alarms window.
Auto-clear alarms is a feature that was built for alarm management purposes.
|  |
Click from the dropdown menu and choose one of the following options.
1. **Never:** Alarm will not clear until user manually "clears" it. Alarm timestamp will be logged in Alarms view.
2. **Only When Acknowledged:** Alarm will not clear until the user "acknowledges" or "clears" the alarm. Alarm timestamp will be logged in Alarms view.
3. **Always:** Alarm will automatically clear when the alarm condition is no longer satisfied. Alarm timestamp will still be logged in Alarms view. View the example provided here:
{% hint style="info" %}
*EXAMPLE: A high warning alarm condition for room temperature is set for at or above 75 degrees. If the room temperature reaches 75 degrees, the Motion Tile has entered an alarm state and the user will be notified. If the temperature then drops below 75 degrees, the Motion Tile will automatically clear the alarm without the user needing to manually clear it.*
{% endhint %}
# Sharing
Hubs, devices, tiles, and apps can be shared between users.
To share any of these objects with another user, you must be either the **Owner** of the object or you must have been assigned the **Admin** *role* for the object.
For most scenarios, users will want to share apps with one another because apps are built to have the precise set of tiles needed for a given use case.
## How to Share
Sharing is possible anywhere the button is found.
Here are the places you can find the button for each object type:
| Object Type | Share Button Location\[s] | What is Shared |
| ----------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| App |
In the left navbar when viewing any app
In the Apps → Manage view, accessible from the Apps view via the left navbar
| The app and all tiles within it |
| Device | In the [Controls → Devices](https://platform.motion.cloud/controls/devices) view, under each device name | The device and all tiles associated with the device |
| Hub | In the [Controls → Hubs](https://platform.motion.cloud/controls/hubs) view, under each hub name | The hub and all devices associated with the device, as well as all tiles associated with those devices |
| Tile | In the [Controls → Tiles](https://platform.motion.cloud/controls/tiles) view, under each tile name | The tile only |
After clicking any button, click **Add User** on the top right of the sharing panel. Here, you can enter either:
1. The user's Motion username
2. The user's email address that is associated with Motion
After a matching user is identified, choose the roles the user should have:
For more information on what permissions are given with different roles, see [Roles and Permissions](https://api-docs.motion.cloud/technical-notes/roles-and-permissions) in our API docs.
{% hint style="warning" %}
Assigning the **Admin** role will give the user the ability to share and un-share the object with other users.
{% endhint %}
{% hint style="info" %}
Multiple roles can be assigned to a single user simultaneously, and different roles may come with overlapping permissions.
Therefore, e.g., it is not necessary to assign any additional roles to a user if they have the **Admin** role because the **Admin** role gives that user all permissions.
{% endhint %}
# Accessing the Platform
# Web Browser
Access Motion Platform anytime from any desktop, TV, mobile, or other device web browser by navigating to [platform.motion.cloud](https://platform.motion.cloud). All modern web browsers and screen sizes are supported.
To use Motion Platform on a smartphone or tablet, check out our [iOS and Android mobile apps](/motion-platform-software/accessing-the-platform/mobile-apps-ios+android).
# Mobile Apps (iOS+Android)
The Motion app is available for both iOS and Android.
To install the Motion app from any smartphone or tablet, do either of the following:
1. Go to [**app.motion.cloud**](https://app.motion.cloud) in your device's web browser, and you will be automatically redirected to the iOS App Store or Google Play Store to then install the app.
2. Search for "**Motion Platform**" in either the iOS App Store or Google Play Store.
# Schedules
# Creating Schedules
In this section, users will learn how to configure tile schedules, which can be done for any point a tile can write to. Common schedules include:
* Lighting
* Thermostat setpoints
* Devices ON/OFF
In the example, we are going to set a **35 degree** temperature set point for a restaurant walk-in refrigerator at **8:45AM** for **Monday, Wednesday, and Friday.**
## **How to Create a Schedule**
### **Step 1:** Navigate to Motion Tile
In the steps below, you will learn to create a schedule for an individual Motion Tile. Locate the App that contains the Motion Tile you are looking to configure.
| Steps | Screenshots |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------- |
|
Scroll through the Apps view, OR search for the Mosaic in the "Search Bar" on the top right hand corner of the view
Locate and click the desired Motion App.
|  |
|
In this example, we are going to be create a temperature set point schedule for a walk-in refrigerator titled "Fridge 1 Set Point".
Locate the Motion Tile that you wish to configure, and continue to the steps below
|  |
### **Step 2:** Navigate to the "Schedules" view for this tile
Locate the **icon** image on the top of each tile. When clicking this icon image, a menu will appear.
| Steps | Screenshots |
| ------------------------------------------------------- | -------------------------------- |
| Click the icon image on the desired Motion tile. |  |
| Click the **Schedules** option in the menu that appears |  |
### **Step 3:** Click the "Add Schedules" button
After navigating to the schedules view, you will see a calendar of schedules. In this example, we have not configured any schedules for the Fridge 1 Temperature set point.
| Click "Add Schedules" | Screenshots |
| ------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| In order to add a schedule to this blank calendar, click the **Add Schedule** button on top right hand corner of the view |  |
### **Step 4:** Configure the Schedule
In the "Create Schedule" view, there are four input sections that users will click on to create an individual schedule:
1. Days of the week
2. Time of Day
3. Value
4. Save/Cancel
#### Days of Week
Locate the **Days of Week** window and follow the steps below:
| Days of Week | Screenshot |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
|
Click the "Day" toggle buttons ON/OFF to enable schedules for the days listed above
In this example, we are configuring a schedule for Monday, Wednesday, and Friday
|  |
#### Time of Day
Locate the **Time of Day** window and follow the steps below:
| Time of Day | Screenshot |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
Configure the hour, minute, and AM/PM by clicking on the appropriate input inside the built-in clock
A pop-up menu will appear, select the appropriate time setting.
In this example, we are going to configure the schedule for 8:45AM on the three days selected above.
|  |
#### Value
Locate the **Value** window and follow the steps below:
| Input Desired Value | Screenshots |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
|
Type the input value inside of the box, or use the up/down arrows to increase/decrease the value in one unit intervals
In this example, we are going to input the value of 35 degrees for the days and time selected above.
|  |
#### Save/Cancel
Locate the **Save/Cancel** buttons and follow the steps below:
| Save/Cancel | Screenshots |
| ---------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
| Locate and click **Save** or **Cancel** the schedule settings that you have configured at the bottom left-hand portion of the view |  |
# Enable/Disable/Configure Schedules
Motion has a useful feature built into the scheduling interface that will allow you to disable the schedule *but* save the configuration settings for a time when they should be reenabled.
### **Step 1:** Locate and click the Schedule on the calendar that you wish to enable/disable
As you will see, we created a schedule on the calendar for M,W,F, at 8:45am.
| Steps | Screenshots |
| ---------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
|
Click any one of these Time buttons within the calendar itself
This will direct you to the "Edit Schedule" view
|  |
### **Step 2:** Locate and click the toggle pill button
At any point in time, you can disable the schedule by clicking the toggle pill at the top right hand corner
| Steps | Screenshots |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
|
At any point in time, you can disable the schedule by clicking the toggle pill at the top right hand corner
After disabling the schedule, you can reenable it at any point in time by clicking the same toggle pill again
|  |
### **Step 3:** Click "Save" button
At the bottom left side of the screen, you can save or cancel the edit options.
# Deleting a Schedule
## Deleting a Schedule
### **Step 1:** Locate and click the Schedule on the calendar that you wish to delete
As you will see in Figure 14, we created a schedule on the calendar for M,W,F, at 8:45am.
| Steps | Screenshots |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------- |
|
Click any one of these Time buttons in the calendar, they are all part of the same schedule you created
This will direct you to the "Edit Schedule" view
|  |
### **Step 2:** Click the "Delete" button
| Steps | Screenshots |
| --------------------------------------------------------------- | -------------------------------- |
| This will completely remove the schedule from you calendar view |  |
# Password Management
To change your password, click on "Security" in the left navigation pane in the Motion Platform web app or mobile app.
When a password is changed:
* All currently logged in browsers/devices (except the one you are using to change the password) will be logged out
* Push notifications will stop being sent to mobile devices until they have logged in again
* If Two-Factor Authentication (2FA) is enabled, the 2FA code must be re-entered when logging in again
# Two-Factor Authentication (2FA)
2FA provides better security than a password alone by requiring that any person attempting to log in to your account has access to a secret 2FA code managed by any TOTP-based 2FA app, such as Google Authenticator or Authy. The secret code changes every 30 seconds, and only your 2FA app and Motion will know the correct code every time it changes.
Keep in mind:
* Once you enable 2FA, you will need your 2FA app handy to access the secret 2FA code any time you log in to Motion
* If you lose access to your 2FA app (e.g. if your smartphone with the 2FA app is lost or stolen), you will not be able to log in without contacting Motion support
* 2FA is not a replacement for a password; you will still enter your password every time you log in, just before being prompted for the 2FA code
* Ensure you have updated any iOS or Android app installations to latest versions
To enable or disable 2FA, click on "Security" in the left navigation pane in the Motion Platform web app or mobile app.