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 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ə |
|---|---|---|
| Platform | Mikrokontroller ailəsinin kompilyator və yükləmə alətləri paketi | atmelavr, 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 infrastrukturu | arduino, espidf |
| Mühit (env) | Platforma, plata, çərçivə və əlavə ayarların birlikdə təyin olunduğu bölmə | [env:uno] |
| Kitabxana | lib_deps ilə layihəyə əlavə olunan hazır kod paketi | adafruit/DHT sensor library |
| PIO Home | Layihə açma, plata və kitabxana axtarışı ekranı | Status panelindəki ev ikonu |
PlatformIO quraşdırılması addım-addım
- 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.
- VS Code-u aç və soldakı Extensions sekməsinə toxun ya da Ctrl+Shift+X (macOS-da Cmd+Shift+X) qısayolundan istifadə et.
- 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.
- 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.
- 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.
- Ev ikonuna toxunaraq PIO Home ekranını aç. Bu ekran problemsiz görünürsə, quraşdırma tamamlanıb.
İ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 / fayl | Nə üçün lazımdır? |
|---|---|
| platformio.ini | Layihə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:
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| Ayar | Vəzifəsi | Nümunə dəyər |
|---|---|---|
| platform | İstifadə olunacaq platforma paketi; versiya da sabitlənə bilər | atmelavr, [email protected] |
| board | Plata identifikatoru | uno, megaatmega2560, esp32dev, pico |
| framework | Proqram çərçivəsi | arduino |
| monitor_speed | Serial monitor sürəti (defolt 9600) | 115200 |
| upload_port | Yükləmə portu (boş buraxılsa avtomatik tapılır) | COM5, /dev/ttyUSB0 |
| upload_speed | Yükləmə baud sürəti (xüsusilə ESP platalarında) | 921600 |
| lib_deps | Avtomatik endiriləcək kitabxanalar | adafruit/DHT sensor library@^1.4.4 |
| build_flags | Kompilyatora əlavə bayraqlar və makrolar | -D LED_PIN=2 |
| monitor_filters | Serial monitor çıxışına tətbiq olunan filtrlər | time, 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:
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}Kompilyasiya, yükləmə və serial monitor
| Əməliyyat | Status paneli / menyu | Terminal komandası |
|---|---|---|
| Kompilyasiya et (Build) | Qeyd işarəsi | pio run |
| Yüklə (Upload) | Sağa ox | pio run -t upload |
| Yüklə və monitoru aç | PlatformIO menyusu > Upload and Monitor | pio run -t upload -t monitor |
| Serial monitor | Fiş ikonu | pio device monitor |
| Təmizlə | Zibil qutusu | pio run -t clean |
| Portları siyahıla | PIO Home > Devices | pio device list |
| Konkret mühiti kompilyasiya et | Mühit seçicisi (env:...) | pio run -e esp32dev |
| Kitabxana quraşdır | PIO Home > Libraries | pio 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ər | Arduino Uno | ESP32 DevKit | Raspberry Pi Pico |
|---|---|---|---|
| platform | atmelavr | espressif32 | raspberrypi |
| board | uno | esp32dev | pico |
| framework | arduino | arduino | arduino (Arduino Mbed nüvəsi) |
| Daxili LED | D13 | GPIO 2 (əksər DevKit platalarında) | GP25 |
| Yükləmə üsulu | USB-serial və bootloader | USB-serial və esptool | USB və BOOTSEL rejimi |
| Tipik monitor_speed | 9600 ya da 115200 | 115200 | 115200 |
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 = picodefault_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.
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.91#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ə
- PIO Home-da yeni layihə yarat və Arduino IDE-də istifadə etdiyin platanın eynisini seç.
- .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.
- Faylın ən üstünə Arduino.h üçün #include sətrini əlavə et.
- setup() və loop()-dan başqa yazdığın hər funksiya üçün faylın yuxarı hissəsinə prototip yaz.
- İ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.
- 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ət | Arduino IDE 2.x | PlatformIO (VS Code) |
|---|---|---|
| Quraşdırma | Tə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ır | platformio.ini daxilində, layihə ilə birlikdə köçür |
| Kitabxanalar | Bütün kompüter üzrə ortaq | Hər layihə üçün ayrıca, versiya sabitlənə bilər |
| Bir neçə plata | Hər dəfə menyudan dəyişdirilir | Tək layihədə bir neçə mühit |
| Fayl strukturu | .ino; qovluq adı fayl adı ilə eyni olmalıdır | src, include, lib; standart .cpp və .h |
| Funksiya prototipləri | Avtomatik 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ır | Asan; .pio qovluğundan başqa hər şey izlənir |
| Sazlama və test | Bəzi platalarda sazlayıcı | Sazlayıcı (debug probe) və vahid test dəstəyi |
| Yeni başlayana uyğunluq | Çox yüksək | Orta; 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ət | Ehtimal olunan səbəb | Həll |
|---|---|---|
| 'xyz' was not declared in this scope | Funksiya prototipi yoxdur | Prototipi setup()-dan əvvəl yaz ya da funksiyanı yuxarı köçür |
| fatal error: DHT.h: No such file or directory | Kitabxana lib_deps-də yoxdur ya da başqa mühitə əlavə olunub | Kitabxananı düzgün [env] bölməsinə əlavə edib yenidən kompilyasiya et |
| Serial monitorda mənasız simvollar | monitor_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 yoxdur | Yalnız şarj naqili ya da CH340/CP2102 drayveri çatışmır | Data naqilindən istifadə et, drayveri quraşdır, pio device list ilə yoxla |
| Access is denied / Resource busy | Port başqa proqramda açıqdır | Arduino IDE serial monitorunu və digər terminalları bağla |
| ESP32-də Failed to connect, Wrong boot mode | Plata yükləmə rejiminə keçmədi | BOOT düyməsini basılı saxlayaraq yükləməni başlat |
| Pico-ya yükləmə başlamır | Plata BOOTSEL rejimində deyil | BOOTSEL 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/ttyUSB0 | udev qaydası ya da istifadəçi icazəsi yoxdur | 99-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 var | PLATFORMIO_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 problemi | VS Code-u yenidən başlat, Output > PlatformIO jurnalına bax |
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.
Bu yazıdan sonra edə biləcəyin layihələr
Bütün layihələrə bax
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.

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.

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).

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.

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.

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.

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.

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.
Digər yazılar
BlueGrays tətbiqi
Bu dövrəni telefonunda addım-addım qur
Dövrə sxemi, kod və hissə siyahısı bir ekranda. 500-dən çox Arduino, ESP32 və Pico layihəsi səni gözləyir.
Telefonunla skan et
Kameranı koda tut; telefonunun tətbiq mağazası açılır.
ya da mağazada aç

