Ini adalah referensi teknis untuk modelnya: apa yang diimplementasikan, register demi register, untuk orang yang menulis firmware menggunakannya. Untuk memakai board ini di editor, mulai dari Seeed XIAO SAMD21 dan halaman board.
XIAO SAMD21 adalah board terkecil di sini dan Cortex-M0+ yang ketiga. Satu komponen kernel (xiao di crates/parts) membungkus model SoC ATSAMD21G18A (crates/atsamd21) pada core yang sama dengan Raspberry Pi Pico (crates/cortexm-core, Profile::V6M). Core-nya dibagi pakai; chip di sekitarnya tidak. Dokumen ini adalah kontraknya, dan dia menang atas komentar apa pun di dalam kode.
Tipe katalognya adalah xiao.
Baca bagian 7 dulu jika kamu membawa build dari sini ke silikon sungguhan. Setiap alamat base dalam model ini adalah alamat yang bisa dinyatakan dokumen ini dari SAM D21 Family Datasheet, dan sebagian besar offset register juga, tetapi offset blok TC dan tabel multipleksing periferal adalah pembacaan model ini sendiri, bukan halaman yang dikutip kembali, dan bagian 7 menyebutkan masing-masing. Tidak ada yang dikira-kira diam-diam di sini.
1. Pin board (urutan katalog)
Tampak atas, soket USB-C di bagian atas, ATSAMD21G18A di bawah silkscreen di tengah. Board ini berukuran 21 x 17,8 mm dan dua barisnya yang masing-masing berisi tujuh pad castellated berjarak 15,24 mm (tepat 0,6 inci), jadi board ini melintasi jalur tengah breadboard.
Kolom kiri, dari atas ke bawah (7 pad): D0, D1, D2, D3, D4, D5, D6.
Kolom kanan, dari atas ke bawah (7 pad): 5V, GND, 3V3, D10, D9, D8, D7.
14 pad. Sebelas adalah I/O dan tiga adalah power. Semua dari sebelas pad itu juga merupakan input analog, dan A0 sampai A10 adalah pad yang sama dengan D0 sampai D10; silkscreen mencetak keduanya.
Pad di belakang tiap pin, dan apa lagi yang bisa dilakukan:
| pin | pad | AIN |
EXTINT |
PWM (fungsi E) | lainnya |
|---|---|---|---|---|---|
D0 / A0 |
PA02 | 0 | 2 | tidak ada | output DAC |
D1 / A1 |
PA04 | 4 | 4 | TCC0 CC0 |
|
D2 / A2 |
PA10 | 18 | 10 | TCC1 CC0 |
|
D3 / A3 |
PA11 | 19 | 11 | TCC1 CC1 |
|
D4 / A4 |
PA08 | 16 | NMI | TCC0 CC0 |
SDA |
D5 / A5 |
PA09 | 17 | 9 | TCC0 CC1 |
SCL |
D6 / A6 |
PB08 | 2 | 8 | TC4 CC0 |
Serial1 TX |
D7 / A7 |
PB09 | 3 | 9 | TC4 CC1 |
Serial1 RX |
D8 / A8 |
PA07 | 7 | 7 | TCC1 CC1 |
SCK |
D9 / A9 |
PA05 | 5 | 5 | TCC0 CC1 |
MISO |
D10 / A10 |
PA06 | 6 | 6 | TCC1 CC0 |
MOSI |
Ada tiga hal di tabel itu yang layak dibaca dua kali, dan ketiganya tentang hardware, bukan tentang modelnya:
D0tidak punya PWM. PA02 adalah pin DAC dan tidak menghasilkan output gelombang sama sekali.analogWrite(0, x)di sini menghidupkan atau mematikan pad di titik tengah, bukan berpura-pura memudar.D4tidak punya external interrupt biasa. PA08 adalah pin NMI chip.attachInterrupt(4, ...)tidak melakukan apa pun, di sini maupun di meja nyata.D5danD7berbagiEXTINT9, jadi hanya salah satu dari keduanya yang bisa membawa interrupt pada satu waktu; yang keduaattachInterruptmengambil jalur dari yang pertama. Dan karena TCC1 dan TCC2 masing-masing punya dua register compare, beberapa pin berbagi satu duty: menulisanalogWritedi salah satuD1/D4,D9/D5,D10/D2atauD8/D3memindahkan keduanya.
Ada tiga LED yang ada di board tapi tidak di pad mana pun: LED pengguna di PA17, LED RX di PA18 dan LED TX di PA19. Ketiganya active low, jadi digitalWrite(LED_BUILTIN, LOW) menyalakan LED pengguna. Ketiganya terlihat melalui probe dan tampilan visual, dan tidak di tempat lain. Runtime menomorinya 13, 12 dan 11 serta mendefinisikan LED_BUILTIN sebagai 13.
Kelistrikan. Setiap pad I/O menggerakkan push-pull pada 3,3 V melalui R_STRONG, berada di high-Z, atau menarik ke atas atau ke bawah melalui 40 k. Input terbaca tinggi pada 1,65 V; net yang bergolak (Unknown) terbaca 0, dan net yang mengambang terbaca noise, seperti pada Uno (docs/uno.md bagian 1). 3V3 menggerakkan 3,3 V pada R_SUPPLY, 5V menggerakkan 5 V dan GND menggerakkan 0 V, selalu, karena board terhubung ke USB. Tidak ada pad reset di header: dua pad reset ada di sisi bawah XIAO sungguhan, dan di sini reset adalah sebuah poke (bagian 5).
2. Peta memori
| flash | 256 KB di 0x0000_0000 |
| SRAM | 32 KB di 0x2000_0000 sampai 0x2000_7FFF |
| puncak stack | 0x2000_8000 |
| PM | 0x4000_0400, bagian 3.2 |
| SYSCTRL | 0x4000_0800, bagian 3.2 |
| GCLK | 0x4000_0C00, bagian 3.2 |
| EIC | 0x4000_1800, bagian 3.6 |
| PORT | 0x4100_4400, bagian 3.1 |
| USB | 0x4100_5000, bagian 3.7 |
| SERCOM0..5 | 0x4200_0800, berjarak 0x400, bagian 3.3 |
| TCC0..2 | 0x4200_2000, berjarak 0x400, bagian 3.4 |
| TC3..TC7 | 0x4200_2C00, berjarak 0x400, bagian 3.4 |
| ADC | 0x4200_4000, bagian 3.5 |
Setiap segmen PT_LOAD harus berada di dalam flash atau SRAM; selain itu ditolak dengan alamat bermasalah disebutkan dalam pesan, dan chip dibiarkan tanpa program.
The vector table goes at zero and nothing goes before it. A real XIAO ships with the UF2 bootloader in the first 8 KB and the application linked at 0x2000; an image built here therefore runs in Mokxi and under a debugger, and needs relinking at 0x2000 to go in over that bootloader. That is a one-line change to ORIGIN in firmware/xiao/link.ld, not a code change.
Blok yang ada di datasheet tapi tidak ada di model ini (PAC0-2, DSU, NVMCTRL, DMAC, MTB, WDT, RTC, EVSYS, AC, DAC, PTC, I2S) di-map dan tidak aktif: membacanya memberi 0 dan dihitung sebagai akses liar, bukan fault. Startup yang mengubah wait state controller NVM tidak akan membuat board crash. Apa pun di luar semua blok adalah access fault, yang di ARMv6-M adalah HardFault dan dilaporkan board sebagai crash di channel host.
3. Register peripheral
Hanya subset di bawah ini yang diimplementasikan. Register SAM D21 lebarnya delapan, enam belas atau tiga puluh dua bit, dan bus melayani masing-masing pada lebar register itu sendiri: akses yang lebih sempit dari registernya adalah read-modify-write seperti yang akan dilakukan bus matrix, dan yang lebih lebar dijawab dari register tempat ia dimulai. Jadi firmware yang ditulis sesuai tipe di datasheet sendiri bekerja tanpa perubahan.
3.1 PORT (0x4100_4400)
Ada dua grup, PA dan PB, berjarak 0x80. Pad dinomori 0..63 di model ini: 0..31 adalah PA00..PA31 dan 32..63 PB00..PB31.
| offset | register |
|---|---|
0x00 |
DIR |
0x04 |
DIRCLR |
0x08 |
DIRSET |
0x0C |
DIRTGL |
0x10 |
OUT |
0x14 |
OUTCLR |
0x18 |
OUTSET |
0x1C |
OUTTGL |
0x20 |
IN |
0x24 |
CTRL (disimpan, bisa dibaca kembali) |
0x28 |
WRCONFIG |
0x30 + n |
PMUXn, satu byte per pasangan pin |
0x40 + n |
PINCFGn, satu byte per pin |
Bit 0 PINCFG PMUXEN, bit 1 INEN, bit 2 PULLEN, bit 6 DRVSTR (disimpan, diabaikan secara elektris).
OUT punya dua fungsi dan ini satu-satunya jebakan nyata di bagian ini. Jika DIR set it is the driven level; with DIR clear it is the arah pull. Jadi INPUT_PULLUP adalah DIRCLR, lalu OUTSET, lalu PINCFG.PULLEN, dan PULLEN tanpa OUT memberikan pull-turun. Dua dari tiga salah dan pin melakukan hal yang salah secara diam-diam.
WRCONFIG menulis PINCFG dan PMUX enam belas pin dalam satu store: PINMASK di bit 0..15, PMUXEN 16, INEN 17, PULLEN 18, DRVSTR 22, PMUX 24..27, WRPMUX 28, WRPINCFG 30, HWSEL 31 (yang menggeser mask ke pin 16..31).
Dengan PMUXEN diset, PMUX memilih salah satu dari delapan fungsi peripheral A..H dan pad meninggalkan kendali PORT. Model ini menindaklanjuti yang dimilikinya (SERCOM dalam mode USART dan keluaran gelombang TC/TCC, tabel di bagian 1) dan memperlakukan setiap pilihan lain sebagai peripheral yang tidak dimilikinya, yang tidak meminta apa pun dan membiarkan pad high-Z daripada mengarang sebuah level. Pull pad tetap milik pad, itulah cara pin RX SERCOM mempertahankan pull-up-nya.
IN membaca 0 pada pin yang INEN-nya kosong, sama seperti perilaku hardware. Pad yang sedang dikendalikan chip ini terbaca kembali dengan nilai yang sedang dikendalikannya.
3.2 PM, GCLK dan SYSCTRL: clock tree tidak dimodelkan
Inti berjalan di 48 MHz sejak instruksi pertama. Tidak ada clock tree di sini: tidak ada DFLL, tidak ada osilator, tidak ada pembagi, tidak ada generator yang benar-benar menghasilkan apa pun. Tiga blok ini ada supaya startup yang ditulis mengikuti register aslinya berjalan sampai selesai alih-alih menggantung pada bit ready.
- SYSCTRL (
0x4000_0800) adalah bayangan dari tiga puluh dua word, dengan dua pengecualian.PCLKSR(0x0C) membaca semua bit ready dan lock sebagai set (XOSCRDY,XOSC32KRDY,OSC32KRDY,OSC8MRDY,DFLLRDY,DFLLLCKF,DFLLLCKC,DFLLRCS,BOD33RDY,DPLLLCKF,DPLLLCKT) dan semua bit kegagalan kosong.DFLLSYNCterbaca 0. Jadiwhile (!(SYSCTRL->PCLKSR.reg & DFLLRDY)) {}langsung terlewati. - GCLK (
0x4000_0C00):CTRLdi0x00(bit 0SWRST),STATUSdi0x01(bit 7SYNCBUSY, tidak pernah diset),CLKCTRLdi0x02,GENCTRLdi0x04,GENDIVdi0x08. Tiga yang terakhir dialamatkan berdasarkan ID dalam nilai yang ditulis, seperti pada komponen aslinya, dan pembacaan menjawab untuk ID yang terakhir ditulis. Tidak ada yang digerbangkan oleh mereka. - PM (
0x4000_0400):AHBMASK0x14,APBAMASK0x18,APBBMASK0x1C,APBCMASK0x20, semuanya disimpan dan terbaca kembali pada nilai reset-nya, danRCAUSEdi0x38, yang di sini hanya bisa dibaca dan memuat bit power-on, bit external-reset, atau bit system-reset tergantung reset terakhir apa yang dialami komponen. Tidak ada yang digerbangkan oleh mask clock: peripheral tetap bekerja baik clock-nya dinyalakan firmware maupun tidak. Runtime tetap menyalakannya, karena komponen asli membutuhkannya.
Waktu itu sendiri datang dari SysTick, yang berada di cortexm-core pada alamat arsitekturnya. Runtime me-reload-nya setiap 48 000 siklus (tepat satu milidetik pada 48 MHz), dan SYST_CALIB melaporkannya sebagai sepersepuluh dari sepuluh milidetik yang tepat.
3.3 SERCOM sebagai USART (0x4200_0800 + 0x400 n)
Enam SERCOM, masing-masing dimodelkan dalam mode USART dengan clock internal (CTRLA.MODE = 1), asinkron 8N1, dan tidak dalam mode lain. SPI dan I2C tidak dimodelkan; SERCOM yang ditaruh di salah satu mode itu tidak melakukan apa-apa.
| offset | register |
|---|---|
0x00 |
CTRLA |
0x04 |
CTRLB |
0x08 |
DBGCTRL (disimpan) |
0x0C |
BAUD |
0x0E |
RXPL (disimpan) |
0x14 |
INTENCLR |
0x16 |
INTENSET |
0x18 |
INTFLAG |
0x1A |
STATUS (disimpan; tidak ada error yang pernah muncul) |
0x1C |
SYNCBUSY (selalu 0) |
0x28 |
DATA |
CTRLA bit 0 SWRST, bit 1 ENABLE, bit 2..4 MODE, bit 16..17 TXPO (0 menggerakkan PAD[0], selain itu PAD[2]), bit 20..21 RXPO (pad yang didengarkan oleh penerima), bit 30 DORD. CTRLB bit 16 TXEN, bit 17 RXEN. INTFLAG bit 0 DRE, bit 1 TXC (terkunci, tulis 1 untuk menghapus), bit 2 RXC.
BAUD adalah generator aritmetika asinkron: BAUD = 65536 (1 - 16 f / f_ref), jadi satu waktu bit adalah 16 x 65536 / (65536 - BAUD) clock referensi. Referensinya dianggap clock inti 48 MHz, karena tidak ada clock tree yang bisa ditanya (bagian 3.2). BAUD bernilai 0 (yang ditinggalkan program yang belum memanggil begin()) kembali ke 115200. Tidak ada mode fraksional.
Pemancar yang enabled dan memiliki TXEN diset memiliki pad-nya dan menggeser bit nyata melaluinya: bit start rendah, delapan bit data mulai dari yang paling tidak signifikan, bit stop tinggi, masing-masing sepanjang satu waktu bit, setiap tepi dicap dengan siklus ketika hardware seharusnya menggerakkannya. Penerima dengan RXEN diset memulai frame pada tepi turun dan mengambil sampel setiap bit data di tengah waktu bitnya. Jadi kabel jumper dari D6 ke D7 membawa satu karakter, dan baud rate yang tidak cocok merusak teks di sini dengan cara yang sama seperti di meja kerja.
Pada board ini Serial1 adalah SERCOM4 dengan TXPO 0 dan RXPO 1, yaitu PAD[0] di PB08 dan PAD[1] di PB09 (D6 dan D7), keduanya pada fungsi peripheral C.
3.4 TCC0-2 dan TC3-7, sebatas PWM
Tiga TCC dan lima TC. Counter di sini tidak pernah dinaikkan langkah demi langkah: ia fungsi bentuk-tertutup dari siklus CPU, begitu juga waktu tepi berikutnya, dan itulah yang membuat inti yang parkir di WFI tidak memakan biaya apa pun selama satu delay() penuh sementara PWM tetap berjalan.
PRESCALER adalah bit 8..10 dari CTRLA pada kedua jenis, dan nilainya bukan pangkat dua sampai ke atas: 0 sampai 4 adalah DIV1, DIV2, DIV4, DIV8 dan DIV16, lalu 5 adalah DIV64, 6 DIV256 dan 7 DIV1024. Lompatan itu jebakan nyata dan salah memahaminya membuat PWM empat kali terlalu lambat.
TCC (0x4200_2000 + 0x400 n):
| offset | register |
|---|---|
0x00 |
CTRLA: bit 0 SWRST, bit 1 ENABLE, bit 8..10 PRESCALER |
0x04/0x05 |
CTRLBCLR/CTRLBSET (disimpan) |
0x08 |
SYNCBUSY (selalu 0) |
0x24/0x28 |
INTENCLR/INTENSET |
0x2C |
INTFLAG: bit 0 OVF |
0x30 |
STATUS (selalu 0) |
0x34 |
COUNT |
0x3C |
WAVE: bit 0..2 WAVEGEN, yang mana 2 adalah PWM normal |
0x40 |
PER, periode |
0x44 + 4c |
CC0..CC3, duty |
0x68/0x6C/0x70 + 4c |
WAVEB/PERB/CCBn, yang di sini langsung berlaku |
TCC0 punya empat kanal compare; TCC1 dan TCC2 punya dua, jadi WO[2] dan WO[3] mereka mengulang WO[0] dan WO[1]. Itulah sebabnya tabel bagian 1 memasangkan beberapa pin.
TC (0x4200_2C00 + 0x400 n, untuk TC3 sampai TC7):
| offset | register |
|---|---|
0x00 |
CTRLA: bit 0 SWRST, bit 1 ENABLE, bit 2..3 MODE (0 COUNT16, 1 COUNT8, 2 COUNT32), bit 5..6 WAVEGEN, bit 8..10 PRESCALER |
0x02 |
READREQ (diterima, tidak melakukan apa pun: count selalu terkini) |
0x04/0x05 |
CTRLBCLR/CTRLBSET (disimpan) |
0x0C/0x0D |
INTENCLR/INTENSET |
0x0E |
INTFLAG: bit 0 OVF |
0x0F |
STATUS (selalu 0) |
0x10 |
COUNT, pada lebar yang dikatakan MODE |
0x14 |
PER, hanya di COUNT8 |
0x18 + c |
CC0, CC1, berjarak satu byte di COUNT8, dua di COUNT16, empat di COUNT32 |
Pada PWM normal (WAVEGEN = 2) nilai puncak TC adalah PER dalam mode COUNT8 dan selebar penuh counter pada mode lainnya; pada PWM match (WAVEGEN = 3) CC0 adalah periodenya dan CC1 duty cycle-nya. Keluaran gelombang tinggi dari awal periode sampai terjadi compare match dan rendah setelahnya, jadi nilai compare 0 menghasilkan rendah terus-menerus dan nilai compare melewati puncak menghasilkan tinggi terus-menerus, tanpa transisi sama sekali. Itulah bentuk yang diinginkan analogWrite dan satu-satunya bentuk yang dihasilkan model ini.
Flag overflow mencapai NVIC saat bit INTENSET-nya diset. Capture, event system, mode one-shot dan ramp, dithering, penyisipan dead-time, pembangkitan pola, serta input fault semuanya tidak ada.
3.5 ADC (0x4200_4000)
Konversi tunggal yang dipicu perangkat lunak, dan itu adalah satu-satunya jalur yang diambil analogRead.
| offset | register | |
|---|---|---|
0x00 |
CTRLA |
bit 0 SWRST, bit 1 ENABLE |
0x01 |
REFCTRL |
tersimpan, terbaca kembali |
0x02 |
AVGCTRL |
tersimpan, terbaca kembali |
0x03 |
SAMPCTRL |
tersimpan, terbaca kembali |
0x04 |
CTRLB |
bit 4..5 RESSEL: 0 dua belas bit, 2 sepuluh, 3 delapan |
0x06 |
WINCTRL |
tersimpan, terbaca kembali |
0x08 |
SWTRIG |
bit 0 FLUSH, bit 1 START |
0x0C |
INPUTCTRL |
bit 0..4 MUXPOS; MUXNEG dan GAIN disimpan |
0x10 |
EVCTRL |
disimpan |
0x12/0x13 |
INTENCLR/INTENSET |
|
0x14 |
INTFLAG |
bit 0 RESRDY, bit 1 OVERRUN |
0x15 |
STATUS |
selalu 0 |
0x16 |
RESULT |
membacanya akan menghapus RESRDY |
0x18..0x22 |
WINLT, WINUT, GAINCORR, OFFSETCORR, CALIB, DBGCTRL |
tersimpan, terbaca kembali |
Satu konversi: arahkan MUXPOS ke kanal, tulis SWTRIG.START, tunggu RESRDY, baca RESULT. Prosesnya memakan waktu tetap 6 mikrodetik waktu simulasi, dan firmware benar-benar menunggunya. Hasilnya adalah round(4095 x Vin / 3.3) dari tegangan pad pada saat konversi dimulai, digeser turun untuk RESSEL di bawah dua belas bit. Kanal yang pinnya tidak dipegang apa pun terbaca 0.
Referensi dan gain tidak berpengaruh di sini. REFCTRL.REFSEL dan INPUTCTRL.GAIN disimpan dan bisa dibaca kembali, dan model selalu mengukur terhadap rel 3,3 V, yang merupakan hasil dari pengaturan bawaan core Arduino, INTVCC1 dengan gain DIV2, di board ini. Sketch yang beralih ke referensi internal 1,0 V mendapatkan angka yang sama di sini dengan yang akan didapatkannya di INTVCC1, dan dokumen ini menyatakannya demikian daripada mengarang skala. Averaging, window monitor, koreksi, mode free-run, mode diferensial, dan event system tidak ada.
Kanal 0..19 tersedia. Tabel di bagian 1 memetakan kanal-kanal itu ke pad.
3.6 EIC (0x4000_1800)
Enam belas jalur EXTINT, yang menjadi dasar attachInterrupt. Sebuah pad mencapai controller dengan mengambil fungsi periferal A, dan jalur mana yang dituju sudah ditentukan oleh pad tersebut (bagian 1).
| offset | register |
|---|---|
0x00 |
CTRL: bit 0 SWRST, bit 1 ENABLE |
0x01 |
STATUS: bit 7 SYNCBUSY, selalu 0 |
0x02/0x03 |
NMICTRL/NMIFLAG (disimpan; NMI itu sendiri tidak dinaikkan) |
0x04 |
EVCTRL (disimpan) |
0x08/0x0C |
INTENCLR/INTENSET |
0x10 |
INTFLAG |
0x14 |
WAKEUP (disimpan) |
0x18/0x1C |
CONFIG0/CONFIG1: empat bit SENSE dan satu FILTEN per jalur |
SENSE: 0 tidak ada, 1 naik, 2 turun, 3 keduanya, 4 level tinggi, 5 level rendah. Sebuah transisi terkunci di INTFLAG dan ditulis untuk menghapusnya. Sebuah level mempertahankan INTFLAG tetap diset selama pin berada pada level itu, jadi handler yang tidak menghilangkan kondisinya akan berjalan lagi, persis seperti pada komponen aslinya. FILTEN disimpan dan tidak menyaring apa pun.
Keenam belas jalur berbagi satu vektor NVIC; runtime membaca INTFLAG dan memanggil handler mana pun yang terpasang.
3.7 Perangkat USB (0x4100_5000): stub yang membawa byte
Pada XIAO satu-satunya soket board terhubung ke USB milik SAM D21 sendiri, dan serial monitor di mejamu berbicara dengan antarmuka CDC ACM yang dienumerasi oleh firmware sketch. Itulah fakta yang membuat board ini apa adanya, dan fakta itu juga yang membuatnya rumit: belum ada Serial sampai firmware menjawab belasan transfer kontrol.
Yang ada di sini adalah pipa dengan nama register ditempelkan padanya, dan jalur transfernya adalah jalur asli komponennya.
| offset | register |
|---|---|
0x00 |
CTRLA: bit 0 SWRST, bit 1 ENABLE, bit 7 MODE |
0x02 |
SYNCBUSY (selalu 0) |
0x03 |
QOSCTRL (disimpan) |
0x08 |
CTRLB: bit 0 DETACH, diset saat reset |
0x0A |
DADD (disimpan) |
0x0C/0x0D/0x10 |
STATUS, FSMSTATUS, FNUM: semuanya terbaca 0; tidak ada bus yang punya state |
0x14/0x18/0x1C |
INTENCLR/INTENSET/INTFLAG (disimpan; tidak ada yang pernah dinaikkan) |
0x20 |
EPINTSMRY |
0x24 |
DESCADD |
0x28 |
PADCAL (disimpan) |
0x100 + 0x20 n |
endpoint n: EPCFG +0, EPSTATUSCLR +4, EPSTATUSSET +5, EPSTATUS +6, EPINTFLAG +7, EPINTENCLR +8, EPINTENSET +9 |
Tabel deskriptor di DESCADD adalah yang asli: dua bank per endpoint, enam belas byte masing-masing, ADDR di +0 dan PCKSIZE di +4 dengan BYTE_COUNT di bit 0..13 dan SIZE di bit 28..30.
- IN. Firmware mengisi buffer, menulis panjangnya ke
PCKSIZEbank 1 dan menyetelEPSTATUS.BK1RDY. Model membaca byte itu dari SRAM, menyerahkannya ke serial monitor, menghapusBK1RDYdan menaikkanEPINTFLAG.TRCPT1. - OUT. Firmware menghapus
EPSTATUS.BK0RDYuntuk menandakan bank 0 bebas. Model menyalin apa pun yang sudah diketik di monitor keADDRbank 0, menulis panjangnya kePCKSIZEmiliknya, menyetelBK0RDYdan menaikkanEPINTFLAG.TRCPT0.
Tidak ada hal lain tentang USB di sini. Tidak ada host, tidak ada bus, tidak ada reset, tidak ada paket SETUP, tidak ada descriptor, tidak ada enumerasi, tidak ada pengalamatan, tidak ada penghitung frame, tidak ada start-of-frame 1 ms, tidak ada NAK, tidak ada STALL dan tidak ada LPM. INTFLAG tidak pernah naik dan interupsi USB tidak pernah sampai ke NVIC, jadi runtime-nya melakukan polling. Sebuah sketch yang menjalankan ini seperti Arduino core menjalankan silikon sungguhan tetap akan bekerja (ia melakukan polling bit bank-ready, yang berperilaku benar), tapi sketch yang menunggu enumerasi akan menunggu selamanya, jadi while (!Serial) {} langsung kembali di sini dan menunggu di meja nyata. Keyboard dan Mouse, yang adalah separuh alasan board native-USB ada, tidak tersedia sama sekali.
Tidak ada baud rate di kanal ini, dan itu bukan jalan pintas: port CDC ACM memang tidak punya baud rate sendiri. Serial.begin(115200) meneruskan angka yang akan sampai ke host sebagai permintaan line coding, dan host bebas mengabaikannya.
3.8 Interupsi
NVIC ada di core pada alamat arsitekturnya, dengan dua bit prioritas. Tabel vektornya milik SAM D21: 0 PM, 1 SYSCTRL, 2 WDT, 3 RTC, 4 EIC, 5 NVMCTRL, 6 DMAC, 7 USB, 8 EVSYS, 9..14 SERCOM0..5, 15..17 TCC0..2, 18..22 TC3..TC7, 23 ADC, 24 AC, 25 DAC, 26 PTC, 27 I2S.
Interupsi yang benar-benar dinaikkan model ini: EIC, SERCOM0..5, ADC, TCC0..2 dan TC3..TC7. Interupsi USB tidak dinaikkan (bagian 3.7) dan interupsi lainnya juga tidak.
4. Kanal host
host_write menaruh byte ke antrean terima USB; host_read mengambil byte yang sudah keluar darinya. Itulah Serial dalam sebuah sketch dan serial monitor di UI. Byte berupa UTF-8 sejauh UI yang bersangkutan dan isinya tidak diperhatikan oleh model.
Serial1 bukan kanal host. Ia menuju D6 dan D7 dan tidak ke mana pun lain, jadi apa yang sketch cetak di sana hanya sampai ke serial monitor jika ada sesuatu di breadboard yang membawanya kembali.
5. Model waktu dan komponen
Pikodetik dalam u64, seperti kernel. Core berjalan di 48 MHz, jadi satu siklus adalah 20833.33 ps, bukan bilangan bulat, dan itu sebabnya waktu tidak pernah diakumulasi: selalu dihitung ulang dari jumlah siklus sebagai cycles x 1_000_000 / 48. Satu irisan 10 us tepat 480 siklus dan tepat 10.000.000 ps, jadi batas irisan tidak pernah bergeser. Penghitung siklus dijangkarkan ke waktu kernel di awal setiap irisan, jadi timer tidak akan pernah bergeser dari rangkaian bagaimanapun irisan jatuhnya, dan core yang diparkir mengejar siklus yang dilewati saat tidur, termasuk SysTick, yang dihitung oleh millis().
Irisan berjalan dalam dua gigi, seperti model STM32: batch kasar yang dibatasi deadline periferal berikutnya, dan satu instruksi dalam satu waktu selama 100 us setelah store yang mendarat di register PORT, SERCOM, timer atau USB. Jadi program yang menyentuh pin berjalan halus dan program yang menghitung berjalan kasar.
probe adalah bitmask: 1 berjalan, 2 parkir di WFI, 4 LED user menyala, 8 LED RX, 16 LED TX, 32 kirim serial dalam 20 ms terakhir, 64 terima serial; 0 tanpa program. Tiga bit LED sudah benar arahnya: pad-nya active low dan komponennya sudah membaliknya.
poke: 1 menahan reset, 0 melepaskannya.
6. Runtime firmware (firmware/xiao/)
Runtime berbentuk Arduino yang ditulis untuk board ini: setup() dan loop(), pinMode, digitalWrite, digitalRead, shiftOut, analogRead (dengan analogReadResolution), analogWrite, millis, micros, micros64, delay, delayMicroseconds, attachInterrupt, detachInterrupt, interrupts, noInterrupts, Serial dan Serial1. Tanpa Atmel Software Framework, tanpa Arduino core, tanpa CMSIS, tanpa newlib, tanpa libgcc dan tanpa compiler-rt.
delay() memarkir: ia menjalankan WFI dan interupsi SysTick berikutnya membangunkannya. Core yang diparkir tidak menyelesaikan instruksi apa pun dan kernel langsung melompat ke waktu bangun, jadi blink menghabiskan satu detik waktu simulasi untuk seribu interupsi alih-alih empat puluh delapan juta siklus. Delay di dalam noInterrupts() malah busy-wait, karena core yang diparkir dengan PRIMASK aktif tidak akan pernah menjalankan handler yang memajukan jam.
analogWrite delapan bit di 732.42 Hz (256 hitungan, PER 255, dari jam 48 MHz dibagi 256: 48 MHz / 256 / 256, frekuensi Arduino Zero) pada sepuluh pad yang menjangkau timer. 0 dan 255 bukan PWM: keduanya mengembalikan pad ke PORT dan menggerakkannya rendah atau tinggi, jadi analogWrite(pin, 0) benar-benar mati.
Dibangun dengan clang --target=thumbv6m-none-eabi -mcpu=cortex-m0plus -mthumb, di-link terhadap firmware/xiao/link.ld dengan ld.lld. Lima file runtime milik Raspberry Pi Pico, dikompilasi ulang untuk board ini alih-alih disalin: pemformatan angka, helper matematika, floor freestanding dan Print. Kedua komponen adalah Cortex-M0+ dan tidak ada dalam file itu yang bergantung pada lokasi periferal. Milik board ini sendiri: header register, tabel pin, kode startup, skrip linker, dua kelas serial dan driver GPIO, analog, waktu, SERCOM, USB dan interupsi. Helper pembagian, perkalian dan shift AEABI di crt0.S milik Pico instruksi demi instruksi, karena kontrak register mereka milik ABI, bukan chip.
String program di katalog adalah elf32 arm samd21. Berbeda dari elf32 arm rp2040 milik Pico karena ELF-nya memang berbeda: set instruksi yang sama, peta memori yang berbeda, dan image yang di-link untuk salah satunya tidak akan berjalan di yang lain.
Empat contoh: blink (LED user dan satu di D10), button (saklar di D2, pada EXTINT10), serial (kedua port, dengan jumper dari D6 ke D7) dan analog (knob di A10 dan fade di D9). Contoh dianggarkan 32 KB, dan batas sebenarnya yang ditegakkan skrip link adalah 32 KB SRAM.
7. Apa yang sudah pasti pada model ini, dan apa yang belum
Tiga kelompok. Bagian ini ada karena model board yang diam-diam menebak sebuah alamat lebih buruk daripada yang mengaku tidak tahu.
Diambil dari datasheet. Peta memori bagian 2: 256 KB flash di nol, 32 KB SRAM di 0x2000_0000, dan alamat dasar PM, SYSCTRL, GCLK, EIC, PORT, USB, enam SERCOM, TCC0-2, TC3-7 dan ADC, dengan jarak 0x400 antar instance. Tata letak register PORT dan jarak grup 0x80-nya, termasuk aturan OUT-memilih-pull dan posisi bidang WRCONFIG. Tata letak SERCOM USART dan rumus baud aritmetikanya. Tata letak TCC. Tata letak ADC. Tata letak EIC dan bidang SENSE empat bitnya. Register perangkat USB, jarak endpoint 0x20 dan bank descriptor enam belas byte dengan ADDR dan PCKSIZE. Encoding PRESCALER, termasuk lompatan dari DIV16 ke DIV64. Nomor vektor interupsi bagian 3.8. Dua bit prioritas NVIC.
Diyakini, tidak diverifikasi. Dua hal, dan program yang dibawa ke silikon sungguhan sebaiknya memeriksa keduanya:
- Offset register blok TC di bagian 3.4:
CTRLA0x00,READREQ0x02,CTRLBCLR/CTRLBSET0x04/0x05,CTRLC0x06,DBGCTRL0x08,EVCTRL0x0A,INTENCLR/INTENSET0x0C/0x0D,INTFLAG0x0E,STATUS0x0F,COUNT0x10,PER0x14,CC0x18. Offset TCC bisa dinyatakan model ini dengan pasti; offset TC adalah pembacaan terbaiknya atas sebuah blok yang layout-nya berubah sesuaiMODE, dan angka itulah yang menjadi dasarfirmware/xiao/include/samd21.h, jadi firmware yang dibangun di sini cocok dengan model ini, cocok atau tidak dengan silikon aslinya. - Tabel multiplexing periferal di bagian 1: kolom
PMUXmana di tiap pad yang membawa pad SERCOM mana, barisEXTINTmana, dan output gelombang mana. Angka pad di belakang tiap pin XIAO adalah milik board dan menjadi dasar firmware; channel timer mana yang bisa dijangkau sebuah pad adalah dasar sketch PWM, dan kesalahan di situ muncul sebagai pin yang tidak meredup, bukan sebagai angka yang salah.crates/atsamd21/src/mux.rsadalah seluruh tabelnya dalam satu tempat.
ID klien generic clock di samd21.h (GCLK_ID_EIC dan lainnya) ada di grup yang sama. Tidak ada yang digerakkan olehnya di sini (bagian 3.2), jadi kesalahan pada salah satunya tak terlihat di Mokxi tetapi akan menghentikan periferal sepenuhnya di meja kerja nyata.
Sengaja tidak ada. Masing-masing sengaja ditinggalkan, bukan dikarang:
- Pohon clock. Tidak ada DFLL, tidak ada osilator, tidak ada PLL, tidak ada generator. Bagian 3.2 menjelaskan apa yang menjadi penggantinya.
- SPI dan I2C pada SERCOM. Bagian 3.3 hanya mode USART saja, jadi
WiredanSPItidak tersedia. - DAC, yang sebenarnya adalah fungsi utama PA02, komparator analog, PTC dan I2S.
- DMAC dan EVSYS. Tidak ada DMA dan tidak ada tautan event antar periferal, yang seharusnya dipakai register
EVCTRLtimer. - NVMCTRL dan pemrograman flash, watchdog, RTC dan DSU. Dipetakan tetapi tidak aktif (bagian 2).
- Seluruh USB di atas pipa byte sederhana, yang dijelaskan panjang lebar di bagian 3.7, dan bersamanya Keyboard dan Mouse.
- The UF2 bootloader. An image here starts at zero; a real XIAO's starts at 0x2000 (section 2).
Itulah sebabnya biner inti Arduino dari vendor tidak berjalan di sini, dan firmware yang dibangun untuk dokumen ini berjalan.