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
Known Issues
- ST-1297: Structure Sensor 3 will not connect
- ST-1208: Auto Exposure Not Supported
- ST-1285: Confidence Threshold leads to tracking loss
- ST-1403: Structure Sensor 3 Connects but Original Structure Sensor does not
- ST-1093: Excessive Noise
- FW-23: Structure Sensor 3 LED Issues
- ST-1371: While calibrating Structure Sensor 3 the ‘WVL’ detection pane refuses to dismiss
- ST-1375: Calibrator app says ‘Insufficient Sunlight’ but the room is already well lit
- SCX-992: Speckling in scan
ST-1297: Structure Sensor 3 will not connect
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.
ST-1208: Auto Exposure Not Supported
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.
ST-1285: Confidence Threshold leads to tracking loss
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.
ST-1403: Structure Sensor 3 Connects but Original Structure Sensor does not
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.
ST-1093: Excessive Noise
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.
FW-23: Structure Sensor 3 LED 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.
ST-1371: While calibrating Structure Sensor 3 the ‘WVL’ detection pane refuses to dismiss
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:
- Close the app completely (do not simply background it)
- Disconnect the sensor
- Restart the app
- Reconnect the sensor
This should restart video streaming and allow the pane to dismiss normally.
ST-1375: Calibrator app says ‘Insufficient Sunlight’ but the room is already well lit
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:
- If possible, calibrate your sensor outdoors or near a window that receives significant natural light.
- 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.
SCX-992: Speckling in scan
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:
- Updating the Sensor to enable Auto Exposure, which will reduce the amount of IR noise received by the cameras.
- 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.