Calibrate device

This tutorial shows how to run calibration on Nureva® HDL310 and HDL410 devices over the local network.

What does calibration do?

Nureva audio devices have two types of calibration: automatic calibration and manual calibration. In most cases, there is no need for users to perform any calibration procedures, since each audio device continuously auto-calibrates for optimal audio quality. Learn about automatic calibration.

Manual calibration can be used to quickly optimize the audio performance of a device when the layout of the room changes significantly or the device is moved to a different room. It can also be included in a script to reset the room.

During the calibration sequence, the speaker will generate a signal that sounds similar to static for approximately 20 seconds. Ensure the room is quiet when running calibration.

It is possible but not recommended to calibrate an audio device during a call. Call participants will not be able to hear each other while the calibration is taking place. The microphones and speakers will be temporarily disconnected from the call. The call will resume after calibration is complete.

For more information, see How to calibrate the HDL310 system and How to calibrate the HDL410 system.

Minimum role required: general

The Run Calibration endpoint can be accessed with the general role or any role of a higher level.

Overview

1. Use Run Calibration to make a request to run manual calibration.
2. Check that the request was successful.

Instructions

Step 1 - Make a request to run manual calibration

Use the Calibration endpoint:

1. Set the path with the IP address of the Nureva device followed by /api/v1/audio/calibrate.
2. Update the headers to include Authorization as key and the value being Nureva followed by the authParameters received from the login endpoint.
3. Update the headers to include Nureva-Client-Id as key and integration_app_name as the value.
4. Update the headers to include Nureva-Client-Version as key and 0.0.1 as the value.

curl --request POST \
     --url https://10.0.0.1/api/v1/audio/calibrate \
     --header 'Authorization: Nureva Z2VuZXJhbDo=' \
     --header 'Nureva-Client-Id: integration_app_name' \
     --header 'Nureva-Client-Version: 0.0.1'

5. Send the POST request.

Step 2 - Check that the manual calibration has started

After sending a request to the Calibration endpoint, look at the returned HTTP status code. If the call is successful, an HTTP status code of 200 OK will be returned as a response, with an empty object response body ({}). The speaker will have also generated a signal that sounds similar to static.

✅

Tutorial complete!

You now know how to calibrate a Nureva audio device.