Bələdçilər · 9 dəq oxu

PlatformIO quraşdırılması: VS Code ilə Arduino, ESP32 və Pico bələdçisi

PlatformIO quraşdırılması: VS Code əlavəsi, platformio.ini ilə Uno, ESP32 və Pico təyini, lib_deps ilə kitabxana, yükləmə, serial monitor və IDE-dən keçid.

PlatformIO quraşdırılması VS Code redaktoruna tək bir əlavə qoşmaqla Arduino Uno, ESP32 və Raspberry Pi Pico kimi platalari eyni peşəkar mühitdən proqramlaşdırmağa imkan verir. Qısaca: VS Code-u quraşdır, Extensions sekməsində PlatformIO IDE-ni axtarıb yüklə, ilk açılışda lazımi alətlərin endirilməsini gözlə, sonra PIO Home ekranından platanı seçib yeni layihə yarat. Qalan hər şey platformio.ini adlı kiçik ayar faylında olur: hansı plata, hansı çərçivə (framework), hansı kitabxanalar və hansı serial port sürəti istifadə ediləcək bu faylda yazılır.

Arduino IDE öyrənmək üçün əla alətdir, amma layihə böyüdükcə onun məhdudiyyətlərini hiss edirsən: kodun tamamlanması əsas səviyyədədir, kitabxanalar bütün layihələr üçün ortaqdır, kitabxana yenilənməsi köhnə layihəni poza bilər, plata ayarı da layihə ilə birlikdə saxlanmır. PlatformIO bu problemləri həll edir. Bu bələdçidə quraşdırmanı addım-addım edəcək, ilk layihəni yaradacaq, platformio.ini ilə üç fərqli platanı tək layihədə təyin edəcək, kitabxana əlavə edəcək, kod yükləyib serial monitoru açacaq və mövcud Arduino IDE layihələrini necə köçürəcəyini öyrənəcəksən. Son bölmədə iki aləti qərəzsiz müqayisə edib hansının sənə uyğun olduğuna qərar verməyə kömək edəcəyik.

PlatformIO ilə proqramlaşdırılan Arduino Uno platası
Arduino Uno, ESP32 və Raspberry Pi Pico kimi platalari PlatformIO ilə eyni redaktordan, tək bir ayar faylı ilə proqramlaşdıra bilərsən.

PlatformIO nədir və necə işləyir?

PlatformIO quraşdırılmış sistemlər üçün açıq mənbəli inkişaf ekosistemidir. Onun mərkəzində Python ilə yazılmış PlatformIO Core adlı komanda sətri aləti durur; VS Code əlavəsi bu aləti düymələr, menyular və PIO Home ekranı ilə rahat edir. Layihəni kompilyasiya edəndə PlatformIO əvvəlcə platformio.ini faylını oxuyur, sonra lazımi kompilyatoru (Uno üçün avr-gcc, ESP32 üçün Xtensa alətlər zənciri, Pico üçün arm-none-eabi-gcc), çərçivəni və kitabxanaları öz anbarından endirib kodunu kompilyasiya edir. Bu paketlər yalnız bir dəfə endirilir və istifadəçi qovluğundakı .platformio qovluğunda saxlanır; sonrakı layihələr eyni paketlərdən yenidən istifadə edir. Aşağıdakı anlayışları bilmək faylı oxumağı çox asanlaşdırır:

AnlayışMənasıNümunə
PlatformMikrokontroller ailəsinin kompilyator və yükləmə alətləri paketiatmelavr, espressif32, raspberrypi
Board (plata)Platforma daxilindəki konkret plata; pin xəritəsi, takt tezliyi və yaddaş məlumatıuno, nanoatmega328, esp32dev, pico
Framework (çərçivə)Kodunu üzərində yazdığın proqram infrastrukturuarduino, espidf
Mühit (env)Platforma, plata, çərçivə və əlavə ayarların birlikdə təyin olunduğu bölmə[env:uno]
Kitabxanalib_deps ilə layihəyə əlavə olunan hazır kod paketiadafruit/DHT sensor library
PIO HomeLayihə açma, plata və kitabxana axtarışı ekranıStatus panelindəki ev ikonu

PlatformIO quraşdırılması addım-addım

  1. Visual Studio Code-u rəsmi saytından endirib quraşdır. Windows-da quraşdırma zamanı Add to PATH seçimini işarələmək terminaldan istifadəni asanlaşdırır.
  2. VS Code-u aç və soldakı Extensions sekməsinə toxun ya da Ctrl+Shift+X (macOS-da Cmd+Shift+X) qısayolundan istifadə et.
  3. Axtarış qutusuna PlatformIO IDE yaz və PlatformIO tərəfindən dərc olunan əlavəni Install düyməsi ilə quraşdır. Lazımi C/C++ əlavəsi də avtomatik gəlir.
  4. Sağ altda "Installing PlatformIO Core" bildirişi görünür. İnternet sürətindən asılı olaraq bu addım bir neçə dəqiqə çəkir; bu müddətdə VS Code-u bağlama.
  5. Quraşdırma bitəndə VS Code yenidən başlatmağı istəyir. Yenidən başlatdıqdan sonra sol kənarda PlatformIO ikonu, alt status panelində də ev ikonu görünür.
  6. Ev ikonuna toxunaraq PIO Home ekranını aç. Bu ekran problemsiz görünürsə, quraşdırma tamamlanıb.
Windows istifadəçi adında Azərbaycan hərfləri (ə, ş, ç, ğ, ı, ö, ü kimi) ya da boşluq varsa, PlatformIO-nun alətlər zənciri C:\Users\<ad>\.platformio yolunda problem yarada bilər və kompilyasiya mənasız yol xətaları ilə dayana bilər. Həll sistem mühit dəyişənlərinə PLATFORMIO_CORE_DIR əlavə edib dəyərini C:\platformio kimi yalnız ingilis hərflərindən ibarət qovluq etməkdir. Linux-da quraşdırma xəta verirsə, əvvəlcə python3-venv paketinin quraşdırılı olduğunu yoxla.

İlk layihənin yaradılması və qovluq strukturu

PIO Home-da New Project düyməsinə bas. Açılan pəncərədə layihəyə ad ver (məsələn, blink-uno), Board qutusuna Arduino Uno yazıb siyahıdan seç, Framework olaraq Arduino-nu saxla və yerləşməni müəyyən et. Finish düyməsinə basanda PlatformIO seçdiyin plata üçün lazım olan platforma paketini ilk dəfə endirir; buna görə ilk layihə bir neçə dəqiqə çəkə bilər, sonrakılar isə saniyələr içində açılır. Layihə yarananda VS Code qovluğu açır və bu strukturu görürsən:

Qovluq / faylNə üçün lazımdır?
platformio.iniLayihənin ürəyi: plata, çərçivə, kitabxana və port ayarları
src/Mənbə kodların; proqram main.cpp faylından başlayır
include/Öz başlıq (.h) faylların
lib/Layihəyə məxsus, əllə əlavə etdiyin yerli kitabxanalar (hər biri ayrı alt qovluqda)
test/Vahid testləri (unit test) üçün ayrılmış qovluq
.pio/Kompilyasiya nəticələri və endirilən kitabxanalar; silinsə yenidən yaradılır
.vscode/VS Code və IntelliSense ayarları; avtomatik yaradılır

platformio.ini faylı nədir?

platformio.ini INI formatında sadə mətn faylıdır. Kvadrat mötərizə ilə başlayan hər [env:ad] bölməsi bir kompilyasiya mühitini təyin edir. Arduino IDE-də Tools menyusundan seçdiyin platanı və port sürətini burada mətnlə göstərirsən; beləliklə layihəni başqa kompüterə köçürəndə ya da dostuna verəndə ayarlar da kodla birlikdə gedir. Nöqtəli vergüllə başlayan sətirlər şərhdir. Uno üçün yaradılan fayla serial monitor sürətini əlavə etdikdə fayl belə görünür:

C++ (Arduino IDE)
1; PlatformIO proje ayarları / PlatformIO project settings
2[env:uno]
3platform = atmelavr
4board = uno
5framework = arduino
6; Seri monitör hızı, Serial.begin ile aynı olmalı / Monitor speed, must match Serial.begin
7monitor_speed = 115200
AyarVəzifəsiNümunə dəyər
platformİstifadə olunacaq platforma paketi; versiya da sabitlənə biləratmelavr, [email protected]
boardPlata identifikatoruuno, megaatmega2560, esp32dev, pico
frameworkProqram çərçivəsiarduino
monitor_speedSerial monitor sürəti (defolt 9600)115200
upload_portYükləmə portu (boş buraxılsa avtomatik tapılır)COM5, /dev/ttyUSB0
upload_speedYükləmə baud sürəti (xüsusilə ESP platalarında)921600
lib_depsAvtomatik endiriləcək kitabxanalaradafruit/DHT sensor library@^1.4.4
build_flagsKompilyatora əlavə bayraqlar və makrolar-D LED_PIN=2
monitor_filtersSerial monitor çıxışına tətbiq olunan filtrlərtime, esp32_exception_decoder

İlk kod: main.cpp və Arduino.h fərqi

src qovluğundakı main.cpp faylı Arduino IDE-dəki .ino faylının qarşılığıdır, lakin iki mühüm fərq var. Birincisi, faylın ən başında Arduino.h başlıq faylını əlavə edən #include sətri olmalıdır; Arduino IDE bunu arxa planda özü əlavə edir, PlatformIO etmir. İkincisi, .cpp faylı real C++ qaydalarına tabedir: funksiyanı çağırmazdan əvvəl kompilyator onu tanımalıdır. Arduino IDE funksiya prototiplərini sənin yerinə yaradır; PlatformIO-da isə ya funksiyanı istifadə etməzdən əvvəl təyin edirsən, ya da faylın üstünə birsətirlik prototip yazırsan. Aşağıdakı nümunə Uno, ESP32 və Pico-nun üçündə də işləyən blink proqramıdır:

C++ (Arduino IDE)
1#include <Arduino.h>
2
3// LED_PIN platformio.ini'den gelebilir / LED_PIN may come from platformio.ini
4#ifndef LED_PIN
5#define LED_PIN LED_BUILTIN   // Uno: 13, Pico: GP25
6#endif
7
8void blinkLed(int count);     // prototip / prototype
9
10void setup() {
11  Serial.begin(115200);
12  pinMode(LED_PIN, OUTPUT);
13  Serial.println("PlatformIO hazir / ready");
14}
15
16void loop() {
17  blinkLed(3);
18  delay(1000);
19}
20
21void blinkLed(int count) {
22  for (int i = 0; i < count; i++) {
23    digitalWrite(LED_PIN, HIGH);
24    delay(150);
25    digitalWrite(LED_PIN, LOW);
26    delay(150);
27  }
28  Serial.print("Yanip sondu / Blinked: ");
29  Serial.println(count);
30}
Kompilyasiyada 'blinkLed' was not declared in this scope xətasını görsən, çatışmayan şey demək olar ki, həmişə prototipdir. Funksiyanın ilk sətrini gövdəsiz, sonuna nöqtəli vergül qoyaraq setup()-ın üstünə köçürmək kifayətdir. Çoxlu funksiyan varsa, onları include qovluğundakı .h faylında toplamaq daha səliqəlidir.

Kompilyasiya, yükləmə və serial monitor

ƏməliyyatStatus paneli / menyuTerminal komandası
Kompilyasiya et (Build)Qeyd işarəsipio run
Yüklə (Upload)Sağa oxpio run -t upload
Yüklə və monitoru açPlatformIO menyusu > Upload and Monitorpio run -t upload -t monitor
Serial monitorFiş ikonupio device monitor
TəmizləZibil qutusupio run -t clean
Portları siyahılaPIO Home > Devicespio device list
Konkret mühiti kompilyasiya etMühit seçicisi (env:...)pio run -e esp32dev
Kitabxana quraşdırPIO Home > Librariespio pkg install -l "adafruit/DHT sensor library"

Serial monitorun düzgün işləməsi üçün platformio.ini-dəki monitor_speed dəyəri koddakı Serial.begin() sürəti ilə eyni olmalıdır; əks halda ekranda mənasız simvollar görürsən. PlatformIO qoşulu platanı adətən özü tapır, lakin kompüterdə bir neçə serial cihaz varsa, yanlış porta yükləməyə cəhd edə bilər. Bu halda pio device list komandası ilə portları siyahıla və düzgün olanı upload_port və monitor_port sətirlərinə yaz. Arduino IDE-nin serial monitoru ya da başqa terminal proqramı portu açıq saxlayırsa, yükləmə "Access is denied" ya da "Resource busy" xətası ilə dayanır; həmin proqramı bağlamaq kifayətdir. Serial monitorun özünü daha yaxşı tanımaq üçün Arduino Serial Monitor yazısına da nəzər sala bilərsən. pio komandası PlatformIO menyusundan açılan PlatformIO Core CLI terminalında həmişə işləyir.

Uno, ESP32 və Pico-nu tək layihədə təyin etmək

PlatformIO-nun ən güclü tərəflərindən biri eyni kodu bir neçə plata üçün kompilyasiya edə bilməsidir. Hər plata üçün ayrıca [env:...] bölməsi yazırsan; ortaq ayarları adsız [env] bölməsinə qoysan, bütün mühitlər onları miras alır. Aşağıdakı cədvəl üç məşhur platanın əsas dəyərlərini ümumiləşdirir:

DəyərArduino UnoESP32 DevKitRaspberry Pi Pico
platformatmelavrespressif32raspberrypi
boardunoesp32devpico
frameworkarduinoarduinoarduino (Arduino Mbed nüvəsi)
Daxili LEDD13GPIO 2 (əksər DevKit platalarında)GP25
Yükləmə üsuluUSB-serial və bootloaderUSB-serial və esptoolUSB və BOOTSEL rejimi
Tipik monitor_speed9600 ya da 115200115200115200
C++ (Arduino IDE)
1[platformio]
2; Varsayılan ortam / Default environment
3default_envs = uno
4
5; Tüm ortamlarda ortak ayarlar / Settings shared by all environments
6[env]
7framework = arduino
8monitor_speed = 115200
9
10[env:uno]
11platform = atmelavr
12board = uno
13
14[env:esp32dev]
15platform = espressif32
16board = esp32dev
17upload_speed = 921600
18monitor_filters = esp32_exception_decoder
19; Dahili LED GPIO 2 / Onboard LED on GPIO 2
20build_flags = -D LED_PIN=2
21
22[env:pico]
23platform = raspberrypi
24board = pico

default_envs sətri status panelindəki kompilyasiya və yükləmə düymələrinin hansı mühitdən istifadə edəcəyini müəyyən edir; bu sətri yazmasan, PlatformIO fayldakı bütün mühitləri ardıcıl kompilyasiya edir. Status panelindəki mühit seçicisindən anındaca başqa platanya keçə bilər ya da terminalda pio run -e esp32dev -t upload yazaraq birbaşa ESP32-yə yükləyə bilərsən. ESP32 mühitindəki -D LED_PIN=2 bayrağı koddakı LED_PIN makrosunu təyin edir; Uno və Pico-da bu bayraq olmadığı üçün kod LED_BUILTIN dəyərinə (13 və 25) keçir. Beləliklə, tək main.cpp üç platada da heç bir dəyişiklik etmədən işləyir. Platalarin pin yerləşməsini tez görmək üçün pinout alətindən istifadə edə bilərsən.

ESP32 üçün PlatformIO ayarları

ESP32 platalari Arduino IDE-də olduğu kimi PlatformIO-da da esptool ilə yüklənir. upload_speed = 921600 yükləmə müddətini nəzərəçarpacaq dərəcədə qısaldır; naqilin uzun ya da keyfiyyətsizdirsə və xəta alırsansa, 460800 ya da 115200 dəyərinə endir. esp32_exception_decoder filtri plata çökəndə serial monitorda çıxan mənasız ünvan yığınını funksiya adlarına və sətir nömrələrinə çevirir; Guru Meditation xətalarını tapmaq üçün çox qiymətlidir. Yükləmə "Connecting..." mərhələsində ilişirsə, platadakı BOOT düyməsini basılı saxla, yükləmə başlayanda burax; ətraflı həllər ESP32 Failed to Connect yazısındadır. Bilməli olduğun bir təfərrüat da nüvə versiyasıdır: PlatformIO-nun rəsmi espressif32 platforması uzun müddət Arduino-ESP32 nüvəsinin 2.x versiyasından istifadə etdi; 3.x-ə məxsus API-lərə ehtiyacın varsa, icmanın dəstəklədiyi pioarduino platformasına keçə bilərsən. Hansı nüvənin istifadə olunduğunu kompilyasiya çıxışının əvvəlindəki PACKAGES sətrində framework-arduinoespressif32 versiyasından görürsən. Kodunun hər iki versiyada kompilyasiya olunmasını istəyirsənsə, ESP_ARDUINO_VERSION_MAJOR makrosu ilə fərqləndirə bilərsən.

Raspberry Pi Pico və PlatformIO

Rəsmi raspberrypi platforması board = pico ayarı ilə Arduino-nun rəsmi Mbed OS əsaslı RP2040 nüvəsindən istifadə edir. Bir çox istifadəçi isə daha çox imkan və kitabxana uyğunluğu təklif edən Earle Philhower-in arduino-pico nüvəsinə üstünlük verir; bu nüvə PlatformIO-da icma tərəfindən dəstəklənən ayrıca platforma paketi və board_build.core = earlephilhower ayarı ilə istifadə olunur. Hansı nüvəni seçsən də, ilk yükləmədə Pico-nu BOOTSEL düyməsini basılı saxlayaraq USB-yə qoşmalı ola bilərsən; plata kompüterdə RPI-RP2 adlı sürücü kimi görünür, PlatformIO proqramı yüklədikdən sonra isə özü yenidən başlayır. Sonrakı yükləmələrdə çox vaxt düymə lazım olmur. Mühüm qeyd: PlatformIO MicroPython-u dəstəkləmir. Pico-nu MicroPython ilə proqramlaşdırmaq istəyirsənsə, Thonny kimi redaktordan istifadə etməlisən; ətraflı məlumat üçün MicroPython əsasları və Raspberry Pi Pico nədir? yazılarına bax.

Kitabxana əlavə etmə: lib_deps

PlatformIO-da kitabxanalar bütün kompüter üçün deyil, hər layihə üçün ayrıca quraşdırılır. Ən təmiz üsul platformio.ini-yə lib_deps sətri əlavə etməkdir: ilk kompilyasiyada PlatformIO kitabxananı reyestrdən (registry) endirir və .pio/libdeps/ qovluğuna qoyur. Kitabxananın tam adını PIO Home-dakı Libraries sekməsində axtarıb Add to Project düyməsi ilə də əlavə edə bilərsən; bu düymə lib_deps sətrini sənin yerinə yazır. Aşağıda DHT11 sensorunu Uno-nun D2 pininə qoşan nümunə var; sensorun naqil bağlantısı üçün DHT11 temperatur və rütubət sensoru yazısına baxa bilərsən.

C++ (Arduino IDE)
1[env:uno]
2platform = atmelavr
3board = uno
4framework = arduino
5monitor_speed = 115200
6; Kütüphaneler ilk derlemede otomatik iner / Libraries download on first build
7lib_deps =
8    adafruit/DHT sensor library@^1.4.4
9    adafruit/Adafruit Unified Sensor@^1.1.9
C++ (Arduino IDE)
1#include <Arduino.h>
2#include <DHT.h>
3
4#define DHT_PIN 2        // Uno D2 pini / Uno pin D2
5#define DHT_TYPE DHT11
6
7DHT dht(DHT_PIN, DHT_TYPE);
8
9void setup() {
10  Serial.begin(115200);
11  dht.begin();
12}
13
14void loop() {
15  delay(2000);                        // DHT11 en fazla 1 Hz / DHT11 max 1 Hz
16  float h = dht.readHumidity();
17  float t = dht.readTemperature();
18  if (isnan(h) || isnan(t)) {
19    Serial.println("Sensor okunamadi / Read failed");
20    return;
21  }
22  Serial.print("Sicaklik / Temp: ");
23  Serial.print(t, 1);
24  Serial.print(" C  Nem / Hum: ");
25  Serial.print(h, 0);
26  Serial.println(" %");
27}

Versiya yazılışında ^1.4.4 1.4.4 və yuxarı, lakin 2.0.0-dan kiçik versiyalara icazə verir; ~1.4.4 yalnız 1.4.x yamalarını qəbul edir; sadəcə 1.4.4 yazsan, versiya tamamilə sabitlənir. Versiyanı sabitləmək bir il sonra layihəni açanda eyni kodun eyni cür kompilyasiya olunmasını təmin edir. Reyestrdə olmayan ya da özünün yazdığın kitabxananı layihənin lib qovluğuna öz adı ilə alt qovluq kimi qoysan, PlatformIO onu avtomatik tapır. Arduino IDE-dəki kitabxana məntiqi ilə müqayisə etmək istəsən, Arduino kitabxana əlavə etmə yazısını oxuya bilərsən.

Arduino IDE-dən PlatformIO-ya layihə köçürmə

  1. PIO Home-da yeni layihə yarat və Arduino IDE-də istifadə etdiyin platanın eynisini seç.
  2. .ino faylının məzmununu src/main.cpp faylına yapışdır; eyni qovluqdakı digər .ino sekmələrini main.cpp-nin sonuna əlavə et, .h və .cpp fayllarını isə src qovluğuna kopyala.
  3. Faylın ən üstünə Arduino.h üçün #include sətrini əlavə et.
  4. setup() və loop()-dan başqa yazdığın hər funksiya üçün faylın yuxarı hissəsinə prototip yaz.
  5. İstifadə etdiyin kitabxanaları PIO Home > Libraries üzərindən tapıb lib_deps-ə əlavə et; Arduino IDE-dəki versiya nömrəsini yazsan, eyni davranışı əldə edirsən.
  6. Serial.begin() sürətini monitor_speed sətrinə yaz və layihəni kompilyasiya et. Xəta siyahısında qalan xəbərdarlıqları bir-bir düzəlt.

Alternativ olaraq PIO Home-dakı Import Arduino Project düyməsi ilə mövcud qovluğu birbaşa idxal edə bilərsən. PlatformIO src qovluğundakı .ino fayllarını kompilyasiya zamanı özü .cpp-yə çevirir və prototipləri yaratmağa çalışır. Lakin bu çevirmə mürəkkəb kodlarda yanıla bildiyi və IntelliSense .ino fayllarında tam səmərəli işləmədiyi üçün uzunmüddətli perspektivdə main.cpp-yə keçmək daha sağlamdır. Kompilyasiya mesajlarını şərh etməkdə çətinlik çəksən, Arduino kompilyasiya xətaları yazısındakı izahlar PlatformIO üçün də keçərlidir.

Arduino IDE, yoxsa PlatformIO?

XüsusiyyətArduino IDE 2.xPlatformIO (VS Code)
QuraşdırmaTək paket, bir neçə dəqiqəVS Code və əlavə; ilk quraşdırmada alətlər endirilir
Kodun tamamlanmasıƏsas səviyyədəQabaqcıl IntelliSense, tərifə keçid, kütləvi adın dəyişdirilməsi
Plata ayarıTools menyusunda, layihə ilə saxlanmırplatformio.ini daxilində, layihə ilə birlikdə köçür
KitabxanalarBütün kompüter üzrə ortaqHər layihə üçün ayrıca, versiya sabitlənə bilər
Bir neçə plataHər dəfə menyudan dəyişdirilirTək layihədə bir neçə mühit
Fayl strukturu.ino; qovluq adı fayl adı ilə eyni olmalıdırsrc, include, lib; standart .cpp və .h
Funksiya prototipləriAvtomatik yaradılırƏllə yazılır (.ino idxalında avtomatik)
Git ilə versiya izləməMümkündür, amma plata ayarları kənarda qalırAsan; .pio qovluğundan başqa hər şey izlənir
Sazlama və testBəzi platalarda sazlayıcıSazlayıcı (debug probe) və vahid test dəstəyi
Yeni başlayana uyğunluqÇox yüksəkOrta; qısa alışma müddəti tələb edir

Qısacası, ilk LED-ini yandırırsansa ya da bir neçə fayllıq məktəb layihəsi edirsənsə, Arduino IDE kifayətdir və daha az çaşdırıcıdır. Bir neçə plata, çoxfayllı kod, Git ilə versiya izləmə və ya komanda işi söz mövzusudursa, PlatformIO ciddi vaxt qazandırır. İki alət bir-birini istisna etmir; eyni kompüterdə hər ikisindən birlikdə istifadə edə bilərsən. Arduino IDE-ni hələ quraşdırmamısansa, Arduino IDE quraşdırılması yazısından başlaya bilərsən.

Tez-tez edilən səhvlər və həlləri

ƏlamətEhtimal olunan səbəbHəll
'xyz' was not declared in this scopeFunksiya prototipi yoxdurPrototipi setup()-dan əvvəl yaz ya da funksiyanı yuxarı köçür
fatal error: DHT.h: No such file or directoryKitabxana lib_deps-də yoxdur ya da başqa mühitə əlavə olunubKitabxananı düzgün [env] bölməsinə əlavə edib yenidən kompilyasiya et
Serial monitorda mənasız simvollarmonitor_speed ilə Serial.begin() sürəti fərqlidirİki dəyəri bərabərləşdir (məs., 115200)
Plata görünmür, port yoxdurYalnız şarj naqili ya da CH340/CP2102 drayveri çatışmırData naqilindən istifadə et, drayveri quraşdır, pio device list ilə yoxla
Access is denied / Resource busyPort başqa proqramda açıqdırArduino IDE serial monitorunu və digər terminalları bağla
ESP32-də Failed to connect, Wrong boot modePlata yükləmə rejiminə keçmədiBOOT düyməsini basılı saxlayaraq yükləməni başlat
Pico-ya yükləmə başlamırPlata BOOTSEL rejimində deyilBOOTSEL düyməsini basılı saxlayaraq qoş, RPI-RP2 sürücüsünün göründüyünü yoxla
Linux-da Permission denied: /dev/ttyUSB0udev qaydası ya da istifadəçi icazəsi yoxdur99-platformio-udev.rules faylını quraşdır, istifadəçini dialout qrupuna əlavə et
Windows-da kompilyasiya mənasız yol xətaları ilə dayanırİstifadəçi adında Azərbaycan hərfləri ya da boşluq varPLATFORMIO_CORE_DIR ilə nüvə qovluğunu C:\platformio-ya köçür
Quraşdırma Installing PlatformIO Core mərhələsində ilişibİnternet, antivirus ya da Python problemiVS Code-u yenidən başlat, Output > PlatformIO jurnalına bax
IntelliSense bəzən kodu qırmızı dalğalı xətlə işarələyir, amma kompilyasiya uğurlu olur. Bu adətən VS Code-da layihənin alt qovluğunu açdığın ya da indeksin yenilənmədiyi mənasına gəlir. Həmişə platformio.ini faylının olduğu qovluğu aç və komanda palitrasından (Ctrl+Shift+P) PlatformIO: Rebuild IntelliSense Index komandasını işə sal.

PlatformIO ilə sınamalı olduğun ilk layihələr

  • Çoxplatalı blink: Yuxarıdakı üç mühitli layihəni Uno, ESP32 və Pico-ya növbə ilə yükləyərək mühit seçicisinin məntiqini qavra.
  • Vaxt damğalı sensor qeydi: DHT11 məlumatını monitor_filters = time ayarı ilə vaxt göstərilməklə serial monitora yazdır.
  • Wi-Fi veb server: ESP32 veb server layihəsində kodu bir neçə .cpp və .h faylına bölərək səliqəli struktur qur.
  • Simsiz yeniləmə: ESP32 OTA ilə upload_protocol = espota və upload_port sətrinə platanın IP ünvanını yazaraq kodu Wi-Fi üzərindən yüklə.
  • Vəziyyət maşını: Arduino vəziyyət maşını məntiqini ayrıca sinif faylında yazaraq PlatformIO-nun qovluq strukturundan faydalan.
  • Delay-sız zamanlama: millis() ilə bir neçə tapşırığı eyni anda icra edən proqram yaz.

PlatformIO quraşdırılması əvvəlcə Arduino IDE-dən bir az uzun çəksə də, platformio.ini faylı layihənin bütün ayarlarını bir yerdə saxladığı üçün zamanla ən çox vaxt qazandıran alətə çevrilir. Quraşdırmanı bitirdikdən sonra ilk iş olaraq sadə LED layihəsini kompilyasiya edib yüklə, sonra kitabxanalı və çoxplatalı layihələrə keç. BlueGrays tətbiqində LED yandırma, ESP32 və Pico başlanğıc layihələrini, həmçinin DHT11 və HC-SR04 kimi sensor layihələrini addım-addım dövrə sxemi və kodları ilə tapa bilər, bu kodları birbaşa öz PlatformIO layihənə köçürərək sınaya bilərsən.

Tez-tez verilən suallar

PlatformIO pulsuzdurmu?

Bəli. PlatformIO Core və VS Code üçün PlatformIO IDE əlavəsi açıq mənbəlidir və pulsuz istifadə olunur. Hobbi, məktəb və ya kommersiya layihələrində plata təyinləri, kitabxana meneceri, kompilyasiya və yükləmə imkanları üçün heç bir lisenziya haqqı ödəməli deyilsən.

Arduino IDE kodları PlatformIO-da işləyirmi?

İşləyir, çünki framework = arduino seçəndə eyni Arduino nüvəsi və eyni funksiyalar istifadə olunur. Etməli olduğun kodu src/main.cpp faylına köçürüb ən üstə Arduino.h include sətrini əlavə etmək, funksiya prototiplərini yazmaq və istifadə etdiyin kitabxanaları lib_deps-ə əlavə etməkdir.

PlatformIO quraşdırılması niyə bu qədər uzun çəkir?

İlk quraşdırmada PlatformIO Core, Python mühiti və əsas alətlər endirilir; ilk layihədə də seçdiyin platanın kompilyatoru və çərçivəsi endirilir. ESP32 paketləri yüzlərlə meqabayt ola bildiyi üçün bu proses əlaqə sürətindən asılı olaraq 5–15 dəqiqə çəkə bilər. Paketlər bir dəfə endirildikdən sonra sonrakı layihələr sürətlə açılır.

PlatformIO MicroPython-u dəstəkləyirmi?

Xeyr, PlatformIO Arduino və ESP-IDF kimi C/C++ əsaslı çərçivələr üçün nəzərdə tutulub. Raspberry Pi Pico ya da ESP32-ni MicroPython ilə proqramlaşdırmaq istəyirsənsə, Thonny kimi redaktordan istifadə etməlisən. İstəsən, eyni platanı PlatformIO ilə Arduino çərçivəsində də proqramlaşdıra bilərsən.

PlatformIO-da kitabxana necə əlavə olunur?

Ən asan yol PIO Home-da Libraries sekməsini açıb kitabxananı axtarmaq və Add to Project ilə layihəni seçməkdir. Bu əməliyyat platformio.ini-yə lib_deps sətrini əlavə edir və kitabxana ilk kompilyasiyada avtomatik endirilir. Öz kitabxanalarını isə layihənin lib qovluğuna alt qovluq kimi qoya bilərsən.

PlatformIO-da COM port necə seçilir?

PlatformIO qoşulu platanı çox vaxt avtomatik tapır. Bir neçə serial cihaz varsa, status panelindəki port seçicisindən ya da platformio.ini-yə upload_port = COM5 və monitor_port = COM5 sətirlərini yazaraq portu sabitləyə bilərsən. Hansı portların qoşulu olduğunu pio device list komandası ilə görürsən.

Bütün layihələrə bax
LED yandırma
AR-1Başlanğıc

LED yandırma

Elektronikanın ilk salamı: tək bir LED-i yandırıb söndürmək. Arduino LED-i çox qısa fasilələrlə yandırıb söndürür, işıq sürətlə qırpılır.

4.6(200)
1246
ESP32 ilə LED yandırma
ES-1Başlanğıc

ESP32 ilə LED yandırma

ESP32 ilə əsas GPIO çıxışından istifadəni öyrədir. LED-i rəqəmsal pindən yandırıb söndürərək yanıb-sönmə effekti əldə edirik. Arduino UNO-dakı klassik blink layihəsinin ESP32 versiyasıdır; Arduino mühitindəki əsas blink əmrləri eynidir, lakin ESP32-nin pin yerləşməsi və 3,3 V GPIO səviyyələri Arduino UNO-dan fərqlidir.

4.7(37)
108
Raspberry Pi Pico daxili LED-in yanıb-sönməsi (Pico və Pico W)
PI-1Başlanğıc

Raspberry Pi Pico daxili LED-in yanıb-sönməsi (Pico və Pico W)

Raspberry Pi Pico seriyasının açılış layihəsi! Pico-nun üzərindəki yaşıl daxili LED-i yandırıb söndürərək platanın işlədiyini təsdiqləyirik; klassik "Hello World" tipli ilk təcrübə. Xarici komponent lazım deyil, Pico və USB kabeli kifayətdir. Kod MicroPython ilə yazılıb (Raspberry Pi Fondunun rəsmi dəstəklədiyi dil).

5.0(1)
10
DHT11 ilə temperatur və rütubət
AR-55Orta

DHT11 ilə temperatur və rütubət

Otağın neçə dərəcədir, hava rütubətlidir, yoxsa quru? DHT11 sensoru temperaturu və rütubəti ölçür, Arduino da bu dəyərləri iki sətirlik LCD ekrana yazır və bir neçə saniyədən bir yeniləyir.

4.7(47)
83
HC-SR04 ilə məsafə ölçmə (Serial ekran)
AR-27Başlanğıc

HC-SR04 ilə məsafə ölçmə (Serial ekran)

Yarasalar qaranlıqda yolunu necə tapırsa, HC-SR04 sensoru da elə işləyir: eşidə bilmədiyin bir səs göndərir, əks-sədasını dinləyir və qarşısındakı cismin nə qədər uzaqda olduğunu ölçür.

4.6(50)
82
ESP32 daxili LED yandırma
ES-4Başlanğıc

ESP32 daxili LED yandırma

ESP32 DevKit V1 üzərindəki daxili (built-in) göy LED-i yanıb-söndürmək. Heç bir xarici komponent lazım deyil! ESP32 alanda ilk sınamalı layihə. GPIO 2 daxili LED-ə qoşulub.

4.8(29)
54
Raspberry Pi Pico xarici LED-in yanıb-sönməsi (breadboard)
PI-2Başlanğıc

Raspberry Pi Pico xarici LED-in yanıb-sönməsi (breadboard)

Pico-nun daxili LED-indən sonrakı addım: breadboard-a xarici LED qoşub GP14 pini ilə idarə etmək. Bu layihədə Pico-nun istənilən GPIO pinindən çıxış kimi istifadəni, LED-in qütblərini (uzun ayaq = anod/+, qısa ayaq = katod/–) və cərəyanı məhdudlaşdıran rezistorun (220Ω) niyə vacib olduğunu öyrənirsən. Rezistoru qoymasan, LED-ə artıq cərəyan gedər və yana bilər.

4.5(2)
7
ESP32 ilə düymədən LED idarəsi (Push)
ES-2Başlanğıc

ESP32 ilə düymədən LED idarəsi (Push)

Düymə basılı saxlananda LED yanır, buraxılanda sönür. ESP32-nin rəqəmsal giriş pinindən və daxili pull-up rezistorundan necə istifadə olunduğunu göstərir. INPUT_PULLUP rejimi sayəsində xarici rezistor lazım deyil.

4.6(36)
57