Unlike mains or battery-powered accessories, a kinetic switch cannot continuously broadcast its presence. It must be manually forced to send a continuous pairing token.
Pairing Sequence Timeout: When you trigger the mechanical combo (holding the Top-Left and Bottom-Right buttons for 7 seconds, then clicking Top-Right once), the switch only has enough stored capacitor energy to broadcast its Bluetooth token for roughly 30 seconds. If you do not tap "Add Switch" in your app within this tight window, the transmission will die. Simply repeat the mechanical combo and try scanning immediately.
The "Soft Press" Combo Failure: When performing the combination sequence, you must press the buttons down firmly and completely until you hear the hard mechanical click. A light or soft press will not actuate the internal generator, meaning zero electrical energy is sent to wake up the Bluetooth transmitter chip.
Smartphone Bluetooth State: Ensure your smartphone or tablet is within 2 meters of the switch during pairing, that your phone's Bluetooth is turned ON, and that the lighting app has been granted full "Local Network" and "Bluetooth" permissions in your phone's system settings.
If pressing the top button turns a light off instead of on, or the left rocker controls the right-side zone:
Inverted Module Chassis: The central black Bluetooth module can accidentally be snapped into the plastic Retrotouch frame upside down. Pop off the glass faceplate and look closely at the plastic casing. There is a small stamp that says "Top" with an arrow. This arrow must point toward the ceiling. If it points down, your physical button presses are sending backwards command parameters to the app mesh.
Software Profile Mismatch: If the app thinks you have installed a 1-Gang rocker plate but you are using a split 2-Gang rocker plate, the button mapping will completely overlap. Go into your app's Switches menu, select the Retrotouch switch, and tap Change Layout to make sure the digital 2D graphic matches your physical buttons.
If the switch successfully added to your network but sometimes requires 2 or 3 hard clicks to turn a light on:
The "Proxy Bulb" is Powered Off: Bluetooth mesh networks rely on nearby mains-powered smart fixtures (like Casambi-ready drivers or smart bulbs) to catch the low-power switch signal and relay it across the room. If a manual wall isolation switch has cut power to the lights themselves, the kinetic switch has no nearby receiver to talk to. Keep your smart fixtures continuously powered.
Structural Signal Shielding: Bluetooth operates on the $2.4\text{ GHz}$ ISM band, which can be heavily attenuated by dense building materials. If you have mounted the switch directly inside a solid metal wall back-box or onto a wall lined with foil-backed insulation, it acts as a Faraday Cage, trapping the weak RF burst. For optimal wireless performance, surface mounting or using plastic back-boxes is recommended.
Physical Rocker Slack: Ensure the glass faceplate and plastic rocker paddles are snapped completely flush onto the frame. If there is a loose gap, your finger pressure will be absorbed by the plastic slack instead of cleanly snapping the internal kinetic module nipples.
| Symptom / Error | Probable Root Cause | Corrective Action |
| App scan times out without finding device | Capacitor drained / Broadcast window closed | Re-trigger the 7-second button combo and immediately refresh the app scan. |
| NFC pairing fails to register | Phone's NFC chip misaligned | Move the top edge/back of your phone slowly across the center of the glass until the NFC antenna registers. |
| Left button triggers right-side scenes | Module mounted upside down | Pop off the glass plate; verify the "Top" arrow points up. |
| Switch stops working after an app update | Mesh network channel change | Delete the switch from the app, perform a fresh mechanical pairing combo, and re-add it to re-sync the BLE keys. |