Known Issue Tracker (Bugs, Stability, Crashes)

Structure team members are frequently monitoring the forums, and developer emails for trending issues facing a variety of individuals. We would like to assure members of the community that we are working to resolve the concerns below, part of which is communicating these issues once we know about them.

If you do not see a bug report that you are experiencing, please follow this form to file a bug report.

Reports are investigated typically within 24-72 business hours, and may require further conversation with the reporting individual. While Structure team members are reviewing your bug report we are looking at:

• Is this a known bug
• When was the bug introduced
• Is this bug reproducible
• How does this bug impact the community

Bug Name: iPad Air (M2) 2024 will not calibrate

Status: Resolved

Bug Description: Newer iPads are not yet supported, including the 13-inch iPad Air (M2), 11-inch iPad Air (M2), 13-inch iPad Pro (M4), and 11-inch iPad Pro (M4)

Impacted Hardware/Software: 13-inch iPad Air (M2), 11-inch iPad Air (M2), 13-inch iPad Pro (M4), and 11-inch iPad Pro (M4)

Cause: The Calibrator app needed an update to recognize the 2024 iPad Air (M2).

Solution: Update Calibrator to version 4.4.5. You can find this version here: https://apps.apple.com/us/app/structure-sensor-calibrator/id914275485

Once updated the iPad Air (M2) 2024 will be recognized.

Bug Name: App Displays Black Screen When Using TrueDepth and a 2024 iPad.

Status: Resolved

Bug Description:

While using an iPad made this year (Model year 2024), and an app using the Structure SDK, attempting to use the TrueDepth or LiDar Sensors will show a black screen.

Impacted Hardware/Software: Model Year 2024 iPads.

Cause: The Structure SDK provides positional values for TrueDepth and LiDar sensors. An update is required to add positional values for the 2024 iPads to the SDK.

Progress: A new SDK Update 3.0.3 has been deployed to fix this problem. The app must be updated to included an SDK of this level or greater, and the problem will be resolved.

Bug Name: SCX-393: Structure Sensor Mark II (ST02A) or Structure Sensor Pro (ST02B) Becomes Unresponsive

Status: Resolved

Bug Description:

On occasion Structure Sensor Mark II (ST02A) and Structure Sensor Pro (ST02B) will become unresponsive/hung state when used with a USB-C iPad.

Impacted Hardware/Software: ST02A, ST02B + USB-C iPads

Solution: Update firmware to (1.3.5) via the Structure app. Please note: When the sensor comes out of the unresponsive state, then it may look like it has a solid or rapid flashing red LED light. However, the sensor should recover from this within 3 re-plugs max. Therefore, if you experience a solid or rapid flashing red LED light, then please plug/unplug your sensor up to three times to recover the unresponsive state on ST02 sensors after the firmware update. This is a feature of the firmware update as when the firmware detects that it is stuck, within 8 seconds it will flash the red LED and reset itself.

Bug Name: ST-950: Calibrator: ST01: You can't calibrate ST01 using Indoor Mode

Status: Open

Bug Description: You will not be able to calibrate ST01 using Calibrator

Impacted Hardware/Software: original Structure Sensor (ST01)

Known Workaround: Use Calibrator during the day when it is not cloudy

Bug Name: ST-895: Scanner Sample App : Darkening of the visible frame when performing a second scan

Status: Resolved

Bug Description: In some instances the scan screen will become dark when taking a subsequent scan.

Impacted Hardware/Software: Structure Sensor (Mark II) & Structure Sensor Pro/ Structure Scanner app

Solution: Update to Scanner Sample App - Version 3.0.2 or higher

Bug Name: ST890: Scanner Sample App: Confusing Message Prompt

Status: Under Investigation

Bug Description: If a user opens the app and is not connected to Wifi the app tells the user they need a license instead of notifying them to turn wifi on.

Impacted Hardware/Software: Structure Sensor (Mark II) & Structure Sensor Pro/ Structure Scanner app

Known Workaround: Turn the wifi on for the license to activate at least once every 7 days. You may need to restart the app as well.

Bug Name: Persistent Red/Yellow Overlay in Structure Scanner App

Status: Resolved

Bug Description: Scanner Sample app exhibits a bug where the red/yellow overlay image persists on the scanned object even after starting a scan. This overlay obscures the view of the completed scan, making it challenging for users to assess the quality of the captured data. Several customer reports have been received, expressing concern about this issue. Despite the overlay, other app functionalities appear to operate normally.

Impacted Hardware/Software: Structure Sensor (Mark II) & Structure Sensor Pro/ Structure Scanner app

Solution: Update to Scanner Sample App - Version 3.0.1 or higher.

Bug Name:  ST-546: Structure Sensor (ST02A/ST02B) Compatibility with iOS 17.0.x & iOS 17.1

Status: Resolved

Bug Description:  Structure Sensor (ST02A & ST02B) are incompatible with USB-C iPads/iPhones due to an Apple-related issue. 

Impacted Hardware/Software: Structure Sensor (ST02A/ST02B) with iOS 17.0.x & iOS 17.1

Solution:  Update to iOS 17.2 or a newer version.