Referensi

Kontrak board Arduino Uno R4 Minima (Fase 9)

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

Ini adalah referensi teknis untuk modelnya: apa yang diimplementasikan, register demi register, untuk orang yang menulis firmware menggunakannya. Untuk memakai board ini di editor, mulai dari Arduino Uno R4 Minima dan halaman board.

Arduino Uno R4 Minima adalah RA4M1 Renesas (Cortex-M4 pada 48 MHz) dalam bentuk Uno. Satu komponen kernel (unor4 di crates/parts) membungkus model SoC RA4M1 (crates/unor4) pada core ARMv7-M yang sama dengan Blue Pill dan Black Pill (crates/cortexm-core). Core-nya dibagi; chip di sekitarnya tidak, dan sama sekali tidak untuk pin-pinnya.

Tipe katalognya unor4. Dokumen ini adalah kontraknya, dan ia menang atas komentar apa pun di kode.

Baca bagian 7 dulu jika kamu membawa build dari sini ke silikon sungguhan. Model ini lebih kecil daripada RA4M1, dan beberapa alamatnya ditandai "dipercaya, belum diverifikasi": bagian 7 menjelaskan yang mana, dan apa yang sama sekali tidak ada. Tidak ada yang dikira-kira diam-diam di sini.

Kenapa ini bukan Blue Pill dengan angka berbeda

RA itu dunia yang berbeda dari STM32, dan bedanya justru yang bikin sketch tersandung:

  • Satu pin itu satu register. PmnPFS adalah kata 32-bit per pin yang memuat arah, latch output, pull-up, open drain, saklar analog, "peripheral ini yang menguasai pin sekarang" dan peripheral yang mana. Tidak ada MODER, tidak ada CRL/CRH, tidak ada PUPDR dan tidak ada AFR.
  • Register itu terproteksi tulis. PWPR.B0WI harus di-nol-kan dan PWPR.PFSWE disetel sebelum tulisan PmnPFS apa pun masuk. Program yang lupa akan menemukan digitalWrite bekerja dan pinMode tidak bereaksi sama sekali. Model ini menegakkannya dan menghitung berapa yang dibuangnya.
  • Peripheral tanpa clock sampai kamu menyalakannya. Setiap bit di register module stop di-reset ke "berhenti". SCI, GPT, ADC14 dan USB semuanya tak bisa diakses (pembacaan mengembalikan nol) sampai MSTPCRB/MSTPCRD ditulis.
  • Ada pull-up dan tidak ada pull-down. INPUT_PULLDOWN di sini cuma mendapat input floating biasa, dan modelnya mengatakannya.
  • Serial itu USB, bukan UART. UART pada D0 dan D1 adalah Serial1. Pada Uno, keduanya satu hal.
  • Konverternya empat belas bit. analogRead tetap mengembalikan sepuluh, karena itulah yang diharapkan sketch Arduino; analogReadResolution meminta sisanya.
  • Flash-nya ada di nol. Tanpa alias, tanpa pin BOOT, dan ada kata pengatur opsi di 0x400 yang dibaca part sungguhan saat keluar reset.
  • LED bawaan aktif high, seperti milik Uno dan tidak seperti Blue Pill.

1. Pin board (urutan katalog)

Lubang demi lubang, header Uno R3, dan itulah yang membuat R4 bisa memakai shield Uno. Board-nya 68.6 x 53.3 mm.

Baris atas, kiri ke kanan (14 lubang): SCL, SDA, AREF, GND, 13, 12, 11, 10, 9, 8, 7, 6, 5, 4, 3, 2, 1, 0.

Baris bawah, kiri ke kanan (13 lubang): IOREF, RESET, 3V3, 5V, GNDb, GNDc, VIN, A0, A1, A2, A3, A4, A5.

31 pin. Nama yang duplikat diberi huruf karena nama pin katalog harus unik.

SCL dan SDA di samping AREF adalah dua potong logam yang sama dengan A5 dan A4: satu trace, dua lubang, seperti di Uno. Meng-drive salah satu ujung meng-drive keduanya.

Pin RA4M1 di balik setiap lubang:

lubang pad juga
0 P301 RXD2, penerimaan Serial1
1 P302 TXD2, transmisi 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

Nomor kanal A4 dan A5 belum diverifikasi (bagian 7). Empat lainnya tidak.

Kelistrikan: setiap I/O meng-drive push-pull pada 5 V melalui R_STRONG, berada di high-Z, atau menarik pull-up melalui 35 k. Tidak ada pull-down internal. Input membaca high pada 2,5 V; net yang diperebutkan (Unknown) terbaca 0, dan yang floating terbaca noise, seperti di Uno (docs/uno.md bagian 1). 5V dan IOREF meng-drive 5 V pada R_SUPPLY, 3V3 meng-drive 3,3 V, tiga ground meng-drive 0 V. RESET membawa pull-up 10 k ke 5 V, dan menariknya di bawah 2,5 V menahan core dalam reset. VIN dan AREF adalah input yang dibaca model dan tidak dipakai untuk apa pun.

Pin 13 membawa LED bawaan: beban 1 k ke ground, ditambahkan hanya saat pin menjadi output, jadi pinMode(13, INPUT_PULLUP) tetap berperilaku normal. Katoda LED di ground, jadi pin meng-supply arus untuk menyalakannya.

2. Peta memori

code flash 256 KB di 0x0000_0000
memori pengaturan opsi 0x0000_0400, dua word, disimpan dan tidak didekode
SRAM 32 KB di 0x2000_0000
puncak stack 0x2000_8000
PORT dan PFS 0x4004_0000, bagian 3.1 dan 3.2
module stop 0x4004_7000, bagian 3.7
ADC14 unit 0 0x4005_C000, bagian 3.5 (diperkirakan)
SCI0..SCI9 0x4007_0000, berjarak 0x20, bagian 3.4
GPT0..GPT7 0x4007_8000, berjarak 0x100, bagian 3.3 (diperkirakan)
USBFS 0x4009_0000, bagian 3.6 (diperkirakan)

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.

Setiap segmen PT_LOAD harus berada di dalam flash atau SRAM; selain itu ditolak dengan alasan, dan chip dibiarkan tanpa program. Data flash (8 KB di 0x4010_0000) dan antarmuka pemrogramannya tidak dimodelkan.

Memori pengaturan opsi di 0x0000_0400 adalah tempat RA4M1 asli membaca OFS0 saat reset untuk menentukan apakah watchdog menyala sendiri. firmware/unor4/crt0.S meletakkan sebuah word di sana dan link.ld memastikan word itu berada di 0x400; model ini tidak punya watchdog dan tidak mendekode word mana pun. Image tanpa itu akan boot di sini dan mereset dirinya sendiri di atas meja, itulah mengapa hal ini tidak opsional.

Core di sini adalah Cortex-M4 tanpa FPU. RA4M1 punya FPU presisi tunggal; cortexm-core mengimplementasikan bagian integer ARMv7E-M dan sama sekali tidak ada VFP, CPACR hanya disimpan dan tidak memberi apa pun, dan setiap encoding VFP memicu UNDEFINSTR. Kompilasi firmware dengan -mfloat-abi=soft -mfpu=none. Aritmetika floating-point dalam sketch tetap berfungsi dan dikerjakan dengan instruksi integer; binary hard-float yang dibuat di tempat lain akan fault pada instruksi VFP pertamanya daripada mengembalikan angka yang salah. Empat bit prioritas, seperti pada komponennya.

3. Register peripheral

Hanya subset di bawah ini yang diimplementasikan. Apa pun selain itu di dalam blok yang terpetakan akan terbaca 0 dan dihitung sebagai akses liar; apa pun di luar semua blok adalah access fault. Module yang bit stop-nya diset (bagian 3.7) terbaca 0 dan dihitung sebagai akses liar juga, itulah bentuk "clock mati" dari sisi bus.

3.1 PORT0..PORT5 (0x4004_0000, berjarak 0x20)

offset register separuh
0x00 PCNTR1 PDR 16 bit rendah, PODR 16 bit tinggi
0x04 PCNTR2 PIDR 16 bit rendah, EIDR 16 bit tinggi (hanya baca)
0x08 PCNTR3 POSR 16 bit rendah menyetel, PORR 16 bit tinggi menghapus (hanya tulis)
0x0C PCNTR4 EOSR/EORR, disimpan

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 membaca pin, bukan latch: output push-pull membaca kembali nilai yang sedang di-drive, input atau output open-drain membaca nilai terakhir yang disample board dari net.

Port 0 sampai 5 dimodelkan, yang mencakup semua pin yang dibawa keluar oleh Minima dan semua input analog yang dimiliki package 64 pin. Pad dinomori port * 16 + pin.

3.2 PmnPFS (0x4004_0800, 0x40 per port, 4 byte per pin) dan PWPR (0x4004_0D03)

Satu word 32 bit per pin di 0x4004_0800 + 0x40*m + 4*n. Alias byte dan halfword yang diberikan manual (PmnPFS_BY, PmnPFS_HA) adalah union dengan register 32 bit, jadi pada komponen little-endian ini keduanya adalah byte rendah dan halfword rendahnya, itulah mengapa pinMode bisa menjadi satu store byte.

bit nama arti
0 PODR latch output
1 PIDR level pada pin, hanya baca
2 PDR 1 = output, 0 = input
4 PCR pull-up internal
6 NCODR open drain kanal-N
10..11 DSCR kekuatan drive, disimpan
12..13 EOFR event pada edge, disimpan
14 ISEL enable input IRQ, disimpan (bagian 3.8)
15 ASEL enable input analog
16 PMR 1 = peripheral memiliki pin
24..28 PSEL peripheral yang mana

Pin dengan ASEL diset secara listrik high-Z apa pun kata word lainnya, dan adalah satu-satunya jenis yang boleh disample converter. Pin dengan PMR diset mengikuti peripheral termodel mana pun yang dinamai PSEL-nya dan mengabaikan PODR; PSEL yang tidak diimplementasikan model ini membiarkan pad begitu saja daripada mengarang level.

PSEL nilai yang dipatuhi model ini: 0b00011 GPT dan 0b00100 SCI. Keduanya diperkirakan, belum diverifikasi (bagian 7).

PWPR adalah satu byte di 0x4004_0D03. B0WI (bit 7) resets set and makes PFSWE (bit 6) tidak bisa ditulis; menulis nol akan menghapusnya, lalu menulis PFSWE mengizinkan penulisan PFS. Penulisan dengan B0WI set membiarkan PFSWE tetap. Penulisan PmnPFS saat PFSWE clear tidak sampai, dan model menghitungnya (protected_writes), karena itulah kegagalan senyap yang terkenal dari komponen ini.

3.3 GPT0..GPT7 (0x4007_8000, berjarak 0x100)

GPT0 dan GPT1 menghitung 32 bit; GPT2 sampai GPT7 menghitung 16.

offset register
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) adalah bit jalankan. GTCR.TPCS (bit 24..26) adalah prescaler, PCLKD / 4^TPCS, jadi 1, 4, 16, 64, 256 dan 1024; nilai reserved diperlakukan sebagai 1024. GTCR.MD (bit 16..18) disimpan; hanya hitung naik gelombang gergaji yang dimodelkan. GTSTR, GTSTP dan GTCLR menerima bitmask channel dan memulai, menghentikan atau meng-nol-kan channel tersebut. GTPR dan GTPBR ditulis bersamaan, karena transfer buffer yang akan dilakukan model ini di akhir siklus akan membawa nilai yang sama.

Penghitungnya tidak pernah disimpan sebagai angka yang bertambah: nilainya dihitung dari siklus CPU sebagai (cycle - started) / divider mod (GTPR + 1), jadi tidak bisa bergeser dari rangkaian, dan pembacaan GTCNT di tengah potongan memberikan hitungan pada instruksi tersebut.

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.

Output GPT untuk tiap pin PWM adalah:

pin pad output
3 P105 GTIOC1B
5 P107 GTIOC2B
6 P111 GTIOC3A
9 P304 GTIOC5B
10 P103 GTIOC4B
11 P411 GTIOC6A

Tabel itu belum terverifikasi (bagian 7). Enam pin itu adalah pin PWM Minima yang terdokumentasi; channel dan output mana untuk tiap pin adalah keyakinan model ini. Model dan runtime sepakat, jadi firmware yang dibuat di sini bekerja di sini.

GPT0 sengaja tidak dipakai oleh runtime.

3.4 SCI0..SCI9 (0x4007_0000, berjarak 0x20)

Register byte, satu demi satu: alamat berdampingan adalah register berbeda, jadi akses yang lebih lebar hanya menjangkau byte pada alamat yang diberikan.

offset register
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) dan RE (4) adalah dua saklarnya (tidak ada master enable), plus TIE (7), RIE (6), TEIE (2). SSR: TDRE (7), RDRF (6), ORER (5), FER (4), PER (3), TEND (2). Flag error dan RDRF dihapus dengan menulis nol padanya dan selain itu hanya bisa dibaca, serta RDRF tidak bisa tetap clear selama ada byte dalam antrean.

Satu bit adalah 32 * 4^CKS * (BRR + 1) siklus PCLKA, dari manual N = PCLKA / (64 * 2^(2n-1) * B) - 1. SEMR.ABCS (bit 5) membagi dua pembaginya dan SEMR.BGDM (bit 4) membagi dua lagi; keduanya diterapkan. Semua yang lain di SEMR, serta SCMR, SNFR, SIMR*, SISR dan SPMR, disimpan dan bisa dibaca kembali tapi tidak mengubah apa pun. Panjang frame mengikuti SMR.CHR, SMR.PE dan SMR.STOP.

Byte keluar pada kecepatan bit, tidak seketika: TDR plus shift register, jadi TDRE kembali begitu sebuah byte mulai keluar dan TEND saat byte terakhir selesai. Sebuah Serial1.println memakan waktu tersimulasi (86,8 us per byte pada 115200), persis seperti di meja kerja.

SCI2 adalah satu-satunya channel yang terhubung ke pin di sini: TXD2 di D1 dan RXD2 di D0. Sembilan lainnya ada supaya nomor channel adalah indeksnya; byte-nya dihitung dan tidak ke mana-mana.

Sebuah pad dengan PMR set dan PSEL = SCI yang merupakan transmitter SCI2 idle tinggi selama SCR.TE diset, yang merupakan perilaku garis TX sungguhan di antara frame. Byte-nya sendiri pergi ke channel host, bukan ke kabel sebagai gelombang.

3.5 ADC14 unit 0 (0x4005_C000)

Alamat dasar dan setiap offset di bagian ini belum terverifikasi (bagian 7).

offset register
0x00 ADCSR (16-bit)
0x04, 0x06 ADANSA0, ADANSA1
0x08, 0x0A ADADS0, ADADS1 (disimpan)
0x0C ADADC (disimpan)
0x0E ADCER
0x10 ADSTRGR (disimpan)
0x12 ADEXICR (disimpan)
0x20 + 2n ADDRn, satu hasil per channel
0xE0 + n ADSSTRn, waktu sampling dalam state ADC, reset ke 0x0B

ADCSR.ADST (bit 15) memulai scan dan tetap set selama berjalan; firmware mem-poll-nya, dan menghapusnya membatalkan scan. ADCSR.ADCS (bit 13..14): 0 tunggal, 2 kontinu; scan kontinu menyiapkan diri lagi secara otomatis. ADCER.ADRFMT (bit 15) memindahkan hasil ke bit paling atas dari enam belas bit; secara bawaan rata ke kanan.

Scan mencakup channel yang dipilih di ADANSA0/ADANSA1 dan memakan waktu sampling masing-masing plus dua belas state aproksimasi berturut-turut. PCLKC adalah ICLK / 2, jadi satu state ADC adalah dua siklus CPU dan konversi satu channel bawaan adalah 23 state, sedikit di bawah satu mikrodetik, yang benar-benar harus ditunggu firmware.

ADDRn menyimpan keempat belas bit. Tidak ada di dalam chip yang menggesernya turun ke sepuluh; analogReadresolusi bawaan 's adalah ulah runtime (bagian 6). Skala penuh adalah rel 5 V.

Scan grup, sensor suhu, referensi internal, perataan data, diagnosis mandiri, mode double-trigger dan semua trigger kecuali software tidak dimodelkan.

3.6 USBFS (0x4009_0000): pipa byte, dan tidak lebih

Alamat dasar dan setiap offset di bagian ini belum terverifikasi (bagian 7), dan lebih penting lagi, begitu pula anggapan bahwa ini USB sama sekali.

offset register
0x00 SYSCFG
0x04 SYSSTS0 (hanya bisa dibaca)
0x08 DVSTCTR0 (tersimpan)
0x14 CFIFO
0x20 CFIFOSEL
0x22 CFIFOCTR
0x30 INTENB0 (tersimpan)
0x40 INTSTS0 (tersimpan)

SYSCFG.USBE (bit 0) menyalakan controller, SYSCFG.DPRPU (bit 4) menyambungkan pull-up D+ (inilah arti "dicolokkan"), dan SYSCFG.SCKE (bit 10) adalah clock-nya. Selama bit module stop belum dihapus dan USBE maupun DPRPU belum disetel, pipe tidak mengirim apa pun.

CFIFOSEL.CURPIPE (bit 0..3) memilih pipe dan CFIFOSEL.ISEL (bit 5) arahnya: setel untuk menulis, hapus untuk membaca. CFIFO memindahkan byte. CFIFOCTR.DTLN (bit 0..8) membaca ada berapa byte, BVAL (bit 15) menyerahkan buffer tulis dan BCLR (bit 14) membuangnya. Buffer yang mencapai 64 byte keluar sendiri, karena tidak ada host yang harus ditunggu.

Tidak ada hal lain tentang USB di sini. Tidak ada host, tidak ada bus, tidak ada reset, tidak ada paket SETUP, tidak ada deskriptor, tidak ada enumerasi, tidak ada pengalamatan, tidak ada penghitung frame, tidak ada SOF, tidak ada double buffering, tidak ada NAK, tidak ada STALL, tidak ada konfigurasi pipe dan tidak ada interrupt. Sketch yang menggerakkan ini seperti driver CDC menggerakkan silikon akan bekerja; sketch yang menunggu enumerasi selesai, atau memeriksa permintaan deskriptor, akan menunggu selamanya. Itulah sebabnya if (Serial) di sini langsung benar begitu begin() dijalankan, dan salah sesaat di meja kerja.

Di sinilah model ini memang sengaja tidak sama dengan chip-nya, dan berpura-pura sebaliknya akan menjadi satu kebohongan yang benar-benar berarti.

3.7 Module stop (0x4004_7000)

alamat register apa yang didekode model ini
0x4004_7000 MSTPCRB SCIn di bit 31 - n, USBFS di bit 11
0x4004_7004 MSTPCRC disimpan
0x4004_7008 MSTPCRD GPTn di bit 12 - n, ADC14 unit 0 di 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, dan ICU yang tidak ada di sini

SysTick milik core, dengan SYST_CALIB = 480.000: clock referensinya ICLK, jadi tick 10 ms adalah 480.000 hitungan. Empat bit prioritas. Tabel vektor berisi enam belas entri sistem lalu tiga puluh dua slot ICU.

Pada RA, tiga puluh dua itu tidak punya arti tetap: peristiwa peripheral mana yang sampai ke IRQ n diprogram di register IELSRn milik ICU. Link peristiwa ICU tidak dimodelkan, jadi tidak ada di model ini yang memunculkan interrupt peripheral, IELSRn tidak diimplementasikan, dan PmnPFS.ISEL hanya tersimpan tanpa berfungsi. SysTick, pengecualian core yang tidak butuh link, adalah satu-satunya interrupt yang menyala. Itulah sebabnya tidak ada attachInterrupt di runtime (bagian 6), dan hal ini dikatakan apa adanya alih-alih didekati: ICU dengan nomor peristiwa yang dikarang akan lebih buruk daripada tidak ada ICU sama sekali.

4. Kanal host

host_write meletakkan byte di keduanya, buffer terima pipe USB dan antrean terima SCI2; host_read mengambil byte yang telah keluar dari salah satunya. Sebuah board punya satu channel host, dan sebuah sketch bisa membaca Serial, Serial1 atau keduanya.

Itu adalah Serial dan Serial1 dalam sebuah sketch dan serial monitor di UI. Byte berupa UTF-8 sejauh menyangkut UI dan bersifat buram (opaque) bagi model.

Kedua port tidak sama dalam satu hal yang terlihat: byte Serial1 keluar sesuai bit rate dan byte Serial keluar di akhir slice saat byte itu diserahkan, jadi baris USB benar-benar bisa mendarat di tengah baris UART di monitor. Itu sifat board-nya, bukan bug.

5. Model waktu dan komponen

Pikodetik dalam u64, seperti kernel. CPU berjalan di 48 MHz, jadi satu siklus adalah 20833,33 ps, bukan bilangan bulat, dan itulah sebabnya waktu tidak pernah diakumulasikan: waktu dihitung ulang dari jumlah siklus sebagai cycles * 1_000_000 / 48. Slice 10 us tepat 480 siklus dan tepat 10.000.000 ps, jadi batas slice tidak pernah bergeser.

Penghitung siklus ditambatkan ke waktu kernel di awal setiap slice, jadi timer tidak bisa bergeser dari rangkaian bagaimanapun slice jatuhnya, dan core yang diparkir mengejar siklus yang dilewatinya saat tidur (termasuk SysTick) tanpa mengeksekusinya.

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 adalah bitmask: 1 berjalan, 2 tidur di WFI, 4 LED bawaan di pin 13 menyala, 8 kirim serial dalam 20 ms terakhir, 16 terima serial. 0 tanpa program, ditahan dalam reset, atau crash.

poke: 1 menahan RESET, 0 melepasnya.

Crash (sebuah BKPT, atau fault yang tidak bisa dikembalikan oleh core) menghentikan board dan meletakkan satu baris di kanal host yang menyebut PC, CFSR dan HFSR:

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

crt0.S mengarahkan setiap vektor yang tidak dibutuhkannya ke handler yang mengeksekusi BKPT, jadi sebuah fault memberi tahu posisinya alih-alih berputar tanpa suara.

6. Firmware runtime (firmware/unor4/)

Runtime berbentuk Arduino yang ditulis dari nol: setup() dan loop(), pinMode, digitalWrite, digitalRead, shiftOut, analogRead, analogReadResolution, analogWrite, millis, micros, delay, delayMicroseconds, map, random, Serial dan Serial1. Tanpa Arduino core, tanpa ArduinoCore-renesas, tanpa FSP, tanpa CMSIS, tanpa libc, tanpa apa pun yang GPL.

Dibangun dengan clang --target=thumbv7em-none-eabi -mcpu=cortex-m4 -mthumb -mfloat-abi=soft -mfpu=none -Os dan ld.lld terhadap firmware/unor4/link.ld, dengan --nmagic agar program dua kilobyte tidak dipadding ke halaman 64 KB. BOARD=unor4 adalah satu-satunya board yang dibangun skrip ini.

  • Pin. Setiap pinMode membuka kunci PWPR, menulis satu kata PmnPFS lalu menguncinya lagi. digitalWrite adalah satu store ke PCNTR3. INPUT_PULLDOWN diterima dan menghasilkan input biasa, karena komponen ini tidak punya pull-down.
  • Waktu. SysTick pada 1 kHz: reload 47.999, jumlah siklus yang bulat pada 48 MHz, jadi millis tidak mengalami drift. micros adalah counter itu ditambah sisa di down-counter milik SysTick, jadi satu timer memberi resolusi mikrosekon pada rentang 32-bit penuh dan setiap channel GPT tetap bebas untuk analogWrite. delay menjalankan WFI dan berhenti; satu detik waktu simulasi hanya memakan sekitar seribu instruksi, bukan empat puluh delapan juta.
  • analogRead mengembalikan sepuluh bit, 0..1023, dari converter empat belas bit, karena itulah yang diharapkan sketch Arduino. analogReadResolution(1..14) mengubah shift, yang ada di src/analog.c dan tidak di chip.
  • analogWrite adalah 0..255 pada 490,0 Hz (48 MHz / 16 / 6123) di D3, D5, D6, D9, D10 dan D11. 0 dan 255 melepas output enable GPT dan menggerakkan pin, jadi analogWrite(pin, 0) benar-benar mati; pin yang bukan salah satu dari enam itu digerakkan rendah atau tinggi di titik tengah, seperti yang dilakukan core Arduino.
  • Serial adalah pipe USB dan tidak mencapai pin header mana pun. Serial1 adalah SCI2 di D0 dan D1, 8N1, BRR = PCLKA / (32 * baud) - 1 dibulatkan. Penerimaan di Serial1 dilakukan dengan polling, karena tidak ada ICU yang mengantarkan interrupt; antrean model di belakang RDR cukup dalam sehingga mengetik saat sketch sibuk tidak kehilangan karakter.
  • Tidak ada attachInterrupt, dengan alasan yang diberikan bagian 3.8. Sebuah sketch melakukan polling.
  • Floating point berfungsi dan merupakan soft float. Serial.print(float) membaca pola bit IEEE-754 dan tidak pernah menghitung dengannya.
  • String, heap dan tone() adalah milik core bersama (firmware/lib): heap berjalan dari _end ke stack, dan tone() adalah PWM GPT pada 50 persen di D3, D5, D6, D9, D10 dan D11, dengan fallback bit-banged yang memblokir untuk nada berdurasi di pin lainnya. Tidak ada I2C, tidak ada SPI.

String katalog program adalah elf32 arm ra4m1.

Empat contoh, masing-masing dianggarkan 16 KB: blink, button (tombol tekan di D2), serial (kedua port, dan sebuah echo) dan analog (sebuah knob di A0 memudarkan LED di D9, mencetak sepuluh bit dan empat belas).

crates/unor4/tests/runtime.rs menjalankan ELF ini terhadap model. Dua kasusnya ada untuk menahan angka dokumen ini alih-alih menyatakannya ulang: clock memang benar 48 MHz selama dua detik simulasi, dan millis mendarat dalam 20 ms dari kebenaran pada detik ketiga.

7. Apa yang sudah pasti pada model ini, dan apa yang belum

Tiga kelompok. Bagian ini ada karena model board yang diam-diam menebak sebuah alamat lebih buruk daripada yang mengaku tidak tahu.

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.

Dipercaya, tidak diverifikasi. Dinamai di sini agar image yang dibawa ke silikon sungguhan punya daftar pendek untuk diperiksa, semuanya dalam satu header, firmware/unor4/include/ra4m1.h:

  • GPT_BASE = 0x4007_8000 dengan stride 0x100, dan setiap offset register di dalam channel GPT (bagian 3.3).
  • Output GPT yang mana untuk setiap pin PWM: tabel enam baris di bagian 3.3. Ini adalah klaim paling lemah dalam dokumen: pinnya benar dan channelnya adalah keyakinan.
  • ADC_BASE = 0x4005_C000 dan setiap offset di dalam ADC14 (bagian 3.5).
  • A4 dan A5 di AN021 dan AN022. Empat channel analog lainnya tidak ada di grup ini.
  • USB_BASE = 0x4009_0000 dan setiap offset di dalam USBFS (bagian 3.6).
  • Enkoding PSEL 0b00011 untuk GPT dan 0b00100 untuk SCI (bagian 3.2).
  • Posisi bit MSTPCRB/MSTPCRD yang tepat untuk USBFS (11) dan ADC14 (16). Bit SCI dan GPT mengikuti aturan hitung-turun, yang tidak ada di grup ini.

Jika model dan dokumen ini tidak setuju dengan silikon, firmware yang dibangun di sini tetap setuju dengan model: firmware berjalan di simulator dan penulisan registernya berada dalam satu header untuk dikoreksi.

Dimodelkan, tetapi tidak diikat ke angka manual. Perilaku alih-alih alamat, dalam urutan yang ditetapkan bagian 7 docs/esp32c6.md dan yang kini diikuti setiap kontrak board di sini:

  • Clock adalah 48 MHz dan clock tree tidak ada. Bit module stop adalah gerbang; HOCO, MOCO, PLL dan SCKDIVCR tidak dimodelkan, jadi apa pun yang diprogram sketch, inti berjalan pada 48 MHz. crates/unor4/tests/runtime.rs menahan itu pada firmware bawaan alih-alih pada kalimat ini.
  • Output GPT tinggi di bawah register compare-nya dan rendah di atasnya (bagian 3.3). Field level-select lima bit GTIOR disimpan dan tidak didekodekan, jadi output terbalik atau toggling tidak direproduksi; duty cycle analogWrite direproduksi.
  • Slice punya dua gigi, dan penyimpanan pertama setelah periode tenang terlalu awal, hingga 10.7 us. Semuanya di dalam burst adalah eksak. Penalarannya adalah penalaran bagian 7 docs/stm32f411.md.
  • ADC14 tidak punya error di dalamnya. Konversi adalah garis lurus terhadap referensi 5 V, disampel pada saat ia dimulai, tanpa sample-and-hold, tanpa impedansi input, tanpa nonlinearitas, tanpa noise dan tanpa offset. Diagnosis mandiri ADCER dan fitur rata-rata ADADC disimpan dan tidak melakukan apa pun.
  • Pad adalah tiga keadaan dan satu ambang. Push-pull pada 5 V, open drain, high-Z, atau pull-up internal 35 kΩ, dibaca kembali terhadap separuh suplai, tanpa histeresis, tanpa pengaturan drive-strength, tanpa rise time dan tanpa batas arus. DSCR disimpan.
  • Serial adalah pipa byte dan pipanya tidak pernah penuh. Byte yang diserahkan pergi di akhir slice alih-alih di batas frame USB, availableForWrite selalu 1, dan if (Serial) adalah keputusan yang dibuat model ini alih-alih handshake yang dijalankannya (bagian 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.
  • Tidak ada tombol pengguna, karena board tidak punya; satu tombol menahan RESET rendah dan datang melalui poke.

Sengaja tidak ada. Masing-masing ditinggalkan alih-alih diciptakan, karena tata letak atau perilakunya bukan sesuatu yang bisa direproduksi model ini dengan jujur:

  • ICU dan event link-nya. Bagian 3.8. Bersamanya pergi setiap interupsi periferal, attachInterrupt, dan pin IRQ.
  • Rangkaian pembangkit clock: HOCO, MOCO, PLL, SCKDIVCR. Bagian dimodelkan sebagai sudah berjalan pada 48 MHz, dan program yang mengonfigurasi clock tree menulis ke blok yang tidak terpetakan.
  • AGT. Timer daya rendah RA4M1, dan satu-satunya yang dipakai inti Arduino untuk millis. SysTick cukup di sini dan eksak.
  • Watchdog (IWDT dan WDT), itulah sebabnya memori pengaturan opsi disimpan dan tidak didekodekan.
  • I2C (IIC), SPI, CAN, DTC, unit sentuh CTSU, RTC, DAC, komparator, OPAMP, unit CRC dan CAC, dan antarmuka pemrograman data flash.
  • USB sebagai protokol. Bagian 3.6 adalah seluruhnya.
  • Pemrograman flash dan boot ROM.

Itulah sebabnya biner FSP vendor atau inti Arduino tidak berjalan di sini, dan firmware yang dibangun untuk dokumen ini berjalan.