Kurulum¶
Dört adım. Sıra önemli; özellikle partition scheme atlanmamalı.
1. Arduino IDE¶
Arduino IDE, ESP32'ye kod yazmak ve yüklemek için kullanılan geliştirme ortamı. Probot kodu Arduino C++ ile yazılır; IDE bu kodu derler ve USB üzerinden karta gönderir.
arduino.cc/en/software adresinden 2.x sürümünü indir ve kur. Eski 1.x sürümü kuruluysa kaldır; her ikisi aynı anda açıkken USB port çakışması çıkıyor.
2. ESP32 Kart Desteği¶
Arduino IDE varsayılan olarak yalnızca standart Arduino kartlarını tanır. ESP32 için ayrı bir kart paketi kurulması gerekiyor. Bu paket IDE'ye ESP32'nin nasıl programlanacağını, hangi pinlerin ne anlama geldiğini ve WiFi gibi özelliklerin nasıl kullanılacağını öğretiyor.
IDE'yi aç. Araçlar > Kart Yöneticisi menüsünü aç. Arama kutusuna esp32 yaz. Listede esp32 by Espressif Systems çıkacak; 3.x sürümünü seç ve kur. 2.x API uyumsuzlukları nedeniyle derlenmeyebilir; 3.x önerilir.
Kurulum bitince kart seç: Araçlar > Kart > ESP32 Arduino > ESP32S3 Dev Module
3. Kütüphaneler¶
Kütüphaneler, başkaları tarafından yazılmış ve tekrar kullanılabilen kod parçaları. Probot'un çalışması için iki kütüphane kurulması gerekiyor.
Araçlar > Kütüphane Yöneticisi menüsünü aç.
Adafruit NeoPixel: Arama kutusuna adafruit neopixel yaz ve kur. Probot durum LED'ini bu kütüphane üzerinden sürüyor; kurulu olmazsa derleme başarısız olur.
probot: Arama kutusuna probot yaz ve kur. Kütüphanenin kendisi bu; Arduino Library Manager'da adı tam olarak probot.
4. Partition Scheme¶
Bu ayarı baştan yapmak önerilir
Varsayılan partition yaklaşık 1.3 MB uygulama alanı ayırır. Kütüphane sığar, ama kullanıcı kodu büyüdükçe "Sketch too big" hatasıyla karşılaşılabilir. Huge APP bu alanı yaklaşık 3 MB'a çıkarır; baştan yapılırsa ilerleyen aşamalarda sorun çıkmaz.
Araçlar > Partition Scheme > Huge APP (3MB No OTA)
Neden gerekli?
ESP32'nin içindeki flash bellek bölümlere ayrılır: bir bölüm uygulama koduna, bir bölüm dosya sistemine, bir bölüm OTA güncellemelerine ayrılır. Varsayılan düzende uygulama koduna yaklaşık 1.3 MB ayrılıyor. Probot WiFi yığını, WebSocket sunucusu ve Driver Station arayüzünü doğrudan karta gömdüğü için bu alan yetmiyor. Huge APP düzeni uygulama alanını yaklaşık 3 MB'a çıkarıyor; bunun karşılığında OTA güncelleme özelliği kapatılıyor. Yarışmada OTA gerekmez.
Bu ayar kalıcı mı?
Hayır, Arduino IDE'de sketch'e özgü. Yeni bir sketch açıldığında veya IDE yeniden başlatıldığında varsayılan değere dönebilir. Derleme öncesinde Araçlar menüsünden kontrol edilmeli.
İlk Yükleme¶
Kurulumu doğrulamak için İlk Bakış sayfasındaki minimal kodu aç.
- ESP32'yi USB kablosuyla bilgisayara bağla.
- Araçlar > Port menüsünden kartın portunu seç. (Windows'ta
COM3,COM4gibi. Linux/Mac'te/dev/ttyUSB0veya/dev/cu.usbserial-...) - Kodu derle ve yükle.
- Serial monitörü aç (115200 baud).
[DS ] IP Address: 192.168.4.1gibi bir çıktı görünmeli.
Sorun Giderme¶
| Belirti | En olası sebep | Çözüm |
|---|---|---|
| Port listesi boş | USB kablosu şarj-only | Veri kablosu kullan |
| Port var, yükleme başarısız | CH340/CP210x sürücüsü yok (Windows) | Sürücüyü kur |
| "Sketch too big" | Partition Scheme yanlış | 4. adımı yeniden yap |
#error ... PASSWORD |
Makrolar #include'dan sonra yazılmış |
Makrolar her zaman #include <probot.h>'den önce gelmeli |
| "probot.h: No such file" | probot kütüphanesi kurulmamış |
Kütüphane Yöneticisi'nden kur |
| Yükleme başlayıp takılıyor | Karta bağlı ekstra devre | Devreyi çıkar, çıplak kart dene |
Çalışma zamanı hataları için: Hatalar.