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
.Shoặc.svà gọi từ C bằngextern "C". Arduino core vẫn còn đó, nênSerial,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.Sduy 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,#ifvà//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ồir22, rồir20, giảm dần theo bước hai. Tham số hai byte chiếm một cặp, byte thấp trước: mộtintnằm trongr25:r24. - Kết quả trả về trong
r24cho một byte,r25:r24cho hai byte, vàr25:r22cho bốn byte. r1phả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ộtmullàm bẩn nó cầnclr r1ngay sau.r2đếnr17,r28vàr29thuộc về bên gọi. Push nếu bạn dùng chúng, và pop trước khiret. 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đếnr3, và kết quả trả về trongr0. r4đếnr11thuộ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,OCIE1Avà 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_vectlà__vector_11, nên.global TIMER1_COMPA_vecttheo 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ằngreti. __zero_reg__làr1và__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
UCSR0BvàTIMSK1, được ánh xạ vào bộ nhớ: đọc bằngldsvà ghi bằngsts.
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.ocủa avr-libc là đối vớiavr-gcc main.S. Đó là bảng vector với mỗi__vector_nlà mộtretiyếu mà bạn có thể ghi đè, rồir1được xóa, stack được đặt ở RAMEND,.datađược sao chép từ flash,.bssđược xóa, và mộtcalltớimaincủa bạn. Vậy nên bạn viếtmainvà 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.vectorsriê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_toptrên Pico hoặc.word _estacktrê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
UBRR103, giữ văn bản trong.progmemvà đọc từng byte một bằnglpm. - AVR timer chạy Timer 1 ở chế độ CTC với xung nhịp chia 256 và
OCR1Abằng 31.249, tức là cứ mỗi 0,5 s, và bật tắt LED trongTIMER1_COMPA_vect. - Pico lấy
IO_BANK0vàPADS_BANK0(vàUART0cho mẫu UART) ra khỏiRESETS, điều khiển GPIO25 qua SIO ở0xD0000000, trễ dựa trênTIMERAWL, 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àBRR729, 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, 5báo LDI chỉ hoạt động trên các thanh ghi cao, r16 đến r31, và gợi ýmovgiá trị xuống sau đó nếu bạn cần nó ở thanh ghi thấp.lid r16, 5bá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, 300không vừa trong một byte. Hãy nạp từng nửa bằnglo8()vàhi8().sbi PORTB, 5dùng địa chỉ dữ liệu0x25trong khisbicần địa chỉ I/O. Hãy viết_SFR_IO_ADDR(PORTB).add r16, 5bị hiểu làadd r16, r5, vì ADD nhận hai thanh ghi. Không có ADDI: hãy trừ số âm bằngsubi r16, -5.out PORTB, r16thiếu__SFR_OFFSET 0là 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
.Svà.scạ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.
Related
- Trình soạn code và biên dịch
- Trình gỡ lỗi
- Bảng thuộc tính
- Assembly AVR trong trình duyệt: dự án mẫu blink từng dòng một, đếm chu kỳ và ngắt timer
- Biên dịch trong trình duyệt: cách tệp
.Sis preprocessed, assembled and linked