Skip to content

Troubleshooting Guide

If you encounter any issues with the UltimateSensor Mini, try the following steps:

General Troubleshooting Steps

  1. Ensure All Cables Are Securely Connected

    • Verify that the USB-C power cable is securely connected to both the UltimateSensor Mini and the power adapter.
  2. Check the Power Source

    • Make sure the power adapter is plugged into a working electrical outlet.
    • Ensure the power cable is not damaged and is functioning properly.
  3. Restart the UltimateSensor Mini

    • Unplug the power cable from the UltimateSensor Mini, wait for 10 seconds, and then plug it back in.
  4. Restart Home Assistant

    • Sometimes a simple restart of Home Assistant can resolve connectivity or integration issues. Navigate to Settings > System > Restart within Home Assistant.
  5. Update Home Assistant

    • Ensure you are running the latest version of Home Assistant. Go to Settings > System > Updates to check for and install any available updates.

WiFi Connectivity Issues

  1. Check WiFi Signal Strength

    • Ensure that the UltimateSensor Mini is within range of your WiFi router. Weak signal strength can cause connectivity issues.
    • If necessary, move the UltimateSensor Mini closer to the router or use a WiFi extender to improve signal strength.
  2. Reconnect to WiFi

    • If the UltimateSensor Mini is not connecting to your WiFi network, try reconnecting:
      1. Power off the UltimateSensor Mini.
      2. Power it back on and connect to the WiFi hotspot named 'ultimatesensor-mini' with the password 'ultimatesensor-mini'.
      3. Follow the on-screen instructions to select and connect to your WiFi network.
  3. Check WiFi Network Configuration

    • Ensure your WiFi network is set to 2.4 GHz, as the UltimateSensor Mini does not support 5 GHz networks.

Data Reading Issues

  1. Sensor Data Not Updating
    • Ensure the sensors are properly installed and positioned.
    • Check for any physical obstructions or interference that might be affecting the sensor readings.

Calibration Issues

  1. Sensor Calibration
    • If the sensor readings seem inaccurate, you may need to calibrate the sensors. Refer to the calibration guide for detailed instructions on how to calibrate each sensor.

Voice Assistant Issues

  1. Voice Assistant Not Working
    • If the voice assistant feature is not working, ensure it has been fully configured. Follow the detailed steps in the voice assistant guide.
    • Check if the microphone and speaker are properly connected and functioning.
    • Verify that the voice assistant settings in Home Assistant are correctly configured.

Speaker issues Crackling or stuttering sound

If you experience crackling or stuttering sound from the speaker, ensure that the device maintains a strong WiFi connection. For optimal performance, consider disabling the wake word detection while streaming music, playing MP3 files, or using text-to-speech functionalities.

LED Indicator Issues

  1. Red Status LED Flashing Slowly

    • Indicates that the sensor is not connected to your WiFi network or Home Assistant server. Follow the steps in the Connect to WiFi section to resolve this issue.
  2. Red Status LED Flashing Rapidly

    • Indicates a startup error. Refer to the complete manual for more detailed troubleshooting steps.

Error '/config/esphome/default_16MB.csv'. ESPHome.

If you get the error Could not find file '/config/esphome/default_16MB.csv'. Please make sure it exists (full path: /config/esphome/default_16MB.csv). then make sure you have the file default_16MB.cvs in the root of your ESPHome folder. You can download the file from our Github repository

Advanced Troubleshooting

  1. Accessing the Web Interface

    • If you are unable to connect the UltimateSensor Mini to your WiFi network, access the fallback web interface by navigating to http://192.168.4.1/ in your browser while connected to the UltimateSensor Mini hotspot.
  2. Firmware Updates

    • Ensure the UltimateSensor Mini is running the latest firmware. Refer to our firmware page for instructions on how to update the firmware.
  3. Factory Reset

    • If all else fails, perform a factory reset on the UltimateSensor Mini. This can be done by reflashing the unit via USB-C. Refer to our firmware page for instructions on how to reflash the latest firmware, which will reset the device back to its original state and remove the saved SSID information.

Additional Resources

By following these steps, you should be able to resolve most issues with your UltimateSensor Mini. If you continue to experience problems, please reach out for further assistance.