Skip to main content

Configuring Mirah Tablets (iPad)

Mirah iPad Configuration & Provisioning Instructions

This guide includes all instructions necessary to set-up and configure your Mirah iPad tablet and the Kiosk Software.

Stage 1: Mirah URL Browser Configuration​

  • You will need to have your initial iPad setup complete, and connected to Wifi
  • Navigate to the Safari app on your iPad, and open a new browser window. The screenshot displays the home screen of an iPad, which is part of the process for configuring Mirah tablets. The screen shows the default wallpaper with ocean waves and sand. At the top left corner, there is the Settings app icon, which is used to access device settings. At the bottom center, the dock contains four app icons: Messages, Safari, Settings, and a folder containing multiple apps. The Safari app icon is highlighted with a red box, indicating it is the next step in the configuration process. The time is displayed at the top left corner, and the battery percentage is shown at the top right corner.
  • In the URL bar, navigate to https://[customer name].mirah.com/patient/welcome
  • Click on the Share icon, then click the option to “Add to Home Screen” The screenshot displays the Mirah Collaborative Care welcome page on an iPad, where users can select their role as either a patient or a parent/caregiver. The page is accessed via the URL 'https://customername.mirah.com/patient/welcome', visible at the top of the screen. The page features two buttons: 'I am a patient' and 'I am a parent/caregiver', which allow users to proceed based on their role. Below these buttons, there is an option to switch the language to Spanish. The screenshot also shows the iPad's share menu, which is activated by tapping the share icon located at the top right corner of the browser. Within this menu, several options are available, including 'Copy', 'Add Bookmark', 'Add to Favorites', 'Add to Quick Note', 'Find on Page', 'Add to Home Screen', and 'Add to Reading List'. The 'Add to Home Screen' option is highlighted, indicating the action to add the Mirah page to the iPad's home screen for quick access.
  • You will have the option to rename the home screen icon. Keep the default values, then click “Add” The screenshot displays the Mirah Collaborative Care website on an iPad, with a pop-up window titled 'Add to Home Screen'. The pop-up provides the option to add the Mirah website to the home screen for quick access. It includes the website name 'Mirah', the URL 'https://qa.mirah.dev/patient/welc...', and a brief description stating that an icon will be added to the home screen. The pop-up has two buttons: 'Cancel' located at the top left corner and 'Add' located at the top right corner, highlighted in red. The background shows the Mirah welcome page with two buttons: 'I am a patient' and 'I am a parent/caregiver', along with a language option 'Español'.

Stage 2: iPad Configuration - Enable Guided Access​

  • Navigate to the Settings app on your iPad The screenshot displays the home screen of an iPad, which is part of the process for configuring Mirah tablets. The screen shows two app icons at the top: 'Settings' on the left, which is used to access device settings, and 'Mirah' on the right, which is the application for collaborative care and measurement-based care. The bottom of the screen features a dock with commonly used apps including Messages, Safari, Gmail, App Store, Photos, and Maps. The time is shown at the top left corner as 8:32 PM, and the battery level is indicated at the top right corner as 75%. The background is a beach scene with waves meeting the sand.
  • Select “Accessibility” in the list on the left-hand side of the screen. In the Accessibility section on the right-hand side of the screen, scroll to the bottom of the list, and select the “Guided Access” option The screenshot displays the Settings menu on an iPad, specifically focusing on the Accessibility settings. On the left side, the screen shows the main Settings menu with options such as Airplane Mode, Wi-Fi, Bluetooth, Cellular Data, and Personal Hotspot, along with sections for Notifications, Sounds, Focus, Screen Time, General, Control Center, Display & Brightness, Home Screen & Dock, Accessibility, Wallpaper, and Siri & Search. The user's profile, Vidhi Luthra, is visible at the top. On the right side, the Accessibility menu is shown, featuring options for Spoken Content, Audio Descriptions, Touch, Switch Control, Voice Control, Home Button, Apple TV Remote, Keyboards, Hearing Devices, Sound Recognition, RTT, Audio & Visual, Subtitles & Captioning, Guided Access, Siri, Accessibility Shortcut, and Per-App Settings. The Guided Access option is highlighted, indicating its importance in the configuration process, and is located under the General section.
  • Turn Guided Access to “On”. In this section, you can also update “Passcode Settings” and “Display Auto-Lock”. The screenshot displays the iPad Settings interface, specifically focusing on the Accessibility settings for Guided Access. On the left side, the main Settings menu is visible, showing options such as Airplane Mode, Wi-Fi, Bluetooth, Cellular Data, Personal Hotspot, Notifications, Sounds, Focus, Screen Time, General, Control Center, Display & Brightness, Home Screen & Dock, Accessibility, Wallpaper, and Siri & Search. The right side of the screenshot highlights the Guided Access settings, which include a toggle switch to enable Guided Access at the top right, Passcode Settings, Time Limits, Accessibility Shortcut, and Display Auto-Lock set to 'Never'. The Guided Access feature is designed to keep the iPad in a single app and control available features, useful for maintaining focus during collaborative care sessions.
  • Setting a passcode prevents patients from disabling guided access mode. Click on the option to “Set Guided Access Passcode”. Then, enter a passcode - make sure to take a note of what the passcode is in case you need to regain access to the iPad. You will be asked to re-enter the passcode to confirm. The screenshot displays the Passcode Settings screen on an iPad, which is part of the process for configuring Mirah tablets. The top section shows the option to 'Set Guided Access Passcode,' which is highlighted, indicating the user should select it to proceed. Below this, there is a toggle switch for 'Touch ID,' which is currently set to off, allowing users to enable or disable the use of Touch ID to end Guided Access. The bottom section of the screenshot shows the 'Set Passcode' dialog, where users are prompted to 'Enter a passcode' using six circular input fields. The 'Cancel' button is located at the top right of this dialog, allowing users to exit the passcode setting process.
  • You can also turn off the “Display Auto-Lock”. This prevents the iPad from turning off during Guided Access Mode The screenshot displays the 'Display Auto-Lock' settings screen on an iPad, which is part of the process for configuring Mirah Tablets. This screen allows users to select the duration before the device automatically locks the display. Options include Default, 30 Seconds, 1 Minute, 2 Minutes, 3 Minutes, 4 Minutes, 5 Minutes, 10 Minutes, 15 Minutes, and Never. The 'Never' option is currently selected, indicated by a checkmark and highlighted with a red border. The 'Back' button is located at the top left corner, allowing users to return to the previous screen.

Stage 3: Turning on Guided Access (Kiosk) Mode​

  • Navigate to the Mirah app you created in Stage 1 The screenshot displays the home screen of an iPad, showcasing the Mirah app icon, which is highlighted with a red border for emphasis. The Mirah app is positioned on the top row, to the right of the Settings app icon. The purpose of this screen is to guide users in locating and accessing the Mirah app for collaborative care and measurement-based care functionalities. The bottom row features the dock with commonly used apps including Messages, Safari, Gmail, Photos, and the App Store. The status bar at the top shows the time, date, and battery percentage, providing users with essential device information.
  • To enable Guided Access in the Mirah app, triple click on the home button. If your iPad doesn’t have a home button, triple click on the top/side button. You should see a pop-up saying “Guided Access Enabled”. The screenshot displays the welcome screen of the Mirah Collaborative Care application on an iPad, indicating the start of Guided Access mode. The screen is designed to guide users in therapy assistance. At the top, there is a navigation bar with options for translation availability and language selection, currently set to English. Below the navigation bar, the Mirah logo is prominently displayed. The main section of the screen features a welcoming message, 'Welcome! Here you can help us guide your therapy.' There are two interactive buttons: 'Guided Access Started' in the center, indicating that the device is in a restricted mode to prevent users from leaving the app, and 'I am a parent/guardian of a client' located below it, which likely leads to a different user flow. At the bottom, there is an option to switch the language to Spanish.
  • You will need to disable the URL bar at the top of the screen to prevent users from navigating away from this page. To do this, triple click on the home button again (or the top/side button if your iPad doesn’t have a home button). You will be prompted to enter your Guided Access passcode you set in Stage 2. The screenshot displays the Mirah Collaborative Care application on an iPad, specifically the passcode entry screen. The purpose of this screen is to authenticate the user before accessing the application. At the top, the browser address bar shows the URL 'qa.mirah.dev', indicating a development environment. Below the address bar, the Mirah logo is visible on a blue background. The central focus is a pop-up dialog titled 'Enter Passcode', which prompts the user to input their passcode using six circular fields. To the right of the title, there is a 'Cancel' button allowing the user to exit the passcode entry process. Below the passcode entry fields, the background displays two buttons: 'Here you can learn more about therapy' and 'I am a returning patient', which are likely options for navigating the application after successful authentication.
  • You will notice that there is a prompt at the bottom of the screen - “Circle areas on the screen you would like to disable”. Circle the entire gray box on the top of the screen - make sure to select the entire section to prevent users from navigating away from this URL. The screenshot displays the Mirah Collaborative Care application interface on an iPad, specifically in Guided Access mode. At the top of the screen, the browser bar shows the URL 'qa.mirah.dev', indicating the application is running in a development environment. The main section of the screen features a welcome message, 'Welcome! Here you can help us guide your therapy.' Below the message are two buttons: 'I am a client' and 'I am a parent/caregiver of a client', which allow users to select their role in the therapy process. There is also a link labeled 'Español' for language selection. At the bottom of the screen, a prompt reads 'Circle areas on the screen you would like to disable', indicating the user can customize the Guided Access settings. The top navigation bar includes options 'End' and 'Resume' for managing the Guided Access session.
  • You will notice that the area inside the circle turns gray. You can edit and expand this area as needed to make sure the entire URL form field is covered. Once you are satisfied with the disabling, click on the “Resume” button. The screenshot displays the initial setup screen for Mirah Collaborative Care on an iPad, with Guided Access mode enabled. The top of the screen shows a navigation bar with 'End' on the left and 'Resume' on the right, indicating options to manage the Guided Access session. Below, a blue welcome screen invites users to select their role in therapy guidance. Two buttons are centrally located: 'I am a client' and 'I am a parent/caregiver of a client', allowing users to specify their involvement. Below these buttons, 'Español' is available for language selection. The bottom of the screen has an 'Options' button on the left, with instructions to circle areas to disable, facilitating customization of the Guided Access experience.
  • You’ve now successfully provisioned your iPad The screenshot displays the initial welcome screen for Mirah Collaborative Care on an iPad. The screen is designed to guide users in selecting their role for therapy guidance. It features a prominent 'Welcome!' message followed by the text 'Here you can help us guide your therapy.' Below this message are two large buttons: 'I am a client' and 'I am a parent/caregiver of a client,' which allow users to specify their role in the therapy process. These buttons are centrally located for easy access. At the bottom of the screen, there is a link labeled 'Español' for language selection, enabling users to switch the interface to Spanish. The top of the screen includes a navigation bar with the Mirah logo on the left, the website URL 'qa.mirah.dev' in the center, and a language toggle 'EN' on the right, along with a close button marked with an 'X'.