Editor

Menulis assembly

Assembly adalah cara kelas satu untuk memprogram board di sini: tab .S di samping sketch-mu, atau satu proyek utuh tanpa Arduino core di bawahnya.

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 .S atau .s dan panggil dari C dengan extern "C". Arduino core masih ada, jadi Serial, millis() dan pinMode() 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, #if dan // 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, lalu r22, lalu r20, turun dua-dua. Argumen dua byte memakai sepasang register, byte rendah dulu: int di r25:r24.
  • Hasil kembali di r24 untuk satu byte, r25:r24 untuk dua byte, dan r25:r22 untuk empat.
  • r1 harus nol saat kamu kembali. Compiler mengasumsikannya di semua tempat, jadi mul yang mengotornya perlu clr r1 setelahnya.
  • r2 sampai r17, r28 dan r29 milik pemanggil. Push jika kamu memakainya, dan pop sebelum ret. Sisanya bebas kamu pakai.

Di board ARM (standar Arm procedure call standard):

  • Argumen masuk di r0 sampai r3, dan hasil kembali di r0.
  • r4 sampai r11 milik 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, OCIE1A dan lainnya adalah nomor bitnya, jadi (1 << TXEN0) terbaca seperti cara data sheet membacanya.
  • Nama vektor. TIMER1_COMPA_vect adalah __vector_11, jadi .global TIMER1_COMPA_vect diikuti labelnya membuat handler interupsi yang dituju oleh tabel vektor. Akhiri dengan reti.
  • __zero_reg__ adalah r1 dan __tmp_reg__ adalah r0, dengan nama-nama itu.
  • Register di luar 64 bagian bawah, seperti UCSR0B dan TIMSK1, dipetakan ke memori: baca dengan lds dan tulis dengan sts.

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.S adalah gcrt1.o dari avr-libc. Yaitu tabel vektor dengan setiap __vector_n berupa reti lemah yang bisa kamu timpa, lalu r1 di-nol-kan, stack diset ke RAMEND, .data disalin dari flash, .bss di-nol-kan, dan sebuah call ke main-mu. Jadi kamu menulis main dan handler apa pun yang kamu mau, dengan nama vektor avr-libc. Jika file-mu mendefinisikan section .vectors sendiri, 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_top di Pico atau .word _estack di 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 sbic untuk melewati satu baris.
  • UART AVR menyetel USART0 ke 9600 baud dengan UBRR 103, menyimpan teksnya di .progmem dan membacanya satu byte sekali dengan lpm.
  • Timer AVR menjalankan Timer 1 dalam mode CTC pada clock dibagi 256 dengan OCR1A di 31.249, yaitu setiap 0,5 s, dan mengubah kondisi LED di TIMER1_COMPA_vect.
  • Pico mengeluarkan IO_BANK0 dan PADS_BANK0 (dan UART0 untuk versi UART) dari RESETS, menggerakkan GPIO25 lewat SIO di 0xD0000000, menunda dengan TIMERAWL, 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 dan BRR 729, 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, 5 memberi tahu bahwa LDI hanya bekerja pada register atas, r16 sampai r31, dan untuk mov nilainya ke bawah setelahnya jika kamu membutuhkannya di register bawah.
  • lid r16, 5 menjawab "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, 300 tidak muat dalam satu byte. Muat kedua bagiannya dengan lo8() dan hi8().
  • sbi PORTB, 5 memakai alamat data 0x25 padahal sbi butuh alamat I/O. Tulis _SFR_IO_ADDR(PORTB).
  • add r16, 5 terbaca sebagai add r16, r5, karena ADD menerima dua register. Tidak ada ADDI: kurangi dengan nilai negatifnya memakai subi r16, -5.
  • out PORTB, r16 tanpa __SFR_OFFSET 0 adalah 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 .S dan .s di 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.