Đâ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:
D0khô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.D4khô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.D5vàD7dùng chungEXTINT9, nên mỗi lúc chỉ một trong hai chân có thể mang ngắt; chân thứ haiattachInterruptlấ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: ghianalogWritevào một trongD1/D4,D9/D5,D10/D2hoặcD8/D3thì 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ậywhile (!(SYSCTRL->PCLKSR.reg & DFLLRDY)) {}chạy xuyên qua ngay lập tức. - GCLK (
0x4000_0C00):CTRLtại0x00(bit 0 làSWRST),STATUStại0x01(bit 7 làSYNCBUSY, không bao giờ được set),CLKCTRLtại0x02,GENCTRLtại0x04,GENDIVtại0x08. 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):AHBMASK0x14,APBAMASK0x18,APBBMASK0x1C,APBCMASK0x20, 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
PCKSIZEcủa bank 1 và đặtEPSTATUS.BK1RDY. Mô hình đọc các byte đó từ SRAM, đưa cho serial monitor, xóaBK1RDYvà phátEPINTFLAG.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àoADDRcủa bank 0, ghi độ dài vàoPCKSIZEcủa nó, đặtBK0RDYvà phátEPINTFLAG.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:
CTRLA0x00,READREQ0x02,CTRLBCLR/CTRLBSET0x04/0x05,CTRLC0x06,DBGCTRL0x08,EVCTRL0x0A,INTENCLR/INTENSET0x0C/0x0D,INTFLAG0x0E,STATUS0x0F,COUNT0x10,PER0x14,CC0x18. Độ 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 theoMODE, và đó là các số màfirmware/xiao/include/samd21.hdự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
PMUXnào trên mỗi pad mang pad SERCOM nào, đườngEXTINTnà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.rslà 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
WirevàSPIkhô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
EVCTRLcủ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.