Tinjauannya, dengan contoh yang berjalan, ada di halaman board dan Model XIAO SAMD21 (setiap register).
Apa ini
Seeed Studio XIAO SAMD21, sebuah ATSAMD21G18A yang berjalan pada core Cortex-M buatan sendiri dalam profil ARMv6-M, core yang sama dengan Raspberry Pi Pico, pada 48 MHz alih-alih 125. Firmware-nya berupa ELF Thumb yang berbicara ke alamat SAM D21 yang sebenarnya.
Board-nya berukuran 21 kali 17,8 mm dan dua baris tujuh pad-nya berjarak 0,6 inci, jadi board ini melintangi saluran tengah breadboard dengan satu baris kosong di tiap sisi.
Pin-pin-nya
Empat belas pad berbatu, tujuh di tiap tepi, dengan soket USB-C di bagian atas.
Kolom kiri: D0, D1, D2, D3, D4, D5, D6.
Kolom kanan: 5V, GND, 3V3, D10, D9, D8, D7.
Semua sebelas pad I/O adalah input analog, dan A0 sampai A10 adalah pad yang sama dengan D0 sampai D10; silkscreen-nya mencetak keduanya. analogRead(A3) dan analogRead(3) adalah pin yang sama.
Ini adalah board 3,3 volt dan pin-nya tidak toleran terhadap 5 V. 3V3 menyuplai 3,3 V dan 5V menyuplai 5 V dari soket USB.
Ada tiga LED di board dan tidak di pad mana pun: LED pengguna, RX dan TX. Ketiganya aktif rendah, jadi digitalWrite(LED_BUILTIN, LOW) menyalakan LED pengguna. LED_BUILTIN adalah 13.
Tiga hal yang pinout ini lakukan padamu
Ini adalah sifat hardware, bukan model, dan masing-masing mengenai seseorang:
D0tidak punya PWM. Pin itu milik DAC dan tidak tersambung ke timer sama sekali, jadianalogWrite(0, x)menggerakkannya nyala atau mati di titik tengah. Gunakan pad lain untuk efek fade.D4tidak punya interupsi eksternal. Pin itu adalah pin NMI milik chip, jadiattachInterrupt(4, ...)tidak melakukan apa-apa. DanD5danD7berbagi satu jalur interupsi, jadi hanya salah satu dari keduanya yang bisa memuat handler pada satu waktu.- Beberapa pad PWM berbagi duty cycle.
D1danD4adalah satu kanal compare, begitu jugaD9danD5,D10danD2, sertaD8danD3. Menulis ke salah satu menggerakkan keduanya.
Serial adalah USB-nya, dan Serial1 bukan
Serial adalah perangkat USB bawaan chip. Itulah yang terhubung ke serial monitor, dan tidak punya baud rate sendiri: angka yang kamu berikan akan sampai ke host sebagai permintaan yang boleh host abaikan.
Tidak ada stack USB di bawahnya. Mokxi memodelkan pengendali perangkat sebagai pipa byte pada register endpoint yang sebenarnya dan tidak lebih dari itu: tanpa enumerasi, tanpa deskriptor, tanpa paket SETUP. Di XIAO sungguhan while (!Serial) {} menunggu host menyadari board-nya; di sini langsung kembali. Dan Keyboard serta Mouse, yang menjadi separuh alasan board USB native ada, tidak tersedia.
Serial1 adalah hal yang berbeda: USART sungguhan di D6 (TX) dan D7 (RX), mengirim frame 8N1 sungguhan sedikit demi sedikit. Pasang jumper dari D6 ke D7 dan sketch-mu mendengar echo miliknya sendiri; atur kedua ujung ke baud rate berbeda dan teksnya kacau, persis seperti di meja kerja sungguhan.
What is modeled
PORT, SysTick, cukup GCLK, PM dan SYSCTRL agar startup gaya Arduino bisa berjalan sampai selesai, enam SERCOM sebagai USART, TCC0-2 dan TC3-7 untuk PWM, ADC SAR di seluruh dua puluh kanal, EIC, dan USB sebagai pipa byte itu.
Itulah set yang dibutuhkan pinMode, digitalWrite, digitalRead, analogRead, analogWrite, millis, micros, delay, attachInterrupt, Serial dan Serial1, di alamat aslinya.
Yang tidak
Pohon clock (core-nya langsung berjalan pada 48 MHz dari instruksi pertama), SPI dan I2C pada SERCOM (Wire dan SPI adalah software pada pin biasa, lihat bawah), DAC, analog comparator, pengendali sentuh, I2S, DMA, sistem event, pengendali NVM, watchdog, RTC, dan seluruh USB di atas pipa byte.
Blocks the chip has and the model does not are mapped and read zero rather than faulting, so a startup that pokes one does not crash the board.
The full list, and a plain account of which register offsets this model can state from the datasheet and which are its own reading, is in model XIAO SAMD21. Bagian 7 adalah yang harus kamu baca sebelum membawa build dari sini ke silikon sungguhan.
Library Arduino bawaan
Tutorial yang memuat Servo.h, Wire.h, SPI.h, EEPROM.h, LiquidCrystal_I2C.h, Adafruit_GFX.h dengan Adafruit_SSD1306.h dan DHT.h dikompilasi di sini apa adanya. Masing-masing adalah header buatan Mokxi sendiri dengan nama upstream, ditulis di atas driver untuk komponen di kotak komponen, dan tidak ada satu pun kode dari library upstream.
Wire.begin()menempatkan bus I2C diD4(SDA) danD5(SCL).EEPROM.hbekerja, tapi model board ini tidak punya EEPROM atau flash yang bisa ditulis, jadi byte-nya tinggal di RAM sebesar 4 KB: byte itu terbaca kembali selama satu Run dan hilang saat reset.Adafruit_NeoPixel.hstops with a message: a WS2812 bit is too short to make by hand on this board. The AVR boards, the ESP32s, the Pico and the Uno R4 drive the strip.
Editor kode dan kompilasi mencantumkan apa yang dicakup masing-masing dan bagaimana bedanya dengan library upstream.
Contoh-contoh
Blink, Button, Serial dan Analog.
Di tempat lain
- Halaman board: /boards/xiao-samd21
- Dokumen kontrak: model XIAO SAMD21
- Board lain pada core yang sama: Raspberry Pi Pico
- Proyek pemula: XIAO SAMD21 serial