docs/Linux_based_host/Troubleshoot.md

   1 # Troubleshoot Instructions
   2 ## 1. Host fails to detect SDIO ESP peripheral
   3 1. Make sure to use ESP32 wrover kit. If you are using a different ESP32 module, please check [SDIO pull up requirements](https://docs.espressif.com/projects/esp-idf/en/latest/esp32/api-reference/peripherals/sd_pullup_requirements.html)
   4 2. Recheck jumper cable connections. Try to use cables that are smaller in length(less than 10 cm should work).
   5 3. Make sure that driver module is loaded.
   6 ```
   7 $ sudo lsmod | grep esp32
   8 esp32                  28672  0
   9 ```
  10 4. Check if host could perform sdio level enumeration. Assuming ESP32 gets detected as mmc1, execute following and check the output.
  11 ```
  12 $ sudo cat /sys/devices/platform/soc/fe300000.mmc/mmc_host/mmc1/mmc1\:0001/mmc1\:0001\:1/uevent
  13 SDIO_CLASS=00
  14 SDIO_ID=6666:2222
  15 MODALIAS=sdio:c00v6666d2222
  16 ```
  17 5. In case issue persists, collect and send following logs to Espressif support.
  18 * dmesg log on host
  19 * Output of above mentioned commands
  20 * ESP console log
  21
  22 ## 2. Network interfaces are not seen on host
  23 Network interfaces are by default in down state. Execute `ifconfig -a` to see those.
  24 In case issue persists, collect and send following logs to Espressif support.
  25 * dmesg log on host
  26 * Output of above mentioned commands
  27 * ESP console log
  28
  29 ## 3. WLAN datapath does not work
  30 1. Check ESP console log for wlan disconnect event. For reconnection, execute provided python script.
  31 2. Execute `route -n` command on host and verify that appropriate routes are configured.
  32 3. In case issue persists, collect and send following logs to Espressif support.
  33 * dmesg log on host
  34 * Output of above mentioned commands
  35 * ESP console log
  36 * WLAN air capture log
  37
  38 ## 4. Bluetooth does not work
  39 1. Make sure that bluetooth is not blocked on host
  40 ```
  41 $ sudo rfkill list
  42 1: hci0: Bluetooth
  43     Soft blocked: no
  44     Hard blocked: no
  45 ```
  46 2. Execute `hciconfig` command to ensure that device is detected and initialized properly
  47 3. User permissions
  48 ```sh
  49 $ sudo usermod -G bluetooth -a pi
  50 ```
  51
  52 4. Reinstall bluetooth software
  53 ```sh
  54 $ sudo apt remove bluez bluez-firmware pi-bluetooth
  55 $ sudo apt install bluez bluez-firmware pi-bluetooth
  56 ```
  57
  58 5. Restart bluetooth service
  59 ```sh
  60 $ sudo systemctl restart bluetooth
  61 $ sudo systemctl status bluetooth
  62 ```
  63
  64 6. In case issue persists, collect and send following logs to Espressif support.
  65 * dmesg log on host
  66 * Output of above mentioned commands
  67 * ESP console log
  68 * hcidump log (`hcidump -X -t`)
  69
  70 ## 5. Unknown symbol error while executing rpi_init.sh
  71 If user gets below dmesg log
  72 ```
  73 [11827.359298] esp32_sdio: Unknown symbol sdio_release_host (err 0)
  74 [11827.359308] esp32_sdio: Unknown symbol sdio_disable_func (err 0)
  75 [11827.359322] esp32_sdio: Unknown symbol sdio_claim_host (err 0)
  76 [11827.359326] esp32_sdio: Unknown symbol sdio_memcpy_fromio (err 0)
  77 [11827.359337] esp32_sdio: Unknown symbol sdio_register_driver (err 0)
  78 [11827.359357] esp32_sdio: Unknown symbol sdio_memcpy_toio (err 0)
  79 [11827.359368] esp32_sdio: Unknown symbol sdio_release_irq (err 0)
  80 [11827.359373] esp32_sdio: Unknown symbol sdio_unregister_driver (err 0)
  81 [11827.359402] esp32_sdio: Unknown symbol sdio_claim_irq (err 0)
  82 [11827.359406] esp32_sdio: Unknown symbol sdio_enable_func (err 0)
  83 [11827.359417] esp32_sdio: Unknown symbol sdio_readb (err 0)
  84 [11827.359421] esp32_sdio: Unknown symbol sdio_writeb (err 0)
  85 ```
  86 It indicates sdhci is not compiled as a part of kernel.
  87 Run below command before execution of rpi_init.sh
  88 ```
  89 sudo modprobe sdhci
  90 ```