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.

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.

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
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
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
Last modified 5mo ago