Neden uğraşmalı
Çünkü bazı şeyler aynı anda yalnızca tek bir komutta doğrudur. AVR veya Cortex-M öğreten bir ders, döngülerle sayılan bir gecikme, elle yazılmış bir vektör tablosu ve duraklatıldığında okuyabileceğin bir yazmaç kümesi ister. Bunların hepsi tarayıcıda çalışır, kodların üzerinde çalıştığı aynı simüle edilmiş çiplerde, kurulacak hiçbir şey olmadan.
İki yol:
- Kodun yanında assembly. Bir
.Sveya.ssekmesi ekle ve C'denextern "C"ile çağır. Arduino çekirdeği hâlâ oradadır, yaniSerial,millis()vepinMode()çalışmaya devam eder. - Arduino çekirdeği olmadan assembly. Kart özelliklerinin Firmware bölümünde Assembly (no
Arduino) altından bir başlangıç seç. Kartın dosyaları tek bir
main.Solur ve yalnızca kendi kodun ile başlangıç kodu bağlanır.
.S ve .s sekmeleri
Dosya şeridindeki + düğmesine bas ve dosyaya bir isim ver. İstem gerekeni açıklıyor: "Yeni dosya adı, örneğin config.h, helpers.cpp veya delay.S". .S veya .s ile biten her şey assembly'dir ve aynı karttaki .ino ve .cpp sekmeleriyle derlenip bağlanır, tıpkı Arduino IDE'nin bir kodun yanındaki .S dosyasını derlemesi gibi.
İki yazım aynı dosya değildir:
.S, büyük S, önce C önişlemcisinden geçer.#include <avr/io.h>,#define,#ifve//yorumların hepsi çalışır ve__ASSEMBLER__ayarlanır. Kullanılacak olan budur..s, küçük s, assembler'a olduğu gibi verilir. Include yok, makro yok.
Yeni bir .S veya .s sekmesi boş başlamaz. Kodun çağırabileceği çalışan bir fonksiyonla açılır, kartın kendi komut setinde: Uno, Nano, Mega, Leonardo ve ATtiny85'te AVR, Pico, STM32 kartları, Uno R4, micro:bit ve XIAO'da ARM Thumb. Üstündeki yorum çağrı kuralını listeler, böylece kurallar yazarken gözünün önündedir. Sil ya da üzerine inşa et.
Assembly sekmeleri kendi sözdizimi vurgulamasını alır ve satır numaralarının yanındaki kesme noktası cebini, tıpkı bir kod gibi alır.
C ile assembly arasında çağrı
Assembly ile yazılmış bir fonksiyon bir .global etiketidir ve C ona extern "C" üzerinden ulaşır, böylece ad bozulmaz. İki yönde de çalışır: assembly de bir C fonksiyonunu aynı şekilde çağırabilir.
// 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
Kurallar çipin kendisinindir, Mokxi'nin değil, yani onlara uyan bir fonksiyon gerçek bir kartta da çalışır.
AVR kartlarda (derleyici buna GCC AVR çağrı kuralı der):
- Argümanlar önce
r24'e, sonrar22'ye, sonrar20'ye gider ve ikili olarak aşağı iner. İki baytlık bir argüman bir çift alır, önce düşük bayt:int,r25:r24'te. - Sonuç bir bayt için
r24'te, iki bayt içinr25:r24'te ve dört bayt içinr25:r22'de döner. - Döndüğünde
r1sıfır olmalıdır. Derleyici bunu her yerde varsayar, yani onu kirleten birmul'dan sonraclr r1gerekir. r2'denr17'ye kadar olanlar iler28ver29çağıran tarafa aittir. Bunları kullanıyorsan push et veret'ten önce pop et. Gerisini istediğin gibi harcayabilirsin.
Arm kartlarda (standart Arm yordam çağrı standardı):
- Argümanlar
r0'danr3'e gider ve sonuçr0'da döner. r4iler11çağıran tarafa aittir: bunları push et ve pop et.bx lrile dön ve etiketi.thumb_funcolarak işaretle.
Bir .S dosyasında avr/io.h
Bir AVR kartında .S dosyasında #include <avr/io.h> yazmak register ve bit adlarını verir ve avr-libc'deki gibi davranır. Bu önemlidir, çünkü tek bir kural neredeyse herkesi yakalar:
Register adı bir veri adresidir, I/O adresi değil. PORTB 0x25'tir. I/O adresi 32 daha düşüktür, bu yüzden in, out, sbi, cbi, sbic ve sbis _SFR_IO_ADDR(PORTB) ister, o da 0x05'tir:
sbi _SFR_IO_ADDR(DDRB), DDB5 ; PB5 is an output
sts TCCR1B, r16 ; a high register, by its data address
Her yerde düz adları yazmayı tercih edersen, include'un üstüne tek bir satır koy ve avr-gcc'nin kendi başlangıç kodunun yaptığı gibi, onlar I/O adresine dönüşür:
#define __SFR_OFFSET 0
#include <avr/io.h>
sbi DDRB, DDB5
Başlığın geri kalanı da çalışır:
- Bit adları.
DDB5,PINB5,TXEN0,WGM12,OCIE1Ave diğerleri kendi bit numaralarıdır, yani(1 << TXEN0)veri sayfasındaki gibi okunur. - Vektör adları.
TIMER1_COMPA_vect,__vector_11'dir, bu yüzden.global TIMER1_COMPA_vectyazıp etiketi koymak, vektör tablosunun atladığı bir kesme işleyicisi oluşturur. Bunuretiile bitir. __zero_reg__şudurr1ve__tmp_reg__şudurr0, bu adlarla.- İlk 64'ün ötesindeki registerlar, örneğin
UCSR0BveTIMSK1, belleğe eşlenir: onlarıldsile oku vestsile yaz.
Satır içi assembly
Bir C fonksiyonunun içindeki birkaç komutun kendi sekmesine ihtiyacı yoktur. Kısıtlamalarla birlikte asm volatile, AVR ve ARM kartlarında çalışır:
uint8_t x = 5;
asm volatile ("lsl %0" : "+r" (x)); // x is 10
Simülatör çevrim sayar, bu yüzden elle yazılmış bir gecikme gerçekten veri sayfasının söylediği kadar uzundur. Tam saat hızında Timer 1 ile zamanlanmış bir nop, dec ve brne döngüsü, ATmega328P veri sayfasının komutlarına tam olarak uyan sayıyı verir: bir lds, bir ldi ve 50 tur döngü 202 çevrim ölçer, 201 değil ve 203 de değil. Çevrim saymayı burada öğretmeye değer kılan da budur.
Arduino çekirdeği olmadan assembly
Kartın özellik panelini aç ve Firmware bölümüne bak. Arduino Uno, Nano, 16 MHz'deki Pro Mini, Raspberry Pi Pico ve STM32F411 Black Pill üzerinde, içinde dört başlangıç kodu bulunan Assembly (no Arduino) adlı bir grup vardır:
| Başlangıç kodu | Ne yapar |
|---|---|
| Assembly ile blink | Çevrim sayan bir gecikme döngüsüyle kartın LED'ini her 250 ms'de bir değiştirir. |
| Assembly ile butondan LED'e | LED, pull-up'ıyla ground'a bağlı bir butonu izler. |
| Assembly ile UART hello | Saniyede iki kez seri monitöre bir satır yazdırır. |
| Assembly ile timer kesmesi | Bir timer kesmesi LED'i değiştirir ve ana döngü sadece boşta bekler. |
Birini seç ve kartın dosyaları tek bir main.S olur. Kartta kendi çalışmandan bir şey varsa önce sana sorulur. Ondan sonra program listesi başladığın başlangıç kodunu tutar ve altındaki not, Çalıştır'ın main.S dosyasını Arduino çekirdeği olmadan derlediğini söyler, böylece geri döndüğünde kart assembly'de kalır.
Derlemede Arduino core yok: setup() yok, loop() yok, millis() tick'i yok ve Serial yok. Bağlanan şey yalnızca şudur:
- Bir AVR kartında, senin dosyan artı başlangıç kodu, yani avr-libc'nin
gcrt1.o'sınınavr-gcc main.S'ye olduğu şey. İçinde her__vector_n'in geçersiz kılabileceğin zayıf birretiolduğu vektör tablosu var, sonrar1temizlenir, yığın RAMEND'e ayarlanır,.dataflash'tan kopyalanır,.bsstemizlenir ve seninmainine bircallyapılır. Yani senmaini ve istediğin işleyicileri, avr-libc'nin vektör adlarıyla yazarsın. Dosyan kendi.vectorsbölümünü tanımlıyorsa hiç başlangıç kodu almazsın ve tüm program senin olur. - Pico ve Black Pill'de, senin dosyandan başka bir şey yok. Senin dosyan vektör tablosudur: Pico'da
.word _stack_topveya Black Pill'de.word _estack, sonra.word Reset_Handler, sonra istediğin işleyiciler, her biri.thumb_func.
Registerları onlarla birlikte okumak istersen, başlangıç kodlarının neler kurduğu:
- AVR blink, PB5'i
PINB5'e 1 yazarak toggle eder; ATmega328P bunu "toggle" olarak yorumlar ve gecikmeyi bir dış ve bir iç döngüyle sağlar: "16 MHz'de 250 ms, 4.000.000 çevrimdir: 40 çarpı 100.000" ve iç döngü tur başına dört çevrimdir. - AVR button, pull-up açıkken PD2'yi okur, yani basınca 0 okunur ve bir satırı atlamak için
sbickullanır. - AVR UART, USART0'ı
UBRR103 ile 9600 baud'a ayarlar, metni.progmem'de tutar velpmile bir kerede bir bayt okur. - AVR timer, Timer 1'i
OCR1A31.249 ile saat üzerinden 256'ya bölerek CTC modunda çalıştırır, bu da 0,5 s'de bir demektir, ve LED'iTIMER1_COMPA_vectiçinde toggle eder. - Pico,
IO_BANK0vePADS_BANK0'ı (UART olanı içinUART0'ı da)RESETS'ten çıkarır, GPIO25'i SIO üzerinden0xD0000000adresinden sürer, gecikmeyiTIMERAWLile yapar, UART0 üzerinden GPIO0'da 115200 ile konuşur ve timer başlangıcı için TIMER'ın alarm 0 IRQ'sunu kullanır. - Black Pill,
RCC_AHB1ENR'de saatleri açar, düşükken yanan PC13'ü sürer, pull-up'ı açıkken PA0'ı okur, USART1 üzerinde PA9'daBRR729 ile 115200 hızında yazdırır ve SysTick'i 1 kHz'de çalıştırır.
Çalıştır'a bas ve kart onu çalıştırır. Seri monitör, osiloskop, mantık analizörü ve tuvaldeki parçalar her zamanki gibi çalışır, çünkü simüle edilen çipin görüntüyü hangi dilin oluşturduğundan haberi yoktur ya da umurunda değildir.
Birleştirilemediğinde
Assembler hataları doğru sekmeye ve doğru satıra düşer, altlarında da onun yerine ne yazılacağını düz Türkçe bir cümleyle söyler. Birkaçı:
ldi r3, 5, LDI'nin yalnızca üst kayıtlarda, r16'dan r31'e kadar çalıştığını söyler ve değere sonra aşağıda ihtiyacın varsa onu aşağı taşımak içinmovyapman gerektiğini söyler.lid r16, 5,"lid" bir AVR komutu değildirder ve bir etiketin iki nokta ile bittiğini, bir yönergenin nokta ile başladığını hatırlatır.- İki noktası olmadan yazılmış bir etiket, sana iki noktası eklenmiş haliyle geri söylenir.
- Hedefine ulaşamayan koşullu dal, bağlayıcı tarafından satırına yerleştirilir ve şöyle düzeltilir:
brne 1f,rjmp far,1:.
Dördü, avr-as'ın yaptığı ama LLVM'in assembler'ının yapmadığı denetimlerdir, bu yüzden Mokxi bunları herhangi bir araç çalışmadan önce kendisi yapar. Onlarsız bir hata, yanlış programa sessizce derlenirdi:
ldi r16, 300bir bayta sığmaz. Yarılarılo8()vehi8()ile yükle.sbi PORTB, 5,sbi'nin I/O adresi beklediği yerde veri adresi0x25'i kullanır._SFR_IO_ADDR(PORTB)yaz.add r16, 5,add r16, r5olarak okunur, çünkü ADD iki kayıt alır. ADDI yoktur: negatifinisubi r16, -5ile çıkar.__SFR_OFFSET 0olmadanout PORTB, r16bir hata değil uyarıdır, çünkü gerçekten derlenir: sadece adı geçenden farklı bir kayda yazar.
I/O adresi 63'ü geçen in ve out, 63'ü geçen sbiw ve adiw ve 7'yi geçen bir bit numarası aynı şekilde yakalanır, her biri yerine kullanılacak yönergeyle birlikte.
Thumb kartlarında yaygın olanlar şunlardır: Cortex-M0+'ta yalnızca r0'dan r7'ye ulaşabilen üst bir kaydedici, yalnızca 16 bitlik kümeye sahip Cortex-M0+ üzerinde 32 bitlik bir Thumb-2 biçimi, erişim menzili dışında kalan bir dallanma, eksik bir Reset_Handler ve eksik bir main.
Komutlar arasında adım adım ilerlemek
Hata ayıklayıcıdaki her şey assembly üzerinde çalışır. Kesme noktaları bir .S sekmesinin kenar boşluğuna konur ve o satırda durur, çünkü derleyicinin kaydettiği satır numaraları önişlenmiş kopyanın değil sekmenin kendi numaralarıdır.
Hata Ayıklama sekmesinde bir Disassembly bölümü vardır. Duraklatıldığında program sayacının çevresindeki komutları listeler: adres, baytlar, llvm-objdump yazımıyla komut ve her birinin başladığı kaynak satırı, ki bu seni o satıra götüren bir düğmedir. Çalışmak üzere olan komut işaretlenir. Step instruction tam olarak bir makine komutu çalıştırır, oysa Step over ve Step into hâlâ bir tam kaynak satırı atlamalı ilerler.
Kaydediciler çekirdeğin kendi değerleriyle okunur. AVR üzerindeki sreg ayrıca ITHSVNZC olarak bayraklarıyla yazılır, sıfır olanların yerine nokta konur, ARM üzerindeki xpsr ise N Z C V Q olarak yazılır, çünkü sekiz bit bir sayı değildir.
Sınırlar
- Arduino çekirdeği olmadan assembly, Uno, Nano, Pro Mini, Pico ve STM32F411 Black Pill üzerinde sunulur. Diğer tüm kartlar bir kodun yanında yine de
.Sve.ssekmeleri alır. - ESP32 ailesi dahil değildir. Clang'ın kendi Xtensa assembler'i elle yazılmış dosyalar için eksiktir, bu yüzden o kartlar yalnızca C ve C++ derler.
- Pico W'nin başlangıç projesi yoktur. LED'i bir GPIO pini yerine kablosuz çip üzerindedir. Düz bir Pico kullan.
- Bir proje düz yapıdadır. Dosya adlarında klasör bulunmaz, dolayısıyla bir include yolu tek klasör derinliğindedir.
Related
- Kod düzenleyici ve derleme
- Hata ayıklayıcı
- Özellikler paneli
- Tarayıcıda AVR assembly: blink başlangıç projesi satır satır, çevrim sayımı ve bir zamanlayıcı kesmesi
- Tarayıcıda derleme: nasıl
.Sis preprocessed, assembled and linked