Bu, modelin mühendislik referansıdır: neyi uyguladığını, yazmaç yazmaç, ona karşı firmware yazan kişiler için. Kartı düzenleyicide kullanmak için başlangıç noktan Seeed XIAO SAMD21 ve kart sayfası.
XIAO SAMD21 buradaki en küçük kart ve üçüncü Cortex-M0+. Tek bir çekirdek bileşeni (crates/parts içindeki xiao), bir ATSAMD21G18A SoC modelini (crates/atsamd21), Raspberry Pi Pico ile aynı çekirdek üzerinde sarar (crates/cortexm-core, Profile::V6M). Çekirdek paylaşılmıştır; etrafındaki çip değildir. Bu belge sözleşmedir ve koddaki herhangi bir yorumdan üstün tutulur.
Katalog türü xiao'dur.
Buradaki bir derlemeyi gerçek silikona taşıyorsan önce 7. bölümü oku. Bu modeldeki her taban adresi bu belgenin SAM D21 Family Datasheet üzerinden söyleyebildiği bir adrestir ve çoğu kaydırma ofseti de öyle, ama TC bloğunun ofsetleri ve çevresel çoğullama tablosu bu modelin okumasıdır, geri sayfalanan bir alıntı değil, ve 7. bölüm her birini adıyla anar. Burada sessizce tahmin edilmiş hiçbir şey yok.
1. Kart pinleri (katalog sırası)
Üstten görünüm, USB-C soketi yukarıda, ATSAMD21G18A ortadaki baskının altında. Kart 21 x 17.8 mm ve ikişer yedi padlik iki sırası 15.24 mm (tam 0.6 inç) arayla, yani bir breadboard'un orta kanalına oturur.
Sol sütun, yukarıdan aşağıya (7 pad): D0, D1, D2, D3, D4, D5, D6.
Sağ sütun, yukarıdan aşağıya (7 pad): 5V, GND, 3V3, D10, D9, D8, D7.
14 pad. On biri I/O, üçü güç. On bir padin her biri aynı zamanda analog giriştir ve A0 ile A10, D0 ile D10 padleriyle aynıdır; baskı ikisini de yazdırır.
Her pinin arkasındaki pad ve başka neler yapabildiği:
| pin | pad | AIN |
EXTINT |
PWM (E işlevi) | diğer |
|---|---|---|---|---|---|
D0 / A0 |
PA02 | 0 | 2 | yok | DAC'ın çıkışı |
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 |
O tabloda iki kez okunmaya değer üç şey var ve üçü de modelden ziyade donanımdır:
D0PWM desteklemez. PA02, DAC'ın pinidir ve hiçbir dalga formu çıkışı vermez.analogWrite(0, x)buradaki pad, soluyormuş gibi yapmak yerine tam yarı yolda açılıp kapanır.D4pininde sıradan bir harici kesme yok. PA08, çipin NMI pinidir.attachInterrupt(4, ...)hem burada hem masada hiçbir şey yapmaz.D5veD7EXTINT9paylaşır, yani ikisinden yalnızca biri aynı anda kesme taşıyabilir; ikincisiattachInterrupthattı birinciden alır. Ve TCC1 ile TCC2'nin ikişer karşılaştırma kaydı olduğu için bazı pinler görev döngüsü paylaşır: birine yazmakanalogWriteşunlardan birindeD1/D4,D9/D5,D10/D2ya daD8/D3ikisini de hareket ettirir.
Kartta ve hiçbir padda olmayan üç LED var: PA17'deki kullanıcı LED'i, PA18'deki RX LED'i ve PA19'daki TX LED'i. Üçü de aktif düşük, yani digitalWrite(LED_BUILTIN, LOW) kullanıcı olanı yakar. Bunlar prob ve görsel üzerinden görülür, başka hiçbir yerde değil. Çalışma zamanı bunlara 13, 12 ve 11 numaralarını verir ve LED_BUILTIN'i 13 olarak tanımlar.
Elektriksel. Her giriş/çıkış paddy R_STRONG üzerinden 3,3 V itme-çekme sürer, yüksek empedansta bekler ya da 40 k üzerinden yukarı ya da aşağı çeker. Bir giriş 1,65 V'ta yüksek okur; çekişmeli (Bilinmeyen) bir ağ 0 okur, boşta olan ise Uno'daki gibi gürültü okur (docs/uno.md bölüm 1). 3V3 her zaman R_SUPPLY üzerinden 3,3 V sürer, 5V 5 V sürer ve GND 0 V sürer, çünkü kart USB'ye takılıdır. Header'da reset paddı yoktur: gerçek bir XIAO'da iki reset paddı alt taraftadır, burada reset bir dokunuştur (bölüm 5).
2. Bellek haritası
| flash | 0x0000_0000 adresinde 256 KB |
| SRAM | 0x2000_0000 ile 0x2000_7FFF arasında 32 KB |
| yığın tepe | 0x2000_8000 |
| PM | 0x4000_0400, bölüm 3.2 |
| SYSCTRL | 0x4000_0800, bölüm 3.2 |
| GCLK | 0x4000_0C00, bölüm 3.2 |
| EIC | 0x4000_1800, bölüm 3.6 |
| PORT | 0x4100_4400, bölüm 3.1 |
| USB | 0x4100_5000, bölüm 3.7 |
| SERCOM0..5 | 0x4200_0800, 0x400 arayla, bölüm 3.3 |
| TCC0..2 | 0x4200_2000, 0x400 arayla, bölüm 3.4 |
| TC3..TC7 | 0x4200_2C00, 0x400 arayla, bölüm 3.4 |
| ADC | 0x4200_4000, bölüm 3.5 |
Her PT_LOAD segmenti flash ya da SRAM içinde olmalıdır; başka bir adres, mesajda sorun yaratan adresle birlikte reddedilir ve çip programsız kalır.
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.
Veri sayfasında bulunan ama bu modelde bulunmayan bloklar (PAC0-2, DSU, NVMCTRL, DMAC, MTB, WDT, RTC, EVSYS, AC, DAC, PTC, I2S) eşlenmiş ve etkisizdir: birini okumak 0 verir ve hatalı erişim olarak sayılır, hata oluşturmaz. NVM denetleyicisinin bekleme durumlarına dokunan bir başlangıç kodu kartı çökertmemelidir. Her bloğun dışındaki her şey bir erişim hatasıdır; bu, ARMv6-M'de bir HardFault'tur ve kart bunu ana kanalda çökme olarak bildirir.
3. Çevre birimi yazmaçları
Yalnızca aşağıdaki alt küme uygulanmıştır. Bir SAM D21 yazmacı sekiz, on altı veya otuz iki bit genişliğindedir ve veri yolu her birini kendi genişliğinde sunar: yazmacından dar bir erişim, veri yolu matrisinin yapacağı okuma-değiştirme-yazma işlemidir; daha geniş olan ise başladığı yazmaçtan yanıtlanır. Böylece veri sayfasının kendi türlerine göre yazılmış firmware değişmeden çalışır.
3.1 PORT (0x4100_4400)
İki grup, PA ve PB, 0x80 arayla. Pedler bu modelde 0..63 olarak numaralandırılır: 0..31 PA00..PA31 ve 32..63 PB00..PB31'dir.
| ofset | yazmaç |
|---|---|
0x00 |
DIR |
0x04 |
DIRCLR |
0x08 |
DIRSET |
0x0C |
DIRTGL |
0x10 |
OUT |
0x14 |
OUTCLR |
0x18 |
OUTSET |
0x1C |
OUTTGL |
0x20 |
IN |
0x24 |
CTRL (saklanır, geri okunur) |
0x28 |
WRCONFIG |
0x30 + n |
PMUXn, pin çifti başına bir bayt |
0x40 + n |
PINCFGn, pin başına bir bayt |
PINCFG bit 0 PMUXEN, bit 1 INEN, bit 2 PULLEN, bit 6 DRVSTR (saklanır, elektriksel olarak yok sayılır).
OUT çift görev üstlenir ve bu parçanın tek gerçek tuzağıdır. ayarlıyken sürülen seviyedir; DIR set it is the driven level; with DIR clear it is the yönüdür. Yani INPUT_PULLUP şudur DIRCLR, sonra OUTSET, sonra PINCFG.PULLEN, ve PULLEN olmadan OUT şunu sağlar: yukarı çekmeaşağı. Üçte ikisi bu durumdayken pin sessizce yanlış işlem yapar.
WRCONFIG tek bir yazmada on altı pinin PINCFG ve PMUX değerlerini yazar: PINMASK 0..15 bitlerinde, PMUXEN 16, INEN 17, PULLEN 18, DRVSTR 22, PMUX 24..27, WRPMUX 28, WRPINCFG 30, HWSEL 31 (bu, maskeyi 16..31 pinlerine kaydırır).
PMUXEN ayarlandığında PMUX, sekiz çevre birimi işlevinden (A..H) birini seçer ve pad PORT'un elinden çıkar. Model, sahip olduğu çevre birimlerinde (USART modunda SERCOM ve TC/TCC dalga formu çıkışları, bölüm 1'deki tablo) etkili olur; diğer tüm seçimleri, hiçbir şey istemeyen ve bir seviye uydurmak yerine pad'i yüksek empedansta bırakan, sahip olmadığı bir çevre birimi olarak değerlendirir. Pad'in pull'u hâlâ pad'indir; bir SERCOM RX pini de pull-up'ını böyle korur.
IN, INEN sıfır olan bir pinden 0 okur; donanım da tam olarak bunu yapar. Bu çipin sürdüğü bir pad, sürdüğü değeri geri okur.
3.2 PM, GCLK ve SYSCTRL: saat ağacı modellenmedi
Çekirdek ilk komuttan itibaren 48 MHz'de çalışır. Burada saat ağacı yoktur: DFLL yok, osilatör yok, bölücü yok, gerçekten bir şey üreten üreteç yok. Bu üç blok, gerçek yazmaçlara göre yazılmış bir başlangıç kodunun hazır bitinde takılıp kalmak yerine sonuna kadar çalışması için vardır.
- SYSCTRL (
0x4000_0800), iki istisna dışında otuz iki kelimelik bir gölgedir.PCLKSR(0x0C) tüm hazır ve kilit bitlerini ayarlı (XOSCRDY,XOSC32KRDY,OSC32KRDY,OSC8MRDY,DFLLRDY,DFLLLCKF,DFLLLCKC,DFLLRCS,BOD33RDY,DPLLLCKF,DPLLLCKT), tüm hata bitlerini ise temiz okur.DFLLSYNC0 okur. Yaniwhile (!(SYSCTRL->PCLKSR.reg & DFLLRDY)) {}doğrudan geçer. - GCLK (
0x4000_0C00):CTRL0x00adresinde (SWRSTbit 0),STATUS0x01adresinde (SYNCBUSYbit 7, hiçbir zaman set edilmez),CLKCTRL0x02adresinde,GENCTRL0x04adresinde,GENDIV0x08adresinde. Son üçü, parçadaki gibi, yazılan değerdeki ID ile adreslenir ve bir okuma, en son yazılan ID için yanıt verir. Bunlara hiçbir şey bağlanmaz. - PM (
0x4000_0400):AHBMASK0x14,APBAMASK0x18,APBBMASK0x1C,APBCMASK0x20, tümü sıfırlama değerlerinde saklanır ve geri okunur;RCAUSEise0x38adresinde olup burada salt okunurdur ve parçayı en son sıfırlayan şeye göre açılış bitini, harici sıfırlama bitini veya sistem sıfırlama bitini taşır. Saat maskeleriyle hiçbir şey koşullandırılmamıştır: bir çevre birimi, firmware saatini açmış olsa da olmasa da çalışır. Çalışma zamanı yine de onları açar, çünkü gerçek bir parça buna gerek duyar.
Zamanın kendisi SysTick'ten gelir; bu, mimari adresinde cortexm-core içindedir. Çalışma zamanı onu her 48 000 döngüde bir yeniden yükler (48 MHz'da tam bir milisaniye) ve SYST_CALIB bunu tam olarak on milisaniyenin onda biri olarak bildirir.
3.3 SERCOM bir USART olarak (0x4200_0800 + 0x400 n)
Altı SERCOM, her biri dahili saatli USART modunda modellenmiştir (CTRLA.MODE = 1), asenkron 8N1 ve başka hiçbir modda değil. SPI ve I2C modellenmedi; bu modlardan birine konmuş bir SERCOM hiçbir şey yapmaz.
| ofset | yazmaç |
|---|---|
0x00 |
CTRLA |
0x04 |
CTRLB |
0x08 |
DBGCTRL (saklanır) |
0x0C |
BAUD |
0x0E |
RXPL (saklanır) |
0x14 |
INTENCLR |
0x16 |
INTENSET |
0x18 |
INTFLAG |
0x1A |
STATUS (saklanır; hiçbir zaman hata verilmez) |
0x1C |
SYNCBUSY (her zaman 0) |
0x28 |
DATA |
CTRLA bit 0 SWRST, bit 1 ENABLE, bit 2..4 MODE, bit 16..17 TXPO (0 PAD[0]'ı sürer, diğer her değer PAD[2]'yi sürer), bit 20..21 RXPO (alıcının dinlediği pad), bit 30 DORD. CTRLB bit 16 TXEN, bit 17 RXEN. INTFLAG bit 0 DRE, bit 1 TXC (tutulur, temizlemek için 1 yazılır), bit 2 RXC.
BAUD asenkron aritmetik üreteçtir: BAUD = 65536 (1 - 16 f / f_ref), yani bir bit süresi 16 x 65536 / (65536 - BAUD) referans saatidir. Referans, 48 MHz çekirdek saati kabul edilir, çünkü sorulacak bir saat ağacı yoktur (bölüm 3.2). 0 olan bir BAUD değeri (begin() çağırmamış bir programın arkasında bıraktığı değer) 115200'e düşer. Kesirli mod yoktur.
Etkinleştirilmiş ve TXEN kurulu bir verici pad'ine sahiptir ve onun üzerinden gerçek bitler kaydırır: düşük bir başlangıç biti, önce en düşük anlamlı olmak üzere sekiz veri biti, yüksek bir durma biti, her biri bir bit süresi uzunluğunda, her kenar donanımın onu hareket ettireceği döngü ile damgalanır. RXEN kurulu bir alıcı, düşen kenarda bir çerçeve başlatır ve her veri bitini bit süresinin ortasında örnekler. Böylece D6'dan D7'ye bir jumper bir karakter taşır ve uyumsuz bir baud hızı burada da, masada olduğu gibi metni bozar.
Bu kartta Serial1, TXPO 0 ve RXPO 1 ile SERCOM4'tür; bu da PB08 üzerinde PAD[0] ve PB09 üzerinde PAD[1] demektir (D6 ve D7), ikisi de çevre birim işlevi C'de.
3.4 TCC0-2 ve TC3-7, PWM tarafına kadar
Üç TCC ve beş TC. Buradaki bir sayaç hiçbir zaman adım adım ilerletilmez: CPU döngüsünün kapalı biçimli bir fonksiyonudur, bir sonraki kenarının zamanı da öyle; bir PWM çalışmaya devam ederken WFI'da bekleyen bir çekirdeğin tüm bir delay() boyunca hiçbir şeye mal olmamasını sağlayan da budur.
PRESCALER her iki türde de CTRLA'nın 8..10 bitleridir ve en yukarıya kadar ikinin kuvveti değildir: 0 ile 4 arası DIV1, DIV2, DIV4, DIV8 ve DIV16'dır, sonra 5 DIV64, 6 DIV256 ve 7 DIV1024'tür. Bu sıçrama gerçek bir tuzaktır ve yanlış yapmak PWM'i dört kat yavaşlatır.
TCC (0x4200_2000 + 0x400 n):
| ofset | yazmaç |
|---|---|
0x00 |
CTRLA: bit 0 SWRST, bit 1 ENABLE, bit 8..10 PRESCALER |
0x04/0x05 |
CTRLBCLR/CTRLBSET (saklanır) |
0x08 |
SYNCBUSY (her zaman 0) |
0x24/0x28 |
INTENCLR/INTENSET |
0x2C |
INTFLAG: bit 0 OVF |
0x30 |
STATUS (her zaman 0) |
0x34 |
COUNT |
0x3C |
WAVE: bit 0..2 WAVEGEN; bunlardan 2 normal PWM'dir |
0x40 |
PER, periyot |
0x44 + 4c |
CC0..CC3, görev döngüleri |
0x68/0x6C/0x70 + 4c |
WAVEB/PERB/CCBn; burada anında etkili olurlar |
TCC0'ın dört karşılaştırma kanalı vardır; TCC1 ve TCC2'nin iki kanalı vardır, bu yüzden WO[2] ve WO[3], WO[0] ve WO[1]'i tekrarlar. Bölüm 1'deki tablonun bazı pinleri eşleştirmesinin nedeni budur.
TC (0x4200_2C00 + 0x400 n, TC3'ten TC7'ye):
| ofset | yazmaç |
|---|---|
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 (kabul edilir, bir şey yapmaz: sayaç her zaman günceldir) |
0x04/0x05 |
CTRLBCLR/CTRLBSET (saklanır) |
0x0C/0x0D |
INTENCLR/INTENSET |
0x0E |
INTFLAG: bit 0 OVF |
0x0F |
STATUS (her zaman 0) |
0x10 |
COUNT, MODE'un söylediği genişlikte |
0x14 |
PER, yalnızca COUNT8'de |
0x18 + c |
CC0, CC1; COUNT8'de bir bayt arayla, COUNT16'da iki, COUNT32'de dört |
Normal PWM modunda (WAVEGEN = 2) bir TC'nin üst sınırı COUNT8 modunda PER, diğer modlarda sayacın tam genişliğidir; eşleşme PWM'inde (WAVEGEN = 3) CC0 periyodu, CC1 görev döngüsünü belirler. Dalga formu çıkışı periyodun başından karşılaştırma eşleşmesine kadar yüksek, sonrasında düşüktür, bu yüzden 0 karşılaştırması sürekli düşük, üst sınırı aşan karşılaştırma ise hiç kenar oluşmadan sürekli yüksek verir. Bu, analogWrite'ın istediği şekildir ve bu modelin ürettiği tek şekil de budur.
Taşma bayrağı, INTENSET biti ayarlandığında NVIC'e ulaşır. Yakalama, olay sistemi, tek atım ve rampa, titrek sayma (dithering), ölü süre ekleme, desen üretme ve hata girişleri yoktur.
3.5 ADC (0x4200_4000)
Yazılım tetiklemeli tek dönüşümler, yani analogRead'in kullandığı tek yol.
| ofset | yazmaç | |
|---|---|---|
0x00 |
CTRLA |
bit 0 SWRST, bit 1 ENABLE |
0x01 |
REFCTRL |
saklanır, geri okunur |
0x02 |
AVGCTRL |
saklanır, geri okunur |
0x03 |
SAMPCTRL |
saklanır, geri okunur |
0x04 |
CTRLB |
bit 4..5 RESSEL: 0 on iki bit, 2 on, 3 sekiz |
0x06 |
WINCTRL |
saklanır, geri okunur |
0x08 |
SWTRIG |
bit 0 FLUSH, bit 1 START |
0x0C |
INPUTCTRL |
bit 0..4 MUXPOS; MUXNEG ve GAIN saklanır |
0x10 |
EVCTRL |
saklanır |
0x12/0x13 |
INTENCLR/INTENSET |
|
0x14 |
INTFLAG |
bit 0 RESRDY, bit 1 OVERRUN |
0x15 |
STATUS |
her zaman 0 |
0x16 |
RESULT |
okunduğunda RESRDY temizlenir |
0x18..0x22 |
WINLT, WINUT, GAINCORR, OFFSETCORR, CALIB, DBGCTRL |
saklanır, geri okunur |
Tek dönüşüm: MUXPOS'ı kanala yönlendir, SWTRIG.START yaz, RESRDY'yi bekle, RESULT'ı oku. Bu, simüle edilmiş zamanda sabit 6 mikrosaniye sürer ve firmware bunu gerçekten bekler. Sonuç, dönüşümün başladığı anda pinin geriliminin round(4095 x Vin / 3.3) değeridir; RESSEL on iki bitin altındaysa sağa kaydırılır. Pinini hiçbir şey tutmayan bir kanal 0 okur.
Referans ve kazanç burada hiçbir şey yapmaz. REFCTRL.REFSEL ve INPUTCTRL.GAIN saklanır ve geri okunur; model her zaman 3.3 V beslemeye göre ölçer, ki Arduino çekirdeklerinin kendi ayarları olan INTVCC1 ve DIV2 kazancı bu kartta tam olarak buna denk gelir. 1.0 V dahili referansa geçen bir kod, burada INTVCC1 ile alacağıyla aynı sayıları alır; bu belge de bir ölçek uydurmak yerine bunu böyle söyler. Ortalama alma, pencere izleyicisi, düzeltmeler, serbest çalışma modu, fark modu ve olay sistemi yoktur.
Kanal 0..19 mevcuttur. Bölüm 1'deki tablo bunları pad'lere eşler.
3.6 EIC (0x4000_1800)
On altı EXTINT hattı, yani attachInterrupt'ın üzerine kurulduğu şey. Bir pad, çevre birim işlevi A'yı alarak denetleyiciye ulaşır ve hangi hatta düşeceği pad tarafından sabitlenir (bölüm 1).
| ofset | yazmaç |
|---|---|
0x00 |
CTRL: bit 0 SWRST, bit 1 ENABLE |
0x01 |
STATUS: bit 7 SYNCBUSY, her zaman 0 |
0x02/0x03 |
NMICTRL/NMIFLAG (saklanır; NMI'nin kendisi üretilmez) |
0x04 |
EVCTRL (saklanır) |
0x08/0x0C |
INTENCLR/INTENSET |
0x10 |
INTFLAG |
0x14 |
WAKEUP (saklanır) |
0x18/0x1C |
CONFIG0/CONFIG1: hat başına dört bit SENSE ve bir FILTEN |
SENSE: 0 yok, 1 yükselen, 2 düşen, 3 ikisi, 4 yüksek seviye, 5 düşük seviye. Bir kenar şu ana kilitlenir: INTFLAG ve temizlemek için yazılır. Bir seviye, pin o seviyede kaldığı sürece INTFLAG'i setli tutar, bu yüzden koşulu ortadan kaldırmayan bir işleyici, parçadakiyle tam olarak aynı şekilde tekrar çalışır. FILTEN saklanır ama hiçbir şey filtrelemez.
On altı hattın tamamı tek bir NVIC vektörünü paylaşır; çalışma zamanı INTFLAG'i okur ve bağlı olan işleyicileri çağırır.
3.7 USB aygıtı (0x4100_5000): baytları taşıyan bir taslak
Bir XIAO'da kartın tek soketi SAM D21'in kendi USB'sine gider ve masanızdaki seri monitör, kodun firmware'i numaralandırdığı bir CDC ACM arayüzüyle konuşur. Kartı kart yapan gerçek budur ve işleri güçleştiren de yine odur: firmware bir düzine kontrol transferini yanıtlamadan Serial ortaya çıkmaz.
Burada olan şey, üzerine kayıt adları yazılmış bir borudur ve aktarım yolu parçanın gerçek yoludur.
| ofset | yazmaç |
|---|---|
0x00 |
CTRLA: bit 0 SWRST, bit 1 ENABLE, bit 7 MODE |
0x02 |
SYNCBUSY (her zaman 0) |
0x03 |
QOSCTRL (saklanır) |
0x08 |
CTRLB: bit 0 DETACH, sıfırlamada set edilir |
0x0A |
DADD (saklanır) |
0x0C/0x0D/0x10 |
STATUS, FSMSTATUS, FNUM: tümü 0 okunur; durumu olacak bir veri yolu yoktur |
0x14/0x18/0x1C |
INTENCLR/INTENSET/INTFLAG (saklanır; hiçbir şey hiç üretilmez) |
0x20 |
EPINTSMRY |
0x24 |
DESCADD |
0x28 |
PADCAL (saklanır) |
0x100 + 0x20 n |
uç nokta n: EPCFG +0, EPSTATUSCLR +4, EPSTATUSSET +5, EPSTATUS +6, EPINTFLAG +7, EPINTENCLR +8, EPINTENSET +9 |
DESCADD'daki tanımlayıcı tablosu gerçektir: uç nokta başına iki banka, her biri on altı bayt, ADDR +0'da ve PCKSIZE +4'te, BYTE_COUNT 0..13 bitlerinde ve SIZE 28..30 bitlerinde.
- IN. Firmware bir tampon doldurur, uzunluğu 1 numaralı bankanın
PCKSIZE'ına yazar veEPSTATUS.BK1RDY'yi set eder. Model bu baytları SRAM'den okur, seri monitöre verir,BK1RDY'yi temizler veEPINTFLAG.TRCPT1'i yükseltir. - OUT. Firmware, 0 numaralı bankanın boş olduğunu belirtmek için
EPSTATUS.BK0RDY'yi temizler. Model, monitörün yazdığı her şeyi 0 numaralı bankanınADDR'ine kopyalar, uzunluğuPCKSIZE'ına yazar,BK0RDY'yi set eder veEPINTFLAG.TRCPT0'ı yükseltir.
USB ile ilgili başka hiçbir şey burada yok. Host yok, veri yolu yok, sıfırlama yok, SETUP paketi yok, deskriptör yok, numaralandırma yok, adresleme yok, kare sayacı yok, 1 ms'lik kare başlangıcı yok, NAK yok, STALL yok ve LPM yok. INTFLAG hiç yükselmez ve USB kesmesi hiçbir zaman NVIC'e ulaşmaz, dolayısıyla çalışma zamanı yoklar. Bunu Arduino çekirdeğinin gerçek silikona yaptığı gibi kullanan bir kod yine de çalışır (banka hazır bitlerini yoklar ve bunlar doğru çalışır), ama numaralandırmayı bekleyen bir kod sonsuza kadar bekler, bu yüzden while (!Serial) {} burada hemen döner, gerçek kartta ise bekler. Yerel USB'li bir kartın var olma nedeninin diğer yarısı olan Klavye ve Fare ise hiç mevcut değil.
Bu kanalda baud hızı yoktur ve bu bir kısayol değildir: bir CDC ACM portunun kendine ait bir baud hızı zaten yoktur. Serial.begin(115200) verdiği sayı host'a satır kodlama isteği olarak ulaşır ve host bunu yok saymakta özgürdür.
3.8 Kesmeler
NVIC, çekirdeğin mimari adresinde, iki öncelik bitiyle birlikte yer alır. Vektör tablosu SAM D21'inkidir: 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.
Bu modelin gerçekten yükselttiği hatlar: EIC, SERCOM0..5, ADC, TCC0..2 ve TC3..TC7. USB'inki yükseltilmez (bölüm 3.7) ve başka hiçbirinin ki de yükseltilmez.
4. Ana makine kanalı
host_write baytları USB'nin alma kuyruğuna koyar; host_read ondan çıkmış baytları alır. Bu, koddaki Serial ve arayüzdeki seri monitördür. Baytlar arayüz açısından UTF-8'dir ve model için opaktır.
Serial1 host kanalı değildir. D6 ve D7'ye gider ve başka hiçbir yere gitmez; dolayısıyla oraya yazdırılan şey ancak breadboard üzerindeki bir şey onu geri taşırsa seri monitöre ulaşır.
5. Zaman modeli ve parça
Çekirdek gibi u64 içinde pikosaniyeler. Çekirdek 48 MHz'de çalışır, yani bir çevrim 20833.33 ps'dir, tam sayı değildir; zaman bu yüzden hiçbir zaman biriktirilmez: her seferinde bir çevrim sayısından cycles x 1_000_000 / 48 olarak yeniden hesaplanır. Bir 10 us dilimi tam 480 çevrim ve tam 10,000,000 ps'dir, böylece dilim sınırları asla kaymaz. Çevrim sayacı her dilimin başında çekirdek zamanına sabitlenir, böylece bir zamanlayıcı dilimler nereye düşerse düşsün devreden asla kopamaz ve duraklatılmış bir çekirdek, SysTick dahil, uyuduğu çevrimleri telafi eder; millis() de bunu sayar.
Dilim, STM32 modellerinde olduğu gibi iki vitesle çalışır: bir sonraki çevre birim sonuna kadar sınırlandırılmış kaba toplu işler ve bir PORT, SERCOM, zamanlayıcı ya da USB yazmacına denk gelen her yazmadan sonra 100 us boyunca birer komut. Yani bir pine dokunan program ince vitesle, hesap yapan program kaba vitesle çalışır.
probe bir bit maskesidir: 1 çalışıyor, 2 WFI içinde duraklamış, 4 kullanıcı LED'i yanık, 8 RX LED'i, 16 TX LED'i, 32 son 20 ms içinde seri gönderim, 64 seri alma; program yokken 0. Üç LED biti zaten doğru yöndedir: pad'ler aktif düşüktür ve parça onları ters çevirmiştir.
poke: 1 sıfırlamayı tutar, 0 bırakır.
6. Firmware çalışma zamanı (firmware/xiao/)
Bu kart için yazılmış Arduino biçiminde bir çalışma zamanı: setup() ve loop(), pinMode, digitalWrite, digitalRead, shiftOut, analogRead (analogReadResolution ile), analogWrite, millis, micros, micros64, delay, delayMicroseconds, attachInterrupt, detachInterrupt, interrupts, noInterrupts, Serial ve Serial1. Atmel Software Framework yok, Arduino çekirdeği yok, CMSIS yok, newlib yok, libgcc yok ve compiler-rt yok.
delay() duraklatır: WFI çalıştırır ve onu bir sonraki SysTick kesmesi uyandırır. Duraklatılmış bir çekirdek komut tamamlamaz ve çekirdek doğrudan uyanma zamanına atlar, böylece blink, simüle edilmiş bir saniyesini kırk sekiz milyon çevrim yerine bin kesmeye harcar. noInterrupts() içindeki bir delay bunun yerine meşgul bekler, çünkü PRIMASK set edilmiş duraklatılmış bir çekirdek, saati ilerletecek işleyiciyi hiç çalıştıramaz.
analogWrite, bir zamanlayıcıya ulaşan on pad'de 732.42 Hz'de sekiz bittir (256 sayım, PER 255, 48 MHz saat 256'ya bölünmüş: 48 MHz / 256 / 256, Arduino Zero'nun frekansı). 0 ve 255 PWM değildir: pad'i PORT'a geri verirler ve düşük ya da yüksek sürerler, yani analogWrite(pin, 0) gerçekten kapatır.
clang --target=thumbv6m-none-eabi -mcpu=cortex-m0plus -mthumb ile derlenir, firmware/xiao/link.ld ile ld.lld kullanılarak bağlanır. Çalışma zamanının beş dosyası Raspberry Pi Pico'nunkidir, kopyalanmak yerine bu kart için yeniden derlenmişlerdir: sayı biçimlendirme, matematik yardımcıları, bağımsız floor ve Print. Her iki parça da Cortex-M0+ ve bu dosyaların hiçbirinde bir çevre biriminin nerede olduğuna bağlı bir şey yoktur. Bu kartın kendine ait olanları ise yazmaç başlık dosyası, pin tablosu, başlangıç kodu, bağlayıcı betiği, iki seri sınıf ve GPIO, analog, zaman, SERCOM, USB ve kesme sürücüleridir. crt0.S içindeki AEABI bölme, çarpma ve kaydırma yardımcıları Pico'nunki komut komutadır, çünkü yazmaç sözleşmeleri çipin değil ABI'nindir.
Katalogdaki program dizgesi elf32 arm samd21'dir. Pico'nun elf32 arm rp2040 dizgesinden farklıdır çünkü ELF gerçekten öyledir: aynı komut kümesi, farklı bellek haritası ve biri için bağlanan görüntü diğerinde çalışmaz.
Dört örnek: blink (kullanıcı LED'i ve D10'da bir tane), button (D2'de bir anahtar, EXTINT10 üzerinde), serial (her iki port, D6'dan D7'ye bir atlama kablosuyla) ve analog (A10'da bir düğme ve D9'da bir soldurma). Bir örneğe 32 KB bütçe ayrılır ve bağlayıcı betiğinin dayattığı gerçek üst sınır 32 KB SRAM'dir.
7. Bu modelin emin oldukları ve emin olmadıkları
Üç grup. Bu bölümün varlık sebebi şudur: bir adresi sessizce tahmin eden kart modeli, bilmediğini söyleyen modelden daha kötüdür.
Veri sayfasından alınmıştır. Bölüm 2'deki bellek haritası: sıfırda 256 KB flash, 0x2000_0000 adresinde 32 KB SRAM ve PM, SYSCTRL, GCLK, EIC, PORT, USB, altı SERCOM, TCC0-2, TC3-7 ile ADC'nin taban adresleri ve örnekler arasındaki 0x400 adım aralıkları. PORT'un yazmaç düzeni ve 0x80 grup adım aralığı, OUT çekme direncini seçme kuralı ve WRCONFIG alan konumları dahil. SERCOM USART düzeni ve aritmetik baud formülü. TCC düzeni. ADC düzeni. EIC düzeni ve dört bitlik SENSE alanları. USB cihaz yazmaçları, 0x20 uç noktası adım aralığı ve ADDR ile PCKSIZE içeren on altı baytlık tanımlayıcı bankası. DIV16'dan DIV64'e sıçrayı da kapsayan PRESCALER kodlaması. Bölüm 3.8'deki kesme vektör numaraları. İki NVIC öncelik biti.
Doğrulanmadı, varsayılmıştır. İki şey var ve gerçek silikona taşınacak bir program ikisini de denetlemeli:
- TC bloğunun yazmaç ofsetleri 3.4 numaralı bölümde:
CTRLA0x00,READREQ0x02,CTRLBCLR/CTRLBSET0x04/0x05,CTRLC0x06,DBGCTRL0x08,EVCTRL0x0A,INTENCLR/INTENSET0x0C/0x0D,INTFLAG0x0E,STATUS0x0F,COUNT0x10,PER0x14,CC0x18. TCC'nin ofsetlerini bu model kesin olarak belirtir; TC'ninkiler, yerleşimiMODEile değişen bir bloğun modelin en iyi okumasıdır ve bunlarfirmware/xiao/include/samd21.hdosyasının derlendiği sayılardır; yani burada derlenen firmware, silikonla uyuşsa da uyuşmasa da modelle uyuşur. - Çevresel birim çoğullama tablosu 1 numaralı bölümde: her pad'deki hangi
PMUXsütununun hangi SERCOM pad'ini, hangiEXTINThattını ve hangi dalga çıkışını taşıdığı. Her XIAO pininin ardındaki pad numaraları karta aittir ve firmware buna dayanır; bir pad'in hangi zamanlayıcı kanalına ulaşabildiği ise bir PWM kodunun bağlı olduğu şeydir ve oradaki bir hata, yanlış bir sayı olarak değil, solmayan bir pin olarak kendini gösterir.crates/atsamd21/src/mux.rstüm tabloyu tek yerde içerir.
samd21.h dosyasındaki genel saat istemci kimlikleri (GCLK_ID_EIC ve diğerleri) aynı gruptandır. Burada hiçbir şey bunlara bağlı değildir (3.2 numaralı bölüm), bu yüzden birindeki hata Mokxi'de görünmez ama gerçek bir kartta bir çevresel birimi tamamen durdurur.
Bilerek yok. Bunların her biri uydurulmak yerine dışarıda bırakıldı:
- Saat ağacı. DFLL yok, osilatör yok, PLL yok, üreteç yok. 3.2 numaralı bölüm onun yerine neyin geçtiğini anlatır.
- SERCOM'larda SPI ve I2C. 3.3 numaralı bölüm yalnızca USART modudur, bu yüzden
WireveSPIkullanılamaz. - DAC, aslında PA02'nin gerçek amacı olan şey, analog karşılaştırıcılar, PTC ve I2S.
- DMAC ve EVSYS. DMA yok ve çevresel birimler arasında olay bağlantısı yok; zamanlayıcıların
EVCTRLyazmaçları bunları kullanacaktı. - NVMCTRL ve flash programlama, watchdog, RTC ve DSU. Eşlenmiş ama etkisiz (2 numaralı bölüm).
- Bir bayt kanalının ötesinde USB'nin tamamı, 3.7 numaralı bölümün uzun uzun anlattığı şey ve onunla birlikte Keyboard ve Mouse.
- The UF2 bootloader. An image here starts at zero; a real XIAO's starts at 0x2000 (section 2).
Satıcı Arduino çekirdek ikili dosyalarının burada çalışmamasının, bu belge için derlenen firmware'in ise çalışmasının nedeni budur.