Hissələr · 11 dəq oxu

Arduino SD kart modulu: məlumat qeydi, CSV, RTC və xəta həlləri

Arduino SD kart modulu necə qoşulur? SPI pinləri, FAT32 formatlama, CSV məlumat qeydi, RTC zaman damğası, ESP32 SD_MMC, Pico və initialization failed həlli.

Arduino SD kart modulu sensorlardan oxuduğun temperatur, rütubət, məsafə və ya məkan məlumatlarını microSD kartda fayl kimi yadda saxlamağa imkan verən kiçik və ucuz platadır. Kompüterə qoşulu qalmadan günlərlə, hətta aylarla ölçmə aparan məlumat qeydedicisi (datalogger) qurmağın ən asan yolu budur: Arduino ölçür, modul hər ölçməni kartdakı CSV faylına sətir-sətir yazır, sən də kartı kompüterə taxıb məlumatları Excel-də qrafikə çevirirsən. Modul SPI ilə qoşulur və Arduino IDE ilə birgə gələn SD kitabxanası ilə bir neçə sətir kodla işləyir.

Bu bələdçidə modulun necə işlədiyini, 5V və 3.3V modullar arasındakı fərqi, Arduino Uno, Mega, ESP32 və Raspberry Pi Pico üçün SPI qoşulmasını, kartı FAT32 formatlamağı, fayl yazıb oxumağı və RTC modulu ilə tarix-saat damğalı CSV qeydi aparmağı addım-addım öyrənəcəksən. Həmçinin ESP32-nin sürətli SD_MMC interfeysini, Pico-da MicroPython ilə SD kart istifadəsini və ən çox rast gəlinən "initialization failed" xətasının həllərini nəzərdən keçiririk.

Arduino microSD kart modulu
MicroSD kart modulu: kart yuvası, 3,3 V stabilizator, səviyyə çevirici mikrosxem və 6 pin (GND, VCC, MISO, MOSI, SCK, CS).

SD kart modulu nədir, necə işləyir?

SD kartlar 3,3 V ilə işləyir və iki fərqli yolla əlaqə qura bilər: sürətli SD rejimi və daha sadə SPI rejimi. Arduino kimi mikrokontrollerlər kartla SPI üzərindən danışır. Modulun vəzifəsi aradakı elektrik uyğunluğunu təmin etməkdir: üzərindəki stabilizator 5 V-u karta uyğun 3,3 V-a endirir, səviyyə çevirici mikrosxem (çox vaxt 74LVC125A) isə Arduino-nun 5 V-luq siqnallarını kartın dözə biləcəyi 3,3 V-a çevirir. Kartın içi 512 baytlıq bloklardan ibarətdir; fayl, qovluq və fayl adı kimi anlayışları FAT fayl sistemi idarə edir. SD kitabxanası bu mürəkkəb işləri sənin yerinə görür; sən yalnız fayl açır, yazır və bağlayırsan.

XüsusiyyətDəyər
İnterfeysSPI (MISO, MOSI, SCK, CS)
Qida (stabilizatorlu microSD modulu)4,5–5,5 V, platada 3,3 V stabilizator
Siqnal səviyyəsi3,3 V və 5 V ilə uyğun (səviyyə çevirici sayəsində)
Dəstəklənən kartlarmicroSD (2 GB-a qədər) və microSDHC (4–32 GB)
Fayl sistemiFAT16 və ya FAT32
CərəyanGözləmə rejimində bir neçə mA, yazma zamanı 100 mA-ə qədər
Fayl adı (Arduino SD kitabxanası)8.3 formatı: ən çox 8 simvollu ad + 3 simvollu uzantı

5V və 3.3V modul fərqi: hansını almalısan?

Modul növüQidaSiqnal səviyyəsiUyğun olduğu platalar
Stabilizatorlu microSD modulu (74LVC125A-lı)5 V3,3 V və 5 VUno, Nano, Mega; 5 V ilə qidalandırılarsa ESP32 və Pico
Tam ölçülü SD kart modulu (+5 və +3.3 pinli)5 V və ya 3,3 VÇoxunda real səviyyə çevirici yoxdur3,3 V-luq platalar; 5 V siqnalla etibarlılığı aşağıdır
Stabilizatorsuz microSD modulu (yalnız yuva)Yalnız 3,3 VYalnız 3,3 VESP32, Raspberry Pi Pico
Daxili yuvalı platalar (ESP32-CAM kimi)Platadan3,3 VSD_MMC ilə birbaşa istifadə olunur

Arduino Uno, Nano və ya Mega istifadə edirsənsə, şəkildəki kimi stabilizatorlu və səviyyə çeviricili microSD modulunu seç və VCC-ni 5V pininə qoş. ESP32 və Pico 3,3 V ilə işləyir; bu platalarda da eyni modulu istifadə edə bilərsən, amma qidasını yenə 5 V-dan verməlisən (ESP32-də VIN, Pico USB-dən qidalananda VBUS pini). Səviyyə çevirici 3,3 V ilə qidalandığı üçün MISO xəttindən mikrokontrollerə gedən siqnal onsuz da 3,3 V olur. Stabilizatorsuz modullar birbaşa 3V3 pininə qoşulur; bunları 5 V-luq Arduino ilə istifadə etməli olsan, MOSI, SCK və CS xətlərinin hər birinə 1 kΩ + 2 kΩ-luq gərginlik bölücü qoşmalı və ya məntiq səviyyəsi çeviricisi istifadə etməlisən. Rezistor dəyərlərini gərginlik bölücü hesablayıcısı ilə yoxlaya bilərsən.

Ən çox edilən səhv stabilizatorlu microSD modulunu 3,3 V ilə qidalandırmaqdır. Moduldakı AMS1117 stabilizatoru təxminən 1 V düşürdüyü üçün karta 2,3 V civarında gərginlik çatır və kart çox vaxt initialization failed xətası verir. Əksinə, stabilizatorsuz modulun pinlərinə 5 V vermək kartı daimi sıradan çıxara bilər. Qoşmazdan əvvəl modulun üzərindəki yazıları oxu və stabilizatorun olub-olmadığına bax.

SD kart modulunun qoşulması: SPI pinləri

Modul piniArduino Uno / NanoArduino MegaESP32Raspberry Pi Pico
GNDGNDGNDGNDGND
VCC5V5VVIN (5 V)VBUS (5 V)
MISOD12D50GPIO 19GP16
MOSID11D51GPIO 23GP19
SCKD13D52GPIO 18GP18
CSD10D53GPIO 5GP17

MISO, MOSI və SCK hər platada aparat SPI pinlərinə qoşulmalıdır; CS (chip select) isə istənilən rəqəmsal pin ola bilər, təki eyni nömrəni koddakı SD.begin() funksiyasına yaz. Hazır şildlərdə CS adətən D4 və ya D10 olur. Eyni SPI xəttinə bir neçə cihaz qoşa bilərsən: hamısı MISO, MOSI və SCK-ni paylaşır, hər birinin öz CS pini olur. SPI-ın iş məntiqini SPI əlaqəsi yazısında ətraflı izah etdik. Pinlərin platadakı yerini görmək üçün pin diaqramı alətindən istifadə edə bilərsən.

SD kartı hazırlamaq: FAT32 formatlama

  • Kart ölçüsü: 4–32 GB arası microSDHC kart seç. Arduino SD kitabxanası SDSC (2 GB-a qədər) və SDHC kartları dəstəkləyir; 64 GB və yuxarı SDXC kartlar fabrikdən exFAT ilə gəlir və bu kitabxana exFAT oxuya bilmir.
  • Fayl sistemi: Kartı FAT32 kimi formatla (2 GB və aşağı kartlarda FAT16 da olar). NTFS və exFAT işləmir.
  • Windows: File Explorer-də karta sağ klik et, Format seç, fayl sistemi olaraq FAT32-ni və susmaya görə ayırma vahidi ölçüsünü seç. 32 GB-dan böyük kartlarda Windows FAT32 seçimini təklif etmir.
  • macOS: Disk Utility-də kartı seç, Erase düyməsinə toxun, format olaraq MS-DOS (FAT), sxem olaraq Master Boot Record seç.
  • Ən etibarlı yol: SD Association-ın pulsuz SD Card Formatter proqramı kartı standarta uyğun formatlayır və qəribə xətaların çoxunu aradan qaldırır.
  • Tək bölmə: Kartda yalnız bir bölmə (partition) olmalıdır. Əvvəllər Raspberry Pi və ya kamera kimi cihazlarda istifadə olunmuş kartlarda bir neçə bölmə qalmış ola bilər; formatlamazdan əvvəl onları sil.
Arduino Uno-dakı SD kitabxanası yalnız 8.3 formatlı qısa fayl adlarından istifadə edir: ən çox 8 simvollu ad və 3 simvollu uzantı, Azərbaycan hərfləri (ə, ş, ç…) və boşluq olmadan. VERI.CSV və ya LOG01.TXT işləyir; sicaklik-kaydi.csv kimi uzun ad isə SD.open() çağırışının səssizcə uğursuz olmasına səbəb olur. ESP32 və Pico-da uzun fayl adlarından problemsiz istifadə etmək olar.

Addım-addım ilk test: SD karta yazmaq və oxumaq

  1. Formatladığın kartı modula tax və modulu yuxarıdakı cədvələ uyğun Arduino-ya qoş.
  2. SD kitabxanası Arduino IDE ilə birgə gəlir, ayrıca quraşdırmağa ehtiyac yoxdur; kodun əvvəlinə yalnız SPI.h və SD.h əlavə olunur.
  3. Aşağıdakı kodu yüklə və Serial Monitor-u 9600 baud sürətində aç.
  4. "tamam" yazısını (oldu) və faylın məzmununu görürsənsə, kart və qoşulma düzgündür. Arduino hər başlayanda TEST.TXT faylına yeni sətir əlavə olunur.
  5. Kartı çıxarıb kompüterə taxanda TEST.TXT faylını istənilən mətn redaktoru ilə aça bilərsən.
C++ (Arduino IDE)
1#include <SPI.h>
2#include <SD.h>
3
4const int CS_PIN = 10;                           // modülün CS pini / module CS pin
5
6void setup() {
7  Serial.begin(9600);
8  Serial.print(F("SD kart baslatiliyor... "));
9  if (!SD.begin(CS_PIN)) {                       // kart başlatılamadı / card init failed
10    Serial.println(F("initialization failed"));
11    while (true);                                // burada dur / stop here
12  }
13  Serial.println(F("tamam"));
14
15  File dosya = SD.open("TEST.TXT", FILE_WRITE);  // yoksa oluşturur, sona ekler / creates it, appends
16  if (dosya) {
17    dosya.println(F("Merhaba BlueGrays!"));
18    dosya.close();                               // tamponu karta yazar / flushes the buffer to the card
19    Serial.println(F("TEST.TXT yazildi"));
20  } else {
21    Serial.println(F("TEST.TXT acilamadi"));     // dosya açılamadı / could not open file
22  }
23
24  dosya = SD.open("TEST.TXT");                   // okumak için aç / open for reading
25  if (dosya) {
26    Serial.print(F("Boyut (bayt): "));
27    Serial.println(dosya.size());
28    while (dosya.available()) {
29      Serial.write(dosya.read());                // içeriği seri porta yaz / print contents to serial
30    }
31    dosya.close();
32  }
33}
34
35void loop() {
36}
FunksiyaNə edir?
SD.begin(cs)Kartı işə salır; uğurlu olarsa true qaytarır
SD.open("NAME.TXT", FILE_WRITE)Faylı yazmaq üçün açır; yoxdursa yaradır, varsa sonuna əlavə edir
SD.open("NAME.TXT")Faylı oxumaq üçün açır (FILE_READ)
file.print() / println()Fayla mətn və ya rəqəm yazır
file.flush()Buferdəki məlumatı faylı bağlamadan karta yazır
file.close()Qalan məlumatı karta yazır və faylı bağlayır
file.available() / read()Oxunacaq bayt qalıb-qalmadığını yoxlayır / bir bayt oxuyur
SD.exists() / SD.remove() / SD.mkdir()Faylın olub-olmadığını yoxlayır / fayl silir / qovluq yaradır

CSV formatında sensor qeydi və RTC ilə zaman damğası

Datalogger üçün ən praktik fayl formatı CSV-dir (vergüllə ayrılmış dəyərlər): hər sətir bir ölçmə, hər sütun bir dəyərdir və ilk sətirə sütun başlıqları yazılır. Ölçmələrin nə vaxt aparıldığını bilmək üçün hər sətirə tarix və saat əlavə etməlisən. millis() yalnız Arduino işə düşəndən bəri keçən müddəti verir və hər resetdə sıfırlanır; buna görə düymə batareyalı RTC (real vaxt saatı) modulundan istifadə edirik. RTC Arduino söndürülü olanda belə vaxtı saymağa davam edir. DS1307 ucuzdur, amma gündə bir neçə saniyə sürüşə bilər; DS3231 isə temperaturla kompensasiya edilən kristalı sayəsində ildə cəmi təxminən bir dəqiqə sapır. Fərqlərini RTC saat modulları yazısında müqayisə etdik.

DS1307 RTC saat modulu
DS1307 RTC modulu I2C ilə qoşulur (SDA, SCL) və düymə batareyası sayəsində Arduino söndürülü olanda da vaxtı saxlayır.

Dövrə: SD modulu əvvəlki cədvəldəki kimi SPI pinlərinə, RTC modulu I2C xəttinə (Uno-da SDA = A4, SCL = A5, VCC = 5V), DHT22 sensorunun data ucu isə D2-yə qoşulur; çılpaq sensor istifadə edirsənsə, data ucu ilə VCC arasına 10 kΩ-luq rezistor əlavə et. Library Manager-dən RTClib (Adafruit) və DHT sensor library kitabxanalarını quraşdır. Sensorun qoşulması ilə bağlı təfərrüatlar üçün DHT11 və DHT22 temperatur-rütubət sensoru yazısına baxa bilərsən.

C++ (Arduino IDE)
1#include <SPI.h>
2#include <SD.h>
3#include <Wire.h>
4#include <RTClib.h>
5#include <DHT.h>
6
7const int CS_PIN = 10;                           // SD modülü CS / SD module CS
8const unsigned long ARALIK = 10000;              // 10 saniyede bir kayıt / log every 10 seconds
9
10RTC_DS1307 rtc;                                  // DS3231 için RTC_DS3231 / RTC_DS3231 for a DS3231
11DHT dht(2, DHT22);                               // veri pini D2, DHT11 de olur / data pin D2, DHT11 also works
12unsigned long sonKayit = 0;
13
14void setup() {
15  Serial.begin(9600);
16  dht.begin();
17  if (!rtc.begin()) {
18    Serial.println(F("RTC bulunamadi"));         // RTC yok / RTC not found
19    while (true);
20  }
21  if (!rtc.isrunning()) {                        // saat hiç kurulmamış / clock never set
22    rtc.adjust(DateTime(F(__DATE__), F(__TIME__)));  // derleme anına kur / set to compile time
23  }
24  if (!SD.begin(CS_PIN)) {
25    Serial.println(F("SD kart hatasi"));         // SD başlatılamadı / SD init failed
26    while (true);
27  }
28  if (!SD.exists("VERI.CSV")) {                  // yeni dosyaya başlık satırı / header row for a new file
29    File f = SD.open("VERI.CSV", FILE_WRITE);
30    if (f) {
31      f.println(F("tarih,saat,sicaklik_C,nem_yuzde"));
32      f.close();
33    }
34  }
35}
36
37void loop() {
38  if (millis() - sonKayit < ARALIK) return;      // zamanı gelmedi / not time yet
39  sonKayit = millis();
40
41  float t = dht.readTemperature();
42  float h = dht.readHumidity();
43  if (isnan(t) || isnan(h)) {                    // sensör okunamadı / sensor read failed
44    Serial.println(F("DHT okuma hatasi"));
45    return;
46  }
47
48  DateTime simdi = rtc.now();
49  char ts[8], hs[8], satir[48];
50  dtostrf(t, 1, 1, ts);                          // AVR'de sprintf %f desteklemez / AVR sprintf has no %f
51  dtostrf(h, 1, 1, hs);
52  snprintf(satir, sizeof(satir), "%04d-%02d-%02d,%02d:%02d:%02d,%s,%s",
53           simdi.year(), simdi.month(), simdi.day(),
54           simdi.hour(), simdi.minute(), simdi.second(), ts, hs);
55
56  File f = SD.open("VERI.CSV", FILE_WRITE);      // sona ekle / append
57  if (f) {
58    f.println(satir);
59    f.close();                                   // her kayıtta kapat: güç kesilse de veri kalır / close every time so data survives a power cut
60    Serial.println(satir);
61  } else {
62    Serial.println(F("VERI.CSV acilamadi"));
63  }
64}

Kod hər 10 saniyədən bir temperaturu və rütubəti oxuyur, RTC-dən tarix və saatı alır və 2026-11-04,14:05:30,23.5,45.2 formatında sətri VERI.CSV faylının sonuna əlavə edir. Fayl hər qeyddən sonra bağlandığı üçün elektrik kəsilsə belə həmin ana qədərki məlumatlar itmir. AVR əsaslı platalarda sprintf() onluq kəsrləri (%f) dəstəkləmir, buna görə rəqəmlər əvvəlcə dtostrf() ilə mətnə çevrilir. Gözləmə üçün delay() əvəzinə millis() istifadə olunduğundan loop() daxilində başqa işlər də görə bilərsən. RTC heç tənzimlənməyibsə, saat kodun kompilyasiya olunduğu ana qurulur. DS3231 istifadə edirsənsə, RTC_DS1307 əvəzinə RTC_DS3231 yazmaq və isrunning() əvəzinə lostPower() yoxlamaq kifayətdir.

Nə qədər yer tutur? Bir sətir təxminən 31 baytdır. 10 saniyədən bir qeydlə gündə 8.640 sətir, yəni təxminən 260 KB məlumat yaranır; bir ildə bu təxminən 95 MB edir. Yəni 8 GB-lıq kart bu tempdə onilliklərlə yetər. Əsl məhdudiyyət kart yox, qidadır: layihəni batareya ilə işlədəcəksənsə, nə qədər dayanacağını əvvəlcədən batareya ömrü hesablayıcısı ilə hesabla.

SD kartdakı məlumatları Excel-də açmaq

  1. Arduino-nun qidasını kəs, kartı moduldan çıxar və kompüterə tax.
  2. VERI.CSV faylını kompüterə kopyala; birbaşa kartda işləmək əvəzinə kopya ilə işləmək daha etibarlıdır.
  3. Excel-də boş iş kitabı aç və Data > From Text/CSV ilə faylı seç.
  4. Önizləmə pəncərəsində ayırıcı olaraq Comma seç və Load düyməsinə toxun; sütunlar tarix, saat, temperatur və rütubət kimi ayrılır.
  5. Temperatur və rütubət sütunlarını seçib Insert sekmesindən xətt qrafiki əlavə et; dəyişimi zamana görə görürsən.
Excel-də ondalık ayırıcı vergüldürsə (məsələn, Azərbaycan və ya türk yerli ayarlarında), 23.5 kimi dəyər rəqəm kimi tanınmaya bilər; mətn, tarix (23 may) və ya yanlış rəqəm kimi görünə bilər. İki həll var: idxal zamanı Transform Data düyməsinə toxunub temperatur və rütubət sütunlarını ingilis (ABŞ) yerli ayarı ilə onluq rəqəmə çevirmək və ya aşağıdakı kimi kodda ayırıcını nöqtəli vergül edib onluq nöqtəni vergülə çevirmək. İkinci yolda fayla cüt klik etmək kifayətdir; Excel sütunları özü ayırır.
C++ (Arduino IDE)
1// Excel'de ondalık ayırıcı virgülse / if Excel uses a decimal comma
2// Bu iki fonksiyonu kayıt kodunda loop()'un üstüne ekle / add these two functions above loop() in the logging sketch
3void noktayiVirgulYap(char *s) {
4  for (; *s; s++) {
5    if (*s == '.') *s = ',';                     // 23.5 -> 23,5
6  }
7}
8
9void excelSatiri(char *satir, size_t boyut, const DateTime &simdi, char *ts, char *hs) {
10  noktayiVirgulYap(ts);
11  noktayiVirgulYap(hs);
12  snprintf(satir, boyut, "%04d-%02d-%02d;%02d:%02d:%02d;%s;%s",   // ayırıcı ; / separator ;
13           simdi.year(), simdi.month(), simdi.day(),
14           simdi.hour(), simdi.minute(), simdi.second(), ts, hs);
15}
16
17// loop() içinde snprintf satırının yerine / in loop(), replace the snprintf line with:
18//   excelSatiri(satir, sizeof(satir), simdi, ts, hs);
19// Başlık satırı da / header row too: tarih;saat;sicaklik_C;nem_yuzde

Arduino kompüterə qoşulu olanda ölçmələri kartı çıxarmadan, canlı şəkildə Excel-ə ötürmək istəsən, Arduino-dan Excel-ə məlumat ötürmə yazısındakı Data Streamer və PLX-DAQ üsullarına nəzər sal. SD kart isə kompüterdən uzaqda, sahədə işləyən layihələrin əvəzsizidir.

ESP32 ilə SD kart istifadəsi (SPI)

ESP32-nin Arduino nüvəsi öz SD kitabxanası ilə gəlir və istifadəsi demək olar ki, eynidir, amma üç mühüm fərq var: fayl yolları / ilə başlayır ("/olcumler.csv"), uzun fayl adlarına icazə verilir və FILE_WRITE faylı sıfırdan yazır. Sona əlavə etmək üçün FILE_APPEND istifadə etməlisən; Uno kodunu olduğu kimi köçürsən, hər açılışda köhnə məlumatların silinir. Susmaya görə SPI pinləri SCK 18, MISO 19 və MOSI 23-dür, CS üçün adətən GPIO 5 istifadə olunur. Kartın növünü və ölçüsünü də bir sətirlə oxumaq olar:

C++ (Arduino IDE)
1#include <SPI.h>
2#include <SD.h>
3
4const int CS_PIN = 5;                            // VSPI: SCK 18, MISO 19, MOSI 23 / default VSPI pins
5const char *DOSYA = "/olcumler.csv";             // yol / ile başlar / path starts with /
6
7void setup() {
8  Serial.begin(115200);
9  if (!SD.begin(CS_PIN)) {                       // varsayılan SPI hızı 4 MHz / default SPI clock 4 MHz
10    Serial.println("Card Mount Failed");
11    return;
12  }
13  uint8_t tur = SD.cardType();
14  if (tur == CARD_NONE) {
15    Serial.println("Kart takili degil");         // kart yok / no card inserted
16    return;
17  }
18  Serial.printf("Kart tipi: %s\n", tur == CARD_SDHC ? "SDHC" : (tur == CARD_SD ? "SDSC" : "MMC"));
19  Serial.printf("Boyut: %llu MB\n", SD.cardSize() / (1024 * 1024));
20
21  if (!SD.exists(DOSYA)) {                       // uzun dosya adı serbest / long file names are fine
22    File f = SD.open(DOSYA, FILE_WRITE);         // FILE_WRITE dosyayı sıfırlar / FILE_WRITE truncates
23    if (f) {
24      f.println("sure_s,isik_ham");
25      f.close();
26    }
27  }
28}
29
30void loop() {
31  File f = SD.open(DOSYA, FILE_APPEND);          // ESP32'de sona ekleme / append on ESP32
32  if (f) {
33    f.printf("%lu,%d\n", millis() / 1000, analogRead(34));   // GPIO34'teki LDR / LDR on GPIO34
34    f.close();
35  }
36  delay(5000);
37}

Kod hər 5 saniyədən bir GPIO 34-ə qoşulmuş LDR-in xam dəyərini (0–4095) qeyd edir. ESP32-də real vaxt üçün RTC modulu şərt deyil: Wi-Fi-a qoşulub saatı NTP serverindən ala, getLocalTime() ilə hər sətirə zaman damğası əlavə edə bilərsən. Naqillər uzundursa və ya kart qeyri-sabit işləyirsə, SPI sürətini azalt: SD.begin(5, SPI, 1000000) kartı 1 MHz ilə başladır. Batareya ilə işləyən qeydedicidə ölçmələr arasında deep sleep istifadə etmək batareya ömrünü dəfələrlə uzadır.

ESP32 SD_MMC: sürətli SD interfeysi və ESP32-CAM

ESP32-də SPI ilə yanaşı kartın öz sürətli protokolunda danışan SDMMC kontrolleri də var. SD_MMC kitabxanası 4-bit rejimdə SPI-dan bir neçə dəfə sürətlidir; foto və ya səs kimi böyük fayllar üçün idealdır. Klassik ESP32-də pinlər sabitdir: CLK GPIO 14, CMD GPIO 15, D0 GPIO 2, D1 GPIO 4, D2 GPIO 12, D3 GPIO 13; bu xətlərdə 10 kΩ-luq pull-up rezistorlar lazımdır. 1-bit rejimdə yalnız CLK, CMD və D0 istifadə olunur; sürət düşür, amma GPIO 4, 12 və 13 sərbəst qalır. ESP32-CAM platasındakı microSD yuvası bu pinlərə qoşulub və 1-bit rejimdən istifadə GPIO 4-dəki flaş LED-in hər kart girişində yanıb-sönməsinin qarşısını alır.

C++ (Arduino IDE)
1#include "FS.h"
2#include "SD_MMC.h"
3
4void setup() {
5  Serial.begin(115200);
6  // 1-bit mod: yalnız CLK 14, CMD 15, D0 2 / 1-bit mode: only CLK 14, CMD 15, D0 2
7  if (!SD_MMC.begin("/sdcard", true)) {
8    Serial.println("SD_MMC baglanamadi");        // kart bağlanamadı / mount failed
9    return;
10  }
11  Serial.printf("Bos alan: %llu MB\n", (SD_MMC.totalBytes() - SD_MMC.usedBytes()) / (1024 * 1024));
12
13  File f = SD_MMC.open("/gunluk.txt", FILE_APPEND);
14  if (f) {
15    f.println("ESP32-CAM acildi");               // açılış kaydı / boot log line
16    f.close();
17  }
18}
19
20void loop() {
21}
GPIO 12 ESP32 açılanda flaş yaddaşın iş gərginliyini müəyyən edən strapping pindir. 4-bit rejimdə D2 xəttindəki pull-up rezistor bəzi modulların heç açılmamasına səbəb ola bilər; belə halda 1-bit rejimdən istifadə et. ESP32-S3 kimi yeni çiplərdə isə SD_MMC.setPins() ilə pinləri istədiyin kimi seçə bilərsən.

Raspberry Pi Pico ilə SD kart (MicroPython)

MicroPython-da SD kart üçün micropython-lib daxilindəki sdcard.py drayveri istifadə olunur. Kompüterində mpremote varsa, mpremote mip install sdcard əmri ilə quraşdıra və ya faylı Thonny ilə Pico-ya kopyalaya bilərsən. Kart os.mount() ilə /sd qovluğu kimi qoşulur və sonra adi Python fayl əmrləri (open, write) ilə istifadə olunur. Aşağıdakı kod Pico-nun daxili temperatur sensorunu oxuyub 10 saniyədən bir CSV sətri yazır. Pico ilə təzə tanışsansa, əvvəlcə Raspberry Pi Pico nədir yazısına nəzər sal.

MicroPython
1from machine import Pin, SPI, ADC
2import os, time
3import sdcard                                    # micropython-lib sürücüsü / micropython-lib driver
4
5spi = SPI(0, baudrate=1000000, sck=Pin(18), mosi=Pin(19), miso=Pin(16))
6sd = sdcard.SDCard(spi, Pin(17, Pin.OUT))        # CS = GP17; kart yoksa OSError / OSError if no card
7os.mount(os.VfsFat(sd), "/sd")                   # kart artık /sd klasörü / the card is now the /sd folder
8
9sensor = ADC(4)                                  # dahili sıcaklık sensörü / internal temperature sensor
10DOSYA = "/sd/pico_log.csv"
11
12if "pico_log.csv" not in os.listdir("/sd"):      # yeni dosyaya başlık / header for a new file
13    with open(DOSYA, "w") as f:
14        f.write("tarih,saat,sicaklik_C\n")
15
16while True:
17    v = sensor.read_u16() * 3.3 / 65535
18    t = 27 - (v - 0.706) / 0.001721              # RP2040 veri sayfası formülü / RP2040 datasheet formula
19    y, ay, g, sa, dk, sn = time.localtime()[:6]
20    with open(DOSYA, "a") as f:                  # "a" = sona ekle / append
21        f.write("{:04d}-{:02d}-{:02d},{:02d}:{:02d}:{:02d},{:.1f}\n".format(y, ay, g, sa, dk, sn, t))
22    print(sa, dk, sn, t)
23    time.sleep(10)                               # 10 saniye bekle / wait 10 seconds

Pico-nun batareyalı saatı yoxdur: Thonny-yə qoşulanda saatı kompüterdən avtomatik tənzimlənir, təkbaşına işləyəndə isə 1 yanvar 2021-dən başlayır. Düzgün zaman damğası üçün DS3231 modulu əlavə edə və ya Pico W-də saatı NTP ilə internetdən ala bilərsən. Kart taxılı deyilsə və ya naqillər səhvdirsə, drayver OSError: no SD card xətası verir. Pico-nu Arduino IDE ilə (arduino-pico nüvəsi) proqramlaşdırırsansa, eyni SD kitabxanası məntiqindən istifadə edə bilərsən; susmaya görə SPI0 pinləri cədvəldəkilərlə eynidir və CS üçün SD.begin(17) yazmaq kifayətdir.

Məlumat itkisinin qarşısını almaq: qida, yazma tezliyi və kart ömrü

  • close() və ya flush() olmadan məlumat karta yazılmır: Kitabxana məlumatı əvvəlcə 512 baytlıq buferdə toplayır. Faylı daim açıq saxlayırsansa, bir neçə sətirdən bir flush() çağır.
  • Yazarkən kartı çıxarma: Yazma zamanı kartı çıxarmaq və ya qidanı kəsmək fayl sistemini poza bilər. Qeydi dayandıran düymə və qeydin davam etdiyini göstərən LED əlavə etmək yaxşı vərdişdir.
  • Qidanı güclü saxla: Kart yazma zamanı 100 mA-ə qədər cərəyan çəkir. Modulun VCC və GND ucları arasına 10–100 µF-lıq kondensator əlavə etmək gərginlik düşmələrini və təsadüfi yazma xətalarını azaldır.
  • Çox tez-tez açıb-bağlama: Saniyədə onlarla ölçmə alırsansa, hər sətirdə faylı açıb bağlamaq yavaşdır; ölçmələri RAM-da toplayıb 10–20 sətirdən bir toplu yaz.
  • Kart ömrü: SD kartlar yazmaları öz daxilində fərqli xanalara paylayır (wear leveling); dəqiqədə bir neçə sətirlik qeydedici kartı illərlə yıpratmır. Yenə də tanınmış markanın kartını seç.
  • Faylı böl: Hər gün üçün ayrıca fayl (məs. 20261104.CSV) açmaq faylları kiçik saxlayır; problem çıxsa, yalnız həmin günün məlumatını itirirsən.

SD kart modulu ilə layihə ideyaları

  • Hava stansiyası qeydedicisi: BME280 ilə temperatur, rütubət və təzyiqi saatlıq qeyd et, mövsümlük qrafik çıxar.
  • Bitki suvarma gündəliyi: Torpaq rütubəti sensoru dəyərlərini və nasosun işlədiyi anları qeyd edib suvarma qaydasını araşdır.
  • GPS marşrut qeydedicisi: NEO-6M GPS ilə velosiped və ya gəzinti marşrutunu CSV kimi yadda saxla, sonra xəritədə göstər.
  • Kartla giriş-çıxış qeydi: RFID RC522 ilə oxudulan hər kartı tarix və saatı ilə fayla yaz.
  • Enerji istehlakı izləmə: ACS712 cərəyan sensoru ilə cihazın gün boyu çəkdiyi cərəyanı ölç və qeyd et.
  • MP3 pleyer: DFPlayer Mini öz microSD yuvası ilə səs fayllarını oxudur; Arduino yalnız komanda göndərir.

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

ƏlamətMümkün səbəbHəll
"initialization failed"Kart taxılı deyil, naqillər səhvdir və ya CS pini koddakı ilə eyni deyilMISO, MOSI və SCK-nin aparat SPI pinlərində olduğunu və SD.begin() daxilindəki CS nömrəsini yoxla
"initialization failed" (naqillər düzgündür)Stabilizatorlu modul 3,3 V ilə qidalandırılıb və ya qida zəifdirModulu 5 V ilə qidalandır, naqilləri qısalt, VCC-GND arasına kondensator əlavə et
"Could not find FAT16/FAT32 partition"Kart exFAT və ya NTFS formatlıdır; 64 GB və yuxarı SDXC kart32 GB-a qədər kartı FAT32 kimi formatla
Fayl açılmır ("error opening")Fayl adı 8.3 qaydasına uyğun deyil və ya əvvəlki fayl bağlanmayıbVERI.CSV kimi qısa ad istifadə et, hər faylı close() ilə bağla
Fayl boşdur və ya son sətirlər çatışmırclose() və ya flush() çağırılmadan qida kəsilibHər qeyddən sonra bağla və ya müntəzəm flush() çağır
Başqa SPI cihazı əlavə ediləndə SD işləmirDigər cihazın CS-i boşdadır və ya modul MISO xəttini buraxmırBütün CS pinlərini setup() əvvəlində OUTPUT və HIGH et; lazım gələrsə MISO-nu buraxan modul istifadə et
Uno-da kod donur və ya qəribə davranırRAM çatmır: SD kitabxanası təxminən 650 bayt, OLED ekranın buferi 1 KB istifadə edirMətnləri F() ilə yaz; lazım gələrsə Mega-ya və ya ESP32-yə keç
ESP32-də hər açılışda köhnə məlumatlar silinirFayl FILE_WRITE ilə açılırSona əlavə etmək üçün FILE_APPEND istifadə et
ESP32-də "Card Mount Failed"Qida, naqil, yüksək SPI sürəti və ya SD_MMC-də çatışmayan pull-upSPI sürətini 1 MHz-ə endir; SD_MMC-də 1-bit rejimi yoxla
Problemin mənbəyini tapmağın ən sürətli yolu Arduino IDE-dəki File > Examples > SD > CardInfo nümunəsidir. Kartın növünü (SD1, SD2 və ya SDHC) göstərir, amma bölmə tapmırsa, problem formatlamadadır; kartın növünü belə göstərə bilmirsə, naqillərə və qidaya bax.

SD kart modulu yalnız ölçən layihəni qeyd aparan cihaza çevirir; bir neçə gün ərzində topladığın real məlumatlar tək anlıq oxumadan çox şey danışır. BlueGrays tətbiqində DHT22, DS1307 RTC, microSD və OLED-li ESP32 temperatur qeydedicisi layihəsini, RTC-li rəqəmsal saatları və temperatur-rütubət ölçmə layihələrini addım-addım dövrə sxemləri və kodları ilə tapa bilərsən.

Tez-tez verilən suallar

Arduino SD kart modulu neçə GB kartı dəstəkləyir?

Arduino-nun standart SD kitabxanası FAT16 və ya FAT32 formatlı SDSC və SDHC kartları, yəni 32 GB-a qədər kartları dəstəkləyir. 64 GB və yuxarı SDXC kartlar exFAT ilə gəlir və bu kitabxana ilə oxunmur. Datalogger üçün 4–16 GB-lıq kart kifayətdən artıqdır.

SD kart niyə "initialization failed" xətası verir?

Ən çox rast gəlinən səbəblər yanlış CS pini, MISO-MOSI-SCK naqillərinin aparat SPI pinlərinə qoşulmaması, kartın FAT32-dən başqa formatda olması və stabilizatorlu modulun 3,3 V ilə qidalandırılmasıdır. Əvvəlcə CardInfo nümunəsini işlət, sonra naqilləri qısaldıb modulu 5 V ilə qidalandırmağı yoxla.

SD kart modulu 3.3V ilə işləyirmi?

Stabilizatorsuz modullar birbaşa 3,3 V ilə işləyir və ESP32 və ya Pico üçün uyğundur. Stabilizatorlu və səviyyə çeviricili microSD modulları isə 4,5–5,5 V tələb edir; 3,3 V ilə qidalandırılsalar, karta kifayət qədər gərginlik çatmır. Bu modulları ESP32-də VIN, Pico-da VBUS pinindən qidalandıra bilərsən.

SD karta yazılan CSV faylı Excel-də necə açılır?

Faylı kompüterə kopyala və Excel-də Data > From Text/CSV ilə idxal et, ayırıcı olaraq vergülü seç. Excel-də ondalık ayırıcı vergüldürsə, rəqəmlər yanlış görünə bilər; bu halda sütunları ingilis (ABŞ) yerli ayarı ilə çevir və ya kodda ayırıcı olaraq nöqtəli vergül istifadə et.

Arduino SD karta nə tezliklə məlumat yaza bilər?

Saniyədə bir neçə sətir yazmaq problem deyil, amma hər sətirdə faylı açıb bağlamaq vaxt aparır. Sürətli ölçmələrdə məlumatları RAM-da toplayıb toplu yaz və ya faylı açıq saxlayıb müntəzəm flush() çağır. Dəqiqədə bir qeyd kimi yavaş tempdə isə hər dəfə aç-yaz-bağla ən etibarlı üsuldur.

SD kart modulu ilə RFID və ya TFT ekran eyni anda istifadə oluna bilərmi?

Bəli, SPI cihazları MISO, MOSI və SCK xətlərini paylaşır və hər biri ayrıca CS pini istifadə edir. Problem çıxsa, bütün CS pinlərini setup() əvvəlində OUTPUT və HIGH et. Bəzi ucuz microSD modullarındakı səviyyə çevirici MISO xəttini heç buraxmır; bu halda MISO-nu buraxan modul və ya ESP32-də ikinci SPI xətti istifadə et.

Bütün layihələrə bax
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
ESP32 temperatur loqqeri (DHT22 + DS1307 RTC + microSD + OLED)
ES-40Qabaqcıl
Premium

ESP32 temperatur loqqeri (DHT22 + DS1307 RTC + microSD + OLED)

ESP32 ilə zaman etiketli temperatur və rütubət qeydiyyat sistemi qur! Bu layihədə DHT22 sensoru ilə dəqiqədə bir temperatur və rütubət oxuyub DS1307 RTC modulundan aldığın real zaman etiketi ilə microSD karta CSV formatında yazırıq. OLED ekranda iri yazı ilə son temperatur, rütubət faizi, zaman damğası və ümumi qeyd sayı canlı göstərilir.

4.7(7)
12
ESP32 RTC DS1307 ilə rəqəmsal saat (I2C + LCD)
ES-18Orta
Premium

ESP32 RTC DS1307 ilə rəqəmsal saat (I2C + LCD)

Bu layihədə DS1307 real vaxt saatı (RTC) modulu ilə 16x2 I2C LCD ekranda saat və tarix məlumatı göstəririk. DS1307 batareya dəstəkli RTC-dir; ESP32 söndürülsə belə vaxtı saxlayır. Hər iki modul eyni I2C xəttini (SDA/SCL) paylaşır, beləcə cəmi iki siqnal naqili ilə çoxlu cihaz idarəsini öyrənmiş oluruq. Bu layihə ilə I2C rabitə protokolunu, RTC modullarının iş prinsipini və LCD ekranda dinamik məlumat göstərilməsini praktik şəkildə öyrənəcəksən.

4.6(26)
40
ESP32 DHT22 temperatur və rütubət (LCD ekranlı)
ES-15Orta

ESP32 DHT22 temperatur və rütubət (LCD ekranlı)

DHT22 sensoru ilə mühitin temperaturunu və rütubət nisbətini ölçüb 16x2 I2C LCD ekranda real vaxtda göstərən layihədir. Adafruit DHT kitabxanasından istifadə edilərək tək naqilli (one-wire) protokolla sensordan məlumat oxunur. Bu layihə IoT hava stansiyası, ağıllı ev avtomatlaşdırması və ya istixanalarda mühit izləmə sistemlərinin əsasını təşkil edir. DHT22 ilə əlaqə ESP32-nin GPIO 4 pini üzərindən təmin olunur.

4.8(38)
57
ESP32 Deep Sleep — batareya qənaəti (OLED + RTC RAM sayğac)
ES-33Qabaqcıl
Premium

ESP32 Deep Sleep — batareya qənaəti (OLED + RTC RAM sayğac)

ESP32-nin Deep Sleep rejimi CPU-nu və əksər periferiyaları söndürərək cərəyan istehlakını təxminən 10µA səviyyəsinə endirir; batareya ilə işləyən IoT cihazları üçün çox vacibdir. Bu layihədə üç oyanma mənbəyi istifadə edirik: taymer (15 san), xarici pin (EXT0, GPIO 33-dəki düymə) və toxunma pini (T0/GPIO 4). RTC_DATA_ATTR ilə işarələnən sayğaclar deep sleep boyunca qorunur.

4.3(10)
16
ESP32 NTP ilə internetdən real vaxt
ES-26Qabaqcıl
Premium

ESP32 NTP ilə internetdən real vaxt

ESP32 Wi-Fi-a qoşulub NTP (Network Time Protocol) serverlərindən millisaniyə dəqiqliyi ilə real vaxtı çəkir. configTzTime() funksiyası sayəsində Türkiyə saat qurşağı (TRT, UTC+3) avtomatik tətbiq olunur; yay/qış saatı tətbiq edən ölkələrdə DST keçidi POSIX TZ sətri ilə avtomatik idarə olunur. Saat həm Serial Monitor-a, həm də istəyə bağlı I2C LCD-yə yazdırılır.

4.5(13)
22
Dot Matrix saat, təqvim və hava stansiyası (MAX7219, DS1307)
AR-85Orta
Premium

Dot Matrix saat, təqvim və hava stansiyası (MAX7219, DS1307)

Masada və ya divarda dayanıb saatı, tarixi və otağın havasını növbə ilə göstərən sürüşən yazılı lövhə.

5.0(50)
66
DS1302 RTC saatın LCD ekranla istifadəsi
AR-46Orta
Premium

DS1302 RTC saatın LCD ekranla istifadəsi

Elektrik kəsilsə belə saatı unutmayan kiçik stol saatı. DS1302 saat modulu öz mini batareyası sayəsində vaxtı saxlayır; Arduino hər saniyə bu məlumatı oxuyub LCD ekranın üst sətrinə saatı və tarixi…

4.7(41)
51