Arquivo de Configuração (config.h)

MicrocontroladorPICPIC16F887MPLABX-XC8 2021-01-22

Configurações do uC

Existem configurações de periféricos que modificam o comportamento do microcontrolador e por isso são realizadas apenas no momento da gravação, não podendo ser realizadas durante a execução do código, como por exemplo a habilitação do Watchdog timer, a proteção da memória de código, a disponibilização de um determinado pino para Master clear ou I/O, etc.

A plataforma MPLAB-X proporciona uma aba para realizar tais configuraçãos de forma fácil, inclusive gerando o respectivo código a ser inserido no programa. Este código é aqui gerado e inserido em um arquivo de cabeçalho (.h) com o nome de config, modularizando e concentrando os comandos de configuração do microcontrolador.

Objetivo

Criar um arquivo para a configuração do microcontrolador utilizando a plataforma MPLAB-X.

Criar um arquivo fonte

O passo inicial é criar no diretório Header Files (Arquivos de cabeçalho) um arquivo com a extensão .h, conforme ilustrado na Figura 1.

  • Clique com o botão direito do mouse sobre o diretório Header Files do projeto;
  • Arraste o cursor até a opção New e em seguida xc8_header.h.
Figura 1: Seleção de novo arquivo de cabeçalho (.h)
Selecao novo arquivo cabeçalho

A depender da versão da IDE podem aparecer outras opções, mas o importante é selecionar um arquivo com a extensão .h e dar o nome de config, uma referência direta ao seu conteúdo.

  • No campo File Name insira o nome config.
Figura 2: Inserção de nome do arquivo
Nome do arquivo .h

Obs.: Não é necessário inserir a extensão no nome do arquivo, pois há um campo específico para isso logo abaixo do local de inserção dele.

Então é gerado automaticamente um arquivo config.h com os termos de uso do software definidos pela Microchip.

Figura 3: Arquivo de cabeçalho com termos de uso
Termos de uso

Em uma tradução direta no Google Tradutor temos:

Microchip Technology Inc. e suas subsidiárias. Você pode usar este software 
e quaisquer derivados exclusivamente com produtos Microchip.

ESTE SOFTWARE É FORNECIDO PELA MICROCHIP "NO ESTADO EM QUE SE ENCONTRA". 
NENHUMA GARANTIA, EXPRESSA OU IMPLÍCITA, SE APLICAR A ESTE SOFTWARE, 
INCLUINDO QUAISQUER GARANTIAS IMPLÍCITAS DE NÃO-VIOLAÇÃO, comercialização e
adequação a uma finalidade específica, ou a sua interação com os produtos 
microchip combinação com quaisquer outros produtos, ou de qualquer INSCRIÇÃO.

EM NENHUMA HIPÓTESE A MICROCHIP SERÁ RESPONSÁVEL POR QUALQUER PERDA INDIRETA,
ESPECIAL, PUNITIVA, INCIDENTAL OU CONSEQUENCIAL, DANO, CUSTO OU DESPESA DE 
QUALQUER TIPO RELACIONADO AO SOFTWARE, POR QUEM FOR CAUSADA, MESMO SE A 
MICROCHIP TIVER SIDO AVISADA PREVIAMENTE. NA EXTENSÃO MÁXIMA PERMITIDA POR LEI, 
A RESPONSABILIDADE TOTAL DA MICROCHIP EM TODAS AS REIVINDICAÇÕES DE QUALQUER 
FORMA RELACIONADAS A ESTE SOFTWARE NÃO EXCEDERÁ O VALOR DAS TAXAS, SE HOUVER, 
QUE VOCÊ PAGOU DIRETAMENTE À MICROCHIP POR ESTE SOFTWARE.

A MICROCHIP FORNECE ESTE SOFTWARE CONDICIONALMENTE APÓS SUA ACEITAÇÃO DESTES TERMOS.

Todo este texto pode ser excluído do arquivo.

  • Clique em qualquer lugar no texto;
  • Pressione Ctrl+A para selecionar todo o texto;
  • Pressione Delete para excluir o texto.
  • Insira o seguinte código:
#ifndef CONFIG_H
#define CONFIG_H

#endif

O resultado é apresentado na ilustração da Figura 4.

Figura 4: Arquivo config.h
Arquivo Config

Para acessar os bits de configuração:

  • Clique em Production;
  • Selecione Set Configuration Bits;
Figura 5: Acessar os bits de configuração
Set Config Bits

Uma aba é aberta, geralmente, na parte inferior da tela.

Figura 6: Registradores de configuração
Generate Code

Faça os ajustes em Options conforme a indicação do quadro 1 na Figura 6.

Em seguida clique no botão Generate Source Code to …. Uma nova aba com o código gerado é exibida.

Repare que na indicação 3 da Figura 7 há um **#include ** logo abaixo das configurações.

O quadro 7 indica o trecho que deve ser Selecionado e copiado para o config.h.

Figura 7: Código de configuração
codeConfig

O resultado após a cópia é ilustrado na Figura 8.

Figura 8: Configuração no config.h
config

Por fim, para uma necessidade futura na utilização da função __delay_ms(500), insira o define:

#define _XTAL_FREQ 4000000

conforme ilustração da Figura 9.

Figura 9: Definição da frequência do oscilador
_XTAL_FREQ

Por fim, inclua o arquivo de configuração no arquivo principal conforme indicação 6 da Figura 10.

Figura 10: Inclusão do config no main
Include config
  • Pressione Shift+F11 ou clique no botão com a indicação 7 da Figura 11, para realizar a limpeza e a compilação do projeto;
Figura 11: Compilação
Compilação

Após o processo de compilação, geralmente na parte inferior, aparece uma a saída da compilação e uma mensagem de sucesso, BUILD SUCCESSFULL, se tudo foi feito corretamente.

Se alguma mensagem de erro ocorrer, veja qual é a primeira indicação de erro, procure entender a mensagem, clique no link de erro pois a IDE deve apontar o local. Atente-se para os detalhes!

« Anexo D - Controle de Versão « Arquivo de Configuração (config.h) » C1 - Pisca LED »

Voltar