# Troubleshooting Feelix

{% hint style="danger" %}
The Feelix Mini-Driver board needs to be connected to the external power supply to work properly. The USB port can only be used to download/upload the Arduino code. The motor can **NOT** be powered through the USB port. *Hardware damage may occur.*
{% endhint %}

## General

#### Motor is not behaving as expected

* [ ] Check if the power supply is connected.
* [ ] The motor draws more current than the external power supply can provide.
* [ ] The motor temperature is **very hot**. Wrong settings could be applied to cause this. **Let the motor cool down** before continuing.
* [ ] Make sure the Feelix Mini-Driver is running the [latest code](/downloads/c-library.md#arduino-library-feelix-design-tool): If you are using your own code, please revert to the stock version to verify whether it is still functioning correctly.

#### **Code is not compiling**

* [ ] Check if [**all dependencies**](/uploading-files/simplefoc.md) are installed
* [ ] Check if you have selected the correct board in the Arduino IDE. *Feelix Mini-Driver uses the STM32F401RE*.

#### Feelix Mini-Driver is not recognized

* [ ] Check if your computer recognizes the microcontroller when its connected via USB. In windows this can be verified by the "Device Manager." 
* [ ] Make sure the port is not in use by another program (e.g. Serial monitor of the Arduino IDE).
* [ ] Try the **RESET** button.
* [ ] Check if **STM32CubeProgrammer** is still able to detect the device in **BOOT mode**.
* [ ] It is recommended to use the cable provided.
* [ ] Test it on a different USB port or computer if possible. 

## Feelix - Haptic Design Tool

#### The Feelix Mini-Driver does not connect with the Feelix Haptic Design Tool

* [ ] Make sure the device is in **RUN mode**. The pink colored LED in the Feelix logo should blink periodically
* [ ] Try to restart Feelix in case the microcontroller is recognized by the computer but not by Feelix. Otherwise follow the steps at "Feelix Mini-Driver is not recognized". 

#### Motor is not behaving as expected

* [ ] Try to [recalibrate ](broken://pages/-M3NHh5uT6JPoz0noj15)the motor
* [ ] Make sure the right number of pole-pairs are specified ([see hardware settings](broken://pages/-M3NHh5uT6JPoz0noj15))\
  If not, recalibrate the motor.

#### Motor cursor does not move

* [ ] Check if the magnetic encoder is still working:\
  Upload example code from the [FeelixEffect library](/downloads/c-library.md#arduino-library-for-exported-feelix-effects) to read the encoder value \
  \&#xNAN;*Arduino IDE > examples > Feelix MiniDriver Effects > test > sensor.*
* [ ] If the sensor value is not read, the issue is probably caused by a broken sensor.

#### Feelix is not loading properly

* [ ] ***Issue occured after update?*** Go to 'help' > 'development tools'.
* [ ] Search for 'application' in the development tools.
* [ ] Clear all data.
* [ ] Restart Feelix.

#### If nothing is working..

* [ ] Delete the Feelix Mini-Driver from microcontroller settings window.
* [ ] Restart Feelix Host software.
* [ ] Reconnect to Feelix Mini-Driver.

{% hint style="success" %}
Is your issue not listed here? Report it on github.
{% endhint %}

{% embed url="<https://github.com/ankevanoosterhout/Feelix/issues>" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.feelix.xyz/uploading-files/troubleshoot.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.