Kenapa repot-repot
Karena beberapa hal hanya benar satu instruksi pada satu waktu. Kursus yang mengajarkan AVR atau Cortex-M biasanya meminta loop delay yang dihitung dalam siklus, tabel vektor yang ditulis tangan, dan sekumpulan register yang bisa kamu baca saat henti. Semuanya bekerja di browser, di chip simulasi yang sama tempat sketch berjalan, tanpa perlu memasang apa pun.
Dua cara masuk:
- Assembly di samping sketch. Tambahkan tab
.Satau.sdan panggil dari C denganextern "C". Arduino core masih ada, jadiSerial,millis()danpinMode()tetap bekerja. - Assembly tanpa Arduino core. Pilih starter di bawah Assembly (no
Arduino) di bagian Firmware pada properti board. File board menjadi satu
main.S, dan hanya kodemu sendiri serta kode startup yang di-link.
Tab .S dan .s
Tekan + di strip file dan beri nama file-nya. Prompt menjelaskan syaratnya: "Nama file baru, seperti config.h, helpers.cpp atau delay.S". Apa pun yang berakhiran .S atau .s adalah assembly, dan dikompilasi serta di-link bersama tab .ino dan .cpp di board yang sama, persis seperti Arduino IDE mem-build .S di samping sketch.
Dua ejaan itu bukan file yang sama:
.S, S besar, melewati preprocessor C lebih dulu.#include <avr/io.h>,#define,#ifdan//komentar semuanya bekerja, dan__ASSEMBLER__disetel. Inilah yang sebaiknya dipakai..s, s kecil, langsung diberikan ke assembler apa adanya. Tanpa include, tanpa makro.
Tab .S atau .s baru tidak dimulai kosong. Ia terbuka dengan satu fungsi yang bekerja dan bisa dipanggil sketch, dalam set instruksi board itu sendiri: AVR di Uno, Nano, Mega, Leonardo dan ATtiny85, dan ARM Thumb di Pico, board STM32, Uno R4, micro:bit dan XIAO. Komentar di atasnya mencantumkan calling convention, jadi aturannya ada di depanmu saat menulis. Hapus saja atau kembangkan.
Tab assembly punya syntax highlighting sendiri, dan gutter breakpoint di samping nomor baris, sama seperti sketch.
Memanggil antara C dan assembly
Fungsi yang ditulis dalam assembly adalah label .global, dan C mengaksesnya lewat extern "C" supaya namanya tidak berubah. Bekerja dua arah: assembly bisa memanggil fungsi C dengan cara yang sama.
// sketch.ino
extern "C" uint8_t add_bytes(uint8_t a, uint8_t b);
void setup() {
Serial.begin(9600);
Serial.println(add_bytes(2, 40)); // 42
}
void loop() {}
; add.S
.global add_bytes
add_bytes:
add r24, r22 ; a is in r24, b in r22
ret ; the result goes back in r24
Aturannya milik chip itu sendiri, bukan milik Mokxi, jadi fungsi yang mengikutinya juga bekerja di board sungguhan.
Di board AVR (compiler menyebut ini GCC AVR calling convention):
- Argumen masuk di
r24, lalur22, lalur20, turun dua-dua. Argumen dua byte memakai sepasang register, byte rendah dulu:intdir25:r24. - Hasil kembali di
r24untuk satu byte,r25:r24untuk dua byte, danr25:r22untuk empat. r1harus nol saat kamu kembali. Compiler mengasumsikannya di semua tempat, jadimulyang mengotornya perluclr r1setelahnya.r2sampair17,r28danr29milik pemanggil. Push jika kamu memakainya, dan pop sebelumret. Sisanya bebas kamu pakai.
Di board ARM (standar Arm procedure call standard):
- Argumen masuk di
r0sampair3, dan hasil kembali dir0. r4sampair11milik pemanggil: push dan pop register-register itu.- Kembali dengan
bx lr, dan tandai labelnya.thumb_func.
avr/io.h di file .S
Di board AVR, #include <avr/io.h> di file .S memberikan nama register dan bit, dan perilakunya persis seperti milik avr-libc. Itu penting, karena satu aturan ini hampir menjerat semua orang:
Nama register adalah alamat data, bukan alamat I/O. PORTB adalah 0x25. Alamat I/O-nya lebih rendah 32, jadi in, out, sbi, cbi, sbic dan sbis butuh _SFR_IO_ADDR(PORTB), yaitu 0x05:
sbi _SFR_IO_ADDR(DDRB), DDB5 ; PB5 is an output
sts TCCR1B, r16 ; a high register, by its data address
Kalau kamu lebih suka menulis nama polos di semua tempat, taruh satu baris di atas include dan semuanya menjadi alamat I/O, seperti yang dilakukan kode startup milik avr-gcc sendiri:
#define __SFR_OFFSET 0
#include <avr/io.h>
sbi DDRB, DDB5
Bagian header lainnya juga berfungsi:
- Nama bit.
DDB5,PINB5,TXEN0,WGM12,OCIE1Adan lainnya adalah nomor bitnya, jadi(1 << TXEN0)terbaca seperti cara data sheet membacanya. - Nama vektor.
TIMER1_COMPA_vectadalah__vector_11, jadi.global TIMER1_COMPA_vectdiikuti labelnya membuat handler interupsi yang dituju oleh tabel vektor. Akhiri denganreti. __zero_reg__adalahr1dan__tmp_reg__adalahr0, dengan nama-nama itu.- Register di luar 64 bagian bawah, seperti
UCSR0BdanTIMSK1, dipetakan ke memori: baca denganldsdan tulis dengansts.
Assembly inline
Beberapa instruksi di dalam fungsi C tidak perlu tab tersendiri. asm volatile dengan constraint bekerja di board AVR dan ARM:
uint8_t x = 5;
asm volatile ("lsl %0" : "+r" (x)); // x is 10
Simulator menghitung siklus, jadi delay yang ditulis manual benar-benar selama yang tertulis di data sheet. Loop dari nop, dec dan brne, diukur dengan Timer 1 pada clock penuh, hasilnya tepat sesuai hitungan yang diberikan data sheet ATmega328P untuk instruksinya: satu lds, satu ldi dan 50 putaran loop terukur 202 siklus, bukan 201 dan bukan 203. Itulah yang membuat menghitung siklus layak diajarkan di sini.
Assembly tanpa Arduino core
Buka panel properti board dan lihat bagian Firmware. Pada Arduino Uno, Nano, Pro Mini 16 MHz, Raspberry Pi Pico dan STM32F411 Black Pill ada grup bernama Assembly (tanpa Arduino) dengan empat starter di dalamnya:
| Starter | Fungsinya |
|---|---|
| Blink dalam assembly | Menyalakan-matikan LED board setiap 250 ms dari loop delay terhitung. |
| Tombol ke LED dalam assembly | LED mengikuti tombol yang disambung ke ground lewat pull-up-nya. |
| UART hello dalam assembly | Mencetak satu baris di Serial Monitor dua kali per detik. |
| Interupsi timer dalam assembly | Interupsi timer menyalakan-matikan LED, dan loop utamanya hanya menganggur. |
Pilih salah satu dan file di board menjadi satu main.S. Kalau ada karya milikmu di board, kamu akan ditanya dulu. Setelah itu daftar program tetap menyimpan starter asalmu, dan catatan di bawahnya mengatakan bahwa Jalankan mengompilasi main.S tanpa Arduino core, jadi board tetap dalam assembly saat kamu kembali.
Tidak ada Arduino core di build: tidak ada setup(), tidak ada loop(), tidak ada tick millis() dan tidak ada Serial. Yang di-link hanya ini:
- Pada board AVR, file-mu ditambah kode startup, yang bagi
avr-gcc main.Sadalahgcrt1.odari avr-libc. Yaitu tabel vektor dengan setiap__vector_nberuparetilemah yang bisa kamu timpa, lalur1di-nol-kan, stack diset ke RAMEND,.datadisalin dari flash,.bssdi-nol-kan, dan sebuahcallkemain-mu. Jadi kamu menulismaindan handler apa pun yang kamu mau, dengan nama vektor avr-libc. Jika file-mu mendefinisikan section.vectorssendiri, kamu tidak mendapat kode startup sama sekali dan seluruh program adalah milikmu. - Pada Pico dan Black Pill, tidak ada apa pun selain file-mu. File-mu adalah tabel vektornya:
.word _stack_topdi Pico atau.word _estackdi Black Pill, lalu.word Reset_Handler, lalu handler yang kamu mau, masing-masing.thumb_func.
Apa yang disiapkan starter-starter itu, kalau kamu ingin membaca registernya bersama mereka:
- AVR blink men-toggle PB5 dengan menulis 1 ke
PINB5, yang dibaca ATmega328P sebagai "toggle", dan menunda dengan loop luar dan loop dalam: "250 ms pada 16 MHz adalah 4.000.000 siklus: 40 kali 100.000", dan loop dalamnya empat siklus per putaran. - Tombol AVR membaca PD2 dengan pull-up menyala, jadi saat ditekan terbaca 0, dan memakai
sbicuntuk melewati satu baris. - UART AVR menyetel USART0 ke 9600 baud dengan
UBRR103, menyimpan teksnya di.progmemdan membacanya satu byte sekali denganlpm. - Timer AVR menjalankan Timer 1 dalam mode CTC pada clock dibagi 256 dengan
OCR1Adi 31.249, yaitu setiap 0,5 s, dan mengubah kondisi LED diTIMER1_COMPA_vect. - Pico mengeluarkan
IO_BANK0danPADS_BANK0(danUART0untuk versi UART) dariRESETS, menggerakkan GPIO25 lewat SIO di0xD0000000, menunda denganTIMERAWL, berkomunikasi lewat UART0 di GPIO0 pada 115200, dan memakai alarm 0 IRQ TIMER untuk starter timer. - Black Pill menyalakan clock di
RCC_AHB1ENR, menggerakkan PC13 yang menyala saat rendah, membaca PA0 dengan pull-up, mencetak di USART1 pada PA9 dengan 115200 danBRR729, serta menjalankan SysTick pada 1 kHz.
Tekan Jalankan dan board menjalankannya. Serial monitor, osiloskop, logic analyzer dan komponen di kanvas semuanya bekerja seperti biasa, karena chip simulasi tidak tahu dan tidak peduli bahasa apa yang membuat image-nya.
Saat gagal dirakit
Error assembler muncul di tab yang tepat dan baris yang tepat, dengan satu kalimat bahasa Indonesia yang mudah dipahami di bawahnya yang menjelaskan apa yang harus ditulis. Beberapa di antaranya:
ldi r3, 5memberi tahu bahwa LDI hanya bekerja pada register atas, r16 sampai r31, dan untukmovnilainya ke bawah setelahnya jika kamu membutuhkannya di register bawah.lid r16, 5menjawab"lid" bukan instruksi AVR, dan mengingatkanmu bahwa label diakhiri titik dua dan direktif diawali titik.- Label yang ditulis tanpa titik duanya akan disebutkan kembali padamu dengan titik dua yang ditambahkan.
- Branch bersyarat yang tidak dapat menjangkau targetnya ditempatkan pada barisnya oleh linker, beserta solusinya:
brne 1f,rjmp far,1:.
Empat di antaranya adalah pemeriksaan yang dilakukan avr-as tetapi tidak oleh assembler LLVM, jadi Mokxi melakukannya sendiri, sebelum alat apa pun dijalankan. Tanpa itu, kesalahan akan terakit diam-diam menjadi program yang salah:
ldi r16, 300tidak muat dalam satu byte. Muat kedua bagiannya denganlo8()danhi8().sbi PORTB, 5memakai alamat data0x25padahalsbibutuh alamat I/O. Tulis_SFR_IO_ADDR(PORTB).add r16, 5terbaca sebagaiadd r16, r5, karena ADD menerima dua register. Tidak ada ADDI: kurangi dengan nilai negatifnya memakaisubi r16, -5.out PORTB, r16tanpa__SFR_OFFSET 0adalah peringatan, bukan error, karena tetap ter-assemble: hanya saja menulis register yang berbeda dari yang disebut.
in dan out melewati alamat I/O 63, sbiw dan adiw melewati 63, dan nomor bit melewati 7 ditangkap dengan cara yang sama, masing-masing dengan instruksi pengganti yang harus digunakan.
Di board Thumb yang umum adalah register tinggi di Cortex-M0+, yang hanya menjangkau r0 sampai r7, bentuk Thumb-2 32-bit di Cortex-M0+, yang hanya punya set 16-bit, branch di luar jangkauan, Reset_Handler yang hilang dan main yang hilang.
Melangkah instruksi demi instruksi
Semua yang ada di debugger bekerja di level assembly. Breakpoint diletakkan di gutter tab .S dan berhenti di baris itu, karena nomor baris yang dicatat assembler adalah milik tab itu sendiri, bukan milik salinan hasil preprocess.
Tab Debug punya bagian Disassembly. Saat berhenti, bagian ini menampilkan instruksi di sekitar program counter: alamat, byte-nya, instruksi dengan ejaan llvm-objdump, dan baris sumber tempat masing-masing dimulai, yang merupakan tombol menuju baris itu. Instruksi yang akan dijalankan ditandai. Step instruction menjalankan tepat satu instruksi mesin, sedangkan Step over dan Step into tetap bergerak satu baris sumber penuh setiap langkahnya.
Register terbaca apa adanya sesuai core-nya. sreg di AVR juga dieja sebagai flag-nya, ITHSVNZC, dengan titik untuk setiap flag yang clear, dan xpsr di ARM dieja sebagai N Z C V Q, karena delapan bit itu bukan sebuah angka.
Batasan
- Assembly tanpa Arduino core tersedia di Uno, Nano, Pro Mini, Pico, dan STM32F411 Black Pill. Board lainnya tetap menerima tab
.Sdan.sdi samping sketch. - Keluarga ESP32 tidak termasuk. Assembler Xtensa milik Clang sendiri belum lengkap untuk file yang ditulis manual, jadi board itu hanya bisa mengompilasi C dan C++.
- Pico W tidak punya starter. LED-nya ada di chip wireless, bukan di pin GPIO. Gunakan Pico biasa.
- Proyek itu flat. Nama file tidak membawa direktori, jadi include path hanya satu direktori.
Related
- Editor kode dan kompilasi
- Debugger
- Panel properti
- Assembly AVR di browser: starter blink baris demi baris, penghitungan siklus dan interrupt timer
- Mengompilasi di browser: bagaimana
.Sis preprocessed, assembled and linked