Trình soạn thảo

Viết assembly

Assembly là một cách chính thống để lập trình bo mạch ở đây: một tab .S bên cạnh sketch của bạn, hoặc cả một dự án không có Arduino core bên dưới.

Sao phải làm vậy

Vì một số điều chỉ đúng khi tính từng lệnh một. Một khóa học dạy AVR hay Cortex-M đòi hỏi một vòng lặp trễ đếm theo chu kỳ, một bảng vector viết tay, và một bộ thanh ghi bạn đọc được khi dừng lại. Tất cả những điều đó chạy trong trình duyệt, trên chính các chip được mô phỏng mà sketch chạy, không cần cài đặt gì.

Hai cách vào:

  • Assembly bên cạnh sketch. Thêm một tab .S hoặc .s và gọi từ C bằng extern "C". Arduino core vẫn còn đó, nên Serial, millis() và pinMode() vẫn hoạt động.
  • Assembly không có Arduino core. Chọn một bản khởi đầu dưới Assembly (no Arduino) trong mục Firmware của thuộc tính bo mạch. Các tệp của bo mạch trở thành một main.S duy nhất, và không có gì được liên kết ngoài code của chính bạn và code khởi động.

Các tab .S và .s

Bấm + trên dải tệp và đặt tên tệp. Lời nhắc nói rõ yêu cầu: "Tên tệp mới, ví dụ config.h, helpers.cpp hoặc delay.S". Bất cứ tệp nào kết thúc bằng .S hoặc .s đều là assembly, và nó được biên dịch, liên kết cùng các tab .ino và .cpp của cùng bo mạch, hệt như Arduino IDE build một tệp .S cạnh sketch.

Hai cách viết không phải là cùng một loại tệp:

  • .S, chữ S in hoa, đi qua bộ tiền xử lý C trước. #include <avr/io.h>, #define, #if và // vẫn hoạt động, và __ASSEMBLER__ được đặt. Đây là loại nên dùng.
  • .s, chữ thường, được đưa thẳng cho assembler. Không include, không macro.

Một tab .S hoặc .s mới không bắt đầu rỗng. Nó mở ra với một hàm chạy được ngay mà sketch có thể gọi, theo bộ lệnh riêng của bo mạch: AVR trên Uno, Nano, Mega, Leonardo và ATtiny85, và ARM Thumb trên Pico, các bo STM32, Uno R4, micro:bit và XIAO. Dòng chú thích phía trên liệt kê quy ước gọi hàm, để các quy tắc nằm trước mắt bạn khi viết. Xóa nó đi hoặc xây tiếp trên nó.

Tab assembly có tô sáng cú pháp riêng, và dải breakpoint cạnh số dòng, giống hệt sketch.

Gọi qua lại giữa C và assembly

Một hàm viết bằng assembly là một nhãn .global, và C gọi tới nó qua extern "C" để tên không bị biến dạng. Hoạt động cả hai chiều: assembly có thể gọi hàm C theo cách tương tự.

// 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

Các quy tắc là của chính chip, không phải của Mokxi, nên hàm tuân theo chúng cũng chạy được trên bo mạch thật.

Trên các bo AVR (trình biên dịch gọi đây là quy ước gọi GCC AVR):

  • Tham số đi vào r24, rồi r22, rồi r20, giảm dần theo bước hai. Tham số hai byte chiếm một cặp, byte thấp trước: một int nằm trong r25:r24.
  • Kết quả trả về trong r24 cho một byte, r25:r24 cho hai byte, và r25:r22 cho bốn byte.
  • r1 phải bằng không khi bạn trả về. Trình biên dịch giả định vậy ở mọi nơi, nên một mul làm bẩn nó cần clr r1 ngay sau.
  • r2 đến r17, r28 và r29 thuộc về bên gọi. Push nếu bạn dùng chúng, và pop trước khi ret. Mọi thanh ghi khác bạn cứ tự do dùng.

Trên các bo ARM (chuẩn gọi thủ tục Arm tiêu chuẩn):

  • Tham số đi vào r0 đến r3, và kết quả trả về trong r0.
  • r4 đến r11 thuộc về bên gọi hàm: hãy push chúng và pop chúng lại.
  • Trả về bằng bx lr, và đánh dấu nhãn .thumb_func.

avr/io.h trong tệp .S

Trên bo mạch AVR, #include <avr/io.h> trong tệp .S cho các tên thanh ghi và bit, và hoạt động y như trong avr-libc. Điều này quan trọng, vì có một quy tắc khiến gần như ai cũng vấp:

Tên thanh ghi là địa chỉ dữ liệu, không phải địa chỉ I/O. PORTB là 0x25. Địa chỉ I/O thấp hơn 32, nên in, out, sbi, cbi, sbic và sbis cần _SFR_IO_ADDR(PORTB), tức là 0x05:

    sbi  _SFR_IO_ADDR(DDRB), DDB5     ; PB5 is an output
    sts  TCCR1B, r16                  ; a high register, by its data address

Nếu bạn muốn viết tên thường ở mọi nơi, hãy thêm một dòng phía trên lệnh include và chúng sẽ trở thành địa chỉ I/O, giống như chính mã khởi động của avr-gcc vẫn làm:

#define __SFR_OFFSET 0
#include <avr/io.h>
    sbi  DDRB, DDB5

Phần còn lại của tệp header cũng hoạt động:

  • Tên bit. DDB5, PINB5, TXEN0, WGM12, OCIE1A và các bit khác chính là số bit của chúng, nên (1 << TXEN0) đọc giống như trong tài liệu kỹ thuật.
  • Tên vector. TIMER1_COMPA_vect là __vector_11, nên .global TIMER1_COMPA_vect theo sau bởi nhãn sẽ tạo một trình xử lý ngắt mà bảng vector nhảy tới. Kết thúc nó bằng reti.
  • __zero_reg__ là r1 và __tmp_reg__ là r0, dưới đúng những tên đó.
  • Thanh ghi vượt quá 64 thanh ghi thấp, chẳng hạn UCSR0B và TIMSK1, được ánh xạ vào bộ nhớ: đọc bằng lds và ghi bằng sts.

Assembly nội tuyến

Vài lệnh nằm trong một hàm C không cần tab riêng. asm volatile với các ràng buộc hoạt động trên cả bo mạch AVR và ARM:

uint8_t x = 5;
asm volatile ("lsl %0" : "+r" (x));   // x is 10

Trình mô phỏng đếm chu kỳ, nên một vòng trễ viết tay thực sự dài đúng như tài liệu dữ liệu ghi. Một vòng lặp gồm nop, dec và brne, đo bằng Timer 1 ở tốc độ xung nhịp đầy đủ, ra đúng số đếm mà tài liệu dữ liệu ATmega328P ghi cho các lệnh của nó: một lds, một ldi và 50 vòng lặp đo được 202 chu kỳ, không phải 201 và không phải 203. Đó là điều khiến việc đếm chu kỳ đáng để dạy ở đây.

Assembly không cần Arduino core

Mở bảng thuộc tính của bo mạch và xem phần Firmware. Trên Arduino Uno, Nano, Pro Mini 16 MHz, Raspberry Pi Pico và STM32F411 Black Pill có một nhóm tên là Assembly (không Arduino) với bốn mẫu bắt đầu:

Mẫu bắt đầu Công dụng
Blink bằng assembly Bật tắt LED trên bo mạch mỗi 250 ms bằng một vòng lặp trễ đếm chu kỳ.
Nút nhấn điều khiển LED bằng assembly LED theo trạng thái của nút nhấn được kéo về mass bằng điện trở pull-up.
UART hello bằng assembly In một dòng trên Serial Monitor hai lần mỗi giây.
Ngắt timer bằng assembly Ngắt timer bật tắt LED, còn vòng lặp chính chỉ chờ rảnh.

Chọn một mẫu và các tệp trên bo mạch trở thành một tệp main.S duy nhất. Nếu trên bo mạch có tác phẩm của riêng bạn, bạn sẽ được hỏi trước. Sau đó danh sách chương trình vẫn giữ mẫu mà bạn bắt đầu từ đó, và ghi chú bên dưới nói rằng nút Chạy sẽ dịch main.S không kèm Arduino core, nên bo mạch giữ chế độ assembly khi bạn quay lại.

Không có Arduino core trong bản build: không có setup(), không có loop(), không có nhịp millis() và không có Serial. Những gì được liên kết chỉ có thế này:

  • Trên bo mạch AVR, tệp của bạn cộng với mã khởi động, đúng như gcrt1.o của avr-libc là đối với avr-gcc main.S. Đó là bảng vector với mỗi __vector_n là một reti yếu mà bạn có thể ghi đè, rồi r1 được xóa, stack được đặt ở RAMEND, .data được sao chép từ flash, .bss được xóa, và một call tới main của bạn. Vậy nên bạn viết main và những trình xử lý nào bạn muốn, dưới các tên vector của avr-libc. Nếu tệp của bạn tự định nghĩa vùng .vectors riêng, bạn sẽ không nhận được mã khởi động nào và toàn bộ chương trình là của bạn.
  • Trên Pico và Black Pill, không có gì ngoài tệp của bạn. Tệp của bạn chính là bảng vector: .word _stack_top trên Pico hoặc .word _estack trên Black Pill, rồi .word Reset_Handler, rồi những trình xử lý bạn muốn, mỗi cái một .thumb_func.

Những gì các mẫu bắt đầu thiết lập, nếu bạn muốn đọc các thanh ghi cùng với chúng:

  • AVR blink bật tắt PB5 bằng cách ghi 1 vào PINB5, mà ATmega328P hiểu là "bật tắt", và trễ bằng một vòng lặp ngoài và một vòng lặp trong: "250 ms ở 16 MHz là 4.000.000 chu kỳ: 40 lần 100.000", và vòng trong mất bốn chu kỳ mỗi lượt.
  • AVR button đọc PD2 với pull-up bật, nên khi nhấn sẽ đọc được 0, và dùng sbic để bỏ qua một dòng.
  • AVR UART đặt USART0 ở 9600 baud với UBRR 103, giữ văn bản trong .progmem và đọc từng byte một bằng lpm.
  • AVR timer chạy Timer 1 ở chế độ CTC với xung nhịp chia 256 và OCR1A bằng 31.249, tức là cứ mỗi 0,5 s, và bật tắt LED trong TIMER1_COMPA_vect.
  • Pico lấy IO_BANK0 và PADS_BANK0 (và UART0 cho mẫu UART) ra khỏi RESETS, điều khiển GPIO25 qua SIO ở 0xD0000000, trễ dựa trên TIMERAWL, giao tiếp trên UART0 ở GPIO0 với 115200, và dùng IRQ alarm 0 của TIMER cho mẫu timer.
  • Black Pill bật các xung nhịp trong RCC_AHB1ENR, điều khiển PC13 (sáng khi ở mức thấp), đọc PA0 với pull-up, in trên USART1 ở PA9 với 115200 và BRR 729, và chạy SysTick ở 1 kHz.

Nhấn Chạy và bo mạch sẽ chạy nó. Serial monitor, scope, máy phân tích logic và các linh kiện trên khung vẽ đều hoạt động như thường, vì con chip được mô phỏng không biết và cũng chẳng quan tâm ngôn ngữ nào tạo ra bản image.

Khi không dịch được

Lỗi dịch rơi đúng tab và đúng dòng, kèm một câu dễ hiểu bên dưới chỉ ra nên viết gì thay thế. Một vài ví dụ:

  • ldi r3, 5 báo LDI chỉ hoạt động trên các thanh ghi cao, r16 đến r31, và gợi ý mov giá trị xuống sau đó nếu bạn cần nó ở thanh ghi thấp.
  • lid r16, 5 báo "lid" không phải là lệnh AVR, và nhắc bạn rằng một nhãn kết thúc bằng dấu hai chấm còn một chỉ thị bắt đầu bằng dấu chấm.
  • Một nhãn viết thiếu dấu hai chấm sẽ được đọc lại cho bạn kèm dấu hai chấm.
  • Một lệnh nhánh có điều kiện không với tới đích sẽ được trình liên kết đặt đúng trên dòng của nó, kèm cách sửa: brne 1f, rjmp far, 1:.

Bốn trong số đó là các kiểm tra mà avr-as thực hiện còn trình dịch của LLVM thì không, nên Mokxi tự làm, trước khi bất kỳ công cụ nào chạy. Thiếu chúng, một lỗi sẽ được dịch lặng lẽ thành chương trình sai:

  • ldi r16, 300 không vừa trong một byte. Hãy nạp từng nửa bằng lo8() và hi8().
  • sbi PORTB, 5 dùng địa chỉ dữ liệu 0x25 trong khi sbi cần địa chỉ I/O. Hãy viết _SFR_IO_ADDR(PORTB).
  • add r16, 5 bị hiểu là add r16, r5, vì ADD nhận hai thanh ghi. Không có ADDI: hãy trừ số âm bằng subi r16, -5.
  • out PORTB, r16 thiếu __SFR_OFFSET 0 là cảnh báo chứ không phải lỗi, vì nó vẫn dịch được: chỉ là nó ghi vào một thanh ghi khác với thanh ghi được nêu tên.

in và out vượt qua địa chỉ I/O 63, sbiw và adiw vượt qua 63, và số bit vượt quá 7 đều được phát hiện theo cùng cách, mỗi trường hợp kèm theo lệnh nên dùng thay thế.

Trên các bo mạch Thumb, các lỗi thường gặp là thanh ghi cao trên Cortex-M0+ chỉ truy cập được r0 đến r7, dạng Thumb-2 32 bit trên Cortex-M0+ vốn chỉ có bộ lệnh 16 bit, lệnh nhảy ngoài phạm vi, thiếu Reset_Handler và thiếu main.

Từng bước chạy qua từng lệnh

Mọi thứ trong trình gỡ lỗi đều hoạt động trên assembly. Breakpoint đặt trong lề của tab .S và dừng tại dòng đó, vì số dòng mà trình dịch ghi lại là của chính tab, không phải của bản đã tiền xử lý.

Tab Debug có mục Disassembly. Khi đang dừng, mục này liệt kê các lệnh quanh thanh ghi chương trình: địa chỉ, các byte, lệnh viết theo kiểu llvm-objdump, và dòng nguồn nơi mỗi lệnh bắt đầu, dòng đó là một nút đưa bạn đến nó. Lệnh sắp chạy được đánh dấu. Step instruction chạy đúng một lệnh máy, trong khi Step over và Step vào vẫn di chuyển nguyên một dòng nguồn mỗi lần.

Các thanh ghi hiển thị đúng như của lõi. sreg trên AVR cũng được viết rõ thành các cờ của nó, ITHSVNZC, với dấu chấm cho mỗi cờ bằng 0, còn xpsr trên ARM được viết thành N Z C V Q, vì tám bit không phải là một con số.

Giới hạn

  • Assembly không kèm Arduino core được hỗ trợ trên Uno, Nano, Pro Mini, Pico và STM32F411 Black Pill. Các bo mạch khác vẫn nhận tab .S và .s cạnh một sketch.
  • Họ ESP32 không được hỗ trợ. Trình assemble Xtensa của chính Clang chưa hoàn thiện cho các tệp viết tay, nên các bo mạch đó chỉ biên dịch được C và C++.
  • Pico W không có dự án mẫu. LED của nó nằm trên chip vô tuyến chứ không phải trên chân GPIO. Hãy dùng Pico thường.
  • Dự án có cấu trúc phẳng. Tên tệp không chứa thư mục, nên đường dẫn include chỉ sâu một mức.