Translation of Getting Started Lesson 1 to portuguese (#243)

* Translation of Getting Started README.md to portuguese

* Translation of Introduction to IoT README.md to portuguese

* Translation of Introduction to IoT wio-terminal.md to portuguese

* Update of some terms of the README.pt.md

* Translation of Introduction to IoT assignmentl.md to portuguese

* Translation of Introduction to IoT virtual-device.md to portuguese

* Translation of Introduction to IoT pi.md to portuguese

* Updating the translation of the device name

Co-authored-by: Jim Bennett <jim.bennett@microsoft.com>
pull/270/head
Leonardo Nascimento 3 years ago committed by GitHub
parent 475d6f4d2d
commit 06598b2021
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

@ -0,0 +1,222 @@
# Introdução à IoT
![Um sketchnote de visão geral desta lição](../../../../sketchnotes/lesson-1.jpg)
> Sketchnote por [Nitya Narasimhan](https://github.com/nitya). Clique na imagem para uma versão maior.
## Questionário pré-aula
[Questionário pré-aula](https://brave-island-0b7c7f50f.azurestaticapps.net/quiz/1)
## Introdução
Esta lição cobre alguns dos tópicos introdutórios sobre a Internet das Coisas e mostra como configurar seu hardware.
Nesta lição, vamos cobrir:
* [O que é a 'Internet das Coisas'?](#o-que-é-a-internet-das-coisas)
* [Dispositivos IoT](#dispositivos-iot)
* [Configure seu dispositivo](#configure-seu-dispositivo)
* [Aplicações de IoT](#aplicações-de-iot)
* [Exemplos de dispositivos IoT que você pode ter ao seu redor](#exemplos-de-dispositivos-iot-que-você-pode-ter-ao-seu-redor)
## O que é a 'Internet das Coisas'?
O termo 'Internet das Coisas' foi cunhado por [Kevin Ashton](https://wikipedia.org/wiki/Kevin_Ashton) em 1999, para se referir à conexão da Internet ao mundo físico por meio de sensores. Desde então, o termo tem sido usado para descrever qualquer dispositivo que interage com o mundo físico ao seu redor, seja reunindo dados de sensores ou fornecendo interações com o mundo real por meio de atuadores (dispositivos que fazem algo como ligar um interruptor ou acender um LED ), geralmente conectado a outros dispositivos ou à Internet.
> **Sensores** coletam informações do mundo, como medição de velocidade, temperatura ou localização.
>
> **Atuadores** convertem sinais elétricos em interações com o mundo real, como acionar um interruptor, acender luzes, fazer sons ou enviar sinais de controle para outro hardware, por exemplo, para ligar uma tomada.
A IoT como uma área de tecnologia é mais do que apenas dispositivos - inclui serviços baseados em nuvem que podem processar os dados do sensor ou enviar solicitações para atuadores conectados a dispositivos IoT. Também inclui dispositivos que não têm ou não precisam de conectividade com a Internet, geralmente chamados de dispositivos de borda. São dispositivos que podem processar e responder a dados de sensores eles próprios, geralmente usando modelos de IA treinados na nuvem.
A IoT é um campo de tecnologia em rápido crescimento. Estima-se que até o final de 2020, 30 bilhões de dispositivos IoT foram implantados e conectados à Internet. Olhando para o futuro, estima-se que até 2025, os dispositivos IoT estarão reunindo quase 80 zetabytes de dados ou 80 trilhões de gigabytes. São muitos dados!
![Um gráfico mostrando dispositivos IoT ativos ao longo do tempo, com uma tendência de aumento de menos de 5 bilhões em 2015 para mais de 30 bilhões em 2025](../../../../images/connected-iot-devices.svg)
✅ Faça uma pequena pesquisa: quanto dos dados gerados pelos dispositivos IoT é realmente usado e quanto é desperdiçado? Por que tantos dados são ignorados?
Esses dados são a chave para o sucesso da IoT. Para ser um desenvolvedor de IoT bem-sucedido, você precisa entender os dados que precisa coletar, como coletá-los, como tomar decisões com base neles e como usar essas decisões para interagir com o mundo físico, se necessário.
## Dispositivos IoT
O **T** em IoT significa **Coisas** - dispositivos que interagem com o mundo físico ao seu redor, seja coletando dados de sensores ou fornecendo interações com o mundo real por meio de atuadores.
Dispositivos para produção ou uso comercial, como rastreadores de condicionamento físico para consumidores ou controladores de máquinas industriais, geralmente são feitos sob medida. Eles usam placas de circuito personalizadas, talvez até processadores personalizados, projetados para atender às necessidades de uma tarefa específica, seja ela pequena o suficiente para caber em um pulso ou robusta o suficiente para funcionar em um ambiente de fábrica de alta temperatura, alto estresse ou alta vibração.
Como um desenvolvedor que está aprendendo sobre IoT ou criando um protótipo de dispositivo, você precisará começar com um kit de desenvolvedor. Esses são dispositivos IoT de uso geral projetados para serem usados por desenvolvedores, geralmente com recursos que você não teria em um dispositivo de produção, como um conjunto de pinos externos para conectar sensores ou atuadores, hardware para suportar depuração ou recursos adicionais que adicionaria custos desnecessários ao fazer uma grande rodada de fabricação.
Esses kits de desenvolvedor geralmente se enquadram em duas categorias - microcontroladores e computadores de placa única. Eles serão apresentados aqui e entraremos em mais detalhes na próxima lição.
> 💁 Seu telefone também pode ser considerado um dispositivo IoT de uso geral, com sensores e atuadores integrados, com diferentes aplicativos que usam os sensores e atuadores de maneiras diferentes com diferentes serviços em nuvem. Você pode até encontrar alguns tutoriais de IoT que usam um aplicativo de telefone como um dispositivo de IoT.
### Microcontroladores
Um microcontrolador (também conhecido como MCU, abreviação de microcontroller unit) é um pequeno computador que consiste em:
🧠 Uma ou mais unidades de processamento central (CPUs) - o 'cérebro' do microcontrolador que executa seu programa
💾 Memória (RAM e memória de programa) - onde seu programa, dados e variáveis são armazenados
🔌 Conexões de entrada/saída (I/O) programáveis - para falar com periféricos externos (dispositivos conectados), como sensores e atuadores
Microcontroladores são tipicamente dispositivos de computação de baixo custo, com preços médios para aqueles usados em hardware customizado caindo para cerca de US$0,50, e alguns dispositivos tão baratos quanto US$0,03. Os kits de desenvolvedor podem começar em US$4, com custos aumentando à medida que você adiciona mais recursos. O [Wio Terminal](https://www.seeedstudio.com/Wio-Terminal-p-4509.html), um kit de desenvolvedor de microcontrolador da [Seeed studios](https://www.seeedstudio.com) que tem sensores, atuadores, Wi-Fi e uma tela custam cerca de US$30.
![Um Wio Terminal](../../../../images/wio-terminal.png)
> 💁 Ao pesquisar por microcontroladores na Internet, tenha cuidado ao pesquisar pelo termo **MCU**, pois isso trará muitos resultados para o Universo Cinematográfico Marvel (Marvel Cinematic Universe), não microcontroladores.
Os microcontroladores são projetados para serem programados para realizar um número limitado de tarefas muito específicas, em vez de serem computadores de uso geral, como PCs ou Macs. Exceto em cenários muito específicos, você não pode conectar um monitor, teclado e mouse e usá-los para tarefas de propósito geral.
Os kits de desenvolvedor de microcontroladores geralmente vêm com sensores e atuadores adicionais a bordo. A maioria das placas terá um ou mais LEDs que você pode programar, junto com outros dispositivos, como plugues padrão para adicionar mais sensores ou atuadores usando ecossistemas de vários fabricantes ou sensores embutidos (geralmente os mais populares, como sensores de temperatura). Alguns microcontroladores possuem conectividade sem fio integrada, como Bluetooth ou WiFi, ou possuem microcontroladores adicionais na placa para adicionar essa conectividade.
> 💁 Microcontroladores geralmente são programados em C/C++.
### Computadores de placa única
Um computador de placa única é um pequeno dispositivo de computação que possui todos os elementos de um computador completo contidos em uma única placa pequena. Esses são dispositivos que têm especificações próximas a um desktop ou laptop PC ou Mac, executam um sistema operacional completo, mas são pequenos, usam menos energia e são substancialmente mais baratos.
![Um Raspberry Pi 4](../../../../images/raspberry-pi-4.jpg)
O Raspberry Pi é um dos computadores de placa única mais populares.
Como um microcontrolador, os computadores de placa única têm CPU, memória e pinos de entrada/saída, mas têm recursos adicionais, como um chip gráfico para permitir a conexão de monitores, saídas de áudio e portas USB para conectar teclados a mouses e outros dispositivos USB padrão como webcams ou armazenamento externo. Os programas são armazenados em cartões SD ou discos rígidos junto com um sistema operacional, em vez de um chip de memória embutido na placa.
> 🎓 Você pode pensar em um computador de placa única como uma versão menor e mais barata do PC ou Mac em que você está lendo isso, com a adição de pinos GPIO (entrada/saída de uso geral) para interagir com sensores e atuadores.
Os computadores de placa única são computadores completos, portanto, podem ser programados em qualquer linguagem. Os dispositivos IoT são normalmente programados em Python.
### Opções de hardware para o resto das lições
Todas as lições subsequentes incluem tarefas usando um dispositivo IoT para interagir com o mundo físico e se comunicar com a nuvem. Cada lição oferece suporte a 3 opções de dispositivo - Arduino (usando um Wio Terminal da Seeed Studios) ou um computador de placa única, seja ele um dispositivo físico (um Raspberry Pi 4) ou um computador de placa única virtual rodando em seu PC ou Mac.
Você pode ler sobre o hardware necessário para completar todas as tarefas no [guia do hardware](../../../../hardware.md).
> 💁 Você não precisa comprar nenhum hardware IoT para completar as atribuições, você pode fazer tudo usando um computador de placa única virtual.
A escolha do hardware depende de você - depende do que você tem disponível em casa ou na escola e de que linguagem de programação você conhece ou planeja aprender. Ambas as variantes de hardware usarão o mesmo ecossistema de sensores, portanto, se você começar por um caminho, poderá mudar para o outro sem ter que substituir a maior parte do kit. O computador de placa única virtual será o equivalente a aprender em um Raspberry Pi, com a maior parte do código transferível para o Pi se você eventualmente conseguir um dispositivo e sensores.
### Kit de desenvolvedor do Arduino
Se você estiver interessado em aprender o desenvolvimento de microcontroladores, poderá concluir as tarefas usando um dispositivo Arduino. Você precisará de um conhecimento básico de programação C/C++, pois as lições ensinarão apenas códigos relevantes para a estrutura do Arduino, os sensores e atuadores em uso e as bibliotecas que interagem com a nuvem.
As tarefas usarão o [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-17441-jabenn) com a [extensão PlatformIO para desenvolvimento de microcontrolador](https://platformio.org). Você também pode usar o IDE do Arduino se tiver experiência com essa ferramenta, pois as instruções não serão fornecidas.
### Kit de desenvolvedor de computador de placa única
Se estiver interessado em aprender o desenvolvimento de IoT usando computadores de placa única, você pode concluir as tarefas usando um Raspberry Pi ou um dispositivo virtual em execução no seu PC ou Mac.
Você precisará de um conhecimento básico de programação Python, já que as lições ensinarão apenas códigos relevantes para os sensores e atuadores em uso e as bibliotecas que interagem com a nuvem.
> 💁 Se você quiser aprender a codificar em Python, confira as duas séries de vídeo a seguir:
>
> * [Python para iniciantes](https://channel9.msdn.com/Series/Intro-to-Python-Development?WT.mc_id=academic-17441-jabenn)
> * [Mais Python para iniciantes](https://channel9.msdn.com/Series/More-Python-for-Beginners?WT.mc_id=academic-7372-jabenn)
As tarefas usarão o [Visual Studio Code](https://code.visualstudio.com/?WT.mc_id=academic-17441-jabenn).
Se estiver usando um Raspberry Pi, você pode executar seu Pi usando a versão desktop completa do Raspberry Pi OS e fazer toda a codificação diretamente no Pi usando [a versão do VS Code para o Raspberry Pi OS](https://code.visualstudio.com/docs/setup/raspberry-pi?WT.mc_id=academic-17441-jabenn) ou executar seu Pi como um dispositivo sem cabeça e codificar a partir de seu PC ou Mac usando o VS Code com a [extensão SSH remota](https://code.visualstudio.com/docs/remote/ssh?WT.mc_id=academic-17441-jabenn) que permite que você se conecte ao seu Pi e edite, depure e execute o código como se você estivesse codificando nele diretamente.
Se você usar a opção de dispositivo virtual, codificará diretamente no seu computador. Em vez de acessar sensores e atuadores, você usará uma ferramenta para simular esse hardware, fornecendo valores de sensor que você pode definir e mostrando os resultados dos atuadores na tela.
## Configure seu dispositivo
Antes de começar a programar seu dispositivo IoT, você precisará fazer algumas configurações. Siga as instruções relevantes abaixo, dependendo de qual dispositivo você irá usar.
> 💁 Se você ainda não tem um dispositivo, consulte o [guia de hardware](../../../../hardware.md) para ajudar a decidir qual dispositivo você vai usar e qual hardware adicional você precisa comprar. Você não precisa comprar hardware, pois todos os projetos podem ser executados em hardware virtual.
Essas instruções incluem links para sites de terceiros dos criadores do hardware ou das ferramentas que você usará. Isso é para garantir que você esteja sempre usando as instruções mais atualizadas para as várias ferramentas e hardware.
Trabalhe com o guia relevante para configurar seu dispositivo e concluir um projeto 'Hello World'. Esta será a primeira etapa na criação de uma luz noturna IoT nas 4 lições desta parte de introdução.
* [Arduino - Wio Terminal](wio-terminal.pt.md)
* [Computador de placa única - Raspberry Pi](pi.pt.md)
* [Computador de placa única - Dispositivo virtual](virtual-device.pt.md)
✅ Você usará o VS Code para o Arduino e para computadores de placa única. Se você nunca usou isso antes, leia mais sobre isso no [site do VS Code](https://code.visualstudio.com?WT.mc_id=academic-17441-jabenn)
## Aplicações de IoT
A IoT cobre uma grande variedade de casos de uso, em alguns grupos amplos:
* IoT do Consumidor
* IoT Comercial
* IoT Industrial
* IoT para Infraestrutura
✅ Faça uma pequena pesquisa: para cada uma das áreas descritas abaixo, encontre um exemplo concreto que não seja fornecido no texto.
### IoT do Consumidor
A IoT do consumidor se refere a dispositivos IoT que os consumidores comprarão e usarão em casa. Alguns desses dispositivos são incrivelmente úteis, como alto-falantes inteligentes, sistemas de aquecimento inteligentes e aspiradores de pó robóticos. Outros são questionáveis em sua utilidade, como torneiras controladas por voz, o que significa que você não pode desligá-los, pois o controle de voz não pode ouvi-lo por causa do som de água corrente.
Os dispositivos IoT do consumidor estão capacitando as pessoas a realizar mais em seus arredores, especialmente 1 bilhão de pessoas com algum tipo de deficiência. Aspiradores de pó robóticos podem fornecer pisos limpos para pessoas com problemas de mobilidade que não podem aspirar a si mesmas, fornos controlados por voz permitem que pessoas com visão ou controle motor limitados aqueçam seus fornos apenas com a voz, monitores de saúde podem permitir que os pacientes monitorem suas condições crônicas com atualizações mais regulares e mais detalhadas. Esses dispositivos estão se tornando tão onipresentes que até crianças pequenas estão usando-os como parte de suas vidas diárias, por exemplo, alunos fazendo aulas virtuais durante a pandemia do COVID configurando cronômetros em dispositivos domésticos inteligentes para rastrear seus trabalhos escolares ou alarmes para lembrá-los das próximas reuniões da turma.
✅ Quais dispositivos IoT do consumidor você tem consigo ou em casa?
### IoT comercial
A IoT comercial cobre o uso da IoT no local de trabalho. Em um ambiente de escritório, pode haver sensores de ocupação e detectores de movimento para gerenciar a iluminação e o aquecimento para apenas manter as luzes e o aquecimento desligados quando não forem necessários, reduzindo o custo e as emissões de carbono. Em uma fábrica, os dispositivos IoT podem monitorar os riscos à segurança, como trabalhadores sem capacete ou ruído que atingiu níveis perigosos. No varejo, os dispositivos IoT podem medir a temperatura do armazenamento refrigerado, alertando o proprietário da loja se uma geladeira ou freezer está fora da faixa de temperatura exigida, ou podem monitorar os itens nas prateleiras para direcionar os funcionários para reabastecer os produtos que foram vendidos. A indústria de transporte está confiando cada vez mais na IoT para monitorar a localização dos veículos, rastrear a quilometragem na estrada para cobrança do usuário da estrada, monitorar as horas do motorista e interromper a conformidade ou notificar a equipe quando um veículo se aproxima de um depósito para se preparar para carga ou descarga
✅ Quais dispositivos IoT comerciais você tem em sua escola ou local de trabalho?
### IoT Industrial (IIoT)
IoT industrial, ou IIoT, é o uso de dispositivos IoT para controlar e gerenciar máquinas em grande escala. Isso cobre uma ampla gama de casos de uso, desde fábricas até agricultura digital.
As fábricas usam dispositivos IoT de muitas maneiras diferentes. A maquinaria pode ser monitorada com vários sensores para rastrear coisas como temperatura, vibração e velocidade de rotação. Esses dados podem então ser monitorados para permitir que a máquina seja parada se ficar fora de certas tolerâncias - ela fica muito quente e é desligada, por exemplo. Esses dados também podem ser coletados e analisados ao longo do tempo para fazer a manutenção preditiva, onde os modelos de IA examinam os dados que levam a uma falha e os usam para prever outras falhas antes que elas aconteçam.
A agricultura digital é importante se o planeta deseja alimentar a população crescente, especialmente para os 2 bilhões de pessoas em 500 milhões de famílias que sobrevivem da [agricultura de subsistência](https://pt.wikipedia.org/wiki/Agricultura_de_subsist%C3%AAncia). A agricultura digital pode variar de alguns sensores de um dígito de dólar a enormes configurações comerciais. Um agricultor pode começar monitorando as temperaturas e usar o [grau-dia de crescimento](https://wikipedia.org/wiki/Growing_degree-day) para prever quando uma safra estará pronta para a colheita. Eles podem conectar o monitoramento da umidade do solo a sistemas de rega automatizados para fornecer a suas plantas a quantidade necessária de água, mas não mais para garantir que suas safras não sequem sem desperdício de água. Os agricultores estão indo mais longe e usando drones, dados de satélite e IA para monitorar o crescimento da safra, doenças e qualidade do solo em grandes áreas de terras agrícolas.
✅ Que outros dispositivos IoT podem ajudar os agricultores?
### IoT para Infraestrutura
A IoT para infraestrutura monitora e controla a infraestrutura local e global que as pessoas usam todos os dias.
[Cidades inteligentes](https://pt.wikipedia.org/wiki/Cidade_inteligente) são áreas urbanas que usam dispositivos IoT para coletar dados sobre a cidade e usá-los para melhorar o funcionamento da mesma. Essas cidades geralmente são administradas com a colaboração entre governos locais, universidades e empresas locais, rastreando e gerenciando coisas que variam de transporte a estacionamento e poluição. Por exemplo, em Copenhague, Dinamarca, a poluição do ar é importante para os residentes locais, por isso é medida e os dados são usados para fornecer informações sobre as rotas de ciclismo e corrida mais limpas.
[Redes de energia inteligentes](https://pt.wikipedia.org/wiki/Rede_el%C3%A9trica_inteligente) permitem uma melhor análise da demanda de energia, reunindo dados de uso no nível de residências individuais. Esses dados podem orientar decisões em nível de país, incluindo onde construir novas usinas de energia, e em nível pessoal, dando aos usuários insights sobre quanta energia eles estão usando, quando estão usando, e até mesmo sugestões sobre como reduzir custos, como por exemplo carregar carros elétricos à noite.
✅ Se você pudesse adicionar dispositivos IoT para medir qualquer coisa onde você mora, o que seria?
## Exemplos de dispositivos IoT que você pode ter ao seu redor
Você ficaria surpreso com a quantidade de dispositivos IoT que tem ao seu redor. Estou escrevendo isso de casa e tenho os seguintes dispositivos conectados à Internet com recursos inteligentes, como controle de aplicativos, controle de voz ou a capacidade de enviar dados para mim através do meu telefone:
* Vários alto-falantes inteligentes
* Geladeira, lava-louças, forno e micro-ondas
* Monitor de eletricidade para painéis solares
* Plugues inteligentes
* Campainha de vídeo e câmeras de segurança
* Termostato inteligente com vários sensores inteligentes de ambiente
* Abridor de porta de garagem
* Sistemas de entretenimento doméstico e TVs controladas por voz
* Luzes
* Rastreadores de condicionamento físico e de saúde
Todos esses tipos de dispositivos possuem sensores e/ou atuadores e se comunicam com a Internet. Posso dizer pelo meu telefone se a porta da garagem está aberta e pedir ao meu alto-falante inteligente para fechá-la para mim. Posso até definir um temporizador para que, se ainda estiver aberta à noite, feche automaticamente. Quando minha campainha toca, posso ver no meu telefone quem está lá em qualquer lugar do mundo e falar com eles por meio de um alto-falante e microfone embutidos na campainha. Posso monitorar minha glicemia, frequência cardíaca e padrões de sono, procurando padrões nos dados para melhorar minha saúde. Posso controlar minhas luzes por meio da nuvem e ficar sentado no escuro quando minha conexão com a Internet cair.
---
## 🚀 Desafio
Liste o máximo de dispositivos IoT que puder em sua casa, escola ou local de trabalho - pode haver mais do que você pensa!
## Questionário pós-aula
[Questionário pós-aula](https://brave-island-0b7c7f50f.azurestaticapps.net/quiz/2)
## Revisão e autoestudo
Leia sobre os benefícios e as falhas dos projetos de IoT do consumidor. Verifique os sites de notícias para obter artigos sobre quando deu errado, como questões de privacidade, problemas de hardware ou problemas causados por falta de conectividade.
Alguns exemplos:
* Verifique a conta do Twitter **[Internet of Sh*t](https://twitter.com/internetofshit) ** *(aviso de palavrões)* para obter alguns bons exemplos de falhas com a IoT do consumidor.
* [c|net - Meu Apple Watch salvou minha vida: 5 pessoas compartilham suas histórias](https://www.cnet.com/news/apple-watch-lifesaving-health-features-read-5-peoples-stories/)
* [c|net - Técnico ADT se declara culpado de espionar imagens de câmeras de clientes por anos](https://www.cnet.com/news/adt-home-security-technician-pleads-guilty-to-spying-on- customer-camera-feeds-for-years/) *(aviso de gatilho - voyeurismo não consensual)*
## Tarefa
[Investigar um projeto IoT](assignment.pt.md)

@ -0,0 +1,13 @@
# Investigue um projeto de IoT
## Instruções
Existem muitos projetos de IoT de grande e pequena escala sendo implementados globalmente, de fazendas inteligentes a cidades inteligentes, em monitoramento de saúde, transporte e para o uso de espaços públicos.
Pesquise na web por detalhes de um projeto do seu interesse, de preferência um perto de onde você mora. Explique as vantagens e desvantagens do projeto, por exemplo, quais os benefícios dele, quaisquer problemas que ele causa e como a privacidade é levada em consideração.
## Rubrica
| Critérios | Exemplar | Adequado | Precisa Melhorar |
| --------- | -------- | -------- | ---------------- |
| Explique as vantagens e desvantagens | Deu uma explicação clara das vantagens e desvantagens do projeto | Deu uma breve explicação sobre as vantagens e desvantagens | Não explicou as vantagens ou desvantagens |

@ -0,0 +1,245 @@
# Raspberry Pi
O [Raspberry Pi](https://raspberrypi.org) é um computador de placa única. Você pode adicionar sensores e atuadores usando uma ampla variedade de dispositivos e ecossistemas, e para essas lições, usando um ecossistema de hardware chamado [Grove](https://www.seeedstudio.com/category/Grove-c-1003.html). Você codificará seu Pi e acessará os sensores Grove usando Python.
![Um Raspberry Pi 4](../../../../images/raspberry-pi-4.jpg)
## Configuração
Se você estiver usando um Raspberry Pi como seu hardware IoT, você tem duas opções - você pode trabalhar em todas essas lições e codificar diretamente no Pi ou pode se conectar remotamente a um Pi 'headless' e codificar de seu computador.
Antes de começar, você também precisa conectar o Grove Base Hat ao seu Pi.
### Tarefa - configuração
Instale o Grove Base Hat no seu Pi e configure o Pi
1. Conecte o Grove Base Hat ao seu Pi. O soquete no Grove Base Hat se encaixa em todos os pinos de GPIO no Pi, deslizando para baixo sobre os pinos para que se assente firmemente na base. Ele fica sobre o Pi, cobrindo-o.
![Ajustando o Grove Hat](../../../../images/pi-grove-hat-fitting.gif)
1. Decida como você deseja programar seu Pi e vá para a seção relevante abaixo:
* [Trabalhe diretamente no seu Pi](#trabalhe-diretamente-no-seu-pi)
* [Acesso remoto para codificar o Pi](#acesso-remoto-para-codificar-o-pi)
### Trabalhe diretamente no seu Pi
Se você quiser trabalhar diretamente no seu Pi, pode usar a versão desktop do Raspberry Pi OS e instalar todas as ferramentas de que precisa.
#### Tarefa - trabalhe diretamente no seu Pi
Configure seu Pi para desenvolvimento.
1. Siga as instruções no [guia de configuração do Raspberry Pi](https://projects.raspberrypi.org/en/projects/raspberry-pi-setting-up) para configurar seu Pi, conecte-o a um teclado/mouse/monitor, conecte-o à sua rede WiFi ou ethernet e atualize o software. O sistema operacional que você deseja instalar é o **Raspberry Pi OS (32 bits)**, ele é marcado como o sistema operacional recomendado ao usar o Raspberry Pi Imager para criar a imagem do seu cartão SD.
Para programar o Pi usando os sensores e atuadores Grove, você precisará instalar um editor para permitir que você escreva o código do dispositivo e várias bibliotecas e ferramentas que interagem com o hardware Grove.
1. Assim que seu Pi for reiniciado, inicie o Terminal clicando no ícone **Terminal** na barra de menu superior ou escolha *Menu -> Acessórios -> Terminal*
1. Execute o seguinte comando para garantir que o sistema operacional e o software instalado estejam atualizados:
```sh
sudo apt update && sudo apt full-upgrade --yes
```
1. Execute o seguinte comando para instalar todas as bibliotecas necessárias para o hardware Grove:
```sh
curl -sL https://github.com/Seeed-Studio/grove.py/raw/master/install.sh | sudo bash -s -
```
Um dos recursos poderosos do Python é a capacidade de instalar [pacotes pip](https://pypi.org) - são pacotes de código escritos por outras pessoas e publicados na Internet. Você pode instalar um pacote pip em seu computador com um comando e, em seguida, usar esse pacote em seu código. Este script de instalação do Grove instalará os pacotes pip que você usará para trabalhar com o hardware Grove a partir do Python.
1. Reinicialize o Pi usando o menu ou executando o seguinte comando no Terminal:
```sh
sudo reboot
```
1. Após a reinicialização do Pi, reinicie o Terminal e execute o seguinte comando para instalar o [Visual Studio Code (VS Code)](https://code.visualstudio.com?WT.mc_id=academic-17441-jabenn) - este é o editor que você usará para escrever o código do seu dispositivo em Python.
```sh
sudo apt install code
```
Depois de instalado, o VS Code estará disponível no menu superior.
> 💁 Você está livre para usar qualquer IDE de Python ou editor para essas lições se tiver uma ferramenta preferida, mas as lições darão instruções baseadas no uso do VS Code.
1. Instale o Pylance. Esta é uma extensão para VS Code que fornece suporte à linguagem Python. Consulte a [documentação da extensão Pylance](https://marketplace.visualstudio.com/items?itemName=ms-python.vscode-pylance&WT.mc_id=academic-17441-jabenn) para obter instruções sobre como instalar esta extensão no VS Code.
### Acesso remoto para codificar o Pi
Em vez de codificar diretamente no Pi, ele pode rodar 'headless', quando não está conectado a um teclado/mouse/monitor, e assim configurar e codificar nele a partir do seu computador, usando o Visual Studio Code.
#### Configure o Pi OS
Para codificar remotamente, o Pi OS precisa ser instalado em um cartão SD.
##### Tarefa - configurar o Pi OS
Configure o Pi OS headless.
1. Baixe o **Raspberry Pi Imager** da [página do software Raspberry Pi OS](https://www.raspberrypi.org/software/) e instale-o
1. Insira um cartão SD em seu computador, usando um adaptador, se necessário
1. Inicie o Raspberry Pi Imager
1. No Raspberry Pi Imager, selecione o botão **CHOOSE OS** e, em seguida, selecione *Raspberry Pi OS (Other)*, seguido por *Raspberry Pi OS Lite (32 bits)*
![O Raspberry Pi Imager com o Raspberry Pi OS Lite selecionado](../../../../images/raspberry-pi-imager.png)
> 💁 Raspberry Pi OS Lite é uma versão do Raspberry Pi OS que não possui a UI para desktop ou ferramentas baseadas em UI. Eles não são necessários para um Pi headless e tornam a instalação menor e o tempo de inicialização mais rápido.
1. Selecione o botão **CHOOSE STORAGE** e, em seguida, selecione seu cartão SD
1. Inicie as **Advanced Options** pressionando `Ctrl+Shift+X`. Essas opções permitem alguma pré-configuração do sistema operacional do Raspberry Pi antes que sua imagem seja criada no cartão SD.
1. Marque a caixa de seleção **Enable SSH** e defina uma senha para o usuário `pi`. Esta é a senha que você usará para fazer login no Pi mais tarde.
1. Se você está planejando se conectar ao Pi por WiFi, marque a caixa de seleção **Configure WiFi** e insira o SSID e a senha do seu WiFi, bem como selecione o país do seu WiFi. Você não precisa fazer isso se for usar um cabo Ethernet. Certifique-se de que a rede à qual você se conecta é a mesma em que seu computador está.
1. Marque a caixa de seleção **Set locale settings** e defina seu país e fuso horário
1. Selecione o botão **SAVE**
1. Selecione o botão **WRITE** para gravar o sistema operacional no cartão SD. Se estiver usando o macOS, será solicitado que você insira sua senha, pois a ferramenta subjacente que grava imagens de disco precisa de acesso privilegiado.
O sistema operacional será gravado no cartão SD e, uma vez concluído, o cartão será ejetado pelo sistema operacional e você será notificado. Remova o cartão SD do seu computador, insira-o no Pi e ligue o Pi.
#### Conecte-se ao Pi
A próxima etapa é acessar remotamente o Pi. Você pode fazer isso usando `ssh`, que está disponível no macOS, Linux e versões recentes do Windows.
##### Tarefa - conectar ao Pi
Acesse remotamente o Pi.
1. Inicie um Terminal ou Prompt de Comando e digite o seguinte comando para se conectar ao Pi:
```sh
ssh pi@raspberrypi.local
```
Se você estiver no Windows usando uma versão mais antiga que não possui o `ssh` instalado, você pode usar o OpenSSH. Você pode encontrar as instruções de instalação na [documentação de instalação do OpenSSH](https://docs.microsoft.com//windows-server/administration/openssh/openssh_install_firstuse?WT.mc_id=academic-17441-jabenn).
1. Isso deve se conectar ao seu Pi e pedir a senha.
Ser capaz de encontrar computadores em sua rede usando `<hostname>.local` é uma adição bastante recente ao Linux e Windows. Se você estiver usando Linux ou Windows e receber algum erro sobre o nome do host não ser encontrado, será necessário instalar software adicional para habilitar o ZeroConf networking (também conhecido pela Apple como Bonjour):
1. Se você estiver usando Linux, instale o Avahi usando o seguinte comando:
```sh
sudo apt-get install avahi-daemon
```
1. Se você estiver usando o Windows, a maneira mais fácil de ativar o ZeroConf é instalar [Bonjour Print Services para Windows](http://support.apple.com/kb/DL999). Você também pode instalar o [iTunes para Windows](https://www.apple.com/itunes/download/) para obter uma versão mais recente do utilitário (que não está disponível standalone).
> 💁 Se você não conseguir se conectar usando `raspberrypi.local`, poderá usar o endereço IP do seu Pi. Consulte a [documentação do endereço IP do Raspberry Pi](https://www.raspberrypi.org/documentation/remote-access/ip-address.md) para obter instruções sobre várias maneiras de obter o endereço IP.
1. Digite a senha que você definiu nas opções avançadas do Raspberry Pi Imager
#### Configure o software no Pi
Assim que estiver conectado ao Pi, você precisa garantir que o sistema operacional esteja atualizado e instalar várias bibliotecas e ferramentas que interagem com o hardware Grove.
##### Tarefa - configurar software no Pi
Configure o software Pi instalado e instale as bibliotecas Grove.
1. Na sessão `ssh`, execute o seguinte comando para atualizar e reinicie o Pi:
```sh
sudo apt update && sudo apt full-upgrade --yes && sudo reboot
```
O Pi será atualizado e reiniciado. A sessão `ssh` terminará quando o Pi for reiniciado, então deixe-o por cerca de 30 segundos e reconecte.
1. A partir da sessão `ssh` reconectada, execute o seguinte comando para instalar todas as bibliotecas necessárias para o hardware Grove:
```sh
curl -sL https://github.com/Seeed-Studio/grove.py/raw/master/install.sh | sudo bash -s -
```
Um dos recursos poderosos do Python é a capacidade de instalar [pacotes pip](https://pypi.org) - são pacotes de código escritos por outras pessoas e publicados na Internet. Você pode instalar um pacote pip em seu computador com um comando e, em seguida, usar esse pacote em seu código. Este script de instalação do Grove instalará os pacotes pip que você usará para trabalhar com o hardware Grove a partir do Python.
1. Reinicialize o Pi executando o seguinte comando:
```sh
sudo reboot
```
A sessão `ssh` terminará quando o Pi for reiniciado. Não há necessidade de reconectar.
#### Configure o VS Code para acesso remoto
Depois que o Pi estiver configurado, você pode se conectar a ele usando o Visual Studio Code (VS Code) a partir do seu computador - este é um editor de texto para desenvolvedores gratuito que você usará para escrever o código do seu dispositivo em Python.
##### Tarefa - configurar o VS Code para acesso remoto
Instale o software necessário e conecte-se remotamente ao seu Pi.
1. Instale o VS Code em seu computador seguindo a [documentação do VS Code](https://code.visualstudio.com?WT.mc_id=academic-17441-jabenn)
1. Siga as instruções em [VS Code Remote Development using SSH documentation](https://code.visualstudio.com/docs/remote/ssh?WT.mc_id=academic-17441-jabenn) para instalar os componentes necessários
1. Seguindo as mesmas instruções, conecte o VS Code ao Pi
1. Depois de conectado, siga as instruções em [gerenciando extensões](https://code.visualstudio.com/docs/remote/ssh#_managing-extensions?WT.mc_id=academic-17441-jabenn) para instalar a [extensão Pylance](https://marketplace.visualstudio.com/items?itemName=ms-python.vscode-pylance&WT.mc_id=academic-17441-jabenn) remotamente no Pi
## Hello World
É tradicional, ao começar com uma nova linguagem de programação ou tecnologia, criar um aplicativo 'Hello World' - um pequeno aplicativo que produz algo como o texto `"Hello World"` para mostrar que todas as ferramentas estão configuradas corretamente.
O aplicativo Hello World para o Pi garantirá que você tenha o Python e o Visual Studio Code instalados corretamente.
Este aplicativo estará em uma pasta chamada `nightlight` e será reutilizado com código diferente em partes posteriores desta tarefa para construir o aplicativo nightlight.
### Tarefa - hello world
Crie o aplicativo Hello World.
1. Inicie o VS Code, diretamente no Pi ou em seu computador e conectado ao Pi usando a extensão Remote SSH
1. Inicie o Terminal do VS Code selecionando *Terminal -> Novo Terminal* ou pressionando `` CTRL+` ``. Ele será aberto no diretório inicial dos usuários `pi`.
1. Execute os seguintes comandos para criar um diretório para o seu código e crie um arquivo Python chamado `app.py` dentro desse diretório:
```sh
mkdir nightlight
cd nightlight
touch app.py
```
1. Abra esta pasta no VS Code selecionando *File -> Open...* e selecionando a pasta *nightlight* e, em seguida, selecione **OK**
![A caixa de diálogo de abertura do VS Code mostrando a pasta nightlight](../../../../images/vscode-open-nightlight-remote.png)
1. Abra o arquivo `app.py` no VS Code explorer e adicione o seguinte código:
```python
print('Hello World!')
```
A função `print` imprime tudo o que é passado para ela no console.
1. No Terminal do VS Code, execute o seguinte para executar seu aplicativo Python:
```sh
python3 app.py
```
> 💁 Você precisa chamar explicitamente `python3` para executar este código apenas no caso de ter o Python 2 instalado além do Python 3 (a versão mais recente). Se você tiver Python2 instalado, chamar `python` usará Python 2 em vez de Python 3
A seguinte saída aparecerá no terminal:
```output
pi@raspberrypi:~/nightlight $ python3 app.py
Hello World!
```
> 💁 Você pode encontrar este código na pasta [code/pi](code/pi).
😀 Seu programa 'Hello World' foi um sucesso!

@ -0,0 +1,210 @@
# Computador de placa única virtual
Em vez de comprar um dispositivo IoT, junto com sensores e atuadores, você pode usar seu computador para simular o hardware IoT. O [projeto CounterFit](https://github.com/CounterFit-IoT/CounterFit) permite que você execute um aplicativo localmente que simula hardware IoT, como sensores e atuadores, e acesse os sensores e atuadores a partir do código Python local que está escrito da mesma forma que o código que você escreveria em um Raspberry Pi usando um hardware físico.
## Configuração
Para usar o CounterFit, você precisará instalar alguns softwares gratuitos em seu computador.
### Tarefa
Instale o software necessário.
1. Instale o Python. Consulte a [página de downloads do Python](https://www.python.org/downloads/) para obter instruções sobre como instalar a versão mais recente do Python.
1. Instale o Visual Studio Code (VS Code). Este é o editor que você usará para escrever o código do seu dispositivo virtual em Python. Consulte a [documentação do VS Code](https://code.visualstudio.com?WT.mc_id=academic-17441-jabenn) para obter instruções sobre como instalar o VS Code.
> 💁 Você está livre para usar qualquer IDE ou editor de código Python para essas lições se tiver uma ferramenta preferida, mas as lições darão instruções baseadas no uso do VS Code.
1. Instale a extensão Pylance do VS Code. Esta é uma extensão para VS Code que fornece suporte à linguagem Python. Consulte a [documentação da extensão Pylance](https://marketplace.visualstudio.com/items?itemName=ms-python.vscode-pylance&WT.mc_id=academic-17441-jabenn) para obter instruções sobre como instalar esta extensão no VS Code.
As instruções para instalar e configurar o aplicativo CounterFit serão fornecidas no momento relevante nas instruções de atribuição, uma vez que é instalado por projeto.
## Hello world
É tradicional, ao começar com uma nova linguagem de programação ou tecnologia, criar um aplicativo 'Hello World' - um pequeno aplicativo que produz algo como o texto `"Hello World"` para mostrar que todas as ferramentas estão configuradas corretamente.
O aplicativo Hello World para o hardware IoT virtual garantirá que você tenha o Python e o Visual Studio Code instalados corretamente. Ele também se conectará ao CounterFit para os sensores e atuadores IoT virtuais. Ele não usará nenhum hardware, apenas se conectará para provar que tudo está funcionando.
Este aplicativo estará em uma pasta chamada `nightlight` e será reutilizado com código diferente em partes posteriores desta atribuição para construir o aplicativo nightlight.
### Configure um ambiente virtual Python
Um dos recursos poderosos do Python é a capacidade de instalar [pacotes pip](https://pypi.org) - são pacotes de código escritos por outras pessoas e publicados na Internet. Você pode instalar um pacote pip em seu computador com um comando e, em seguida, usar esse pacote em seu código. Você usará o pip para instalar um pacote para falar com o CounterFit.
Por padrão, quando você instala um pacote, ele está disponível em qualquer lugar do seu computador, e isso pode causar problemas com as versões do pacote - como um aplicativo dependendo de uma versão de um pacote que quebra quando você instala uma nova versão para um aplicativo diferente. Para contornar esse problema, você pode usar um [ambiente virtual Python](https://docs.python.org/3/library/venv.html), essencialmente uma cópia do Python em uma pasta dedicada, e ao instalar o pip pacotes são instalados apenas nessa pasta.
#### Tarefa - configurar um ambiente virtual Python
Configure um ambiente virtual Python e instale os pacotes pip para CounterFit.
1. Em seu terminal ou linha de comando, execute o seguinte em um local de sua escolha para criar e navegar para um novo diretório:
```sh
mkdir nightlight
cd nightlight
```
1. Agora execute o seguinte para criar um ambiente virtual na pasta `.venv`
```sh
python3 -m venv .venv
```
> 💁 Você precisa chamar explicitamente `python3` para criar o ambiente virtual apenas no caso de ter o Python 2 instalado além do Python 3 (a versão mais recente). Se você tiver Python2 instalado, chamar `python` usará Python 2 em vez de Python 3
1. Ative o ambiente virtual:
* No Windows, execute:
```cmd
.venv \ Scripts \ activate.bat
```
* No macOS ou Linux, execute:
```cmd
source ./.venv/bin/activate
```
1. Uma vez que o ambiente virtual foi ativado, o comando padrão `python` irá executar a versão do Python que foi usada para criar o ambiente virtual. Execute o seguinte para obter a versão:
```sh
python --version
```
A saída deve conter o seguinte:
```output
(.venv) ➜ nightlight python --version
Python 3.9.1
```
> 💁 Sua versão do Python pode ser diferente - contanto que seja a versão 3.6 ou superior, você está bem. Caso contrário, exclua esta pasta, instale uma versão mais recente do Python e tente novamente.
1. Execute os seguintes comandos para instalar os pacotes pip para CounterFit. Esses pacotes incluem o aplicativo CounterFit principal, bem como shims para hardware Grove. Esses shims permitem que você escreva código como se estivesse programando usando sensores e atuadores físicos do ecossistema Grove, mas conectado a dispositivos IoT virtuais.
```sh
pip install CounterFit
pip install counterfit-connection
pip install counterfit-shims-grove
```
Esses pacotes pip só serão instalados no ambiente virtual e não estarão disponíveis fora dele.
### Escreva o código
Assim que o ambiente virtual Python estiver pronto, você pode escrever o código para o aplicativo 'Hello World'
#### Tarefa - escreva o código
Crie um aplicativo Python para imprimir `" Hello World "` no console.
1. Em seu terminal ou linha de comando, execute o seguinte dentro do ambiente virtual para criar um arquivo Python chamado `app.py`:
* No Windows, execute:
```cmd
type nul > app.py
```
* No macOS ou Linux, execute:
```cmd
touch app.py
```
1. Abra a pasta atual no VS Code:
```sh
code .
```
> 💁 Se o seu terminal retornar `command not found` no macOS, significa que o VS Code não foi adicionado ao seu PATH. Você pode adicionar o VS Code ao seu PATH seguindo as instruções na seção [Iniciando a partir da linha de comando da documentação do código do VS](https://code.visualstudio.com/docs/setup/mac?WT.mc_id=academic-17441-jabenn#_launching-from-the-command-line) e execute o comando depois. O VS Code é instalado em seu PATH por padrão no Windows e Linux.
1. Quando o VS Code for iniciado, ele ativará o ambiente virtual Python. O ambiente virtual selecionado aparecerá na barra de status inferior:
![VS Code mostrando o ambiente virtual selecionado](../../../../images/vscode-virtual-env.png)
1. Se o Terminal do VS Code já estiver em execução quando o VS Code for inicializado, ele não terá o ambiente virtual ativado nele. A coisa mais fácil a fazer é matar o terminal usando o botão **Kill the active terminal instance**:
![Botão Kill the active terminal instance do VS Code](../../../../images/vscode-kill-terminal.png)
Você pode dizer se o terminal tem o ambiente virtual ativado, pois o nome do ambiente virtual será um prefixo no prompt do terminal. Por exemplo, pode ser:
```sh
(.venv) ➜ nightlight
```
Se você não tiver `.venv` como prefixo no prompt, o ambiente virtual não está ativo no terminal.
1. Inicie um novo Terminal do VS Code selecionando *Terminal -> Novo Terminal* ou pressionando `` CTRL+` ``. O novo terminal irá carregar o ambiente virtual, e a chamada para ativá-lo aparecerá no terminal. O prompt também terá o nome do ambiente virtual (`.venv`):
```output
➜ nightlight source .venv/bin/activate
(.venv) ➜ nightlight
```
1. Abra o arquivo `app.py` no VS Code explorer e adicione o seguinte código:
```python
print('Hello World!')
```
A função `print` imprime no console tudo o que é passado para ela.
1. No terminal do VS Code, execute o seguinte para executar seu aplicativo Python:
```sh
python app.py
```
O seguinte estará na saída:
```output
(.venv) ➜ nightlight python app.py
Hello World!
```
😀 Seu programa 'Hello World' foi um sucesso!
### Conecte o 'hardware'
Como uma segunda etapa 'Hello World', você executará o aplicativo CounterFit e conectará seu código a ele. Isso é o equivalente virtual de conectar algum hardware IoT a um kit de desenvolvimento.
#### Tarefa - conecte o 'hardware'
1. A partir do terminal do VS Code, inicie o aplicativo CounterFit com o seguinte comando:
```sh
CounterFit
```
O aplicativo começará a funcionar e abrir no seu navegador da web:
![O aplicativo Counter Fit em execução em um navegador](../../../../images/counterfit-first-run.png)
Ele será marcado como *Desconectado*, com o LED no canto superior direito apagado.
1. Adicione o seguinte código ao topo de `app.py`:
```python
from counterfit_connection import CounterFitConnection
CounterFitConnection.init('127.0.0.1', 5000)
```
Este código importa a classe `CounterFitConnection` do módulo` counterfit_connection`, que vem do pacote pip `counterfit-connection` que você instalou anteriormente. Em seguida, ele inicializa uma conexão com o aplicativo CounterFit em execução em `127.0.0.1`, que é um endereço IP que você sempre pode usar para acessar seu computador local (muitas vezes referido como *localhost*), na porta 5000.
> 💁 Se você tiver outros aplicativos em execução na porta 5000, pode alterar isso atualizando a porta no código e executando o CounterFit usando `CounterFit --port <port_number>`, substituindo `<port_number>` pela porta que deseja usar.
1. Você precisará iniciar um novo terminal do VS Code selecionando o botão **Create a new integrated terminal**. Isso ocorre porque o aplicativo CounterFit está sendo executado no terminal atual.
![Botão Create a new integrated terminal do VS Code](../../../../images/vscode-new-terminal.png)
1. Neste novo terminal, execute o arquivo `app.py` como antes. O status do CounterFit mudará para **Conectado** e o LED acenderá.
![CounterFit mostrando como conectado](../../../../images/counterfit-connected.png)
> 💁 Você pode encontrar este código na pasta [code/virtual-device](../code/virtual-device).
😀 Sua conexão com o hardware foi um sucesso!

@ -0,0 +1,198 @@
# Wio Terminal
O [Wio Terminal da Seeed Studios] (https://www.seeedstudio.com/Wio-Terminal-p-4509.html) é um microcontrolador compatível com Arduino, com WiFi e alguns sensores e atuadores integrados, bem como portas para adicionar mais sensores e atuadores, usando um ecossistema de hardware chamado [Grove] (https://www.seeedstudio.com/category/Grove-c-1003.html).
![Um Wio Terminal da Seeed studios](../../../../images/wio-terminal.png)
## Configuração
Para usar o Wio Terminal, você precisará instalar algum software gratuito no computador. Você também precisará atualizar o firmware do Wio Terminal antes de conectá-lo ao WiFi.
### Tarefa - configuração
Instale o software necessário e atualize o firmware.
1. Instale o Visual Studio Code (VS Code). Este é o editor que você usará para escrever o código do seu dispositivo em C/C++. Consulte a [documentação do VS Code](https://code.visualstudio.com?WT.mc_id=academic-17441-jabenn) para obter instruções sobre como instalar o VS Code.
> 💁 Outro IDE popular para o desenvolvimento do Arduino é o [Arduino IDE](https://www.arduino.cc/en/software). Se você já está familiarizado com esta ferramenta, você pode usá-la em vez do VS Code e PlatformIO, mas as lições darão instruções baseadas no uso do VS Code.
1. Instale a extensão PlatformIO do VS Code. Esta é uma extensão do VS Code que oferece suporte à programação de microcontroladores em C/C++. Consulte a [documentação da extensão PlatformIO](https://marketplace.visualstudio.com/items?itemName=platformio.platformio-ide&WT.mc_id=academic-17441-jabenn) para obter instruções sobre como instalar esta extensão no VS Code. Esta extensão depende da extensão Microsoft C/C++ para funcionar com código C e C ++, e a extensão C/C++ é instalada automaticamente quando você instala a extensão PlatformIO.
1. Conecte o Wio Terminal ao computador. O Wio Terminal possui uma porta USB-C na parte inferior e ela precisa ser conectada a uma porta USB no seu computador. O Wio Terminal vem com um cabo USB-C para USB-A, mas se o seu computador tiver apenas portas USB-C, você precisará de um cabo USB-C ou de um adaptador USB-A para USB-C.
1. Siga as instruções na [documentação de visão geral de WiFi da Wiki do Wio Terminal](https://wiki.seeedstudio.com/Wio-Terminal-Network-Overview/) para configurar seu Wio Terminal e atualizar o firmware.
## Hello World
É tradicional, ao começar com uma nova linguagem de programação ou tecnologia, criar um aplicativo 'Hello World' - um pequeno aplicativo que produz algo como o texto `"Hello World"` para mostrar que todas as ferramentas estão configuradas corretamente.
O aplicativo Hello World para o Wio Terminal garantirá que você tenha o Visual Studio Code instalado corretamente com PlatformIO e configurado para desenvolvimento de microcontrolador.
### Crie um projeto PlatformIO
A primeira etapa é criar um novo projeto usando PlatformIO configurado para o Wio Terminal.
#### Tarefa - criar um projeto PlatformIO
Crie o projeto PlatformIO.
1. Conecte o Wio Terminal ao seu computador
1. Inicie o VS Code
1. O ícone PlatformIO estará na barra de menu lateral:
![A opção de menu Platform IO](../../../../images/vscode-platformio-menu.png)
Selecione este item de menu e, em seguida, selecione *PIO Home -> Open*
![A opção de Abrir do Platform IO](../../../../images/vscode-platformio-home-open.png)
1. Na tela de boas-vindas, selecione o botão **+ New Project**
![O botão de Novo Projeto](../../../../images/vscode-platformio-welcome-new-button.png)
1. Configure o projeto no *Project Wizard*:
1. Nomeie seu projeto como `nightlight`
1. No dropdown de *Board*, digite `WIO` para filtrar as placas e selecione *Seeeduino Wio Terminal*
1. Deixe o *Framework* como *Arduino*
1. Deixe a caixa de seleção *Use default location* marcada, ou desmarque-a e selecione um local para o seu projeto
1. Selecione o botão **Finish**
![O assistente de projeto concluído](../../../../images/vscode-platformio-nightlight-project-wizard.png)
PlatformIO baixará os componentes necessários para compilar o código para o Wio Terminal e criar seu projeto. Isso pode levar alguns minutos.
### Investigue o projeto PlatformIO
O explorador do VS Code mostrará vários arquivos e pastas criados pelo assistente PlatformIO.
#### Pastas
* `.pio` - esta pasta contém dados temporários necessários para PlatformIO, como bibliotecas ou código compilado. Ela é recriada automaticamente se excluída e você não precisa adicioná-la ao controle do código-fonte se estiver compartilhando seu projeto em sites como o GitHub.
* `.vscode` - esta pasta contém a configuração usada por PlatformIO e VS Code. Ela é recriada automaticamente se excluída e você não precisa adicioná-la ao controle do código-fonte se estiver compartilhando seu projeto em sites como o GitHub.
* `include` - esta pasta é para arquivos de cabeçalho externos necessários ao adicionar bibliotecas adicionais ao seu código. Você não usará esta pasta em nenhuma dessas lições.
* `lib` - esta pasta é para bibliotecas externas que você deseja chamar de seu código. Você não usará esta pasta em nenhuma dessas lições.
* `src` - esta pasta contém o código-fonte principal do seu aplicativo. Inicialmente, ele conterá um único arquivo - `main.cpp`.
* `test` - esta pasta é onde você colocaria quaisquer testes de unidade para o seu código
#### Arquivos
* `main.cpp` - este arquivo na pasta `src` contém o ponto de entrada para sua aplicação. Abra este arquivo e ele conterá o seguinte código:
```cpp
#include <Arduino.h>
void setup() {
// coloque seu código de configuração aqui, para ser executado uma vez:
}
void loop() {
// coloque seu código principal aqui, para executar repetidamente:
}
```
Quando o dispositivo é inicializado, a estrutura do Arduino executará a função `setup` uma vez e, em seguida, executará a função `loop` repetidamente até que o dispositivo seja desligado.
* `.gitignore` - este arquivo lista os arquivos e diretórios a serem ignorados ao adicionar seu código ao controle de código-fonte do git, como enviar para um repositório no GitHub.
* `platformio.ini` - este arquivo contém a configuração para seu dispositivo e aplicativo. Abra este arquivo e ele conterá o seguinte código:
```ini
[env:seeed_wio_terminal]
platform = atmelsam
board = seeed_wio_terminal
framework = arduino
```
A seção `[env:seeed_wio_terminal]` tem configuração para o Wio Terminal. Você pode ter várias seções `env` para que seu código possa ser compilado para várias placas.
Os outros valores correspondem à configuração do assistente de projeto:
* `platform = atmelsam` define o hardware que o Wio Terminal usa (um microcontrolador baseado em ATSAMD51)
* `board = seeed_wio_terminal` define o tipo de placa do microcontrolador (o Wio Terminal)
* `framework = arduino` define que este projeto está usando o framework Arduino.
### Escreva o aplicativo Hello World
Agora você está pronto para escrever o aplicativo Hello World.
#### Tarefa - escrever o aplicativo Hello World
Escreva o aplicativo Hello World.
1. Abra o arquivo `main.cpp` no VS Code
1. Altere o código para corresponder ao seguinte:
```cpp
#include <Arduino.h>
void setup()
{
Serial.begin(9600);
while (!Serial)
; // Aguarde até que o Serial esteja pronto
delay(1000);
}
void loop()
{
Serial.println("Hello World");
delay(5000);
}
```
A função `setup` inicializa uma conexão com a porta serial - neste caso, a porta USB que é usada para conectar o Wio Terminal ao seu computador. O parâmetro `9600` é a [taxa de transmissão](https://wikipedia.org/wiki/Symbol_rate) (também conhecida como taxa de símbolo), ou velocidade com que os dados serão enviados pela porta serial em bits por segundo. Essa configuração significa que 9.600 bits (0s e 1s) de dados são enviados a cada segundo. Em seguida, ele espera que a porta serial esteja pronta.
A função `loop` envia a linha `Hello World!` para a porta serial, então os caracteres de `Hello World!` junto com um caractere de nova linha. Em seguida, ele dorme por 5.000 milissegundos ou 5 segundos. Depois que o `loop` termina, ele é executado novamente, e novamente, e assim por diante, o tempo todo em que o microcontrolador permanece ligado.
1. Construa e carregue o código para o Wio Terminal
1. Abra a paleta de comando do VS Code
1. Digite `PlatformIO Upload` para pesquisar a opção de upload e selecione *PlatformIO: Upload*
![A opção de upload do PlatformIO na paleta de comando](../../../../images/vscode-platformio-upload-command-palette.png)
PlatformIO construirá automaticamente o código, se necessário, antes de fazer o upload.
1. O código será compilado e enviado para o Wio Terminal
> 💁 Se você estiver usando o macOS, será exibida uma notificação sobre um *DISCO NÃO EJETADO CORRETAMENTE*. Isso ocorre porque o Wio Terminal é montado como uma unidade como parte do processo de flashing e é desconectado quando o código compilado é gravado no dispositivo. Você pode ignorar esta notificação.
⚠️ Se você receber erros sobre a porta de upload não estar disponível, primeiro certifique-se de ter o Wio Terminal conectado ao seu computador e ligado usando o botão no lado esquerdo da tela. A luz verde na parte inferior deve estar acesa. Se você ainda receber o erro, puxe o botão liga/desliga para baixo duas vezes em rápida sucessão para forçar o Wio Terminal no modo bootloader e tente fazer o upload novamente.
PlatformIO tem um monitor serial que pode monitorar os dados enviados pelo cabo USB do Wio Terminal. Isso permite que você monitore os dados enviados pelo comando `Serial.println("Hello World");`.
1. Abra a paleta de comando do VS Code
1. Digite `PlatformIO Serial` para pesquisar a opção Serial Monitor e selecione *PlatformIO: Serial Monitor*
![A opção PlatformIO Serial Monitor na paleta de comandos](../../../../images/vscode-platformio-serial-monitor-command-palette.png)
Um novo terminal será aberto e os dados enviados pela porta serial serão transmitidos para este terminal:
```output
> Executing task: platformio device monitor <
--- Available filters and text transformations: colorize, debug, default, direct, hexlify, log2file, nocontrol, printable, send_on_enter, time
--- More details at http://bit.ly/pio-monitor-filters
--- Miniterm on /dev/cu.usbmodem101 9600,8,N,1 ---
--- Quit: Ctrl+C | Menu: Ctrl+T | Help: Ctrl+T followed by Ctrl+H ---
Hello World
Hello World
```
`Hello World` será impresso no monitor serial a cada 5 segundos.
> 💁 Você pode encontrar este código na pasta [code/wio-terminal](../code/wio-terminal).
😀 Seu programa 'Hello World' foi um sucesso!
Loading…
Cancel
Save