Tham khảo

Hợp đồng bo mạch Seeed XIAO SAMD21 (Giai đoạn 9)

ATSAMD21G18A: hai nhóm PORT, các SERCOM làm USART, PWM bằng TCC và TC, ADC trên mọi chân, và USB như một dòng byte.

Đây là tài liệu tham khảo kỹ thuật cho mô hình: nó mô tả những gì được triển khai, thanh ghi này đến thanh ghi khác, dành cho những người viết firmware chạy trên đó. Để dùng bo mạch trong trình soạn thảo, hãy bắt đầu với Seeed XIAO SAMD21 và trang bo mạch.

XIAO SAMD21 là bo mạch nhỏ nhất ở đây và là vi điều khiển Cortex-M0+ thứ ba. Một thành phần nhân (xiao trong crates/parts) bọc một mô hình SoC ATSAMD21G18A (crates/atsamd21) trên cùng một nhân với Raspberry Pi Pico (crates/cortexm-core, Profile::V6M). Nhân được dùng chung; con chip bao quanh nó thì không. Tài liệu này là hợp đồng, và nó có ưu tiên hơn mọi ghi chú trong mã.

Kiểu trong danh mục là xiao.

Đọc mục 7 trước nếu bạn muốn đưa một bản dựng từ đây lên chip thật. Mọi địa chỉ cơ sở trong mô hình này đều là địa chỉ mà tài liệu này nêu ra được từ SAM D21 Family Datasheet, và phần lớn offset của thanh ghi cũng vậy, nhưng offset của khối TC và bảng ghép kênh ngoại vi là cách hiểu của mô hình này chứ không phải trang nào được trích lại, và mục 7 nêu tên từng cái. Không có gì ở đây được đoán bừa trong im lặng.

1. Chân bo mạch (thứ tự trong danh mục)

Nhìn từ trên, ổ cắm USB-C ở trên cùng, ATSAMD21G18A dưới lớp silkscreen ở giữa. Bo mạch có kích thước 21 x 17.8 mm và hai hàng bảy pad dạng răng cưa cách nhau 15.24 mm (đúng 0.6 inch), nên nó bắt vắt qua rãnh giữa của breadboard.

Cột trái, từ trên xuống dưới (7 pad): D0, D1, D2, D3, D4, D5, D6.

Cột phải, từ trên xuống dưới (7 pad): 5V, GND, 3V3, D10, D9, D8, D7.

14 pad. Mười một pad là I/O và ba pad là nguồn. Tất cả mười một pad đều cũng là đầu vào analog, và A0 đến A10 là chính các pad D0 đến D10; lớp silkscreen in cả hai tên.

Pad đứng sau mỗi chân, và những vai trò khác của nó:

chân pad AIN EXTINT PWM (chức năng E) khác
D0 / A0 PA02 0 2 không có đầu ra của 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

Ba điều trong bảng đó đáng đọc lại hai lần, và cả ba đều là phần cứng chứ không phải mô hình:

  • D0 không có PWM. PA02 là chân của DAC và hoàn toàn không có sóng ngõ ra nào. analogWrite(0, x) ở đây bật hoặc tắt pad ở điểm giữa thay vì giả vờ làm mờ dần.
  • D4 không có ngắt ngoài thông thường. PA08 là chân NMI của chip. attachInterrupt(4, ...) không có tác dụng gì, cả ở đây lẫn trên bàn thật.
  • D5 và D7 dùng chung EXTINT9, nên mỗi lúc chỉ một trong hai chân có thể mang ngắt; chân thứ hai attachInterrupt lấy đường nối từ chân thứ nhất. Và vì TCC1 và TCC2 mỗi cái có hai thanh ghi so sánh, một số chân dùng chung độ rộng xung: ghi analogWrite vào một trong D1/D4, D9/D5, D10/D2 hoặc D8/D3 thì cả hai cùng thay đổi.

Ba LED nằm trên bo mạch chứ không trên pad nào: LED người dùng trên PA17, LED RX trên PA18 và LED TX trên PA19. Cả ba đều active low, nên digitalWrite(LED_BUILTIN, LOW) làm sáng LED người dùng. Chúng được nhìn thấy qua que đo và phần hiển thị, chứ không ở đâu khác. Runtime đánh số chúng là 13, 12 và 11 và định nghĩa LED_BUILTIN là 13.

Về điện. Mọi pad I/O đều đẩy kéo (push-pull) ở 3,3 V qua R_STRONG, ở trạng thái trở kháng cao, hoặc kéo lên hoặc kéo xuống qua 40 k. Một ngõ vào đọc mức cao ở 1,65 V; một đường nối xung đột (Unknown) đọc là 0, và một đường nối lơ lửng đọc là nhiễu, giống như trên Uno (docs/uno.md mục 1). 3V3 cấp 3,3 V qua R_SUPPLY, 5V cấp 5 V và GND cấp 0 V, luôn luôn, vì bo mạch đang cắm vào USB. Không có pad reset trên header: hai pad reset nằm ở mặt dưới của một con XIAO thật, còn ở đây reset là một poke (mục 5).

2. Bản đồ bộ nhớ

flash 256 KB tại 0x0000_0000
SRAM 32 KB từ 0x2000_0000 đến 0x2000_7FFF
đỉnh stack 0x2000_8000
PM 0x4000_0400, mục 3.2
SYSCTRL 0x4000_0800, mục 3.2
GCLK 0x4000_0C00, mục 3.2
EIC 0x4000_1800, mục 3.6
PORT 0x4100_4400, mục 3.1
USB 0x4100_5000, mục 3.7
SERCOM0..5 0x4200_0800, cách nhau 0x400, mục 3.3
TCC0..2 0x4200_2000, cách nhau 0x400, mục 3.4
TC3..TC7 0x4200_2C00, cách nhau 0x400, mục 3.4
ADC 0x4200_4000, mục 3.5

Mỗi đoạn PT_LOAD phải nằm trong flash hoặc SRAM; ngoài phạm vi đó sẽ bị từ chối kèm địa chỉ lỗi trong thông báo, và chip sẽ không còn chương trình nào.

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.

Các khối có trong datasheet mà mô hình này không có (PAC0-2, DSU, NVMCTRL, DMAC, MTB, WDT, RTC, EVSYS, AC, DAC, PTC, I2S) thì được ánh xạ nhưng vô hiệu: đọc vào nhận được 0 và được tính là một truy cập lạc, thay vì gây fault. Một chương trình khởi động có poke vào wait states của bộ điều khiển NVM sẽ không làm sập bo mạch. Bất cứ gì nằm ngoài mọi khối đều là access fault, trên ARMv6-M là một HardFault, và bo mạch báo cáo nó là một crash trên kênh host.

3. Thanh ghi ngoại vi

Chỉ phần con số dưới đây được cài đặt. Một thanh ghi SAM D21 rộng tám, mười sáu hoặc ba mươi hai bit, và bus phục vụ mỗi thanh ghi theo đúng độ rộng của nó: một truy cập hẹp hơn thanh ghi là phép đọc-sửa-ghi mà ma trận bus lẽ ra phải làm, và một truy cập rộng hơn được trả lời từ thanh ghi mà nó bắt đầu. Vì vậy firmware viết theo đúng kiểu dữ liệu của datasheet chạy được không cần sửa.

3.1 PORT (0x4100_4400)

Hai nhóm, PA và PB, cách nhau 0x80. Trong mô hình này các pad được đánh số 0..63: 0..31 là PA00..PA31 và 32..63 là PB00..PB31.

offset thanh ghi
0x00 DIR
0x04 DIRCLR
0x08 DIRSET
0x0C DIRTGL
0x10 OUT
0x14 OUTCLR
0x18 OUTSET
0x1C OUTTGL
0x20 IN
0x24 CTRL (được lưu, đọc lại được)
0x28 WRCONFIG
0x30 + n PMUXn, một byte cho mỗi cặp chân
0x40 + n PINCFGn, một byte cho mỗi chân

PINCFG bit 0 PMUXEN, bit 1 INEN, bit 2 PULLEN, bit 6 DRVSTR (được lưu, bỏ qua về mặt điện).

OUT kiêm hai vai trò và đây là cái bẫy thật sự duy nhất của phần này. Khi DIR set it is the driven level; with DIR clear it is the hướng của điện trở kéo. Nên INPUT_PULLUP là DIRCLR, rồi OUTSET, rồi PINCFG.PULLEN, và PULLEN không kèm OUT cho một điện trở kéo xuống. Hai trong ba điều đó sai thì chân sẽ hoạt động sai một cách âm thầm.

WRCONFIG ghi PINCFG và PMUX của mười sáu chân trong một lần ghi: PINMASK ở bit 0..15, PMUXEN 16, INEN 17, PULLEN 18, DRVSTR 22, PMUX 24..27, WRPMUX 28, WRPINCFG 30, HWSEL 31 (bit này dịch mặt nạ sang chân 16..31).

Khi PMUXEN được đặt, PMUX chọn một trong tám chức năng ngoại vi A..H và pad rời khỏi quyền quản lý của PORT. Mô hình chỉ hành xử theo những chức năng nó có (SERCOM ở chế độ USART và các đầu ra sóng TC/TCC, bảng ở mục 1) và coi mọi lựa chọn khác là ngoại vi không tồn tại, thứ không yêu cầu gì và để pad ở trạng thái trở kháng cao thay vì bịa ra một mức điện áp. Điện trở kéo của pad vẫn là của pad, đó là cách một chân SERCOM RX giữ được điện trở kéo lên của nó.

IN đọc được 0 trên một chân có INEN bị xóa, đúng như phần cứng thật làm. Một pad mà chip này đang điều khiển sẽ đọc lại đúng giá trị nó đang điều khiển.

3.2 PM, GCLK và SYSCTRL: cây đồng hồ không được mô phỏng

Lõi chạy ở 48 MHz ngay từ lệnh đầu tiên. Ở đây không có cây đồng hồ: không DFLL, không bộ dao động, không bộ chia, không bộ tạo xung nào thực sự tạo xung. Ba khối này tồn tại để một đoạn mã khởi động viết theo các thanh ghi thật chạy đến cùng thay vì treo trên một bit ready.

  • SYSCTRL (0x4000_0800) là một bản chép của ba mươi hai word, với hai ngoại lệ. PCLKSR (0x0C) đọc về mọi bit ready và lock đều được đặt (XOSCRDY, XOSC32KRDY, OSC32KRDY, OSC8MRDY, DFLLRDY, DFLLLCKF, DFLLLCKC, DFLLRCS, BOD33RDY, DPLLLCKF, DPLLLCKT) và mọi bit lỗi đều bị xóa. DFLLSYNC đọc về 0. Vì vậy while (!(SYSCTRL->PCLKSR.reg & DFLLRDY)) {} chạy xuyên qua ngay lập tức.
  • GCLK (0x4000_0C00): CTRL tại 0x00 (bit 0 là SWRST), STATUS tại 0x01 (bit 7 là SYNCBUSY, không bao giờ được set), CLKCTRL tại 0x02, GENCTRL tại 0x04, GENDIV tại 0x08. Ba thanh ghi cuối được đánh địa chỉ theo ID trong giá trị được ghi, giống như trên linh kiện thật, và khi đọc sẽ trả về kết quả cho ID được ghi gần nhất. Không có gì phụ thuộc vào chúng.
  • PM (0x4000_0400): AHBMASK 0x14, APBAMASK 0x18, APBBMASK 0x1C, APBCMASK 0x20, tất cả đều được lưu và đọc lại với giá trị reset của chúng, và RCAUSE ở 0x38, ở đây chỉ đọc và mang bit khởi động nguồn, bit reset ngoài hoặc bit reset hệ thống tùy vào lần reset cuối của chip. Không có gì phụ thuộc vào các mặt nạ đồng hồ: một ngoại vi vẫn hoạt động cho dù firmware có bật đồng hồ của nó hay không. Runtime vẫn bật chúng, vì chip thật cần vậy.

Thời gian đến từ SysTick, nằm trong cortexm-core tại địa chỉ kiến trúc của nó. Runtime nạp lại nó mỗi 48 000 chu kỳ (đúng một mili giây ở 48 MHz), và SYST_CALIB báo giá trị đó bằng đúng một phần mười của mười mili giây.

3.3 SERCOM ở chế độ USART (0x4200_0800 + 0x400 n)

Sáu SERCOM, mỗi cái được mô phỏng ở chế độ USART với xung nhịp nội (CTRLA.MODE = 1), không đồng bộ 8N1, và không ở chế độ nào khác. SPI và I2C không được mô phỏng; một SERCOM đặt vào một trong các chế độ đó sẽ không làm gì.

offset thanh ghi
0x00 CTRLA
0x04 CTRLB
0x08 DBGCTRL (được lưu)
0x0C BAUD
0x0E RXPL (được lưu)
0x14 INTENCLR
0x16 INTENSET
0x18 INTFLAG
0x1A STATUS (được lưu; không bao giờ có lỗi)
0x1C SYNCBUSY (luôn bằng 0)
0x28 DATA

CTRLA bit 0 SWRST, bit 1 ENABLE, bit 2..4 MODE, bit 16..17 TXPO (0 điều khiển PAD[0], giá trị khác điều khiển PAD[2]), bit 20..21 RXPO (pad mà bộ nhận nghe), bit 30 DORD. CTRLB bit 16 TXEN, bit 17 RXEN. INTFLAG bit 0 DRE, bit 1 TXC (được chốt, ghi 1 để xóa), bit 2 RXC.

BAUD là bộ tạo số học không đồng bộ: BAUD = 65536 (1 - 16 f / f_ref), nên thời gian một bit là 16 x 65536 / (65536 - BAUD) chu kỳ tham chiếu. Tham chiếu được lấy là xung nhịp lõi 48 MHz, vì không có cây đồng hồ để hỏi (mục 3.2). BAUD bằng 0 (điều mà một chương trình chưa gọi begin() để lại) sẽ quay về 115200. Không có chế độ phân số.

Một bộ phát được bật và có TXEN đặt sẽ sở hữu pad của mình và dịch các bit thật qua nó: một bit start mức thấp, tám bit dữ liệu bắt đầu từ bit nhỏ nhất, một bit stop mức cao, mỗi bit dài đúng một bit time, mỗi cạnh được đóng dấu bằng chu kỳ mà phần cứng lẽ ra đã di chuyển nó. Một bộ nhận có RXEN đặt sẽ bắt đầu một khung ở cạnh xuống và lấy mẫu mỗi bit dữ liệu ở giữa bit time của nó. Vì vậy một dây cắm từ D6 sang D7 chuyển được một ký tự, và tốc độ baud không khớp làm văn bản lỗi ở đây y như trên bàn làm việc thật.

Trên bo mạch này Serial1 là SERCOM4 với TXPO 0 và RXPO 1, tức là PAD[0] trên PB08 và PAD[1] trên PB09 (D6 và D7), cả hai ở chức năng ngoại vi C.

3.4 TCC0-2 và TC3-7, phần liên quan đến PWM

Ba TCC và năm TC. Một bộ đếm ở đây không bao giờ được bước tăng từng bước: nó là một hàm đóng của chu kỳ CPU, và thời điểm cạnh kế tiếp của nó cũng vậy, đó là điều cho phép một lõi đang nằm ở WFI không tốn gì suốt một delay() trong khi PWM vẫn chạy.

PRESCALER là bit 8..10 của CTRLA trên cả hai loại, và nó không phải lũy thừa hai suốt từ đầu đến cuối: 0 đến 4 là DIV1, DIV2, DIV4, DIV8 và DIV16, rồi 5 là DIV64, 6 DIV256 và 7 DIV1024. Cú nhảy đó là một bẫy thật và làm sai thì PWM chậm gấp bốn lần.

TCC (0x4200_2000 + 0x400 n):

offset thanh ghi
0x00 CTRLA: bit 0 SWRST, bit 1 ENABLE, bit 8..10 PRESCALER
0x04/0x05 CTRLBCLR/CTRLBSET (được lưu)
0x08 SYNCBUSY (luôn bằng 0)
0x24/0x28 INTENCLR/INTENSET
0x2C INTFLAG: bit 0 OVF
0x30 STATUS (luôn bằng 0)
0x34 COUNT
0x3C WAVE: bit 0..2 WAVEGEN, trong đó 2 là PWM thường
0x40 PER, chu kỳ
0x44 + 4c CC0..CC3, độ rộng xung (duty cycle)
0x68/0x6C/0x70 + 4c WAVEB/PERB/CCBn, áp dụng ngay lập tức ở đây

TCC0 có bốn kênh so sánh; TCC1 và TCC2 có hai, nên WO[2] và WO[3] của chúng lặp lại WO[0] và WO[1]. Đó là lý do bảng ở mục 1 ghép một số chân thành cặp.

TC (0x4200_2C00 + 0x400 n, cho TC3 đến TC7):

offset thanh ghi
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 (được chấp nhận, không làm gì: giá trị đếm luôn cập nhật)
0x04/0x05 CTRLBCLR/CTRLBSET (được lưu)
0x0C/0x0D INTENCLR/INTENSET
0x0E INTFLAG: bit 0 OVF
0x0F STATUS (luôn bằng 0)
0x10 COUNT, theo độ rộng mà MODE chỉ định
0x14 PER, chỉ trong COUNT8
0x18 + c CC0, CC1, cách nhau một byte trong COUNT8, hai trong COUNT16, bốn trong COUNT32

Trong PWM thường (WAVEGEN = 2), giá trị đỉnh của một TC là PER ở chế độ COUNT8 và bằng toàn bộ chiều rộng bộ đếm trong các chế độ khác; trong PWM so khớp (WAVEGEN = 3) thì CC0 là chu kỳ và CC1 là độ rộng xung. Ngõ ra dạng sóng mức cao từ đầu chu kỳ cho đến khi so khớp và mức thấp sau đó, nên giá trị so khớp bằng 0 cho ra mức thấp liên tục và giá trị so khớp vượt quá đỉnh cho ra mức cao liên tục, hoàn toàn không có sườn xung. Đó chính là dạng sóng mà analogWrite cần và là dạng sóng duy nhất mà mô hình này tạo ra.

Cờ tràn chỉ đến được NVIC khi bit INTENSET của nó được đặt. Các chức năng capture, hệ thống sự kiện, chế độ one-shot và ramp, dithering, chèn thời gian chết (dead-time), tạo mẫu hình (pattern generation) và các ngõ vào fault đều không có.

3.5 ADC (0x4200_4000)

Chuyển đổi đơn được kích hoạt bằng phần mềm, đây là con đường duy nhất mà analogRead đi.

offset thanh ghi
0x00 CTRLA bit 0 SWRST, bit 1 ENABLE
0x01 REFCTRL được lưu, đọc lại được
0x02 AVGCTRL được lưu, đọc lại được
0x03 SAMPCTRL được lưu, đọc lại được
0x04 CTRLB bit 4..5 RESSEL: 0 là mười hai bit, 2 là mười, 3 là tám
0x06 WINCTRL được lưu, đọc lại được
0x08 SWTRIG bit 0 FLUSH, bit 1 START
0x0C INPUTCTRL bit 0..4 MUXPOS; MUXNEG và GAIN được lưu lại
0x10 EVCTRL được lưu
0x12/0x13 INTENCLR/INTENSET
0x14 INTFLAG bit 0 RESRDY, bit 1 OVERRUN
0x15 STATUS luôn bằng 0
0x16 RESULT đọc nó sẽ xóa RESRDY
0x18..0x22 WINLT, WINUT, GAINCORR, OFFSETCORR, CALIB, DBGCTRL được lưu, đọc lại được

Một lần chuyển đổi: trỏ MUXPOS tới kênh, ghi SWTRIG.START, chờ RESRDY, đọc RESULT. Quá trình này mất đúng 6 microgiây thời gian mô phỏng, và firmware thực sự chờ trong khoảng thời gian đó. Kết quả là round(4095 x Vin / 3.3) của điện áp trên pad tại thời điểm bắt đầu chuyển đổi, dịch xuống nếu RESSEL dưới mười hai bit. Một kênh mà chân của nó không có gì giữ sẽ đọc được 0.

Điện áp tham chiếu và độ lợi không có tác dụng ở đây. REFCTRL.REFSEL và INPUTCTRL.GAIN được lưu và đọc lại được, và mô hình luôn đo so với đường nguồn 3.3 V, vốn đúng với thiết lập của chính Arduino core, INTVCC1 với độ lợi DIV2, trên bo mạch này. Một sketch chuyển sang tham chiếu nội 1.0 V sẽ nhận được ở đây cùng các số như khi dùng INTVCC1, và tài liệu này nói rõ điều đó thay vì bịa ra một thang đo. Các chức năng lấy trung bình, theo dõi cửa sổ (window monitor), hiệu chỉnh, chế độ free-run, chế độ vi sai và hệ thống sự kiện đều không có.

Có các kênh 0..19. Bảng ở mục 1 ánh xạ chúng tới các pad.

3.6 EIC (0x4000_1800)

Mười sáu đường EXTINT, chính là nền tảng của attachInterrupt. Một pad đến được bộ điều khiển bằng cách chọn chức năng ngoại vi A, và nó rơi vào đường nào là do pad quyết định (mục 1).

offset thanh ghi
0x00 CTRL: bit 0 SWRST, bit 1 ENABLE
0x01 STATUS: bit 7 SYNCBUSY, luôn bằng 0
0x02/0x03 NMICTRL/NMIFLAG (được lưu; bản thân NMI không được phát ra)
0x04 EVCTRL (được lưu)
0x08/0x0C INTENCLR/INTENSET
0x10 INTFLAG
0x14 WAKEUP (được lưu)
0x18/0x1C CONFIG0/CONFIG1: mỗi đường có bốn bit SENSE và một bit FILTEN

SENSE: 0 là không, 1 là sườn lên, 2 là sườn xuống, 3 là cả hai, 4 là mức cao, 5 là mức thấp. Một cạnh sẽ chốt vào INTFLAG và được ghi để xóa. Một mức sẽ giữ INTFLAG được đặt chừng nào chân còn ở mức đó, nên một hàm xử lý không loại bỏ điều kiện đó sẽ chạy lại, đúng như trên linh kiện thật. FILTEN được lưu và không lọc gì cả.

Cả mười sáu đường dùng chung một vector NVIC; phần chạy đọc INTFLAG và gọi các hàm xử lý đang được gắn.

3.7 Thiết bị USB (0x4100_5000): một stub truyền từng byte

Trên XIAO, cổng duy nhất của bo mạch nối thẳng vào USB của chính SAM D21, và serial monitor trên máy bạn đang trò chuyện với một giao diện CDC ACM do firmware của sketch liệt kê. Đó là sự thật làm nên bo mạch này, và cũng là sự thật làm nó trở nên khó xử lý: chưa có Serial cho đến khi firmware trả lời cả chục lần truyền điều khiển.

Những gì có ở đây là một đường ống mang tên các thanh ghi, và đường truyền là đường thật của linh kiện.

offset thanh ghi
0x00 CTRLA: bit 0 SWRST, bit 1 ENABLE, bit 7 MODE
0x02 SYNCBUSY (luôn bằng 0)
0x03 QOSCTRL (được lưu)
0x08 CTRLB: bit 0 DETACH, được đặt khi reset
0x0A DADD (được lưu)
0x0C/0x0D/0x10 STATUS, FSMSTATUS, FNUM: đều đọc được 0; không có bus để có trạng thái
0x14/0x18/0x1C INTENCLR/INTENSET/INTFLAG (được lưu; không bao giờ có gì được phát ra)
0x20 EPINTSMRY
0x24 DESCADD
0x28 PADCAL (được lưu)
0x100 + 0x20 n endpoint n: EPCFG +0, EPSTATUSCLR +4, EPSTATUSSET +5, EPSTATUS +6, EPINTFLAG +7, EPINTENCLR +8, EPINTENSET +9

Bảng mô tả (descriptor) tại DESCADD là bảng thật: hai bank cho mỗi endpoint, mỗi bank mười sáu byte, ADDR tại +0 và PCKSIZE tại +4 với BYTE_COUNT ở bit 0..13 và SIZE ở bit 28..30.

  • IN. Firmware đổ dữ liệu vào buffer, ghi độ dài vào PCKSIZE của bank 1 và đặt EPSTATUS.BK1RDY. Mô hình đọc các byte đó từ SRAM, đưa cho serial monitor, xóa BK1RDY và phát EPINTFLAG.TRCPT1.
  • OUT. Firmware xóa EPSTATUS.BK0RDY để nói rằng bank 0 rảnh. Mô hình chép những gì monitor đã nhận vào ADDR của bank 0, ghi độ dài vào PCKSIZE của nó, đặt BK0RDY và phát EPINTFLAG.TRCPT0.

Không có gì khác về USB ở đây. Không có host, không có bus, không có reset, không có gói SETUP, không có descriptor, không có enumeration, không có đánh địa chỉ, không có bộ đếm frame, không có start-of-frame 1 ms, không có NAK, không có STALL và không có LPM. INTFLAG không bao giờ bật lên và ngắt USB không bao giờ đến được NVIC, nên runtime sẽ thăm dò (poll). Một sketch điều khiển phần này theo cách Arduino core điều khiển chip thật vẫn chạy được (nó poll các bit bank-ready, mà các bit này hoạt động đúng), nhưng một sketch chờ enumeration sẽ chờ mãi mãi, nên while (!Serial) {} ở đây trả về ngay lập tức còn trên bàn làm việc thì phải chờ. Keyboard và Mouse, vốn là một nửa mục đích của bo mạch native-USB, thì hoàn toàn không có.

Không có baud rate trên kênh này, và đó không phải là lối tắt: một cổng CDC ACM vốn không có baud rate riêng. Serial.begin(115200) truyền vào một con số vốn sẽ đến host dưới dạng một line coding request, và host hoàn toàn có thể bỏ qua nó.

3.8 Ngắt

NVIC nằm trong core tại địa chỉ kiến trúc của nó, với hai bit ưu tiên. Bảng vector là của 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.

Các ngắt mà mô hình này thực sự nâng lên: EIC, SERCOM0..5, ADC, TCC0..2 và TC3..TC7. Ngắt của USB thì không được nâng (mục 3.7) và của những thứ khác cũng không.

4. Kênh host

host_write đặt các byte vào hàng đợi nhận của USB; host_read lấy các byte đã đi ra khỏi nó. Đó chính là Serial trong sketch và serial monitor trong giao diện. Các byte là UTF-8 theo như giao diện thấy, còn với mô hình thì không minh bạch.

Serial1 không phải là kênh host. Nó đi đến D6 và D7 và không đi đâu khác, nên những gì sketch in ra đó chỉ đến được serial monitor nếu có thứ gì đó trên breadboard mang nó quay lại.

5. Mô hình thời gian và linh kiện

Picosecond trong một u64, giống như kernel. Core chạy ở 48 MHz, nên một chu kỳ là 20833.33 ps, không phải số nguyên, đó là lý do thời gian không bao giờ được cộng dồn: nó luôn được tính lại từ số chu kỳ là cycles x 1_000_000 / 48. Một lát 10 us đúng bằng 480 chu kỳ và đúng bằng 10,000,000 ps, nên biên của các lát không bao giờ trôi. Bộ đếm chu kỳ được neo vào thời gian kernel ở đầu mỗi lát, nên timer không bao giờ trôi khỏi mạch dù các lát rơi thế nào, và một core đang đỗ sẽ bắt kịp các chu kỳ nó đã ngủ qua, kể cả SysTick, thứ mà millis() đếm.

Lát chạy theo hai cấp, như các mô hình STM32: các lô thô bị giới hạn bởi deadline ngoại vi tiếp theo, và từng lệnh một trong 100 us sau bất kỳ lệnh store nào rơi vào thanh ghi PORT, SERCOM, timer hoặc USB. Vậy nên một chương trình chạm vào chân thì chạy ở chế độ mịn còn chương trình tính toán thì chạy ở chế độ thô.

probe là một bitmask: 1 đang chạy, 2 đang đỗ trong WFI, 4 LED người dùng sáng, 8 LED RX, 16 LED TX, 32 truyền serial trong 20 ms qua, 64 nhận serial; 0 khi không có chương trình. Ba bit LED đã đúng chiều rồi: các pad active thấp và linh kiện đã đảo chúng lại.

poke: 1 giữ reset, 0 nhả reset.

6. Runtime firmware (firmware/xiao/)

Một runtime hình Arduino viết cho bo mạch này: setup() và loop(), pinMode, digitalWrite, digitalRead, shiftOut, analogRead (kèm analogReadResolution), analogWrite, millis, micros, micros64, delay, delayMicroseconds, attachInterrupt, detachInterrupt, interrupts, noInterrupts, Serial và Serial1. Không có Atmel Software Framework, không có Arduino core, không có CMSIS, không có newlib, không có libgcc và không có compiler-rt.

delay() đỗ lõi: nó thực thi WFI và ngắt SysTick tiếp theo sẽ đánh thức nó. Một core đang đỗ không hoàn thành lệnh nào và kernel nhảy thẳng đến thời điểm thức dậy, nên blink dành một giây thời gian mô phỏng của mình cho một nghìn ngắt thay vì bốn mươi tám triệu chu kỳ. Một delay bên trong noInterrupts() thì quay vòng bận chờ thay vì vậy, vì một core đang đỗ với PRIMASK được set sẽ không bao giờ chạy handler để đẩy thời gian đi.

analogWrite là tám bit ở 732.42 Hz (256 mức đếm, PER 255, của xung nhịp 48 MHz chia cho 256: 48 MHz / 256 / 256, tần số của Arduino Zero) trên mười pad chạm đến được một timer. 0 và 255 không phải là PWM: chúng trả pad về cho PORT và kéo nó xuống thấp hoặc lên cao, nên analogWrite(pin, 0) thực sự là tắt.

Biên dịch bằng clang --target=thumbv6m-none-eabi -mcpu=cortex-m0plus -mthumb, liên kết với firmware/xiao/link.ld bằng ld.lld. Năm file của runtime là của Raspberry Pi Pico, được biên dịch lại cho bo mạch này chứ không phải sao chép: phần định dạng số, các hàm hỗ trợ toán học, floor freestanding và Print. Cả hai đều là Cortex-M0+ và không có gì trong các file đó phụ thuộc vào chỗ ngoại vi nằm. Riêng của bo mạch này là header thanh ghi, bảng chân, mã khởi động, linker script, hai lớp serial và các driver GPIO, analog, thời gian, SERCOM, USB và ngắt. Các hàm chia, nhân và dịch của AEABI trong crt0.S là của Pico theo từng lệnh một, vì khế ước thanh ghi của chúng là của ABI chứ không phải của con chip.

Chuỗi program trong danh mục là elf32 arm samd21. Nó khác với elf32 arm rp2040 của Pico vì ELF thực sự khác: cùng bộ lệnh, sơ đồ bộ nhớ khác nhau, và một image liên kết cho cái này sẽ không chạy trên cái kia.

Bốn ví dụ: blink (LED người dùng và một LED trên D10), button (một công tắc trên D2, trên EXTINT10), serial (cả hai cổng, với một dây cắm từ D6 sang D7) và analog (một núm xoay trên A10 và một hiệu ứng fade trên D9). Một ví dụ được cấp 32 KB, và trần thật mà linker script áp dụng là 32 KB SRAM.

7. Những gì mô hình này chắc chắn, và những gì không chắc chắn

Ba nhóm. Mục này tồn tại vì một mô hình bo mạch âm thầm đoán một địa chỉ thì tệ hơn một mô hình nói rõ là nó không biết.

Lấy từ datasheet. Sơ đồ bộ nhớ của mục 2: 256 KB flash tại số không, 32 KB SRAM tại 0x2000_0000, và địa chỉ cơ sở của PM, SYSCTRL, GCLK, EIC, PORT, USB, sáu SERCOM, TCC0-2, TC3-7 và ADC, với các bước nhảy 0x400 giữa các instance. Sơ đồ thanh ghi của PORT và bước nhảy nhóm 0x80 của nó, kể cả quy tắc OUT-chọn-điện trở kéo và vị trí các trường của WRCONFIG. Sơ đồ SERCOM USART và công thức baud số học. Sơ đồ TCC. Sơ đồ ADC. Sơ đồ EIC và các trường SENSE bốn bit của nó. Các thanh ghi thiết bị USB, bước nhảy endpoint 0x20 và ngân hàng descriptor mười sáu byte với ADDR và PCKSIZE. Mã hóa PRESCALER, kể cả cú nhảy từ DIV16 sang DIV64. Các số vector ngắt của mục 3.8. Hai bit ưu tiên NVIC.

Tin là vậy, chưa kiểm chứng. Hai điều, và một chương trình chuẩn bị đưa lên chip thật nên kiểm tra cả hai:

  • Độ lệch thanh ghi của khối TC trong mục 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. Độ lệch của TCC thì mô hình này nêu rõ; còn của TC là cách đọc tốt nhất của nó về một khối có bố cục thay đổi theo MODE, và đó là các số mà firmware/xiao/include/samd21.h dựa vào để build, nên firmware build ở đây khớp với mô hình bất kể nó có khớp với silicon thật hay không.
  • Bảng ghép kênh ngoại vi của mục 1: cột PMUX nào trên mỗi pad mang pad SERCOM nào, đường EXTINT nào và ngõ ra sóng nào. Các số pad đứng sau mỗi chân XIAO là của bo mạch và là thứ firmware dựa vào; kênh timer nào mà một pad có thể tới là thứ mà một sketch PWM dựa vào, và lỗi ở đó thể hiện qua một chân không mờ dần được chứ không phải qua một số sai. crates/atsamd21/src/mux.rs là toàn bộ bảng gom lại ở một chỗ.

Các ID client của clock chung trong samd21.h (GCLK_ID_EIC và phần còn lại) nằm trong cùng nhóm. Ở đây không có gì phụ thuộc vào chúng (mục 3.2), nên lỗi ở một ID sẽ không thấy được trong Mokxi nhưng sẽ làm một ngoại vi chết hẳn trên bàn thực tế.

Cố ý không có. Mỗi thứ sau đây bị bỏ qua thay vì bị bịa ra:

  • Cây clock. Không có DFLL, không có bộ tạo dao động, không có PLL, không có generator. Mục 3.2 cho biết thứ gì đứng thế chỗ cho nó.
  • SPI và I2C trên các SERCOM. Mục 3.3 chỉ là chế độ USART và không có gì khác, nên Wire và SPI không dùng được.
  • Bộ DAC, thứ mà PA02 thực sự dành cho, cùng bộ so sánh tương tự, PTC và I2S.
  • DMAC và EVSYS. Không có DMA và không có liên kết sự kiện giữa các ngoại vi, vốn là thứ mà các thanh ghi EVCTRL của timer lẽ ra sẽ dùng.
  • NVMCTRL và lập trình flash, watchdog, RTC và DSU. Được ánh xạ nhưng không hoạt động (mục 2).
  • Toàn bộ phần USB ở trên mức một ống dẫn byte, được mục 3.7 trình bày kỹ, và cùng với nó là Keyboard và Mouse.
  • The UF2 bootloader. An image here starts at zero; a real XIAO's starts at 0x2000 (section 2).

Đó là lý do các file nhị phân Arduino core của hãng không chạy được ở đây, còn firmware build cho tài liệu này thì chạy được.