Preskočiť na hlavný obsah

Modul MCAL USART

Podporované rodiny STM32: G4 · H5 · U5
Nepodporované: H7, L4

Tento modul poskytuje abstrakčnú vrstvu na konfiguráciu a správu periférií USART na MCU STM32.
Podporuje inicializáciu, konfiguráciu komunikačných parametrov, prenosy DMA, spracovanie prerušení a nastavenie GPIO.

Vlastnosti​

  • Základná inicializácia a deinicializácia
  • Konfigurácia baudrate, šírky dát, stop bitov, parity, režimu prenosu a riadenia toku
  • Funkcia Driver Enable a jej polarita
  • Podpora oversamplingu a half-duplexu
  • Konfigurácia RX timeoutu
  • Správa úrovní pinov
  • Priamy prístup k registrom pre TX/RX
  • Blokujúce a neblokujúce prenosy
  • Prenosy dát cez DMA (TX/RX)
  • Plná podpora spracovania prerušení s callbackmi
  • Inicializácia pinov GPIO pre signály USART

Verejné API​

Správa modulu​

  • usart_ModuleVersion_t Usart_Get_ModuleVersion(void);
  • usart_RequestState_t Usart_Init(usart_BusConfig_t * const usartConfig);
  • usart_RequestState_t Usart_Deinit(usart_PeriphId_t usartId);
  • void Usart_Task(void);
  • usart_RequestState_t Usart_Get_DefaultConfig(usart_BusConfig_t *usartConfig);

Riadenie periférie​

  • usart_RequestState_t Usart_Set_PeriphActive(usart_PeriphId_t usartId);
  • usart_RequestState_t Usart_Set_PeriphInactive(usart_PeriphId_t usartId);
  • usart_RequestState_t Usart_Get_PeriphState(usart_PeriphId_t usartId, usart_FlagState_t * const reqState);

Komunikačné nastavenia​

  • usart_RequestState_t Usart_Set_Baudrate(usart_PeriphId_t usartId, usart_Baudrate_t baudrate);
  • usart_RequestState_t Usart_Get_Baudrate(usart_PeriphId_t usartId, usart_Baudrate_t * const baudrate);
  • usart_RequestState_t Usart_Set_DataWidth(usart_PeriphId_t usartId, usart_DataWidth_t dataWidth);
  • usart_RequestState_t Usart_Get_DataWidth(usart_PeriphId_t usartId, usart_DataWidth_t * const dataWidth);
  • usart_RequestState_t Usart_Set_StopBits(usart_PeriphId_t usartId, usart_StopBits_t stopBits);
  • usart_RequestState_t Usart_Get_StopBits(usart_PeriphId_t usartId, usart_StopBits_t * const stopBits);
  • usart_RequestState_t Usart_Set_Parity(usart_PeriphId_t usartId, usart_Parity_t parity);
  • usart_RequestState_t Usart_Get_Parity(usart_PeriphId_t usartId, usart_Parity_t * const parity);
  • usart_RequestState_t Usart_Set_TransferMode(usart_PeriphId_t usartId, usart_TransferMode_t transferMode);
  • usart_RequestState_t Usart_Get_TransferMode(usart_PeriphId_t usartId, usart_TransferMode_t * const transferMode);
  • usart_RequestState_t Usart_Set_FlowControl(usart_PeriphId_t usartId, usart_FlowControl_t flowControl);
  • usart_RequestState_t Usart_Get_FlowControl(usart_PeriphId_t usartId, usart_FlowControl_t * const flowControl);

Driver Enable a časovanie​

  • usart_RequestState_t Usart_Set_DriverEnableState(usart_PeriphId_t usartId, usart_DeFeatureState_t deState);
  • usart_RequestState_t Usart_Get_DriverEnableState(usart_PeriphId_t usartId, usart_DeFeatureState_t * const deState);
  • usart_RequestState_t Usart_Set_DriverEnablePolarity(usart_PeriphId_t usartId, usart_DePolarity_t dePolarity);
  • usart_RequestState_t Usart_Get_DriverEnablePolarity(usart_PeriphId_t usartId, usart_DePolarity_t * const dePolarity);
  • usart_RequestState_t Usart_Set_AssertDeassertTimes(usart_PeriphId_t usartId, usart_AssertTime_us_t assertTime, usart_DeassertTime_us_t deassertTime);
  • usart_RequestState_t Usart_Get_AssertDeassertTimes(usart_PeriphId_t usartId, usart_AssertTime_us_t * const assertTime, usart_DeassertTime_us_t * const deassertTime);

Pokročilé komunikačné nastavenia​

  • usart_RequestState_t Usart_Set_Oversampling(usart_PeriphId_t usartId, usart_Oversampling_t oversamplingMode);
  • usart_RequestState_t Usart_Get_Oversampling(usart_PeriphId_t usartId, usart_Oversampling_t * const oversamplingMode);
  • usart_RequestState_t Usart_Set_HalfDuplexState(usart_PeriphId_t usartId, usart_HalfDuplex_t halfDuplexState);
  • usart_RequestState_t Usart_Get_HalfDuplexState(usart_PeriphId_t usartId, usart_HalfDuplex_t * const halfDuplexState);
  • usart_RequestState_t Usart_Set_RxTimeoutActive(usart_PeriphId_t usartId, usart_RxTimeout_t timeoutBitsCnt);
  • usart_RequestState_t Usart_Set_RxTimeoutInactive(usart_PeriphId_t usartId);
  • usart_RequestState_t Usart_Get_RxTimeoutState(usart_PeriphId_t usartId, usart_FlagState_t * const reqState);

Správa pinov​

  • usart_RequestState_t Usart_Set_PinLevels(usart_PeriphId_t usartId, usart_RxPinLevel_t rxPinLevels, usart_TxPinLevel_t txPinLevels);
  • usart_RequestState_t Usart_Get_PinLevels(usart_PeriphId_t usartId, usart_RxPinLevel_t * const rxPinLevels, usart_TxPinLevel_t * const txPinLevels);
  • usart_RequestState_t Usart_Get_TxRegisterAddr(usart_PeriphId_t usartId, usart_RxRegAddr_t * const regAddr);
  • usart_RequestState_t Usart_Get_RxRegisterAddr(usart_PeriphId_t usartId, usart_RxRegAddr_t * const regAddr);

Prenos dát​

  • void Usart_SendData(usart_PeriphId_t usartId, usart_TxData_t txData);
  • usart_RxData_t Usart_ReadData(usart_PeriphId_t usartId);

Podpora DMA​

  • usart_RequestState_t Usart_Init_Dma(usart_PeriphId_t usartId, usart_DmaConfig_t * const dmaConfig);
  • TX:
    • usart_RequestState_t Usart_Set_DmaTxStart(usart_PeriphId_t usartId, usart_TxDataCnt_t bytesCnt, usart_TxData_t * const dataBuff);
    • usart_RequestState_t Usart_Set_DmaTxStop(usart_PeriphId_t usartId);
    • usart_RequestState_t Usart_Get_DmaTxRemainingCnt(usart_PeriphId_t usartId, usart_TxDataCnt_t * const bytesCnt);
  • RX:
    • usart_RequestState_t Usart_Set_DmaRxStart(usart_PeriphId_t usartId, usart_RxDataCnt_t bytesCnt, usart_RxData_t * const dataBuff);
    • usart_RequestState_t Usart_Set_DmaRxStop(usart_PeriphId_t usartId);
    • usart_RequestState_t Usart_Get_DmaRxRemainingCnt(usart_PeriphId_t usartId, usart_RxDataCnt_t * const bytesCnt);
  • Požiadavky DMA:
    • usart_RequestState_t Usart_Set_DmaTxRequestActive(usart_PeriphId_t usartId);
    • usart_RequestState_t Usart_Set_DmaTxRequestInactive(usart_PeriphId_t usartId);
    • usart_RequestState_t Usart_Get_DmaTxReqState(usart_PeriphId_t usartId, usart_FlagState_t * const reqState);
    • usart_RequestState_t Usart_Set_DmaRxRequestActive(usart_PeriphId_t usartId);
    • usart_RequestState_t Usart_Set_DmaRxRequestInactive(usart_PeriphId_t usartId);
    • usart_RequestState_t Usart_Get_DmaRxReqState(usart_PeriphId_t usartId, usart_FlagState_t * const reqState);

Prerušenia a callbacky​

  • Všeobecné:
    • usart_RequestState_t Usart_Set_InterruptsActive(usart_PeriphId_t usartBus);
    • usart_RequestState_t Usart_Set_InterruptsInactive(usart_PeriphId_t usartBus);
    • usart_RequestState_t Usart_Set_IrqPriority(usart_PeriphId_t usartId, usart_IrqPrio_t irqPrio);
    • usart_RequestState_t Usart_Get_IrqPriority(usart_PeriphId_t usartId, usart_IrqPrio_t * const irqPrio);
  • RX Not Empty:
    • usart_RequestState_t Usart_Set_RxNotEmptyIrqActive(usart_PeriphId_t usartId);
    • usart_RequestState_t Usart_Set_RxNotEmptyIrqInactive(usart_PeriphId_t usartId);
    • usart_RequestState_t Usart_Get_RxNotEmptyIrqState(usart_PeriphId_t usartId, usart_FlagState_t * const reqState);
    • usart_RequestState_t Usart_Set_RxNotEmptyIsrCallback(usart_PeriphId_t usartId, usart_RxNeIrqCallback_t * const callback);
  • TX Empty:
    • usart_RequestState_t Usart_Set_TxEmptyIrqActive(usart_PeriphId_t usartId);
    • usart_RequestState_t Usart_Set_TxEmptyIrqInactive(usart_PeriphId_t usartId);
    • usart_RequestState_t Usart_Get_TxEmptyIrqState(usart_PeriphId_t usartId, usart_FlagState_t * const reqState);
    • usart_RequestState_t Usart_Set_TxEmptyIsrCallback(usart_PeriphId_t usartId, usart_TxeIrqCallback_t * const callback);
  • TX Complete:
    • usart_RequestState_t Usart_Set_TxCompleteIrqActive(usart_PeriphId_t usartId);
    • usart_RequestState_t Usart_Set_TxCompleteIrqInactive(usart_PeriphId_t usartId);
    • usart_RequestState_t Usart_Get_TxCompleteIrqState(usart_PeriphId_t usartId, usart_FlagState_t * const reqState);
    • usart_RequestState_t Usart_Set_TxCompleteIsrCallback(usart_PeriphId_t usartId, usart_TcIrqCallback_t * const callback);
  • Idle:
    • usart_RequestState_t Usart_Set_IdleIrqActive(usart_PeriphId_t usartId);
    • usart_RequestState_t Usart_Set_IdleIrqInactive(usart_PeriphId_t usartId);
    • usart_RequestState_t Usart_Get_IdleIrqState(usart_PeriphId_t usartId, usart_FlagState_t * const reqState);
    • usart_RequestState_t Usart_Set_IdleIsrCallback(usart_PeriphId_t usartId, usart_IdleIrqCallback_t * const callback);
  • RX Timeout:
    • usart_RequestState_t Usart_Set_RxTimeoutIrqActive(usart_PeriphId_t usartId);
    • usart_RequestState_t Usart_Set_RxTimeoutIrqInactive(usart_PeriphId_t usartId);
    • usart_RequestState_t Usart_Get_RxTimeoutIrqState(usart_PeriphId_t usartId, usart_FlagState_t * const reqState);
    • usart_RequestState_t Usart_Set_RxTimeoutIsrCallback(usart_PeriphId_t usartId, usart_RxTimeoutIrqCallback_t * const callback);
  • Chyba:
    • usart_RequestState_t Usart_Set_ErrorIrqActive(usart_PeriphId_t usartId);
    • usart_RequestState_t Usart_Set_ErrorIrqInactive(usart_PeriphId_t usartId);
    • usart_RequestState_t Usart_Get_ErrorIrqState(usart_PeriphId_t usartId, usart_FlagState_t * const reqState);
    • usart_RequestState_t Usart_Set_ErrorIsrCallback(usart_PeriphId_t usartId, usart_ErrIrqCallback_t * const callback);

Konfigurácia GPIO​

  • usart_RequestState_t Usart_InitRxGpio(usart_RxPin_t pinId);
  • usart_RequestState_t Usart_InitTxGpio(usart_TxPin_t pinId);
  • usart_RequestState_t Usart_InitDeGpio(usart_DePin_t pinId);

🛠 Integrácia s CMake​

  1. Zahrňte Usart_Lib do svojej knižnice CMake.
  2. Zahrňte Usart_Port.h do svojho projektu.
  3. Prilinkujte implementačné súbory modulu Usart.
  4. Nakonfigurujte modul podľa potrieb vášho hardvéru.

Licencia​

Tento projekt je licencovaný pod licenciou Creative Commons Attribution–NonCommercial 4.0 International (CC BY-NC 4.0).

Toto dielo môžete slobodne používať, upravovať a zdieľať na nekomerčné účely, pokiaľ uvediete primeraný zdroj.

Úplné znenie podmienok nájdete v LICENSE.md alebo na creativecommons.org/licenses/by-nc/4.0.

Autori​

Príspevky sú vítané! Otvorte prosím pull request.