bug #397: update documentation

Author: FabienDanieau

docs/troubleshooting.md

@@ -1,29 +1,36 @@
 # Troubleshooting
 
+
 ## No Microphone Input
 *For beta only*
 
-There is a known issue where the microphone may not initialize correctly. The best way to resolve this is to reboot the microphone array using [xvf_host](https://github.com/respeaker/reSpeaker_XVF3800_USB_4MIC_ARRAY/tree/master/host_control):
+There is a known issue where the microphone may not initialize correctly. You can use the `--fix-audio` argument to force the audio card to reset before starting the daemon.
+
+Make sure your firmware is updated to version 2.1.2. You may need to run the [update script](../src/reachy_mini/assets/firmware/update.sh). Linux users should also install the proper udev rules using [this script](../src/reachy_mini/assets/firmware/install_udev_rules.sh). Then run:
 
 ```bash
-xvf_host(.exe) REBOOT 1
+reachy-mini-daemon --fix-audio
 ```
 
-Then run [examples/debug/sound_record.py](../examples/debug/sound_record.py) to check that everything is working properly.
+Afterwards, run [examples/debug/sound_record.py](../examples/debug/sound_record.py) to check that everything is working properly.
 
 If the problem persists, check the connection of the flex cables ([see slides 45 to 47](https://huggingface.co/spaces/pollen-robotics/Reachy_Mini_Assembly_Guide)).
 
+
 ## Sound Direction of Arrival Not Working
 *For beta only*
 
-The microphone array requires firmware version 2.1.0 or higher to support this feature. The firmware is located in `src/reachy_mini/assets/firmware/*.bin`.
+The microphone array requires firmware version 2.1.0 or higher to support this feature. The firmware files are located in `src/reachy_mini/assets/firmware/*.bin`.
 
 Refer to the [Seeed documentation](https://wiki.seeedstudio.com/respeaker_xvf3800_introduction/#update-firmware) for the upgrade process.
 
+A [helper script](../src/reachy_mini/assets/firmware/update.sh) is available for Unix users.
+
+
 ## Volume Is Too Low
 *Linux only*
 
-Check with `alsamixer` that PCM1 is set to 100%. Then use PCM,0 to adjust the volume.
+Check in `alsamixer` that PCM1 is set to 100%. Then use PCM,0 to adjust the volume.
 
 To make this change permanent:
 ```bash
@@ -32,6 +39,7 @@ amixer -c "$CARD" set PCM,1 100%
 sudo alsactl store "$CARD"
 ```
 
+
 ## Circular Buffer Overrun Warning
 
 When starting a client with `with ReachyMini() as mini:` in Mujoco (--sim mode), you may see the following warning: