[Из песочницы] Бюджетный отладчик к ESP-32 и его настройка
Что из этого вышло — читайте под катом. Недавно при написании библиотеки к ESP-32 возникла необходимость ловить дедлоки, которые возникали иногда из-за моей криворукости, что породило необходимость покупки платы-отладчика с интерфейсом JTAG.
Приборы и материалы
Наша главная героиня, а точнее — цель отладки:
Ссылку не дам, т. Плата на основе чипа ESP-WROOM-32. в том месте уже всё раскупили. к.
Теперь — сама плата отладки:
CJMCU FT232H
вместе с доставкой ePacket. Не заморачивался и заказал на алиэкспрессе за 740,08 руб. Плата приходит с неприпаянными ногами, что нам только на руку, поскольку они нам не нужны.
Набор проводов, 6 шт.: один конец паять, другой — к ESP-32.
Ещё очень рекомендую USB-удлинитель, без него будет туго…
04. Компьютер с (X)Ubuntu 18.
Настройка
Установка OpenOCD для ESP-32
Тут можно смело ссылаться на доки самой esp-idf:
sudo apt-get install make libtool pkg-config autoconf automake texinfo libusb-1.0 libftdi1-2 git
git clone --recursive https://github.com/espressif/openocd-esp32.git # Или скачиваем релиз из https://github.com/espressif/openocd-esp32/releases
cd openocd-esp32
./bootstrap
./configure # Убеждаемся, что FTDI-based adapters включены
make -j6
sudo make install
Отдельно отмечу, что я ставил эту версию OpenOCD в систему (sudo make install
), что неприемлемо, когда у вас разные OpenOCD для разных устройств.
Настройка OpenOCD под нас
Получилось так:
board.cfg: На этом этапе я разделил конфиг для платы отладки и самой ESP-32.
transport select jtag
adapter_khz 20000 # С этим можно поиграться
# set ESP32_ONLYCPU 1 # Только первое ядро
# set ESP32_RTOS none # Убрать поддержку RTOS
source [find target/esp32.cfg]
interface.cfg:
interface ftdi
ftdi_vid_pid 0x0403 0x6014
ftdi_layout_init 0x0c08 0x0f1b
Пишем правило Udev
Это можно исправить одной строчкой правила udev: Из-за проблем с правами мы не сможем получить доступ к USB-устройству.
echo 'SUBSYSTEM=="usb", ATTR=="0403", ATTR{idProduct}=="6014", GROUP="plugdev, MODE="0666"' | sudo tee /etc/udev/rules.d/99-JTAG.rules
sudo systemctl restart udev.service
sudo udevadm control --reload-rules
Вспомогательный скрипт
Кроме всего прочего, весьма удобен скрипт вроде такого:
openocd_command:
#!/bin/bash
echo "$@" | telnet localhost 4444
Но об этом — позже. Он позволит быстро посылать команды напрямую демону OpenOCD.
Подключаем плату CJMCU к ESP-32
Ниже приведена таблица, что к чему подключать и зачем. Тут нам понадобятся провода и паяльник, без этого никак.
Контакт CJMCU
Назначение JTAG
Контакт ESP-32
AD0
TCK
13
AD1
TDI
12
AD2
TDO
15
AD3
TMS
14
+5V
VIN (читать подробно!)
+3.3V
3V3 (читать подробно!)
GND
GND (внезапно)
Про VIN и 3V3
Прошивка при этом будет идти через JTAG, что, как показал личный опыт, гораздо быстрее. Если вы не хотите тянуть от компа отдельный провод к ESP-32 devkit'у, то можно подключить +5V к VIN. Один минус этого варианта — нет возможности смотреть лог UART, но ИМХО отладчик напрочь убирает необходимость сего действия.
Если вам нужно отладить отдельный чип, можно запитаться от преобразователя самого CJMCU, подключив +3. Как заметили в комментариях, на сам ESP-32 подавать 5V нельзя, только на devkit'ы. Но про то, хватит ли мощности преобразователя, ничего не могу сказать, лучше возьмите отдельный источник питания. 3V на нём к 3V3 на ESP-32. 3V одновременно не стоит. И да, подключать 5V и 3.
При этом GND подключать обязательно всегда!
Проверяем OpenOCD
Запускаем OpenOCD так:
openocd -s 'куда вы кидали interface.cfg и board.cfg' -f interface.cfg -f board.cfg
Если всё прошло успешно, вам покажут что-то вроде этого:
Open On-Chip Debugger 0.10.0-dev (2018-08-22-14:47)
Licensed under GNU GPL v2
For bug reports, read http://openocd.org/doc/doxygen/bugs.html
adapter speed: 20000 kHz
esp32 interrupt mask on
Info : ftdi: if you experience problems at higher adapter clocks, try the command "ftdi_tdo_sample_edge falling"
Info : clock speed 20000 kHz
Info : JTAG tap: esp32.cpu0 tap/device found: 0x120034e5 (mfg: 0x272 (Tensilica), part: 0x2003, ver: 0x1)
Info : JTAG tap: esp32.cpu1 tap/device found: 0x120034e5 (mfg: 0x272 (Tensilica), part: 0x2003, ver: 0x1)
Info : esp32: Debug controller was reset (pwrstat=0x5F, after clear 0x0F).
Info : esp32: Core was reset (pwrstat=0x5F, after clear 0x0F).
Info : Detected debug stubs @ 3ffb3134 on core0 of target 'esp32'
cpu0: Current bits set: BreakIn BreakOut RunStallIn
cpu1: Current bits set: BreakIn BreakOut RunStallIn
Это говорит о том, что всё заработало!
Важно: процесс OpenOCD должен крутиться всё время, пока вы заняты отладкой.
Задействуем Eclipse
Тут есть целый ряд шагов, который прекрасно описан в официальной документации, и я их не буду повторять.
Советы по отладке в Eclipse
- Забудьте про кнопку EN аки reset на плате. Перезапуск делайте только через "Terminate and relaunch".
- Для прошивки используйте
openocd_command 'program_esp32 абсолютный_путь/файл.bin 0x10000 verify'
- Вы можете получить не то, что ожидали, после остановки и возобновления. Моя библиотека для воспроизведения звука после этого тараторит как ненормальная из-за приколов с таймером.
Желаю плодотворной отладки (будем честны, приятной она не бывает)! На этом мой текущий опыт работы с данной системой заканчивается.