Known Issues Tracker (Bugs, Stability, Crashes) - Structure Sensor 3 (ST03)

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: Structure Sensor 3 will not connect

Status: Open

Description: Despite Structure Sensor 3 Connecting to the iPad, and displaying a blue light (showing a connection), Sensor will not connect to the app.

Impacted Hardware/Software: SDK 3.1, Structure Sensor 3. 

Cause: Structure Sensor 3 features a new chipset, and in some circumstances the connection protocol to that chipset is disrupted. 

Solution: A full fix is being worked on. In the short term, unplugging Structure Sensor 3, closing all apps, restarting the app, then plugging the sensor back in, will clear the issue. 

Bug Name: Auto Exposure Not Supported

Status: Ongoing

Description: IR Cameras can sometimes produce bright or washed scenes

Impacted Hardware/Software: SDK 3.1, Structure Sensor 3. 

Cause: Auto Exposure is currently being implemented into SDK 3.1, without Auto Exposure the Sensor defaults to the max exposure.

Solution: A fix is being prepared for SDK 3.1. In the short term, simply set exposure to 15ms or less. 

Bug Name: Confidence Threshold leads to tracking loss

Status: Resolved

Description: When setting confidence threshold above 7, tracking losses are common and the mesh produced has holes

Impacted Hardware/Software: SDK 3.1, Structure Sensor 3. 

Cause: Confidence Threshold is a setting that rejects low quality data. If set to strict (above 7), essential data can also be rejected. This includes data used for tracking.

Solution: Simply set Confidence Threshold to 7 or less. 

Bug Name: Structure Sensor 3 Connects but Original Structure Sensor does not

Status: Resolved

Description: An app would work with Structure Sensor Pro/Mark II or Structure Sensor 3, but not Original Structure Sensor

Impacted Hardware/Software: SDK 3.1, Structure Sensor 3. 

Cause: Original Structure Sensor had a different communication protocol than either the Structure Sensor Pro/Mark II or Structure Sensor 3. 

Solution: A workflow was implemented for the user to select their sensor and, depending on selection, turns on support for Structure Sensor Pro/Mark II or Structure Sensor 3, or turns on support for Original Structure Sensor. This can be done with SDK 3.1. Contact developers@structure.io for more information.

Bug Name: Excessive Noise

Status: Open

Description: Feedback may include excessive noise.

Impacted Hardware/Software: SDK 3.1, Structure Sensor 3. 

Solution: Structure Sensor 3’s Firmware and the SDK 3.1 is being refined to remove these issues. 

Status: Ongoing

Description: LED Diagnostic lights are not displaying in the correct pattern

Impacted Hardware/Software: Structure Sensor 3.

Solution: A firmware update is being actively worked on. Once completed, it will be made available through the Structure App. 

Status: Ongoing

Description: When calibrating Structure Sensor 3, the WVL (Wide View Lens) detection popup launches but will not go away/freezes. 

Impacted Hardware/Software: Structure Sensor 3, Structure Sensor Calibrator v 4.5.0

Solution: In the future, Calibrator will be updated to remove the WVL workflow, which will remove the event that triggers the freeze. 

For now, in order to clear the freeze, the app and sensor need to be restarted. Here is how to do that: 

1. Close the app completely (do not simply background it)
2. Disconnect the sensor
3. Restart the app
4. Reconnect the sensor

This should restart video streaming and allow the pane to dismiss normally.

Status: Ongoing

Description: When calibrating Structure Sensor 3, the brightness warning will not dismiss, despite being in a well lit room and/or enabling ‘Indoor Mode’

Impacted Hardware/Software: Structure Sensor 3, Structure Calibrator v 4.5.0

Solution: Structure Sensor 3 works using infrared (IR) light. This means that it needs a good source of IR light when calibrating. But this can present a challenge - modern homes or offices are lit by LED lights, which do not generate enough IR light to calibrate the sensor. 

In previous models, Structure addressed this with an ‘Indoor Mode’ setting that reduced the amount of light needed to calibrate. However, Structure Sensor 3 uses more sensitive cameras than previous Sensors, and as a consequence, Indoor Mode is ineffective.

Structure is working on an update to allow Structure Sensor 3 to calibrate better indoors. In the meantime, try the following: 

1. If possible, calibrate your sensor outdoors or near a window that receives significant natural light. 
2. If the sensor must be calibrated away from a natural light source, use a light source with an incandescent or halogen bulb. Both light sources will provide enough IR light for the Sensor to calibrate. 

Status: Ongoing

Description: Structure Sensor 3 will ‘scan’ particles in the air. These particles may be left over in the processed Scan. 

Impacted Hardware/Software: Structure Sensor 3

Solution: The particle ‘speckling’ effect is caused by the sensitivity of the Structure Sensor 3’s cameras. Structure is working on the following to address this: 

1. Updating the Sensor to enable Auto Exposure, which will reduce the amount of IR noise received by the cameras.
2. Adjust post processing to clean noise more effectively from the final scan.

As a workaround, speckling can be reduced by scanning on a non reflective surface - for example, a gray or dark colored cloth.