Tham khảo

Hợp đồng bo mạch Arduino Uno R4 Minima (Giai đoạn 9)

The RA4M1 on our Cortex-M4 core: the PFS port block, GPT PWM, SCI2 as Serial1 and a fourteen-bit ADC.

Đâ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 Arduino Uno R4 Minima và trang bo mạch.

Arduino Uno R4 Minima là một Renesas RA4M1 (Cortex-M4 48 MHz) theo hình dáng của Uno. Một thành phần kernel (unor4 trong crates/parts) bao bọc một mô hình SoC RA4M1 (crates/unor4) chạy trên cùng nhân ARMv7-M với Blue Pill và Black Pill (crates/cortexm-core). Nhân là dùng chung; con chip quanh nó thì không, và chẳng có gì về các chân là dùng chung.

Kiểu trong danh mục là unor4. Tài liệu này là hợp đồng, và nó thắng mọi ghi chú trong code.

Đọc mục 7 trước nếu bạn định đem bản build từ đây sang chip thật. Mô hình này nhỏ hơn RA4M1 thật, và một số địa chỉ của nó được đánh dấu "theo suy đoán, chưa kiểm chứng": mục 7 cho biết những địa chỉ nào, và những gì còn thiếu hẳn. Không có gì ở đây được đoán bừa một cách âm thầm.

Vì sao đây không phải một Blue Pill với số khác

Một dòng RA là một thế giới khác với STM32, và các điểm khác biệt chính là những thứ mà một sketch hay vấp phải:

  • Một chân là một thanh ghi. PmnPFS là một từ 32-bit cho mỗi chân, chứa hướng, chốt đầu ra, điện trở kéo lên, open drain, khóa analog, "một ngoại vi đang sở hữu chân này" và ngoại vi nào. Không có MODER, không có CRL/CRH, không có PUPDR và không có AFR.
  • Thanh ghi đó được bảo vệ chống ghi. PWPR.B0WI phải được xóa và PWPR.PFSWE phải được đặt trước khi bất kỳ lệnh ghi PmnPFS nào có hiệu lực. Một chương trình quên điều này sẽ thấy digitalWrite vẫn chạy còn pinMode chẳng làm gì cả. Mô hình này ép buộc điều đó và đếm xem nó đã vứt bỏ bao nhiêu lệnh ghi.
  • Một ngoại vi không có xung nhịp cho tới khi bạn khai báo. Mọi bit trong các thanh ghi module stop đều reset về "stopped". SCI, GPT, ADC14 và USB đều không truy cập được (đọc trả về số không) cho tới khi MSTPCRB/MSTPCRD được ghi.
  • Có kéo lên và không có kéo xuống. INPUT_PULLDOWN ở đây chỉ cho một ngõ vào lơ lửng (floating) thông thường, và mô hình sẽ nói rõ điều đó.
  • Serial là USB, không phải UART. UART trên D0 và D1 là Serial1. Trên Uno thì hai thứ này là một.
  • Bộ chuyển đổi có độ phân giải mười bốn bit. analogRead vẫn trả về mười bit, vì đó là điều một sketch Arduino mong đợi; analogReadResolution sẽ lấy phần còn lại.
  • Flash nằm ở địa chỉ không. Không có alias, không có chân BOOT, và có một từ cấu hình option tại 0x400 mà linh kiện thật sẽ đọc ra sau reset.
  • LED tích hợp hoạt động ở mức cao (active high), giống Uno và khác Blue Pill.

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

Từng lỗ một, header Uno R3, chính là điều cho phép R4 cắm shield Uno. Bo mạch có kích thước 68.6 x 53.3 mm.

Hàng trên, từ trái sang phải (14 lỗ): SCL, SDA, AREF, GND, 13, 12, 11, 10, 9, 8, 7, 6, 5, 4, 3, 2, 1, 0.

Hàng dưới, từ trái sang phải (13 lỗ): IOREF, RESET, 3V3, 5V, GNDb, GNDc, VIN, A0, A1, A2, A3, A4, A5.

31 chân. Tên trùng nhau sẽ mang thêm một chữ cái vì tên chân trong danh mục phải là duy nhất.

SCL và SDA nằm cạnh AREF là cùng một mảnh kim loại với A5 và A4: một đường mạch, hai lỗ, giống như trên Uno. Kéo bất kỳ đầu nào thì cả hai cũng bị kéo theo.

Chân RA4M1 phía sau mỗi lỗ:

lỗ pad đồng thời
0 P301 RXD2, nhận của Serial1
1 P302 TXD2, phát của Serial1
2 P104
3 P105 PWM
4 P106
5 P107 PWM
6 P111 PWM
7 P112
8 P303
9 P304 PWM
10 P103 PWM, SS
11 P411 PWM, MOSI
12 P410 MISO
13 P102 SCK, LED_BUILTIN
A0 P014 AN009
A1 P000 AN000
A2 P001 AN001
A3 P002 AN002
A4 P101 AN021, SDA
A5 P100 AN022, SCL

Số kênh của A4 và A5 chưa được xác minh (mục 7). Bốn kênh còn lại thì không.

Về điện: mọi chân I/O đều đẩy-kéo (push-pull) 5 V qua R_STRONG, ở trạng thái trở kháng cao, hoặc kéo lên qua 35 k. Không có điện trở kéo xuống bên trong. Một đầu vào đọc mức cao tại 2,5 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 trên Uno (docs/uno.md mục 1). 5V và IOREF phát 5 V tại R_SUPPLY, 3V3 phát 3,3 V, ba chân đất phát 0 V. RESET có điện trở kéo lên 10 k lên 5 V, và kéo xuống dưới 2,5 V sẽ giữ lõi ở trạng thái reset. VIN và AREF là đầu vào mà mô hình chỉ đọc chứ không dùng làm gì.

Chân 13 mang LED tích hợp: một tải 1 k xuống đất, chỉ thêm vào khi chân là đầu ra, nên pinMode(13, INPUT_PULLUP) vẫn hoạt động đúng. Catode của LED nối đất, nên chân phải cấp dòng để LED sáng.

2. Bản đồ bộ nhớ

flash chứa code 256 KB tại 0x0000_0000
bộ nhớ tùy chọn 0x0000_0400, hai word, được lưu nhưng không giải mã
SRAM 32 KB tại 0x2000_0000
đỉnh stack 0x2000_8000
PORT và PFS 0x4004_0000, mục 3.1 và 3.2
module stop 0x4004_7000, mục 3.7
bộ ADC14 số 0 0x4005_C000, mục 3.5 (theo suy đoán)
SCI0..SCI9 0x4007_0000, cách nhau 0x20, mục 3.4
GPT0..GPT7 0x4007_8000, cách nhau 0x100, mục 3.3 (theo suy đoán)
USBFS 0x4009_0000, mục 3.6 (theo suy đoán)

The code flash really is at zero. There is no alias and no boot pin to choose one, so the vector table is at address 0 and VTOR's reset value is already right. A flash address that looks like a null pointer is the vector table, not a bug.

Mỗi đoạn PT_LOAD phải nằm trong flash hoặc SRAM; ngoài ra sẽ bị từ chối kèm lý do, và bo mạch bị bỏ lại không có chương trình. Data flash (8 KB tại 0x4010_0000) và giao diện nạp của nó không được mô phỏng.

Bộ nhớ tùy chọn tại 0x0000_0400 là nơi một RA4M1 thật đọc OFS0 ngay sau reset để quyết định watchdog có tự khởi động hay không. firmware/unor4/crt0.S đặt một word ở đó và link.ld khẳng định nó nằm tại 0x400; mô hình này không có watchdog và không giải mã word nào. Một image thiếu nó sẽ boot đến đây và tự reset trên bàn, vì vậy nó không phải tùy chọn.

Lõi ở đây là Cortex-M4 không có FPU. RA4M1 có FPU đơn chính xác; cortexm-core cài đặt phần số nguyên của ARMv7E-M và hoàn toàn không có VFP, CPACR chỉ được lưu chứ không cấp quyền gì, và mọi mã hóa VFP đều gây UNDEFINSTR. Hãy biên dịch firmware với -mfloat-abi=soft -mfpu=none. Số học dấu phẩy động trong sketch vẫn chạy và được thực hiện bằng lệnh số nguyên; một binary hard-float build ở chỗ khác sẽ lỗi ngay ở lệnh VFP đầu tiên thay vì trả về số sai. Bốn bit ưu tiên, như trên linh kiện thật.

3. Thanh ghi ngoại vi

Chỉ phần dưới đây được cài đặt. Bất cứ thứ gì khác bên trong một khối đã ánh xạ đọc được 0 và bị tính là truy cập lạc; bất cứ thứ gì nằm ngoài mọi khối là lỗi truy cập. Một module có bit stop được đặt (mục 3.7) đọc được 0 và cũng bị tính là truy cập lạc, đó là diện mạo của "clock bị tắt" nhìn từ bus.

3.1 PORT0..PORT5 (0x4004_0000, cách nhau 0x20)

offset thanh ghi nửa
0x00 PCNTR1 PDR 16 bit thấp, PODR 16 bit cao
0x04 PCNTR2 PIDR 16 bit thấp, EIDR 16 bit cao (chỉ đọc)
0x08 PCNTR3 POSR 16 bit thấp để set, PORR 16 bit cao để clear (chỉ ghi)
0x0C PCNTR4 EOSR/EORR, được lưu

PCNTR3 is this part's BSRR, with the halves the other way around from an STM32's: the low half sets. A bit set in both halves of one write ends up clear. digitalWrite is one store to it and cannot race an interrupt handler touching another bit.

PIDR đọc chân, không phải latch: một ngõ đẩy-kéo đọc lại chính giá trị nó đang xuất, một ngõ vào hoặc ngõ open-drain đọc giá trị bo mạch mới lấy mẫu từ đường nối.

Port 0 đến 5 được mô phỏng, bao trùm mọi chân Minima đưa ra và mọi ngõ vào analog của gói 64 chân. Pad được đánh số port * 16 + pin.

3.2 PmnPFS (0x4004_0800, 0x40 mỗi port, 4 byte mỗi chân) và PWPR (0x4004_0D03)

Một word 32-bit mỗi chân tại 0x4004_0800 + 0x40*m + 4*n. Các alias byte và halfword trong tài liệu (PmnPFS_BY, PmnPFS_HA) là union với thanh ghi 32-bit, nên trên linh kiện little-endian này chúng là byte thấp và halfword thấp của nó, vì vậy pinMode có thể là một lệnh ghi byte duy nhất.

bit tên ý nghĩa
0 PODR latch ngõ ra
1 PIDR mức điện áp trên chân, chỉ đọc
2 PDR 1 = ngõ ra, 0 = ngõ vào
4 PCR điện trở kéo lên bên trong
6 NCODR open-drain kênh N
10..11 DSCR độ mạnh ngõ ra, được lưu
12..13 EOFR sự kiện theo sườn, được lưu
14 ISEL cho phép ngõ vào IRQ, được lưu (mục 3.8)
15 ASEL cho phép ngõ vào analog
16 PMR 1 = một peripheral sở hữu chân
24..28 PSEL peripheral nào

Một chân có ASEL được đặt thì điện học là cao trở dù word nói gì, và là loại duy nhất bộ chuyển đổi được phép lấy mẫu. Một chân có PMR được đặt sẽ theo peripheral được mô phỏng mà PSEL của nó chỉ định và bỏ qua PODR; một PSEL mà mô hình này không cài đặt sẽ để pad yên chứ không bịa ra một mức điện áp.

PSEL các giá trị mà mô hình này áp dụng: 0b00011 GPT và 0b00100 SCI. Cả hai đều theo suy đoán, chưa kiểm chứng (mục 7).

PWPR là một byte tại 0x4004_0D03. B0WI (bit 7) resets set and makes PFSWE (bit 6) không ghi được; ghi số không sẽ xóa nó, và sau đó ghi PFSWE cho phép ghi PFS. Một lệnh ghi với B0WI được đặt thì để nguyên PFSWE . Một lệnh ghi PmnPFS trong khi PFSWE bằng không không có tác dụng, và mô hình đếm nó (protected_writes), vì đó chính là lỗi im lặng mà linh kiện này nổi tiếng.

3.3 GPT0..GPT7 (0x4007_8000, cách nhau 0x100)

GPT0 và GPT1 đếm 32 bit; GPT2 đến GPT7 đếm 16 bit.

offset thanh ghi
0x00 GTWP
0x04 GTSTR
0x08 GTSTP
0x0C GTCLR
0x2C GTCR
0x30 GTUDDTYC
0x34 GTIOR
0x38 GTINTAD
0x3C GTST
0x40 GTBER
0x48 GTCNT
0x4C GTCCRA
0x50 GTCCRB
0x54 GTCCRC
0x58 GTCCRE
0x5C GTCCRD
0x60 GTCCRF
0x64 GTPR
0x68 GTPBR

GTCR.CST (bit 0) là bit chạy. GTCR.TPCS (bit 24..26) là bộ chia trước, PCLKD / 4^TPCS, tức là 1, 4, 16, 64, 256 và 1024; giá trị dự phòng được coi là 1024. GTCR.MD (bit 16..18) được lưu; chỉ chế độ đếm tăng dạng răng cưa được mô phỏng. GTSTR, GTSTP và GTCLR nhận một bitmask các kênh để khởi động, dừng hoặc đưa chúng về không. GTPR và GTPBR được ghi cùng nhau, vì việc chuyển buffer mà mô hình này sẽ làm ở cuối chu kỳ cũng chỉ mang cùng một giá trị.

Bộ đếm không bao giờ được lưu dưới dạng một số tự tăng: nó được tính từ chu kỳ CPU theo (cycle - started) / divider mod (GTPR + 1), nên không thể lệch khỏi mạch, và việc đọc GTCNT ở giữa một lát cắt cho ra giá trị đếm tại lệnh đó.

The output is this model's own rule, and a simplification. GTIOR.OAE (bit 8) and GTIOR.OBE (bit 24) decide whether GTIOCnA and GTIOCnB are driven; the level is high while the count is below the channel's compare register and low otherwise. A compare of zero is permanently low and a compare above GTPR permanently high, which is what analogWrite(pin, 0) and analogWrite(pin, 255) need. The five-bit GTIOA and GTIOB level-select fields in GTIOR, which on silicon can produce an inverted output or a toggle, are stored and read back and not decoded. firmware/unor4/src/pwm.c writes the setting a real GPT would need anyway, so a build taken to a desk is configured and not merely enabled.

Tín hiệu GPT nào tương ứng với từng chân PWM:

chân pad đầu ra
3 P105 GTIOC1B
5 P107 GTIOC2B
6 P111 GTIOC3A
9 P304 GTIOC5B
10 P103 GTIOC4B
11 P411 GTIOC6A

Bảng đó chưa được kiểm chứng (mục 7). Sáu chân là các chân PWM được ghi nhận của bản Minima; kênh nào và ngõ ra nào cho từng chân là phán đoán của mô hình này. Mô hình và runtime thống nhất với nhau, nên firmware biên dịch ở đây sẽ chạy được ở đây.

GPT0 cố ý không được runtime dùng đến.

3.4 SCI0..SCI9 (0x4007_0000, cách nhau 0x20)

Các thanh ghi byte, nối tiếp nhau: hai địa chỉ liền kề là hai thanh ghi khác nhau, nên một truy cập rộng hơn chỉ chạm tới byte ở địa chỉ đã cho.

offset thanh ghi
0x00 SMR
0x01 BRR
0x02 SCR
0x03 TDR
0x04 SSR
0x05 RDR
0x06 SCMR
0x07 SEMR
0x08 SNFR
0x09..0x0B SIMR1..SIMR3
0x0C SISR
0x0D SPMR

SCR: TE (5) và RE (4) là hai công tắc (không có bit bật tổng), cộng thêm TIE (7), RIE (6), TEIE (2). SSR: TDRE (7), RDRF (6), ORER (5), FER (4), PER (3), TEND (2). Các cờ lỗi và RDRF bị xóa bằng cách ghi số không vào chúng, ngoài ra chỉ đọc được, và RDRF không thể giữ mức không khi vẫn còn byte trong hàng đợi.

Một bit là 32 * 4^CKS * (BRR + 1) chu kỳ PCLKA, dựa theo công thức N = PCLKA / (64 * 2^(2n-1) * B) - 1 trong tài liệu hướng dẫn. SEMR.ABCS (bit 5) giảm một nửa số chia và SEMR.BGDM (bit 4) giảm một nửa lần nữa; cả hai đều được áp dụng. Mọi thứ khác trong SEMR, cùng với SCMR, SNFR, SIMR*, SISR và SPMR, chỉ được lưu và đọc lại chứ không gây ảnh hưởng gì. Độ dài khung truyền theo SMR.CHR, SMR.PE và SMR.STOP.

Các byte rời đi theo tốc độ bit, không tức thời: TDR cộng với thanh ghi dịch, nên TDRE trở lại ngay khi một byte bắt đầu được gửi và TEND khi byte cuối kết thúc. Một Serial1.println tốn thời gian mô phỏng (86.8 us một byte ở 115200), đúng như trên bàn thí nghiệm.

SCI2 là kênh duy nhất nối ra chân ở đây: TXD2 trên D1 và RXD2 trên D0. Chín kênh còn lại tồn tại để số kênh trùng với chỉ số; byte của chúng được đếm rồi đi vào hư vô.

Một pad với PMR được đặt và PSEL = SCI là bộ phát của SCI2 giữ mức cao khi SCR.TE được đặt, đúng như một đường TX thật giữa các khung. Bản thân các byte đi vào kênh máy chủ, chứ không lên dây dưới dạng sóng.

3.5 ADC14 unit 0 (0x4005_C000)

Địa chỉ cơ sở và mọi offset trong mục này chưa được kiểm chứng (mục 7).

offset thanh ghi
0x00 ADCSR (16 bit)
0x04, 0x06 ADANSA0, ADANSA1
0x08, 0x0A ADADS0, ADADS1 (được lưu)
0x0C ADADC (được lưu)
0x0E ADCER
0x10 ADSTRGR (được lưu)
0x12 ADEXICR (được lưu)
0x20 + 2n ADDRn, một kết quả cho mỗi kênh
0xE0 + n ADSSTRn, thời gian lấy mẫu theo trạng thái ADC, đặt lại thành 0x0B

ADCSR.ADST (bit 15) khởi động một lần quét và vẫn được đặt trong khi nó chạy; firmware poll bit này, và xóa nó sẽ hủy lần quét. ADCSR.ADCS (bit 13..14): 0 đơn, 2 liên tục; lần quét liên tục tự nạp lại. ADCER.ADRFMT (bit 15) đẩy kết quả lên đầu của mười sáu bit; mặc định là căn phải.

Một lần quét bao gồm các kênh được chọn trong ADANSA0/ADANSA1 và tốn đúng thời gian lấy mẫu của từng kênh cộng thêm mười hai trạng thái xấp xỉ liên tiếp. PCLKC là ICLK / 2, nên một trạng thái ADC bằng hai chu kỳ CPU và một lần chuyển đổi một kênh mặc định là 23 trạng thái, hơi dưới một microgiây, mà firmware thật sự phải chờ.

ADDRn giữ đủ mười bốn bit. Không có gì trong chip dịch chúng xuống mười bit; analogReadđộ phân giải mặc định của nó là do runtime làm (mục 6). Thang đầy là đường nguồn 5 V.

Quét theo nhóm, cảm biến nhiệt độ, điện áp tham chiếu nội bộ, lấy trung bình dữ liệu, tự chẩn đoán, chế độ kích hoạt kép và mọi nguồn kích hoạt trừ nguồn phần mềm đều không được mô phỏng.

3.6 USBFS (0x4009_0000): một đường ống byte, và không gì hơn

Địa chỉ cơ sở và mọi offset trong mục này chưa được kiểm chứng (mục 7), và quan trọng hơn, cả ý niệm rằng đây là USB cũng vậy.

offset thanh ghi
0x00 SYSCFG
0x04 SYSSTS0 (chỉ đọc)
0x08 DVSTCTR0 (được lưu)
0x14 CFIFO
0x20 CFIFOSEL
0x22 CFIFOCTR
0x30 INTENB0 (được lưu)
0x40 INTSTS0 (được lưu)

SYSCFG.USBE (bit 0) bật bộ điều khiển, SYSCFG.DPRPU (bit 4) nối điện trở pull-up D+ (đây chính là ý của việc "cắm vào"), còn SYSCFG.SCKE (bit 10) là clock. Cho đến khi bit module stop được xóa và cả USBE lẫn DPRPU đều được đặt, pipe không truyền gì cả.

CFIFOSEL.CURPIPE (bit 0..3) chọn một pipe, còn CFIFOSEL.ISEL (bit 5) chọn hướng: đặt để ghi, xóa để đọc. CFIFO di chuyển các byte. CFIFOCTR.DTLN (bit 0..8) đọc xem có bao nhiêu byte, BVAL (bit 15) giao buffer ghi đi còn BCLR (bit 14) vứt nó đi. Một buffer đầy 64 byte sẽ tự gửi đi, vì không có host nào để chờ.

Không có gì khác về USB ở đây. Không host, không bus, không reset, không gói SETUP, không descriptor, không enumeration, không addressing, không bộ đếm frame, không SOF, không double buffering, không NAK, không STALL, không cấu hình pipe và không interrupt. Một sketch điều khiển mô-đun này theo cách một driver CDC điều khiển chip thật sẽ chạy được; một sketch chờ enumeration hoàn tất, hoặc kiểm tra một yêu cầu descriptor, sẽ chờ mãi mãi. Đó là lý do if (Serial) ở đây đúng ngay khi begin() đã chạy, còn trên bàn làm việc thì lại sai một lúc.

Đây là chỗ mô hình cố ý không giống chip, và giả vờ ngược lại sẽ là lời nói dối duy nhất đáng kể.

3.7 Module stop (0x4004_7000)

địa chỉ thanh ghi mô hình này giải mã những gì
0x4004_7000 MSTPCRB SCIn tại bit 31 - n, USBFS tại bit 11
0x4004_7004 MSTPCRC được lưu
0x4004_7008 MSTPCRD GPTn tại bit 12 - n, ADC14 đơn vị 0 tại bit 16

A set bit stops the module, and every one of them resets set. The numbering counts down, which is the thing that surprises people. A stopped module's registers read 0 and the access is counted as stray; the port block and these registers themselves are always reachable, because something has to be.

3.8 SysTick, NVIC, và ICU không có ở đây

SysTick là của core, với SYST_CALIB = 480.000: clock tham chiếu là ICLK, nên một tick 10 ms là 480.000 vòng đếm. Bốn bit ưu tiên. Bảng vector gồm mười sáu mục hệ thống rồi ba mươi hai ô ICU.

Trên một chip RA, ba mươi hai ô đó không có ý nghĩa cố định: sự kiện ngoại vi nào đến được IRQ n được lập trình trong thanh ghi IELSRn của ICU. Các liên kết sự kiện của ICU không được mô hình hóa, nên không gì trong mô hình này phát sinh interrupt ngoại vi, IELSRn không được hiện thực, còn PmnPFS.ISEL được lưu nhưng không làm gì. SysTick, một exception của core không cần liên kết, là interrupt duy nhất hoạt động. Đó là lý do không có attachInterrupt trong runtime (mục 6), và điều này được nói thẳng thay vì xấp xỉ: một ICU với số hiệu sự kiện bịa ra sẽ tệ hơn không có ICU.

4. Kênh host

host_write đặt byte vào cả hai chỗ: buffer nhận của pipe USB và hàng đợi nhận của SCI2; host_read lấy các byte đã rời khỏi một trong hai. Một bo mạch có một kênh host, và một sketch có thể đang đọc Serial, Serial1 hoặc cả hai.

Đó là Serial và Serial1 trong một sketch, và serial monitor trong UI. Các byte là UTF-8 theo như UI thấy, còn với mô hình thì không rõ nghĩa gì.

Hai port khác nhau ở một điểm dễ thấy: byte của Serial1 rời đi theo tốc độ bit, còn byte của Serial rời đi vào cuối slice mà chúng được giao, nên một dòng USB thực sự có thể nằm lẫn trong một dòng UART trên monitor. Đó là bo mạch, không phải lỗi.

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

Picosecond trong một u64, giống kernel. CPU 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ó được tính lại từ số chu kỳ là cycles * 1_000_000 / 48. Một slice 10 us đúng bằng 480 chu kỳ và đúng 10.000.000 ps, nên ranh giới slice không bao giờ bị trôi.

Bộ đếm chu kỳ được neo vào thời gian kernel ở đầu mỗi slice, nên timer không thể trôi khỏi mạch dù các slice rơi thế nào, và một core đang ngủ sẽ bắt kịp số chu kỳ đã ngủ qua (kể cả SysTick) mà không phải thực thi chúng.

A slice runs in two gears. Coarse is Cpu::run in chunks bounded by the next peripheral deadline; fine is one instruction at a time with the bus told the cycle each one starts at, which is what lets a pin change carry the cycle that caused it. A store to a port, GPT, SCI or USB register drops the slice into fine for the next 4,800 cycles.

probe là một bitmask: 1 đang chạy, 2 đang ngủ trong WFI, 4 LED tích hợp trên chân 13 sáng, 8 có truyền serial trong 20 ms qua, 16 có nhận serial. Bằng 0 khi không có chương trình, đang bị giữ reset, hoặc đã sập.

poke: 1 giữ RESET, 0 nhả ra.

Một cơn sập (lệnh BKPT, hoặc một fault mà lõi không thể quay lại được) làm dừng bo mạch và ghi một dòng lên kênh host ghi rõ PC, CFSR và HFSR:

firmware crashed at pc=0x00001000, BKPT #0 (CFSR 0x00000000, HFSR 0x00000000)

crt0.S trỏ mọi vector không cần đến một handler thực thi BKPT, nên khi có fault ta biết nó xảy ra ở đâu thay vì treo im lặng.

6. Firmware runtime (firmware/unor4/)

Một runtime hình dáng Arduino viết từ đầu: setup() và loop(), pinMode, digitalWrite, digitalRead, shiftOut, analogRead, analogReadResolution, analogWrite, millis, micros, delay, delayMicroseconds, map, random, Serial và Serial1. Không có Arduino core, không ArduinoCore-renesas, không FSP, không CMSIS, không libc, không có gì thuộc GPL.

Được build bằng clang --target=thumbv7em-none-eabi -mcpu=cortex-m4 -mthumb -mfloat-abi=soft -mfpu=none -Os và ld.lld với firmware/unor4/link.ld, kèm --nmagic để chương trình hai kilobyte không bị đệm thành trang 64 KB. BOARD=unor4 là bo mạch duy nhất mà script này build.

  • Chân. Mỗi pinMode mở khóa PWPR, ghi một từ PmnPFS rồi khóa lại. digitalWrite là một lệnh ghi vào PCNTR3. INPUT_PULLDOWN được chấp nhận và cho ra input thường, vì linh kiện không có điện trở kéo xuống.
  • Thời gian. SysTick ở 1 kHz: reload 47,999, một số chu kỳ tròn trịa ở 48 MHz, nên millis không bị trôi. micros là bộ đếm đó cộng với phần còn lại trong chính bộ đếm đếm ngược của SysTick, nên một bộ đếm duy nhất cho độ phân giải micro giây trên toàn dải 32-bit và mọi kênh GPT đều rảnh cho analogWrite. delay thực thi WFI và đỗ; một giây thời gian mô phỏng tốn khoảng một nghìn lệnh thay vì bốn mươi tám triệu.
  • analogRead trả về mười bit, 0..1023, từ một bộ chuyển đổi mười bốn bit, vì đó là thứ một sketch Arduino mong đợi. analogReadResolution(1..14) thay đổi shift, vốn nằm ở src/analog.c chứ không nằm trong chip.
  • analogWrite là 0..255 ở 490.0 Hz (48 MHz / 16 / 6123) trên D3, D5, D6, D9, D10 và D11. 0 và 255 bỏ output enable của GPT và điều khiển chân trực tiếp, nên analogWrite(pin, 0) thực sự tắt; một chân không thuộc nhóm sáu đó được kéo thấp hoặc cao tại điểm giữa, giống như các Arduino core vẫn làm.
  • Serial là đường ống USB và không tới chân header nào. Serial1 là SCI2 trên D0 và D1, 8N1, BRR = PCLKA / (32 * baud) - 1 làm tròn. Nhận trên Serial1 được poll, vì không có ICU để đưa ra interrupt; hàng đợi phía sau của mô hình RDR đủ sâu nên gõ phím khi sketch đang bận vẫn không mất ký tự.
  • Không có attachInterrupt, vì lý do mà mục 3.8 nêu ra. Một sketch dùng cơ chế polling.
  • Số thực dấu phẩy động hoạt động và là soft float. Serial.print(float) đọc chuỗi bit IEEE-754 và không bao giờ tính toán với nó.
  • String, heap và tone() là của nhân dùng chung (firmware/lib): heap chạy từ _end tới stack, và tone() là PWM GPT ở 50 phần trăm trên D3, D5, D6, D9, D10 và D11, với phương án dự phòng bit-bang chặn để phát một nốt có thời lượng trên bất kỳ chân nào khác. Không có I2C, không có SPI.

Chuỗi program của danh mục là elf32 arm ra4m1.

Bốn ví dụ, mỗi ví dụ giới hạn 16 KB: blink, button (một nút nhấn trên D2), serial (cả hai cổng, và một echo) và analog (một biến trở trên A0 điều sáng LED trên D9, in mười bit và mười bốn bit).

crates/unor4/tests/runtime.rs chạy các ELF này trên mô hình. Hai trường hợp trong đó tồn tại để giữ số liệu của tài liệu này thay vì nói lại: clock thực sự là 48 MHz trong suốt hai giây mô phỏng, và millis sai lệch trong vòng 20 ms so với giá trị đúng sau ba giây.

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.

Taken from the RA4M1 group user's manual and the Minima's own documentation. The core: a Cortex-M4 at 48 MHz with four priority bits. 256 KB of code flash at zero, 32 KB of SRAM at 0x2000_0000, 8 KB of data flash at 0x4010_0000. The option-setting memory at 0x0000_0400. PORT_BASE = 0x4004_0000 with a 0x20 stride, and PCNTR1..PCNTR4 at 0x00, 0x04, 0x08, 0x0C with the half-word meanings section 3.1 gives. PFS_BASE = 0x4004_0800 with a 0x40 stride and four bytes a pin, and the PmnPFS bit positions in section 3.2. PWPR at 0x4004_0D03 with B0WI at bit 7 and PFSWE at bit 6. MSTP_BASE = 0x4004_7000, that a set bit stops the module, and that the numbering counts down. SCI_BASE = 0x4007_0000 with a 0x20 stride, the byte-register layout in section 3.4, and the SCR/SSR/SMR bit positions and the bit-rate formula. That SCI2 is the Minima's Serial1 on D0 and D1, and that Serial is the on-die USB. The Uno R3 header and the RA4M1 pad behind each hole in section 1, less the two noted below. That A0 is AN009 and A1..A3 are AN000..AN002. That D3, D5, D6, D9, D10 and D11 are the PWM pins. That the board is 68.6 x 53.3 mm.

Tin là đúng, chưa kiểm chứng. Nêu tên ở đây để một bản ảnh chiếu lên silicon thật có một danh sách ngắn để đối chiếu, tất cả trong một header, firmware/unor4/include/ra4m1.h:

  • GPT_BASE = 0x4007_8000 với stride 0x100, và mọi offset thanh ghi bên trong một kênh GPT (mục 3.3).
  • Mỗi chân PWM là ngõ ra GPT nào: bảng sáu dòng trong mục 3.3. Đây là khẳng định yếu nhất trong tài liệu: các chân là đúng còn các kênh là phỏng đoán.
  • ADC_BASE = 0x4005_C000 và mọi offset bên trong ADC14 (mục 3.5).
  • A4 và A5 trên AN021 và AN022. Bốn kênh analog còn lại không có trong nhóm này.
  • USB_BASE = 0x4009_0000 và mọi offset bên trong USBFS (mục 3.6).
  • Các mã PSEL 0b00011 cho GPT và 0b00100 cho SCI (mục 3.2).
  • Vị trí bit chính xác của MSTPCRB/MSTPCRD cho USBFS (11) và ADC14 (16). Các bit SCI và GPT theo quy tắc đếm ngược, vốn không có trong nhóm này.

Nơi mô hình và tài liệu này không khớp với silicon, firmware dựng ở đây vẫn khớp với mô hình: nó chạy trong trình mô phỏng và các lệnh ghi thanh ghi của nó nằm trong một header để dễ sửa.

Được mô hình hóa, nhưng không bị ràng buộc theo số liệu trong sổ tay. Chỉ hành vi chứ không phải địa chỉ, theo cách sắp xếp mà mục 7 của docs/esp32c6.md đặt ra và mọi hợp đồng bo mạch ở đây giờ đều tuân theo:

  • Clock là 48 MHz và cây clock không tồn tại. Các bit module stop chỉ là cổng chặn; HOCO, MOCO, PLL và SCKDIVCR không được mô hình hóa, nên dù sketch lập trình thế nào, nhân vẫn chạy ở 48 MHz. crates/unor4/tests/runtime.rs giữ điều đó theo firmware xuất xưởng thay vì theo câu này.
  • Ngõ ra GPT ở mức cao khi nhỏ hơn thanh ghi so sánh và mức thấp khi lớn hơn (mục 3.3). Các trường chọn mức năm bit của GTIOR được lưu chứ không giải mã, nên ngõ ra đảo hoặc bật tắt không được tái hiện; chu kỳ nhiệm vụ của analogWrite thì có.
  • Phiên cắt thời gian có hai tầng số, và lệnh ghi đầu tiên sau một khoảng im lặng đến sớm hơn, tới 10.7 us. Mọi thứ bên trong một chuỗi liên tục đều chính xác. Lý giải giống với mục 7 của docs/stm32f411.md.
  • ADC14 không có sai số. Một lần chuyển đổi là đường thẳng so với tham chiếu 5 V, lấy mẫu tại đúng thời điểm bắt đầu, không có sample-and-hold, không trở kháng ngõ vào, không phi tuyến, không nhiễu và không offset. Chẩn đoán tự động của ADCER và chức năng lấy trung bình của ADADC được lưu lại và không làm gì.
  • Các pad có ba trạng thái và một ngưỡng. Push-pull ở 5 V, open drain, highZ, hoặc điện trở kéo trong 35 kΩ, đọc lại so với một nửa nguồn cấp, không có trễ, không cài đặt độ mạnh ngõ ra, không thời gian lên và không giới hạn dòng. DSCR được lưu.
  • Serial là một ống dẫn byte và ống dẫn không bao giờ đầy. Các byte được giao đi rời đi cuối phiên cắt thời gian chứ không phải tại ranh giới khung USB, availableForWrite luôn là 1, và if (Serial) là một quyết định của mô hình này chứ không phải một thao tác bắt tay mà nó thực hiện (mục 3.6).
  • The board is an ideal supply: 5V, IOREF and 3V3 at rail impedance for ever, so nothing browns out. Start-up is a microsecond, where a real R4 spends its first moments in the bootloader.
  • Không có nút nhấn của người dùng, vì bo mạch không có; nút duy nhất giữ RESET ở mức thấp và đến thông qua poke.

Cố ý không có. Mỗi mục dưới đây bị bỏ qua thay vì bị chế ra, vì bố cục hay hành vi của nó không phải thứ mô hình này có thể tái tạo một cách trung thực:

  • ICU và các liên kết sự kiện của nó. Mục 3.8. Cùng với nó là mọi ngắt ngoại vi, attachInterrupt, và các chân IRQ.
  • Mạch tạo clock: HOCO, MOCO, PLL, SCKDIVCR. Phần này được mô hình hóa như đang chạy sẵn ở 48 MHz, và chương trình cấu hình cây clock sẽ ghi vào một khối không được ánh xạ.
  • AGT. Bộ đếm thời gian tiết kiệm năng lượng của RA4M1, và là bộ mà nhân Arduino dùng cho millis. Ở đây SysTick là đủ và chính xác.
  • Các watchdog (IWDT và WDT), đó là lý do bộ nhớ option-setting được lưu chứ không được giải mã.
  • I2C (IIC), SPI, CAN, DTC, khối cảm ứng CTSU, RTC, DAC, các bộ so sánh, các OPAMP, các khối CRC và CAC, và giao diện lập trình của data flash.
  • USB với tư cách một giao thức. Mục 3.6 là toàn bộ những gì có.
  • Lập trình flash và boot ROM.

Đó là lý do một binary FSP của hãng hay nhân Arduino không chạy được ở đây, còn firmware dựng cho tài liệu này thì chạy.