Referensi

Kontrak board Seeed XIAO SAMD21 (Fase 9)

ATSAMD21G18A: dua grup PORT, SERCOM sebagai USART, PWM TCC dan TC, ADC di setiap pad, dan USB sebagai pipa byte.

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:

  • D0 tidak 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.
  • D4 tidak punya external interrupt biasa. PA08 adalah pin NMI chip. attachInterrupt(4, ...) tidak melakukan apa pun, di sini maupun di meja nyata.
  • D5 dan D7 berbagi EXTINT9, jadi hanya salah satu dari keduanya yang bisa membawa interrupt pada satu waktu; yang kedua attachInterrupt mengambil jalur dari yang pertama. Dan karena TCC1 dan TCC2 masing-masing punya dua register compare, beberapa pin berbagi satu duty: menulis analogWrite di salah satu D1/D4, D9/D5, D10/D2 atau D8/D3 memindahkan 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. DFLLSYNC terbaca 0. Jadi while (!(SYSCTRL->PCLKSR.reg & DFLLRDY)) {} langsung terlewati.
  • GCLK (0x4000_0C00): CTRL di 0x00 (bit 0 SWRST), STATUS di 0x01 (bit 7 SYNCBUSY, tidak pernah diset), CLKCTRL di 0x02, GENCTRL di 0x04, GENDIV di 0x08. 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): AHBMASK 0x14, APBAMASK 0x18, APBBMASK 0x1C, APBCMASK 0x20, semuanya disimpan dan terbaca kembali pada nilai reset-nya, dan RCAUSE di 0x38, 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 PCKSIZE bank 1 dan menyetel EPSTATUS.BK1RDY. Model membaca byte itu dari SRAM, menyerahkannya ke serial monitor, menghapus BK1RDY dan menaikkan EPINTFLAG.TRCPT1.
  • OUT. Firmware menghapus EPSTATUS.BK0RDY untuk menandakan bank 0 bebas. Model menyalin apa pun yang sudah diketik di monitor ke ADDR bank 0, menulis panjangnya ke PCKSIZE miliknya, menyetel BK0RDY dan menaikkan EPINTFLAG.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: CTRLA 0x00, READREQ 0x02, CTRLBCLR/CTRLBSET 0x04/0x05, CTRLC 0x06, DBGCTRL 0x08, EVCTRL 0x0A, INTENCLR/INTENSET 0x0C/0x0D, INTFLAG 0x0E, STATUS 0x0F, COUNT 0x10, PER 0x14, CC 0x18. Offset TCC bisa dinyatakan model ini dengan pasti; offset TC adalah pembacaan terbaiknya atas sebuah blok yang layout-nya berubah sesuai MODE, dan angka itulah yang menjadi dasar firmware/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 PMUX mana di tiap pad yang membawa pad SERCOM mana, baris EXTINT mana, 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.rs adalah 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 Wire dan SPI tidak 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 EVCTRL timer.
  • 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.