Qeedji SBL10e User manual

User manual
SBL10e m365_room
1.11.10 002A

2
Legal notice
SBL10e m365_room 1.11.10 (002A_en)
© 2020 Qeedji
Rights and Responsibilities
All rights reserved. No part of this manual may be reproduced in any form or by any means whatsoever. or by any means whatsoever without the
written permission of the publisher. The products and services mentioned herein may be trademarks and/or service marks of the publisher. or
trademarks of their respective owners. The publisher and the author do not claim any rights to these Marks.
Although every precaution has been taken in the preparation of this document, the publisher and the author assume no liability for errors or
omissions, or for damages resulting from the use of the information contained in this document or the use of programs and source code that can go
with it. Under no circumstances can the publisher and the author be held responsible for any loss of profits or any other commercial prejudice caused
or alleged to have been caused directly or indirectly by this document.
Product information
Product design and specifications are subject to change at any time and `Qeedji` reserves the right to modify them without notice. This includes the
hardware, the embedded software and this manual, which should be considered as a general guide to the product. The accessories supplied with the
product may differ slightly from those described in this manual, depending on the developments of the various suppliers.
Precautions for use
Please read and heed the following warnings before turning on the power: - installation and maintenance must be carried out by professionals. - do
not use the device near water. - do not place anything on top of the device, including liquids (beverages) or flammable materials (fabrics, paper). - do
not expose the device to direct sunlight, near a heat source, or in a place susceptible to dust, vibration or shock.
Warranty clauses
The `Qeedji` device is guaranteed against material and manufacturing defects for a certain duration. Check the device warranty duration value at the
end of the document. These warranty conditions do not apply if the failure is the result of improper use of the device, inappropriate maintenance,
unauthorized modification, operation in an unspecified environment (see operating precautions at the beginning of the manual) or if the device has
been damaged by shock or fall, incorrect operation, improper connection, lightning, insufficient protection against heat, humidity or frost.
WEEE Directive
This symbol means that your appliance at the end of its service life must not be disposed of with household waste, but must be taken to a collection
point for waste electrical and electronic equipment or returned to your dealer. Your action will protect the environment. In this context, a collection
and recycling system has been set up by the European Union.

3
1.1
1.1.1
1.1.2
1.1.3
1.1.4
1.2
2.1
3.1
3.1.1
3.1.2
3.1.3
3.1.4
3.1.5
3.1.6
3.1.7
3.1.8
3.1.9
3.1.10
3.1.11
3.1.12
4.1
4.2
5.1
6.1
6.2
6.3
6.4
6.5
6.6
Table of contents
Part I : Description and installation
Introduction
Device dimensions
Labelling
Installation
Uninstallation
Smart Busy Light applications
Part II : Applicative user interface
Applicative user interface
Part III : Administration console user interface
Administration console user interface
Configuration > Administrator
Configuration > LAN
Configuration > Servers
Configuration > Date and time
Configuration > Tasks
Maintenance > Firmware
Maintenance > Preferences
Maintenance > Logs
Maintenance > Tools
Maintenance > Files
Information > Device
Information > Network
Part IV : Technical information
Technical specifications
Conformities
Part V : Contacts
Contacts
Part VI : Appendix
Appendix: Web services
Appendix: Qether
Appendix: Azure AD User Principal Name
Appendix: AZURE AD Application Powershell module
Appendix: Microsoft Azure AD portal for Microsoft 365
Appendix: Configuration using powerShell for Microsoft 365 (M365)

4
Part I Description and installation

5
1.1  Introduction
This manual explains how to install and configure your device SBL10e.
Recommendations and w arnings
This device is designed for indoor use only.
To ensure better rendering of the SBL10e, the device should not be installed under direct sunlight.
The SBL10e device is designed to be illuminated 12 hours a day, 7 days a week.
Pack age Contents
Articles Description
Device SBL10e device with the default regular ¹ application embedded.
¹ It is possible to easily update the device with the m3 6 5 _room application afterwards.

6
1.1.1  Device dimensions

7
1.1.2  Labelling
Product label
The model of the device, the power supply characteristics, the serial number (PSN) and the MAC address are written on a label stuck on the case.
☛ The QR code on the product label is corresponding to the product identification UR L, for example:
i.q eedj i.tech?model=S B L 10 e&sn=0 13 2 0 -0 0 0 0 9 &mac.lan1=0 0 -1C -E 6 -0 2 -4C -E C &mac.wpan1=D F -2 7 -8 3 -3 C -8 A -9 0 .
Pack ingbox label
This is the label stuck also on the packingbox. It is showing:
the device model,
the product serial number (PSN) (embedded also in the QR code),
the manufacturer Web site.
☛ The QR code on the packingbox label is corresponding to the product P SN , for example:
PSN01320-00009 CD1 .
☛ The serial number of the device could be req uested in case of technical support.

8
1.1.3  Installation
☛ Install the SBL10e device on the E thernet wall plugs of the buildings following the installation map given by your IT departement.
The SBL10e device has to be plugged to an Ethernet wall plug supporting PoE IEEE802.3af.
G iven the device footprint, it is preconised to use Ethernet wall plug plastron with a right insertion.
Consequently, the Ethernet wall plug whose plastron is angled is not supported.
☛ Thanks to the lock pin of its E thernet connector, the SBL10e device can be installed on vertical surfaces, like walls as well as horizontal
surfaces, like ceilings.

9
1.1.4   Uninstallation
With a screw driver, hold down the pin of the Ethernet connector 1 of the SBL10e device at the same time you are releasing with the hand 2 the
SBL10e device from the Ethernet wall plug.
1
2

10
1.2  Smart Busy Light applications
The m365_room application periodically connects to your M365 (Microsoft 365) solution and to get information about the O ffice calendar of a specific
resource id. If an event has started or happening in the day, the event' s title, the event' s start time and the event' s end time can be watched in the
SBL10e Web user interface. Depending on the event has started, happens soon or will happen later in the day, the appropriate light state/color is
displayed.
Light states and colors
The SLB10e can support the states and colors values showed below.
Color State
OFF
Red ON steady or ON flashing
Green ON steady or ON flashing
Blue ON steady or ON flashing
Orange ON steady or ON flashing
Yellow ON steady or ON flashing
☛ The O N flashing state is fl ashing with this seq uence: O N for 0,5 seconds then O F F for 0,5 seconds every one second.
☛ Depending on the application running on it, some color/ state may be never used.
☛ The light color and state values are stored in the volatile memory (R AM). That means that in case the SBL10e device is unplugged from the
E thernet wall plug then plugged back again, the light comes back to its default state: O F F .

11
Confi guration
The Smart Busy Light application supports the configuration update:
by connecting to the Administration console user interface http:/ / <device-ip-addr>/ and changing parameters,
by pushing, from a WebDAV client or with the device Web user interface, a prefs.json configuration file on the device WebDAV directory
http:/ / <device-ip-addr>/ .conf/ ,
by pushing, from a WebDAV client or with the device Web user interface, a .js configuration script on the device WebDAV directory
http:/ / <device-ip-addr>/ .conf/ ,
by receiving a configure command with an appropriate .js configuration script from the Q ether tool (Qether V 1.12.10 or above).
F irmw are upgrade
The Smart Busy Light application supports the firmware upgrade:
by connecting to the Administration console user interface http:/ / <device-ip-addr>/ and loading an appropriate bm0032_m365_room-sbl10e-
xx.yy.zz.bin ¹ firmware file,
by pushing a new bm0032_m365_room-sbl10e-xx.yy.zz.bin ¹ firmware file at the root of the device WebDAV directory http:/ / <device-ip-addr>/ ,
pushed with a WebDAV client,
by receiving an install command with an appropriate bm0032_m365_room-sbl10e-xx.yy.zz.bin ¹ firmware file from the Q ether tool.
¹ Can work also with any other b m0 0 3 2 _<custom>-sb l10 e-x x .yy.z z compatible firmware.
☛ After a firmware upgrade, the device is rebooting once.
☛ When the config uration command or the install command has been processed, the last S mart B usy L ig ht state and color are restored.
Preprogrammed fl ashing seq uence
The SBL10e device has two modes:
Nominal mode : the Smart Busy Light application runs properly and sets the light state and color as expected. When a configuration or a firmware
upgrade is in progress, the light illumination can be temporarily inconsistent and follows the light flashing sequence shown in the table hereafter.
Recovery mode : the Smart Busy Light application can not be executed. The light state or color can not be modified anymore. It is required to
update the firmware to return to the nominal mode .

12
Depending on these modes, the Smart Busy Light applications can fall into one of these preprogrammed flashing sequences:
M ode S mar t B u sy
l ig h t behaviour Information
Recovery
2 very short and
consecutive blue
flashs (250 ms)
with a 4,5
seconds
periodicity
The Smart Busy Light application can not be executed (it should never occur). The device Web user
interface is so not available. This sequence is displayed until a new firmware update is realized with
Q ether tool. For further information, contact support@ qeedji.tech.
Recovery
3 very short and
consecutive blue
flashs (250 ms)
with a 5 seconds
periodicity
The software resource of the SBL10e device set at factory are not valid. It should never occur. For further
information, contact support@ qeedji.tech.
Nominal
or
recovery
4 very short and
consecutive blue
flashs (250 ms)
with a 5,5
seconds
periodicity
A SBL10e device Firmware update is in progress. Please wait a couple of seconds.
Nominal 5 very short and consecutive blue
flashs (150 ms) A SBL10e device configuration is in progress. Please wait a couple of seconds.
Nominal 6 very short and consecutive blue
flashs (150 ms)
The datasource is not consistent because some of the parameters are missing or the Date and time is not
correct because the NTP server is not activated or not valid. For further information about the datasource
form, refer to the chapter § Configuration > Servers. For further information about the reporting of the
problems faced with some datasource parameters, refer to the chapter § Maintenance > Logs.

13
Part II Applicative user interface

14
2.1  Applicative user interface
The SBL10e device has a Web user interface that can be accessed with a Web browser. The supported Web browsers are: Google Chrome , Mozilla
Firefox , MS-Edge (Chromium) .
It is available from the URL: http:/ / <device_IP_addr>/ .
By default, the login credentials for the device Web user interface are:
login: admin ,
password: admin .
The URL falls into the m365_room applicative user interface: http:/ / <device_IP_addr>/ webui/ . This pane allows to:
watch the current light state/color:
ON steady/green: there is no more event scheduled today or the next event scheduled today happens in more than 15 minutes,
ON steady/orange: a next event happens in less than 15 minutes,
ON steady/red: an event has started,
watch the event properties: title, start time, end time:
for the one which has started or,
of the next one happening today (whose the start date is today).
Examples:

15
☛ After a device restart, the time to get the time from to the N TP server (few seconds), the LE D color/ state is O rang e/O F F .
☛ Only the first 128 bytes of the N ex t b ook ing sub j ect can be displayed.
☛ In case the meeting summary is more than 128 bytes and contains some unicode characters, the N ex t b ook ing sub j ect value, the start date
and the end date could stay sometimes empty or the N ex t b ook ing sub j ect value may be displayed with a unexpected shortened value of the
original meeting summary. However, the LE D state/ status continue to be displayed properly.
☛ E vents taking place all day long and accross several days are supported. In this case, the start time and end time are displayed from the
current day at 12 : 0 0 A M to the day after at 12 : 0 0 A M .

16
Part III Administration console user interface

17
3.1  Administration console user interface
The SBL10e device has a Web user interface that can be accessed with a Web browser. The supported Web browsers are: Google Chrome , Mozilla
Firefox , MS-Edge and MS-Edge (Chromium) .
It is available from the URL: http:/ / <device_IP_addr>/ .
By default, the login credentials for the device Web user interface are:
login: admin ,
password: admin .
The URL falls automatically into the applicative user interface¹ . At the top right corner, click on the Administration Console button.
¹ F or further information, refer to the chapter § Applicative user interface.
This is the Administration console user interface.
◬ After you have changed and saved all your settings in the different panes, be sure to perform a device restart by clicking on the Reboot the
device 2 button so that your changes are fully reflected.
Click on the device logo 1 at the left top corner to return to the applicative user interface.
1
2

18
3.1.1  Confi guration > Administrator
In the Configuration pane, select the Administrator menu to change:
the Hostname ,
the login credentials:
Administrator name ,
Password .
For security reasons, it may be useful to change the login credentials to access to the device' s Web user interface. Please keep these login credentials
in a safe place afterwards.
☛ The same login credentials are used to access to the WebDAV server.
☛ It is recommended that you enter one uniq ue H ostname value for each device. In case several SBL10e devices are located in different buildings
or geographical locations, we recommend that you enter hostname values with information about the building and the location (e.g. H all-R D -
P aris-1 ).
☛ A blanck screen could be displayed after having refreshed rapidly and sereral times the Web user interface. To work around, wait a dozen of
seconds, and refresh again the Web user interface.

19
3.1.2  Confi guration > LAN
In the Configuration pane, select the LAN menu to set up the network configuration of the LAN interface of your device.
☛ The device supports the UP nP and can be for example detected in the local network environment of your computer.
☛ When only the T ime for attempts value is modified, press on TAB key to make appear the V alidate button.
☛ By default, the device is configured with DHCP activated. In the default configuration, in case the DHCP is unavailable, after the T ime for
attempts (10 minutes, maximum and default value) has expired, the device ends up using the static IP address entered in the LAN configuration.
The static IP address is 192.168.0.2 when it has not been changed yet by the end user. It is recommended to set an appropriate IP address,
netmask and gateway if this case would happen. When DHCP is activated and T ime for attempts is unchecked, the device never falls into a LAN
configuration with a static IP address. As soon as the server DHCP becomes available, the device ends by getting back a valid IP address given by
the DHCP server.

20
3.1.3  Confi guration > Servers
In the Configuration pane, select the Servers menu to define the configuration of the servers peripheral to your device.
The Datasource Server allows, through Azure AD, to access to a dedicated resource id' s calendar available in your M365/O ffice. Depending whether
there is meeting programmed for the resource id or not, the m365_room application device is applying a state/color value to the busylight:
Steady/ green : previous event finished and no next event happening is less than 15 minutes,
Steady/ Orange : next event happening in less that 15 minutes,
Steady/ Red : an event has started.
☛ When only the heartbeat value is modified, press on TAB key to make appear the V alidate button.
Datasource Server :
Type : M365_ room,
Tenant Id 1: Directory Tenant Id (from Azure AD),
Client Id 2: Application client Id (from Azure AD),
Client Secret 3: Client secret value (from Azure AD),
Resource Id 4: M365/O ffice resource email,
Heartbeat 5: periodicity of the connection to the Datasource Server :
from 10 seconds (default value) to 900 seconds,
HTTPS proxy server 6:
Address : enter the IPv4 address, or the domain name of your proxy server,
Port : enter the operating port of your proxy server,
DNS servers 7,
NTP time server 8: ensure that NTP time server is checked and has a valid IP address.
◬ The m365_room application can work properly only when the NTP server is activated in the Web user interface and if a valid NTP server IP
address is set, allowing to the SBL10e to stay on time.
Using M365 (or Microsoft 365 ) implies to create an Azure Active Directory (Azure AD) application for the busylight m365_ room application. After
consent success, fill with the appropriate values:
Tenant Id 1,
Client Id 2,
Client Secret 3.
☛ The same T enant I d , C lient I d , C lient S ecret value can be then used for all your SBL10e having a m365_room application and connected
to resources id coming from the same M365 account.
For further information about the procedure to create an Azure Active Directory application, refer to the chapter § Appendix: Azure AD.
◬ Some organization can use an alias for the resource Id email instead of using the official one. For the room resource Id 4, do ensure to
only enter the User principal Name of the resource. For further information, refer to the chapter § Appendix: Azure AD User Principal Name.
This is an example with a M365 room resource id called [email protected] (fake values):
Resource Id : [e-mail]
Client Id : 269d8878-f581-43fe-b53d-fea6c181b7f4
Tenant Id : 967b7cc3-847f-41ec-bd74-997a4df1855b
Client secret : 6-CdOVxv6p1wwH4y0Q6Yr11SY7.dU~Tt
1
2
3
4
5
6
7
8