> For the complete documentation index, see [llms.txt](https://luum.io/llms.txt).
> Canonical page: [Touchscreen Setup Guide](https://luum.io/docs/amatis/programming/touchscreen-setup).

LUUM.IO

# **Touchscreen Setup Guide** - GUIDE

## About This Guide

This guide explains how to configure a dedicated touchscreen device as a lighting control panel for the Amatis Light & Spaces app. It provides step-by-step instructions for both iOS and Android devices using their native lock features so that end users can only access the lighting controls app. It also includes notes on advanced methods (kiosk launchers and MDM solutions) for customers who need the device to remain locked down after reboot or for larger, multi-device deployments.

## Necessary Parts

The following parts will be necessary to complete this guide:

1. A functional Amatis lighting controls system
2. An Amatis Controls user account
3. A touchscreen device (iOS or Android)

## System Setup

Before getting started, download the Light & Spaces app from the App Store (iOS) or Google Play Store (Android).

## iOS Touchscreen Setup

Guided access will be used to configure an iOS device with the Light & Spaces app.

1. On the iPad, open Settings → Accessibility → Guided Access.
2. Turn on Guided Access.
3. Set a Passcode (or Face/Touch ID) to prevent exit.
4. Launch your lighting control app.
5. Triple-click the Home button (or Side/Top button on models without Home) → tap Start.

The iPad is now locked into that app. The Home/Multitasking buttons and notifications are disabled. To exit, triple-click the button again, enter the passcode, and tap End.

> **Note**
> Guided access does not start on boot. It will need to be re-enabled after a restart.
>
## Android Touchscreen Setup

Screen pinning will be used to configure an Android device with the Light & Spaces app.

1. Open Settings → Security & privacy (or Security).
2. Tap More security settings (or Advanced).
3. Turn on App pinning (or Screen pinning).
4. Enable Ask for PIN/Pattern to unpin (highly recommended).
5. Open the app you want to lock.
6. Open Overview/Recents (swipe up and hold, or the ◻️ button).
7. Tap the app icon at the top of its card (or the 3-dot menu).
8. Tap Pin / Pin this app.

The tablet is now locked into that app. The Home, Back, Recents buttons, and notification shade are disabled. To exit, press and hold Back + Overview (or Back + Home) together, then enter your PIN.

> **Note**
> Screen pinning does not start on boot. It will need to be re-enabled after a restart.
>
## Advanced

For permanent, always-on kiosk mode (where the device boots directly into the Light & Spaces app and remains locked), use either a kiosk launcher app or an MDM (Mobile Device Management) service.

- Why:
    - Native Guided Access / Screen Pinning must be re-enabled after every reboot.
    - Kiosk launchers and MDM solutions provide true “single-app mode” and remote management options.

Recommended Free Kiosk Apps

- Android:
    - Kiosk Browser Lockdown (Play Store – free basic features)
    - Kiosk Lockdown LimaxLock (Play Store – free with optional upgrades)
- iOS:
    - Native Guided Access (best for one-off use)
    - For more permanent setups, use MDM with Single App Mode (see below).

Recommended Free MDM (iOS & Android)

- Miradore (Free Plan):
    - Works with both iOS and Android devices.
    - Supports Single App Kiosk Mode (locks the device to Light & Spaces automatically, even after reboot).
    - Provides a web dashboard for admins to manage devices, push updates, or remotely unlock a panel.
    - Free forever for core features — great for small to medium installations.

> **Important**
> Enrolling a device into an MDM solution requires a factory reset. This means the device will be wiped during setup.
>
## Related Information

### Technical Support

Questions about this guide can be sent to [support@luum.io](mailto:support@luum.io).

### Document Feedback

While we have taken great care to ensure the accuracy and completeness of this document, we welcome your feedback and suggestions. If you notice any errors or omissions, or feel a topic could benefit from further explanation, please email your feedback to [support@luum.io](mailto:support@luum.io).

### Revision History

| Date | Revision | Notes |
| --- | --- | --- |
| 11/3/2026 | A | Converted to the current guide format. |

### Disclaimer

All rights, title, and interest in and to this guide, including without limitation all copyright, trademark, patent, trade secret, and other proprietary rights, belong solely and exclusively to Luum.io and/or its licensors. This guide is provided solely for the purpose of locking a touchscreen to the Light & Spaces app, and no license or other rights are granted or implied hereby. No part of this guide may be reproduced, distributed, or transmitted in any form or by any means, including photocopying, recording, or other electronic or mechanical methods, without the prior written permission of Luum.io. The contents of this guide are subject to change without notice. The information contained herein is provided on an 'as is' basis and is for informational purposes only. Luum.io makes no warranty, express or implied, as to the accuracy, completeness, or usefulness of this information, nor does it assume any legal liability or responsibility for the consequences of any errors or omissions therein. The names of actual companies and products mentioned herein may be the trademarks of their respective owners.

---

_©2026 Luum.io. All rights reserved._
