#6 Freedom Board - Hello World na porta Serial

O primeiro tutorial será bem simples, para escrever na porta Serial utilizando a Freedom Board KL25Z. Antes de mais nada, certifique-se que você já tem instalado o CodeWarrior, caso não tenha, aqui possui um tutorial.
Apesar de ser um sistema embarcado, algumas vezes é importante mostrar dados na serial, para monitorar variáveis. Neste exemplo, você poderá escrever na serial e o programa irá imprimir o dado igual.
Primeiro crie um novo projeto: File > New > Bareboard. 
Obs: Utilizando a opção Bareboard significa que não será utilizando nenhum sistema operacional embarcado.
Uma nova janela irá aparecer, coloque o nome do projeto e  pressione Next. 
Uma nova janela irá aparecer, selecione Kinetis L Series > KL2X Family > KL25Z (48MHz) Family > MKL25Z128.
Modelo utilizado neste projeto pode ser visto neste link.
Após isso, adicione os seguintes componentes:

Caso, não tenha o componente RingBufferUInt8, ele pode ser baixado aqui.  

Configuração UART
Como o modelo KL25Z não tem um conector UART físico, vou utilizar o OpenSDA porta virtual USB CDC P&E. 

Adicione o componente Serial_LDD e configure com interrupção ativa usando os TPM2_CH0 e TPM2_CH1 pinos, como mostra a figura abaixo:

O RingBufferUInt8 é configurado da seguinte maneira: 

Após configurado é preciso gerar os códigos, pressione o botão generate Code, como mostra a figura abaixo: 

Para esta aplicação foram criados dois arquivos, Application.c e Application.h. 

No arquivo Application.h foi colocado o seguinte código: 

#include "PE_Types.h"
#include "PE_LDD.h"
 
typedef struct {
  LDD_TDeviceData *handle; // Dispositivo LDD
  volatile uint8_t isSent; // Quando o bloco for enviado, esta variável vai ser 1
  uint8_t rxChar; // Buffer de caracteres
  uint8_t (*rxPutFct)(uint8_t);
} UART_Desc;
 
void APP_Run(void);

APP_Run() é a função principal (chamado depois que todas as funções do sistemas forem chamadas na função main()).

No arquivo Application.c é colocado o seguinte código:

#include "Application.h"
#include "RxBuf.h"
#include "AS1.h"
 
static UART_Desc deviceData;
 
static void SendChar(unsigned char ch, UART_Desc *desc) {
  desc->isSent = FALSE;  // É definido quando o bloco 1 for enviado
  while(AS1_SendBlock(desc->handle, (LDD_TData*)&ch, 1)!=ERR_OK) {} // Manda o char
  while(!desc->isSent) {} // Aguarda até receber a confirmação que foi enviado.
}
 
static void SendString(const unsigned char *str,  UART_Desc *desc) {
  while(*str!='\0') {
    SendChar(*str++, desc); //Envia carácter por carácter
  }
}
 
static void Init(void) {
  //Inicializa a struct
  deviceData.handle = AS1_Init(&deviceData);
  deviceData.isSent = FALSE;
  deviceData.rxChar = '\0';
  deviceData.rxPutFct = RxBuf_Put;
  // Configura para iniciar o Buffer, começar receber
  RxBuf_Init(); // Inicializa o buffer
  // Configura como buffer de byte único
  while(AS1_ReceiveBlock(deviceData.handle, (LDD_TData *)&deviceData.rxChar, sizeof(deviceData.rxChar))!=ERR_OK) {} // Inicio para começar receber dados
}
 
void APP_Run(void) {
  Init();
  SendString((unsigned char*)"Hello World\r\n", &deviceData);
  for(;;) {
    if (RxBuf_NofElements()!=0) {
      SendString((unsigned char*)"echo: ", &deviceData);
      while (RxBuf_NofElements()!=0) {
        unsigned char ch;
 
        (void)RxBuf_Get(&ch);
        SendChar(ch, &deviceData);
      }
      SendString((unsigned char*)"\r\n", &deviceData);
    }
  }
}

Como está sendo utilizado interrupção é preciso preencher as funções (OnBlockReceived () e OnBlockSent ()) em Events.c:

Por último é só abrir o arquivo ProcessExpert.c e adicionar a biblioteca Application.h no topo do código e chamar a função APP_Run() logo após a função  PE_low_level_init();

Agora é compilar o programa e passar para sua Freedom Board. Para este exemplo foi utilizado o terminal Termite 2.9 que pode ser baixado aqui. 

Abaixo uma imagem de um teste realizado.

Fonte:

MCU on Eclipse