Configuração do ST Visual Develop com o Cosmic STM8 Compiler: 11 etapas

2024 Autor: John Day | [email protected]. Última modificação: 2024-01-30 11:34

É assim que configurei o Ambiente de Desenvolvimento Integrado (IDE) para programar os microcontroladores STM8 da ST Microelectronics (ST) com o Windows 10. Não afirmo que este seja o caminho certo, mas funciona bem para mim. Neste Instructable, vai parecer muito trabalho, mas na verdade não é muito trabalho.

Suprimentos:

Café e um pouco de paciência

PC com Windows 10

Acesso à internet

Depurador / programador STLink

Etapa 1: Faça download do Cosmic Compiler e ST Microelectronics IDE (STVD)

Você precisará se registrar no site ST.com e no site Cosmic.com e baixar vários programas deles. Além disso, você precisa de uma licença para usar o compilador Cosmic. Esta licença é gratuita e válida por um ano, após o qual você simplesmente solicita uma nova licença. A licença é válida apenas para o pc em que o pedido é feito. Acho que é pago pela ST como um serviço para as empresas que utilizam o seu hardware, mas não tenho a certeza disso. (Eu sei que há outro compilador, SDCC, que é de código aberto, mas não tenho nenhuma experiência com ele.)

Vou começar com o download do compilador Cosmic porque a solicitação de licença é tratada por um funcionário da Cosmic, então pode levar algum tempo, se você enviar a solicitação em um final de semana provavelmente terá que esperar até a próxima semana. Nesse tempo, podemos baixar e instalar o IDE do ST. Então vá para:

https://www.cosmicsoftware.com/download.php

Role para baixo até ver o bloco amarelo "STM8 ferramentas gratuitas sem limites", clique no link "Cadastre-se e faça o download" e preencha as informações solicitadas. Depois disso, você pode baixar os compiladores. Existem dois compiladores e dois programas chamados Idea_STM8 e IdeaCXM no download, usaremos apenas o compilador STM8 dele.

Etapa 2: Instalando o (s) Compilador (es) Cósmico (s)

Execute o programa baixado como administrador do seu pc (você precisará da senha do administrador) para que ele possa instalar no diretório "Arquivos de programas (x86)". Basta seguir as instruções, aceitar a licença (não li, alguém?), Preencher seu nome e o nome de alguma empresa e clicar em avançar pelas telas seguintes. Depois de instalar todos os arquivos, ele quer se colocar no "caminho", fiz ele se cadastrar no HKEY_LOCAL_MACHINE para que funcione para todos os usuários do pc, não apenas o administrador.

Tenha o cuidado de ler as informações nas próximas telas e selecione o que deseja ou não, por ex. Não quero nenhum ícone na área de trabalho.

No final da instalação, o Readme.txt abre informando que você pode registrar o software de duas maneiras. Comigo, o método "Na Web" não funcionou, então escolhi a opção de e-mail. Preencha o usuário, empresa e e-mail com seu nome real e endereço de e-mail, não tenho uma empresa então acabei de inventar um nome legal. Em seguida, selecione "Gravar no arquivo", salve-o em um local onde você e o administrador tenham acesso a: C: / trabalhou para mim. Você pode enviar este arquivo como um anexo de um e-mail ou copiar o texto nele e colocá-lo no corpo do seu e-mail para a Cosmic. O endereço de e-mail é:

[email protected]

e certifique-se de colocar: "STM8FSE_2020 License Request" como o assunto. Conclua a instalação e deixe o seu pc reiniciar. E então é só esperar a licença chegar.

Etapa 3: Baixe e instale o ST Visual Develop

Enquanto isso, baixe e instale o software ST Visual Develop.

Acesse:

Vá até o final da página e clique em "Obter Software", aceite o Acordo de Licença (eu também não li …) e faça o Login se já tiver um login no ST ou cadastre-se se ainda não tiver um login. O site ST é bastante lento, então você pode ter que esperar por uma resposta dele por vários segundos, apenas espere pacientemente, vai funcionar.

Salve o arquivo zip baixado e abra-o, extraia o software para onde o Windows quiser. Inicie a instalação do ST Visual Develop executando "sttoolset_pack42.exe" como administrador. Clique nas primeiras telas, aceitando novamente o contrato de licença (e novamente sem lê-lo) e aceitando a maioria das opções sugeridas pela ST. Não, também não sei por que ST escolheu nomes de diretório como "st_toolset". Novamente, eu não queria ícones da área de trabalho e não li as notas de lançamento.

A primeira vez que instalei o ST Toolset, ele falhou ao travar no final da instalação. Quando terminei a instalação por meio do gerenciador de tarefas e tentei iniciar o ST Visual Develop, recebi uma tela informando que havia uma "anomalia". Depois que o programa começou …

Reinstalei e da segunda vez tudo correu bem. Outra reinicialização do Windows depois que o programa foi instalado corretamente e iniciado sem mensagens de erro.

Etapa 4: algumas opções no STVD

Precisamos definir várias opções no ST Visual Develop (STVD) Vá para - Ferramentas - Opções - Conjunto de ferramentas. Selecione o conjunto de ferramentas chamado "STM8 Cosmic" e defina seu "caminho raiz" para:

"C: / Arquivos de programas (x86) COSMIC / FSE_Compilers / CXSTM8"

O "Caminho da caixa" pode ficar vazio, o "Caminho de inclusão" já será "HSTM8" e o "caminho da biblioteca" será "Lib", estão todos corretos. Clique em Aplicar e em OK; os avisos que você receberá são sobre outros conjuntos de ferramentas para que possam ser ignorados.

Dê uma olhada nas outras guias das Opções, você pode querer alterar algumas das opções.

Na aba "Debug" selecionei Salvamento Automático de Arquivos porque me incomodava quando depois de cada edição perguntava se eu queria salvar antes de uma compilação. Claro que quer que minhas edições sejam salvas!

Na guia "Editar", desativei Long Line - Ativado por padrão e mudei o tamanho da guia de 2 para 4 e a fonte de "Courier New" para "Consolas" com um tamanho de ponto de 12.

Mas essas configurações são preferências pessoais, não são importantes e podem ser feitas mais tarde.

Etapa 5: Primeiro programa (piscando)

É hora de programar. Para fazer isso, precisamos de um espaço de trabalho chamado onde STVD salva informações sobre os projetos nele. Clique em Arquivo - Novo Espaço de Trabalho - Criar Espaço de Trabalho Vazio, geralmente dou ao espaço de trabalho o nome do tipo de microcontrolador que irei usar para o projeto em isto. Então, vou escolher "STM8S103" e vou colocá-lo em um diretório com o mesmo nome.

Agora você pode "clicar com o botão direito" no espaço de trabalho (STM8S103.stw) e criar um novo projeto nele. Em seguida, clique em Novo Projeto e dê o nome que deseja, crie também um diretório para colocar este projeto, o STVD não faz isso sozinho! Selecione o conjunto de ferramentas STM8 Cosmic e verifique se a raiz do conjunto de ferramentas é "C: / Arquivos de programas (x86) COSMIC / FSE_Compilers / CXSTM8" Clique em OK.

Em seguida selecione o microcontrolador que você irá usar, aqui vou escolher o STM8S103F3P, e clicar em Selecionar, OK

O projeto é criado e você pode abrir as pastas para ver quais arquivos foram criados pelo STVD. Agora CLOSE ST Visual Desenvolva e salve as alterações na área de trabalho e seu novo projeto. Iremos sobrescrever alguns arquivos e adicionar mais para preparar STVD para uso com o compilador Cosmic.

Etapa 6: sobrescrever e adicionar arquivos

Os arquivos necessários podem ser baixados de:

https://gitlab.com/WilkoL/setup-st-visual-develop-…

e salvá-los em uma nova pasta, chamo essa pasta de meu modelo

Na etapa anterior, criamos o projeto em sua própria pasta de projeto. Copie TODOS os arquivos e pastas que você baixou do Gitlab para esta pasta de projeto. Ele substituirá alguns arquivos que já estão lá.

A biblioteca padrão é usada (veja main.h) stm8s_conf.h já está editado para excluir USE_FULL_ASSERT)

stm8s_it.c já foi editado para incluir o tratamento de TIMER4 UPDATE IRQ (para systick e DELAY)

Etapa 7: reinicie o ST Visual Develop e conclua a configuração do projeto

Ao reiniciar o STVD, você verá uma tela muito vazia.

Para chegar ao seu projeto, selecione Arquivo - Espaço de trabalho recente - "o nome que você deu a ele" O STVD abrirá o último (e ainda o único) projeto. Você pode dar uma olhada nos arquivos, mas ainda não estamos prontos.

Primeiro adicione os seguintes arquivos:

stm8s_it.c para arquivos de origem

stm8s_it.h e main.h para incluir arquivos (veja as fotos)

Agora crie as pastas na pasta do projeto:

lib

lib / inc

lib / src

standard_lib

standard_lib / inc

standard_lib / scr (veja as fotos)

E depois disso, adicione todos os arquivos nas pastas de disco correspondentes às novas pastas no projeto. No final, ela deve se parecer com a última foto acima.

Etapa 8: As configurações do projeto

Estamos quase prontos …

ACESSE: Projeto -> Configurações -> Geral

- O conjunto de ferramentas deve ser STM8 Cosmic

- escolha "Caminho do conjunto de ferramentas específico do projeto"

- mude o caminho raiz para: C: / Arquivos de programas (x86) COSMIC / FSE_Compilers / CXSTM8

- incluir o caminho deve ser Hstm8, o caminho da biblioteca deve ser Lib

ACESSE: Projeto -> Configurações -> Compilador C -> Categoria Geral

- alterar as otimizações para personalizar

- alterar a exibição da mensagem do compilador de "Exibir apenas erros" para "Exibir erros e avisos"

- adicione STM8S103 HSE_VALUE = 16000000UL às Definições do Pré-processador

- (ou o STM8S103 ou outro tipo de microcontrolador e o valor HSE real que você usa)

ACESSE: Projeto -> Configurações -> Compilador C -> Otimizações de categoria

Para DEBUG selecione:

- Desativar para depuração (-não)

- Funções de divisão em seções separadas (+ divisão)

Para RELEASE selecione:

- Funções de divisão em seções separadas (+ divisão)

- Otimização de velocidade (+ rápido) (STM8 Cosmic> = 4.3.2)

- ou escolha Minimizar o tamanho do código (+ compacto)

(mas não + rápido e + compacto)

ACESSE: Projeto -> Configurações -> Compilador C -> Pré-processador de categoria

- as bibliotecas de inclusão adicionais devem ser:

standard_lib / inc; lib / inc;. ← adicione o "ponto"

- verifique isso para as configurações de depuração e liberação

ACESSE: Projeto -> Configurações -> Linker

- na Saída da categoria, marque "Gerar arquivo de mapa"

- se você precisar de suporte para variáveis de ponto flutuante, na categoria General tick Float (isso aumentará o tamanho do código, então faça isso apenas quando necessário)

- faça isso para as configurações de depuração e liberação

E finalmente:

clique em OK e tente REBUILD_ALL para verificar se há avisos / erros. Se tudo correr bem, o código é compilado sem erros e vinculado a um arquivo S19 que você pode encontrar na pasta Debug.

Etapa 9: Programação do microcontrolador

A última etapa é colocar o código no próprio microcontrolador. Existem várias maneiras de fazer isso, aqui vou mostrar como fazê-lo com o "Light Programmer" que faz parte do STVD.

Na barra de menu você o encontrará em Ferramentas - Programador

ACESSE: Ferramentas -> Programador -> Configurações:

- mude o Hardware para "ST-LINK"

ACESSE: Ferramentas -> Programador -> Áreas de Memória - MEMÓRIA DE DADOS: deve estar vazio

- MEMÓRIA DO PROGRAMA -> Adicionar: arquivo projectname / Debug / xxx.s19 ou

- MEMÓRIA DO PROGRAMA -> Adicionar: arquivo projectname / Release / xxx.s19 quando você compilou no modo de lançamento

Os bytes de opção são interessantes de verificar, mas geralmente estão corretos. Acho que é melhor alterar os bytes de opção com um programa separado: ST Visual Programmer, que não discutirei aqui.

AGORA CLIQUE OK, isso é importante, faça isso antes de programar o microcontrolador ou você continuará configurando todas as opções mencionadas acima.

ACESSE: Ferramentas -> Programador -> Programa

clique em "Iniciar" para fazer o upload do código para o MCU e admire seu led piscando:-)

Etapa 10: solução de problemas

Por razões que eu não conheço, pode acontecer que a depuração não funcione. A solução parece ser cancelar o registro do arquivo DAO350. LL e registrá-lo novamente.

Para fazer isso, inicie o cmd como administrador e execute os próximos comandos:

Regsvr32 / u "C: / Arquivos de programas (x86) Arquivos comuns / Microsoft Shared / DAO / DAO350. DLL"

Regsvr32 "C: / Arquivos de programas (x86) Arquivos comuns / Microsoft Shared / DAO / DAO350. DLL"

Também pode acontecer que, assim que você quiser iniciar o Light Programmer, o STVD travará, às vezes com um erro de "falta de memória". Se isso acontecer, copie o arquivo ProgrammerAddOn. DLL sobre o da pasta / STVD.

Usando o EEProm

Quando os dados precisam ir para a EEPROM, o upload por meio do Light Programmer NÃO funciona comigo. A solução que encontrei é abrir uma sessão DEBUG, que se encarregará de programar tanto a MEMÓRIA DO PROGRAMA quanto a MEMÓRIA DE DADOS (eeprom)

Tive alguns problemas menores com o acesso a arquivos e pastas do Cosmic e STVD, isso é porque eu uso o Windows como um usuário regular e não como administrador. Sei que não é a maneira certa de resolver isso, mas simplesmente dei a todos os usuários regulares do pc os direitos Modificar nas pastas:

C: / Arquivos de programas (x86) STMicroelectronics / st_toolset

C: / Arquivos de programas (x86) COSMIC / FSE_Compilers

Quando a depuração não começa com a mensagem para selecionar um destino, o programa não configurou o ST-Link como o instrumento de depuração. Selecione essa opção na barra de tarefas principal e defina a Seleção do Instrumento de Depuração para Swim ST-Link

Etapa 11: Módulo Stlink V2 e STM8S103F3p

Não há muito a dizer, só para mostrar o STlink-V2 e o STM8S103F3P que utilizo. Eu tenho o STLink genuíno feito pela ST Microelectronics e o clone barato que comprei no Ebay, ambos funcionam bem. Os módulos STM8S103 vêm todos do Ebay, Aliepress ou outro, não acho que os revendedores oficiais como Farnell ou Mouse terão o STM8S103 como módulos, mas você pode obtê-los como peças simples.