Link

FAQs and Troubleshooting

Litho beta release 0.6.0 (2019-12-16)

Table of contents

  1. Interaction
    1. Why can’t I see the laser pointer?
    2. Why is my Litho laser pointer inverted?
    3. Why is my pointer drifting to the left or the right over time?
    4. Why does my Litho feel laggy or jittery in the Unity editor or on iPhone?
    5. In a Litho app my pointer doesn’t feel like it’s following my hand
  2. Connection
    1. Why is my Litho not connecting?
    2. Why is my Litho slow to connect on my phone?
    3. Why is my Litho not on the device selection screen?
    4. Why is my Litho slow to connect in the Unity Editor?
  3. AR
    1. My AR planes are being slow to be discovered or my AR tracking is unreliable
  4. Development
    1. Unity Editor crashes when pressing play
    2. I have Unity build errors
    3. I have Xcode build errors
  5. Hardware
    1. Why is my Litho not charging?
    2. Why is my trackpad or haptic motor behaving erratically?
    3. Why is my Litho’s battery life so short (e.g. under 3 hours)?
  6. I think I have another hardware issue…

Interaction

Why can’t I see the laser pointer?

  • Ensure you’re holding the device in the grip you have selected in the UI
  • Your Litho might not be calibrated, see the calibration instructions

back to top

Why is my Litho laser pointer inverted?

  • You might be holding Litho the wrong way around, have a look at how to wear Litho
  • Ensure you’re holding the device in the grip you have selected in the UI

back to top

Why is my pointer drifting to the left or the right over time?

  • To resolve this put your Litho on a table while it is still connected, and leave completely still for 30 seconds
  • If this does not resolve the issue then download the Litho Companion App on the App Store
    • Make sure you’re on the latest firmware. If you’re not press the Update button
    • If your Litho has the latest firmware installed press the Reset Litho button
    • After updating or resetting the device, please leave your Litho stationary on a table for another 30 seconds
  • If problems persist, please email support@litho.cc with details

back to top

Why does my Litho feel laggy or jittery in the Unity editor or on iPhone?

  • This is most likely a Bluetooth signal strength issue. This can be improved by reducing interference by doing things such as:
    • Disconnecting other Bluetooth devices such as headphones
    • Disconnecting any USB-C adapters as these can cause Bluetooth interference
    • Switching off WiFi and Handoff on Mac
    • Making sure your Litho device is close to the computer or phone
    • Restarting your computer or phone
    • Avoiding using Litho in places with many other 2.4GHz devices e.g conferences

back to top

In a Litho app my pointer doesn’t feel like it’s following my hand

  • Ensure you calibrate your Litho while you’re holding your phone at head height. The Litho must be recalibrate to each individual user
  • Ensure the handedness option (in the menu/ UI) matches the hand you’re holding Litho in
  • Ensure you have scanned the ground plane before calibrating
  • Use your Litho as described in the using Litho video (coming soon)

(General improvements to the quality of our positional tracking in a wider range of scenarios will be released over the following months.)

back to top


Connection

Why is my Litho not connecting?

  • Ensure your Litho is charged
  • Ensure your phone has Bluetooth enabled (check in phone settings)
  • Ensure your phone has permitted the Litho app to access Bluetooth (check in phone app settings)

back to top

Why is my Litho slow to connect on my phone?

  • Disconnect any other Bluetooth devices from your phone
  • Switch off WiFi on your phone
  • Bring your Litho as close to your phone as possible when connecting

back to top

Why is my Litho not on the device selection screen?

  • If the light on your Litho device is on (pulsing slowly)
    • Your Litho is already connected to another app on your phone or computer. To disconnect, completely close any other Litho apps on the phone and make sure no scenes are running in the Unity Editor. If it is still connected, try switching off Bluetooth on your phone and Mac
    • Download the Litho Companion App from the App Store
      • Make sure you’re on the latest firmware. If not, press the ‘update’ button
      • If you’re on the latest firmware press the ‘Reset’ Litho button
  • If the light is off
    • Charge the Litho for at least 60 mins
    • Occasionally the device may take longer to appear on the selection screen. Please wait at least 30 seconds
    • Restart your phone or Mac
    • Download the Litho Companion App on the App Store
      • Make sure you’re on the latest firmware. If you’re not press the Update button.
      • If your Litho has the latest firmware installed press the Reset Litho button.
    • If problems persist, please email support@litho.cc with details

back to top

Why is my Litho slow to connect in the Unity Editor?

  • Macs have a buggy Bluetooth stack, so this connection issue is largely out of our hands. However, some suggesetions that may reduce problems are:
    • Use the Litho emulator for general development - this will mean you don’t need to test with Litho hardware as frequently
    • Disconnect other Bluetooth devices such as headphones
    • Disconnect any USB-C adapters, as these can cause Bluetooth interference
    • Switch off WiFi and Handoff on Mac
    • Make sure your Litho device is close to the computer
    • Restart your computer or phone

back to top


AR

My AR planes are being slow to be discovered or my AR tracking is unreliable

(Welcome to mobile AR!)

  • Tips for improving AR tracking:
    • Cleaning the lens of your phone camera
    • Make sure your environment is well-lit
    • Avoid pointing your camera at reflective surfaces
    • Move your phone camera slowly (avoid sudden or large movements)
    • Ensure you are in a stationary environment (AR tracking will not work in moving vehicles, elevators, etc.)
  • AR Tracking is generally getting better with each new generation of mobile phones, so you may benefit from upgrading your device - refer to your mobile phone retailer for advice on AR suitability of devices

back to top


Development

Unity Editor crashes when pressing play

  • Make sure you’re using the correct software versions (Unity Editor, ARFoundation, ARKit, ARCore)
  • If you are using the correct software versions, please report this bug to support@litho.cc

back to top

I have Unity build errors

  • Make sure to use the exact versions of software (Unity Editor, ARFoundation, ARKit, ARCore) specified in the getting started instructions
  • Even small differences in version number can lead to build errors

back to top

I have Xcode build errors

  • If it relates to ‘bitcode’, please disable bitcode in Xcode by going to your project’s Build Settings in Xcode, searching for bitcode, and setting the corresponding flag to ‘False’
  • If it relates to architecture, please ensure that you have selected ARM64 architecture in Unity build settings
  • If it relates to signing, please read this guide on getting started with iOS code signing
  • If it relates to permissions, ensure you have filled in a Camera Usage Description in the Project Settings in Unity, then rebuild your project

back to top


Hardware

Why is my Litho not charging?

Litho will display an animation on the LEDs when the device is charging. When fully charged, all LEDs will remain solidly lit. If the LED animation is not playing, try checking the following:

  • Ensure that the Litho is not connected to an app via Bluetooth
  • Ensure the cable you are using is fully plugged into a power outlet (check for loose connection)
  • Ensure the cable you are using is fully plugged into your Litho (check for loose connection)
  • Ensure the power outlet is switched on
  • If using a portable charger, ensure that it has charge remaining and is powered on
  • Some portable chargers will switch off automatically when the charge current is low - because of the smaller battery in a Litho, the charge current will be much lower than a mobile phone, and so these power banks cannot be used to charge your Litho

back to top

Why is my trackpad or haptic motor behaving erratically?

  • Leave your Litho on a non-conductive surface for 30 seconds
  • Disconnect and reconnect to the device
  • If you still have issues:
    • Download the Litho Companion App on the App Store
    • Make sure you’re on the latest firmware. If you’re not press the Update button

back to top

Why is my Litho’s battery life so short (e.g. under 3 hours)?

  • Excessive use of the haptic motor will discharge the battery quickly. If using haptics within your app, try to avoid effects which play for more than a second, especially if they are played on a regular basis
  • Make sure to disconnect the device from your phone when not in use. This can be done by completely closing the app using Litho or by disabling Bluetooth on your phone
  • If you still have issues, make sure you’re on the latest firmware:
    • Download the Litho Companion App on the App Store
    • Make sure you’re on the latest firmware. If you’re not press the Update button

back to top


I think I have another hardware issue…

Please email support@litho.cc and someone from the Litho team will get back to you soon