Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update imu-calibration.md #274

Open
wants to merge 4 commits into
base: main
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions src/server/imu-calibration.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,12 +30,23 @@ If you have a BMI160 and firmware v0.3.3 or higher, you will need to calibrate y

Optionally, you can perform temperature calibration for BMI160 IMUs, which is a more advanced process but significantly reduces drift:

#### With a 3d printer
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
#### With a 3d printer
#### With a 3d printer

1. Place your trackers in a fridge or freezer for a period of time to cool them down to below 15°C. If you're unsure about the temperature of your trackers, you can check it in the SlimeVR Server when the tracker is turned on.
1. Turn on your trackers and gradually heat them, calibration will automatically begin if the temperature is below 15°C.
- You can use something like a 3D printer bed or a heat gun, but be careful not to overheat your battery or melt your case.
- It is important to not rush this. Temperature calibration should take at least 15 minutes, otherwise you risk having a partial calibration, which can lead to increased drift.
1. The calibration will be complete and automatically saved once the IMU reaches 45°C.

#### With a hairdryer
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
#### With a hairdryer
#### With a hairdryer

1. Place your tracker in a fridge or freezer for a short period of time(about 10 minutes) to cool it down to below 15°C.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
1. Place your tracker in a fridge or freezer for a short period of time(about 10 minutes) to cool it down to below 15°C.
1. Place your tracker in a fridge or freezer for a short period of time (about 10 minutes) to cool it down to below 15°C.

1. Get the tracker out and put it on a stable underground.
- Open the SlimeVR app -> Turn on developer mode -> In home at the bottom-right toggle more info, to see all details about your slime and it's temperature.
Comment on lines +42 to +43
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
1. Get the tracker out and put it on a stable underground.
- Open the SlimeVR app -> Turn on developer mode -> In home at the bottom-right toggle more info, to see all details about your slime and it's temperature.
1. Take the tracker out and put it on a stable surface like a table.
- Open the SlimeVR app -> Turn on developer mode -> One the home tab at the bottom-right, toggle "More info" to see all details about your Slime and it's temperature.

- Turn it on and let it sit until it reaches operating temperatures naturally; Don't use a hairdryer yet! When you put your tracker closer to your computer you can reach a higher temperature quicker.
1. Wait until your tracker's temperature levels out. Warm it up with your hairdryer to around 43°C, do not reach 45°C yet.
1. Let it cool down naturally to operating temperature again.
1. 30 degrees? Airdry it to 46 degrees to squeeze out the last points for your TCAL and let it cool down.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
1. 30 degrees? Airdry it to 46 degrees to squeeze out the last points for your TCAL and let it cool down.
1. Once around 30°C, use the hairdryer to get it to around 46°C to finish measuring the last points for your TCAL, then let it cool down.

1. Check if you did well with the [USB WebUI checking tool](https://ilyasnow.github.io/TCAL-Checker/)

The tracker can be moved around during temperature calibration, but it will not record any data while it's in motion.

It may be difficult to determine how the calibration process is going. Setting `#define BMI160_TEMPCAL_DEBUG` to true in the `defines_bmi160.h` file in the firmware exposes more information about the process, replacing the regular temperature readout with temperature calibration debug info in the SlimeVR Server.
Expand Down