Search
K

Adding Drivers & Modules

Steps and Advice on using Drivers and Modules with PlaceOS.
PlaceOS uses drivers to communicate with third party systems and integrations.
A driver should be considered the parent and only needs to be loaded once.
A driver should not have any specific configuration attached, this will be done once the driver is instantiated as a module in a system.
For More Information you can read the key concepts of Drivers and Modules.

How to add a Driver

1. Navigate to PlaceOS Backoffice
2. Click on Drivers
Step 2 screenshot
3. Click Add New Driver
Step 3 screenshot
4. Select the Repository you want to add the driver from
In most cases this will be preconfigured as the PlaceOS Drivers Repo.
Step 4 screenshot
5. Search for and select the required driver
Step 5 screenshot
6. Select a driver commit
It is recommended to select the most recent commit
7. Click on Save…
Step 7 screenshot

How to add a New Module

A module is an instantiation of a driver for use with a specific system, or collection of systems.
For modules that will be added to multiple systems, it is recommended to create a parent system that contains all the necessary service modules.
Specific configuration of the driver such as API Key's and other relevant configuration will be applied to the module.
1. Navigate to PlaceOS Backoffice
2. Click on Systems
Step 2 screenshot
3. Select your System
If configuring a global module, add it to your services system so it can easily be added to other room systems.
4. Click the Modules Tab
Step 4 screenshot
5. Click on Add new
Step 5 screenshot
6. Select the Driver you want to add from the List
Step 6 screenshot
7. Click on Save…
Step 7 screenshot
8. Click on the new module to configure
Step 8 screenshot
9. Select the appropriate tab for your configuration
Step 9 screenshot
10. Enter the required configuration
This might include API keys and other relevant information for that particular driver
11. Click on Save
Step 11 screenshot

Add an Existing Module to a System

There are specific applications where you would instantiate a driver in the Services system then re-use this module in additional systems.
Most common use cases for this method is creating bookable room systems, where each room system requires the driver to integrate with the Graph API (in the case of Microsoft 365) or where you have rooms with AV Control.
For the purposes of this demo, we will create a new bookable room system and add the existing calendar module from the tracking system.
1. Navigate to PlaceOS Backoffice
2. Click on Systems
Step 2 screenshot
3. Click New System
Step 3 screenshot
4. Select the required Zone
Step 4 screenshot
5. Enter a System Name
Step 5 screenshot
6. Enter the Resource Address
Step 6 screenshot
7. Enter a Display Name
Step 7 screenshot
8. Click on Save…
Step 8 screenshot
9. Click Modules
Step 9 screenshot
10. Select the Existing Module from the dropdown menu
Step 10 screenshot
11. Click on Add existing
Step 11 screenshot
12. Your existing module will now be added to the new system
Step 12 screenshot