Düzenleyici

Assembly yazmak

Assembly, burada bir kartı programlamanın tam teşekküllü bir yoludur: kodunun yanında bir .S sekmesi ya da altında Arduino çekirdeği olmayan tam bir proje.

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 .S veya .s sekmesi ekle ve C'den extern "C" ile çağır. Arduino çekirdeği hâlâ oradadır, yani Serial, millis() ve pinMode() ç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.S olur 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, #if ve // 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, sonra r22'ye, sonra r20'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çin r25:r24'te ve dört bayt için r25:r22'de döner.
  • Döndüğünde r1 sıfır olmalıdır. Derleyici bunu her yerde varsayar, yani onu kirleten bir mul'dan sonra clr r1 gerekir.
  • r2'den r17'ye kadar olanlar ile r28 ve r29 çağıran tarafa aittir. Bunları kullanıyorsan push et ve ret'ten önce pop et. Gerisini istediğin gibi harcayabilirsin.

Arm kartlarda (standart Arm yordam çağrı standardı):

  • Argümanlar r0'dan r3'e gider ve sonuç r0'da döner.
  • r4 ile r11 çağıran tarafa aittir: bunları push et ve pop et.
  • bx lr ile dön ve etiketi .thumb_func olarak 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, OCIE1A ve 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_vect yazıp etiketi koymak, vektör tablosunun atladığı bir kesme işleyicisi oluşturur. Bunu reti ile bitir.
  • __zero_reg__ şudur r1 ve __tmp_reg__ şudur r0, bu adlarla.
  • İlk 64'ün ötesindeki registerlar, örneğin UCSR0B ve TIMSK1, belleğe eşlenir: onları lds ile oku ve sts ile 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ın avr-gcc main.S'ye olduğu şey. İçinde her __vector_n'in geçersiz kılabileceğin zayıf bir reti olduğu vektör tablosu var, sonra r1 temizlenir, yığın RAMEND'e ayarlanır, .data flash'tan kopyalanır, .bss temizlenir ve senin mainine bir call yapılır. Yani sen maini ve istediğin işleyicileri, avr-libc'nin vektör adlarıyla yazarsın. Dosyan kendi .vectors bö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_top veya 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 sbic kullanır.
  • AVR UART, USART0'ı UBRR 103 ile 9600 baud'a ayarlar, metni .progmem'de tutar ve lpm ile bir kerede bir bayt okur.
  • AVR timer, Timer 1'i OCR1A 31.249 ile saat üzerinden 256'ya bölerek CTC modunda çalıştırır, bu da 0,5 s'de bir demektir, ve LED'i TIMER1_COMPA_vect içinde toggle eder.
  • Pico, IO_BANK0 ve PADS_BANK0'ı (UART olanı için UART0'ı da) RESETS'ten çıkarır, GPIO25'i SIO üzerinden 0xD0000000 adresinden sürer, gecikmeyi TIMERAWL ile 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'da BRR 729 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çin mov yapman gerektiğini söyler.
  • lid r16, 5, "lid" bir AVR komutu değildir der 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, 300 bir bayta sığmaz. Yarıları lo8() ve hi8() ile yükle.
  • sbi PORTB, 5, sbi'nin I/O adresi beklediği yerde veri adresi 0x25'i kullanır. _SFR_IO_ADDR(PORTB) yaz.
  • add r16, 5, add r16, r5 olarak okunur, çünkü ADD iki kayıt alır. ADDI yoktur: negatifini subi r16, -5 ile çıkar.
  • __SFR_OFFSET 0 olmadan out PORTB, r16 bir 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 .S ve .s sekmeleri 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.