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.

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ət | Dəyər |
|---|---|
| İnterfeys | SPI (MISO, MOSI, SCK, CS) |
| Qida (stabilizatorlu microSD modulu) | 4,5–5,5 V, platada 3,3 V stabilizator |
| Siqnal səviyyəsi | 3,3 V və 5 V ilə uyğun (səviyyə çevirici sayəsində) |
| Dəstəklənən kartlar | microSD (2 GB-a qədər) və microSDHC (4–32 GB) |
| Fayl sistemi | FAT16 və ya FAT32 |
| Cərəyan | Gö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ü | Qida | Siqnal səviyyəsi | Uyğun olduğu platalar |
|---|---|---|---|
| Stabilizatorlu microSD modulu (74LVC125A-lı) | 5 V | 3,3 V və 5 V | Uno, 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 yoxdur | 3,3 V-luq platalar; 5 V siqnalla etibarlılığı aşağıdır |
| Stabilizatorsuz microSD modulu (yalnız yuva) | Yalnız 3,3 V | Yalnız 3,3 V | ESP32, Raspberry Pi Pico |
| Daxili yuvalı platalar (ESP32-CAM kimi) | Platadan | 3,3 V | SD_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.
SD kart modulunun qoşulması: SPI pinləri
| Modul pini | Arduino Uno / Nano | Arduino Mega | ESP32 | Raspberry Pi Pico |
|---|---|---|---|---|
| GND | GND | GND | GND | GND |
| VCC | 5V | 5V | VIN (5 V) | VBUS (5 V) |
| MISO | D12 | D50 | GPIO 19 | GP16 |
| MOSI | D11 | D51 | GPIO 23 | GP19 |
| SCK | D13 | D52 | GPIO 18 | GP18 |
| CS | D10 | D53 | GPIO 5 | GP17 |
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.
Addım-addım ilk test: SD karta yazmaq və oxumaq
- Formatladığın kartı modula tax və modulu yuxarıdakı cədvələ uyğun Arduino-ya qoş.
- 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.
- Aşağıdakı kodu yüklə və Serial Monitor-u 9600 baud sürətində aç.
- "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.
- Kartı çıxarıb kompüterə taxanda TEST.TXT faylını istənilən mətn redaktoru ilə aça bilərsən.
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}| Funksiya | Nə 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.

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.
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
- Arduino-nun qidasını kəs, kartı moduldan çıxar və kompüterə tax.
- 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.
- Excel-də boş iş kitabı aç və Data > From Text/CSV ilə faylı seç.
- Ö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.
- 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.
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_yuzdeArduino 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:
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.
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}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.
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 secondsPico-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ət | Mümkün səbəb | Həll |
|---|---|---|
| "initialization failed" | Kart taxılı deyil, naqillər səhvdir və ya CS pini koddakı ilə eyni deyil | MISO, 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əifdir | Modulu 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 kart | 32 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ıb | VERI.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ır | close() və ya flush() çağırılmadan qida kəsilib | Hə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əmir | Digər cihazın CS-i boşdadır və ya modul MISO xəttini buraxmır | Bü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ır | RAM çatmır: SD kitabxanası təxminən 650 bayt, OLED ekranın buferi 1 KB istifadə edir | Mə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 silinir | Fayl FILE_WRITE ilə açılır | Sona ə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-up | SPI sürətini 1 MHz-ə endir; SD_MMC-də 1-bit rejimi yoxla |
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.
Bu yazıdan sonra edə biləcəyin layihələr
Bütün layihələrə bax
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.

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.

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.

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.

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.

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.

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

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…
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ç

