API UART

Aplikačné rozhranie bloku UART

Kompletný popis aplikačného rozhrania modulu UART môžete nájsť v literatúre. API bloku UART pozostáva z dvoch častí

• Low Level API - je určené pre riadenie bloku a základnú znakovú komunikáciu, funkcie API sú priamo volateľné z ASM M8C
• High Level API - je určené pre komplexnú prácu s reťazcom znakov reprezentujúcich povel s parametrami. Funkcie API sú určené pre volanie z jazyka C.

• UART_Start Enable user module and set parity.
• UART_Stop Disable user module.
• UART_EnableInt Enable both RX and TX interrupts.
• UART_DisableInt Disable both RX and TX interrupts.
• UART_SetTxIntMode Set the source of the Tx interrupt.
• UART_SendData Send byte without checking TX status.
• UART_bReadTxStatus Return status of TX Status register.
• UART_bReadRxData Return data in RX Data register without checking status of character is valid.
• UART_bReadRxStatus Check status of RX Status register.

Príklady použitia API UART

Pre rôzne testy zariadení a overenie funkcionality častí programov často potrebujeme jednoduchý program, ktorý po príjme znaku zo sériového rozhrania vykoná naprogramovanú aktivitu. Na takýto program sa môžeme pozerať aj ako na primitívny udalosťami riadený operačný systém. Vývojový diagram takéhoto programu ukazuje nasledujúci obrázok.

Vývojový diagram príkladu

Zdrojový kód príkladu je uvedený nižšie. Program po inicializácii čaká v slučke na príchod znaku, po príchode znaku ho načíta z buffra UART a podľa významu znaku vykonáva predvolenú aktivitu. Po ukončení aktivity sa vráti do slučky čakania na príchod znaku.

_main:	
        mov   A,UART_PARITY_NONE        ; inicializacia serioveho rozhrania  
        call  UART_Start         
	M8C_EnableGInt   

   WaitForData:                         ; cakanie na prichod znaku     
        call  UART_bReadRxStatus    
        and   A, UART_RX_COMPLETE    
        jz    WaitForData         
        call  UART_bReadRxData          ; nacitanie znaku      
    
 	cmp A,'x'                       ; skok na aktivitu 'x'
 	jz state_x
 	
 	cmp A,'y'			; skok na aktivitu 'y'
 	jz state_y
        jmp   WaitForData               ; navrat do slucky cakania na novy znak

state_x:   
        ; implementacia aktivity 'x'
        jmp   WaitForData

state_y:   
        ; implementacia aktivity 'y'
        jmp   WaitForData

Ďaľšie príklady k modulu UART nájdete na stránkach