Başvuru

Seeed XIAO SAMD21 kart sözleşmesi (Faz 9)

ATSAMD21G18A: iki PORT grubu, USART olarak SERCOM'lar, TCC ve TC PWM, her pad'de ADC ve bayt kanalı olarak USB.

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:

  • D0 PWM 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.
  • D4 pininde sıradan bir harici kesme yok. PA08, çipin NMI pinidir. attachInterrupt(4, ...) hem burada hem masada hiçbir şey yapmaz.
  • D5 ve D7 EXTINT9 paylaşır, yani ikisinden yalnızca biri aynı anda kesme taşıyabilir; ikincisi attachInterrupt hattı 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 yazmak analogWrite şunlardan birinde D1/D4, D9/D5, D10/D2 ya da D8/D3 ikisini 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. DFLLSYNC 0 okur. Yani while (!(SYSCTRL->PCLKSR.reg & DFLLRDY)) {} doğrudan geçer.
  • GCLK (0x4000_0C00): CTRL 0x00 adresinde (SWRST bit 0), STATUS 0x01 adresinde (SYNCBUSY bit 7, hiçbir zaman set edilmez), CLKCTRL 0x02 adresinde, GENCTRL 0x04 adresinde, GENDIV 0x08 adresinde. 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): AHBMASK 0x14, APBAMASK 0x18, APBBMASK 0x1C, APBCMASK 0x20, tümü sıfırlama değerlerinde saklanır ve geri okunur; RCAUSE ise 0x38 adresinde 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 ve EPSTATUS.BK1RDY'yi set eder. Model bu baytları SRAM'den okur, seri monitöre verir, BK1RDY'yi temizler ve EPINTFLAG.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ın ADDR'ine kopyalar, uzunluğu PCKSIZE'ına yazar, BK0RDY'yi set eder ve EPINTFLAG.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: 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. TCC'nin ofsetlerini bu model kesin olarak belirtir; TC'ninkiler, yerleşimi MODE ile değişen bir bloğun modelin en iyi okumasıdır ve bunlar firmware/xiao/include/samd21.h dosyası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 PMUX sütununun hangi SERCOM pad'ini, hangi EXTINT hattı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.rs tü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 Wire ve SPI kullanı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 EVCTRL yazmaç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.