Getting started guide.

What's in the box

Each Occulights kit equips one room.

A standalone Light kit equips one door.

Before you start

Choose your mounting locations

Sensor coverage at a glance

The OccuHub's PIR motion sensor reliably detects subtle movements (typing, gesturing) in a 5–6 m radius. From a 2.7 m ceiling that comfortably covers a 5 × 5 m room.

Decision: ceiling or wall?

Where the OccuLight goes

The Light belongs outside the meeting room, beside the door, at eye-level or slightly above (1.6 m – 2.2 m). People walking down the corridor should be able to read its colour from at least 5 m away without ducking or looking up.

Mount the OccuHub — ceiling

The Hub ships with its square mounting plate already clipped on. Pull the plate off, screw it to the ceiling with four M3 × 8 self-tapping screws into the corner holes, then snap the Hub straight back onto the four inner pegs.

1. Pull the square mounting plate off the Hub.

   Pull straight downward. The plate stays in your hand — the Hub itself goes back in the box until step 5.

2. Pull the PoE / USB-C cable.

   Drop Cat 5e/6 (or USB-C) through the ceiling tile and feed it through one of the plate's pass-throughs (Ø 28 mm for chunky ethernet plugs, Ø 18 mm for slim cables). Leave 30–50 cm of slack on the room side.

3. Mark and drill the four corner holes.

   Hold the plate against the tile, level it, and pencil-mark through all four corner holes — an 83.5 × 83.5 mm square pattern. Drill 3 mm pilots. Drop tile and plasterboard need no extra anchor for these self-tapping screws.

4. Drive the four M3 × 8 screws.

   Screw heads countersink into the plate's chamfered holes and sit flush. The plate should be tight against the tile but not flexing it.

5. Snap the Hub onto the plate.

   Plug ethernet/USB-C into the Hub's port first, then align the Hub's four sockets with the plate's four snap-fit pegs (70 × 70 mm pattern) and press straight up until you feel all four clips engage. Tug gently downward to confirm.

6. Confirm sensor orientation.

   The PIR lens on the Hub's underside must point straight down at the floor — not toward a wall.

Mount the OccuHub — wall

Use this when ceiling access isn't practical. The Hub sits on the wall opposite the door, looking into the room.

1. Pull the square mounting plate off the Hub.

   Same plate as the ceiling install — pull straight off the four snap-fit pegs.

2. Pick the wall opposite the door.

   This gives the longest line-of-sight and avoids people standing under the sensor unnoticed as they enter.

3. Mark the height.

   2.0 m is the sweet spot for a 2.7 m ceiling. Above the sight-line of seated occupants, below the ceiling line so the cone covers the whole room.

4. Pull the cable into a back-box or trunking.

   Run PoE/USB-C from the nearest cable channel and feed it through one of the plate's pass-throughs (Ø 28 mm or Ø 18 mm). Avoid running parallel to mains for more than 30 cm.

5. Mark and drill four 3 mm pilot holes.

   Use the plate as your template — 83.5 × 83.5 mm corner pattern. Plasterboard: push self-drive anchors flush into all four pilots. Concrete: 5 mm masonry plug. Wood stud: drive M3 × 8 directly.

6. Drive the four M3 × 8 screws.

   Snug, plate flush against the wall, screw heads countersunk into the chamfered corner holes.

7. Snap the Hub on.

   Plug PoE/USB-C in first, line up the four snap-fit pegs with the Hub's sockets, and press straight on until you feel all four clips engage. The "Occuhub" wordmark should read horizontally.

8. Verify the sensor angle.

   The PIR lens should look straight across the room, not at the floor or ceiling. A small inclinometer app on your phone helps if you're being picky.

Mount the OccuLight beside the door

Visible from down the corridor, eye-level or above.

Fig. 4 — A live install. The OccuLight sits on the side of the door at ~1.8 m, glowing green to signal the room is available.

1. Pull a PoE drop or USB-C cable to the wall.

   Either a Cat 5e/6 from your PoE switch or a USB-C run from a wall charger, terminating on the side of the door at 1.6–2.2 m.

2. Plug the cable into the Light.

3. Fix the Light to the wall.

Power up & connect

Every Light ships with a Wi-Fi captive portal called WiFiManager. The portal is the same in either mode; the only thing that changes is which Network mode you pick.

1. Power both devices.

   Plug in the Light first (PoE or USB-C), then the Hub. The Light blinks during boot.

2. On your phone or laptop, join Occulight_XXXXXXXXXXXX.

   The 12-character suffix is the Light's MAC address (e.g. 3844BEE2C4C4). The captive portal opens automatically — if not, browse to http://192.168.4.1.

3. Tap Configure WiFi.

   You'll see the form in Fig. 7.

4. Set Network mode → Slave.

   This puts the Light into ESP-Now slave mode so it pairs with the nearest provisioned OccuHub. Leave SSID and Password blank — the Light gets its data from the Hub, not from Wi-Fi.

5. Now provision the Hub.

   The Hub has its own captive portal. Repeat the same join + Configure WiFi flow against OccuHub_XXXXXX, this time entering your office Wi-Fi credentials. Up to 6 minutes to sync.

1. Power the Light.

   Plug in the PoE or USB-C cable. The Light blinks during boot.

2. On your phone or laptop, search for available WIFI-networks.

   Locate and join Occulight_XXXXXXXXXXXX.

   The 12-character suffix is the Light's MAC address (e.g. 3844BEE2C4C4). The captive portal opens automatically — if not, browse to http://192.168.4.1.

3. Tap Configure WiFi.

   You'll see the form in Fig. 6.

4. Pick a Network mode.

   Ethernet — the Light uses its PoE wired connection. Leave SSID and Password blank. Tick Use static Ethernet IP only if your network requires it; otherwise the Light gets an address via DHCP.
   WiFi — Select your Wi-Fi network and enter the Password (2.4 GHz).

5. Hit Save.

   The Light reboots, joins your chosen network.

Provision to the cloud

1. Scan the QR code on the box, or type:

   https://app.occulights.com/inventory/{Hub MAC address}

2. Sign into the Portal.

   If this is your first installation, make sure your tenant has been created. If not, request it using this form or contact your partner.

3. Click Provision to cloud.

   Add it to the designated room. The Hub is now bound to your tenant and will appear in your inventory. Repeat per Hub.

4. Navigate to the room.

   Go to rooms, click on the room you just assigned the hub to and click on add light.

5. Add Light.

   Type the MAC address of the light you want to add and click lookup.

1. Scan the QR code on the box, or type:

   https://app.occulights.com/inventory/{Light MAC address}

2. Sign into the Portal.

   If this is your first installation, make sure your tenant has been created. If not, request it using this form or contact your partner.

3. Click Provision to cloud.

   Pick the room (or door) the Light belongs to. The Light is now bound to your tenant and will appear in your inventory.

4. Set the control source.

   In the room view, choose how this Light is driven: Portal toggle (manual), Calendar integration (Microsoft 365 / Google Workspace), or API / Webhook (your own system). Save.

Verify the install

A 2-minute walk-through confirms the room is live.

What the LEDs mean

Smoke test

1. Walk into the room.

   The OccuLight should turn red within 2 seconds.

2. Stand still for 30 seconds, then leave.

   The Light should switch to green within the configured release timeout (default 5 min, settable in the Portal).

3. Open the Portal.

   You should see two state changes for this room in the timeline.

Smoke test

1. Open the Portal, find the room and toggle it to Occupied.

   The Light should turn red within 2 seconds.

2. Toggle it back to Available.

   The Light should switch to green within 2 seconds.

3. If you wired up Calendar or API control:

   Book a 1-minute meeting in your calendar (or POST a state to the webhook) and confirm the Light reacts.

Troubleshooting

The five symptoms we see most often, and how to clear them.