stm — STM32 MCU’lara özgü işlevsellik#

Bu modül, çevre birimi yazmaçlarına doğrudan erişim de dahil olmak üzere STM32 mikrodenetleyicilerine özgü işlevsellik sağlar.

Bellek erişimi#

Modül, ham bellek erişimi için kullanılan abone olunabilir (subscriptable) üç nesne sunar. Her biri bayt adresiyle indekslenen seyrek bir dizi gibi davranır: value = memN[addr] okur, memN[addr] = value yazar. Adres, erişim genişliğinden bağımsız olarak her zaman bir bayt adresidir.

Bu bellek nesneleri, MCU donanım çevre birimi yazmaçlarını ve SoC’nin adres uzayındaki herhangi bir başka konumu okumak ve yazmak için aşağıdaki çevre birimi yazmaç sabitleriyle birlikte kullanılabilir.

stm.mem8#

Abone olunabilir 8 bitlik bellek erişimcisi. mem8[addr], addr adresindeki bayttan 0-255 aralığında bir int okur; mem8[addr] = value, value öğesinin düşük 8 bitini yazar. addr herhangi bir bayt hizalı adres olabilir.

stm.mem16#

Abone olunabilir 16 bitlik (halfword) bellek erişimcisi. mem16[addr], 0-65535 aralığında bir int okur; mem16[addr] = value düşük 16 biti yazar. addr 2 bayta hizalanmış olmalıdır.

stm.mem32#

Abone olunabilir 32 bitlik (word) bellek erişimcisi. mem32[addr], 0-0xFFFFFFFF aralığında bir int okur; mem32[addr] = value düşük 32 biti yazar. addr 4 bayta hizalanmış olmalıdır.

Çevre birimi yazmaç sabitleri#

stm modülü, aygıt yazılımının (firmware) hangi STM32 ailesi için derlendiğine bağlı olarak CMSIS yazmaç adreslerinin ve ofsetlerinin tamamını sunar. Adlar, ST’nin CMSIS başlıklarını tam olarak yansıtır: sırasıyla M4, M7, H7 ailesi (H7 / H7 Plus / Pure Thermal) ve N6 OpenMV Cam’lerde STM32F427xx, STM32F765xx, STM32H743xx ve STM32N657xx. Adların tamamı aile başına birkaç yüz semboldür (M4’te 271, M7’de 306, H7’de 494, N6’da 594); bunları burada sıralamak, ST’nin başvuru kılavuzunu ve CMSIS başlıklarını yalnızca yinelemiş olurdu.

İki adlandırma kuralı kullanılır:

  • Bir çevre birimi örneğine göre adlandırılan sabitler (GPIOA, USART1, TIM2, …) mutlak temel adreslerdir.

  • Bir çevre birimi türüyle öneklenen sabitler (GPIO_BSRR, USART_CR1, TIM_CCR1, …) eşleşen temele göre yazmaç ofsetleridir.

Tek bir yazmacın tam adresini elde etmek için bir mutlak temeli ve bir yazmaç ofsetini toplayın. Örneğin stm.GPIOA + stm.GPIO_BSRR, GPIOA->BSRR öğesinin mutlak adresidir.

Örnek:

import stm

# set PA2 high
stm.mem32[stm.GPIOA + stm.GPIO_BSRR] = 1 << 2

# read PA3
value = (stm.mem32[stm.GPIOA + stm.GPIO_IDR] >> 3) & 1

Temsili sabitler#

Aşağıdaki seçim, adlandırma kuralının bir bakışta anlaşılır olması için seçilmiş, her büyük çevre birimi kategorisi başına bir girdiyi kapsar. Derleme hedefine ait diğer her CMSIS sembolü de modülde mevcuttur – tür denetleyici geri dönüşü için aşağıdaki __getattr__() öğesine bakın.

stm.GPIOA: int#

GPIOA çevre biriminin temel adresi. GPIOB … GPIOK (aralık MCU paketine bağlıdır) aynı deseni izler.

stm.USART1: int#

USART1 çevre biriminin temel adresi. Diğer USART / UART örnekleri, mevcut olduğu kadarıyla USART2, USART3, UART4 … altında sunulur.

stm.SPI1: int#

SPI1 çevre biriminin temel adresi. Ek SPI örnekleri, MCU’nun sayısına kadar SPI2, SPI3, … olarak görünür.

stm.I2C1: int#

I2C1 çevre biriminin temel adresi. I2C2 … I2C4 izler.

stm.TIM1: int#

TIM1 gelişmiş kontrol zamanlayıcısının temel adresi. Genel amaçlı ve temel zamanlayıcılar (mevcut olduğu kadarıyla TIM2 … TIM17) aynı adlandırmayı izler.

stm.ADC1: int#

ADC1 öğesinin temel adresi. ADC2 / ADC3, birden çok ADC bloğuna sahip MCU’larda görünür.

stm.DAC: int#

DAC çevre biriminin, bu birime sahip MCU’lardaki temel adresi.

stm.DMA1: int#

DMA1 öğesinin temel adresi. DMA2 çoğu STM32’de mevcuttur; H7 sınıfı parçalar ayrıca BDMA, MDMA ve (N6’da) HPDMA / GPDMA öğelerini de sunar.

stm.RCC: int#

Reset and Clock Control çevre biriminin temel adresi.

stm.EXTI: int#

External Interrupt / Event Controller temel adresi.

stm.FLASH: int#

Gömülü flash denetleyicisinin temel adresi (flash dizisinin kendisi değil, çevre birimi).

stm.SYSCFG: int#

System Configuration Controller temel adresi.

stm.PWR: int#

Power Control çevre biriminin temel adresi.

stm.GPIO_BSRR: int#

Herhangi bir GPIOx temeli içindeki GPIO bit ayarlama/sıfırlama yazmacının ofseti.

stm.GPIO_IDR: int#

GPIO giriş veri yazmacının ofseti.

stm.GPIO_ODR: int#

GPIO çıkış veri yazmacının ofseti.

stm.USART_CR1: int#

USART/UART kontrol yazmacı 1’in ofseti.

stm.TIM_CR1: int#

Zamanlayıcı kontrol yazmacı 1’in ofseti.

stm.TIM_CCR1: int#

Zamanlayıcı yakalama/karşılaştırma yazmacı 1’in ofseti. TIM_CCR2 … TIM_CCR4, birden çok kanala sahip zamanlayıcılarda izler.

stm.RCC_CR: int#

RCC saat kontrol yazmacının ofseti.

stm.RCC_CFGR: int#

RCC saat yapılandırma yazmacının ofseti.

stm.__getattr__(name: str) → int#

Dinamik öznitelik geri dönüşü: aygıt yazılımı (firmware) tarafından sunulan ve yukarıda tek tek listelenmeyen herhangi bir CMSIS sembolü (örneğin stm.FDCAN1, stm.OCTOSPI1, stm.GPIO_AFR, çeşitli bit alanı kaydırmaları ve maskeleri, …) yine de mutlak adresine veya ofsetine bir int olarak çözümlenir.

Çalışma zamanı modülü, içe aktarma sırasında bu sembolleri doğrudan globals sözlüğüne doldurur, bu nedenle __getattr__ aslında hiçbir zaman çağrılmaz. İmza, yalnızca statik tür denetleyicilerinin (Pyright, Pylance, mypy) bir “module has no attribute” tanılaması olmadan stm.<any CMSIS name> öğesini kabul etmesi için sunulur.