Skip to content

Commit

Permalink
Merge pull request #77 from ResidenciaTICBrisa/pages_v2
Browse files Browse the repository at this point in the history
Atualização Pages v2
  • Loading branch information
mrodrigues14 authored Nov 1, 2023
2 parents 01af39f + 2b05a42 commit 6e259c1
Show file tree
Hide file tree
Showing 84 changed files with 1,122 additions and 75 deletions.
3 changes: 3 additions & 0 deletions .vscode/settings.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
{
"liveServer.settings.port": 5501
}
35 changes: 34 additions & 1 deletion docs/Instruções/Choregraphe_v4.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,10 @@

## O que é o Choregraphe?

<div align=center>
<img src='../overrides/assets/icons/choregraphe.png'/>
</div>

**Choregraphe** é um programa da **Softbank Robotics** usado para:

- Criar animações, comportamentos, diálogos,
Expand Down Expand Up @@ -36,8 +40,16 @@ Para baixar o Choregraphe 2.1.4, acesse o [site da Aldebaran Robotics](https://w

Desça até o sub-menu Choregraphe, e na seção do **LINUX**, clique em `Former versions`.

<div align=center>
<img src='../overrides/assets/images/choregraphe_v4-1.jpeg'>
</div>

Na página que se abre, selecione o **setup** do Choregraphe na versão 2.1.4 (versão usada com o NAO v4).

<div align=center>
<img src='../overrides/assets/images/choregraphe_v4-2.jpg'>
</div>

O download será iniciado.

## Instalação
Expand All @@ -48,19 +60,34 @@ O download será iniciado.

- Marque a caixa `Permitir a execução desse arquivo como um programa`.

<div align=center>
<img src='../overrides/assets/images/choregraphe_v4-3.jpg'>
</div>

- No terminal, abra o diretório onde o setup foi baixado.

- Execute o setup com o seguinte código (supondo que o nome do arquivo baixado seja "choregraphe-suite-2.1.4.13-linux64-setup.run"):

```
sudo ./choregraphe-suite-2.1.4.13-linux64-setup.run
```
<div align=center>
<img src='../overrides/assets/images/choregraphe_v4-4.jpg'>
</div>

No wizard que se abre, aceite as permissões, selecione a opção **Quick install** e, quando for pedida a _license key_, insira o seguinte código:

> 654e-4564-153c-6518-2f44-7562-206e-4c60-5f47-5f45
- Deixe marcada a opção de iniciar (launch) o Choregraphe para testar se a instalação foi feita com sucesso.
<div align=center>
<img src='../overrides/assets/images/choregraphe_v4-5.jpg'>
</div>

- Deixe marcada a opção de iniciar (launch) o Choregraphe para testar se a instalação foi feita com sucesso e clique em `Finish`.

<div align=center>
<img src='../overrides/assets/images/choregraphe_v4-6.jpg'>
</div>

> Obs.: Como alternativa ao processo de instalação manual, pode-se executar o seguinte código:
Expand All @@ -81,3 +108,9 @@ Para executar o Choregraphe 2.1.4, existem duas maneiras diferentes.
2. Pelo terminal

> Execute o seguinte código: `"/opt/Aldebaran Robotics/Choregraphe Suite 2.1/bin/choregraphe_launcher"` (com as aspas).
Caso a seguinte janela se abra, **parabéns**! Você **instalou o Choregraphe 2.1.4 com sucesso.**

<div align=center>
<img src='../overrides/assets/images/choregraphe_v4-7.jpg'>
</div>
47 changes: 40 additions & 7 deletions docs/Instruções/Choregraphe_v6.md
Original file line number Diff line number Diff line change
@@ -1,8 +1,12 @@
# Guia de instalação do Choregraphe 2.8.6 (NAO v6)
# Guia de instalação do Choregraphe 2.8.7 (NAO v6)
---

## O que é o Choregraphe?

<div align=center>
<img src='../overrides/assets/icons/choregraphe.png'/>
</div>

**Choregraphe** é um programa da **Softbank Robotics** usado para:

- Criar animações, comportamentos, diálogos,
Expand Down Expand Up @@ -32,9 +36,13 @@ Ainda que o Choregraphe seja multiplataforma, recomenda-se a instalação no **U

## Download

Para baixar o Choregraphe 2.8.6, acesse o [site da Aldebaran Robotics](https://www.aldebaran.com/en/support/nao-6/downloads-softwares).
Para baixar o Choregraphe 2.8.7, acesse o [site da Aldebaran Robotics](https://www.aldebaran.com/en/support/nao-6/downloads-softwares).

Desça até o sub-menu Choregraphe, e na seção "LINUX (2.8.7 and later)", selecione `Choregraphe 2.8.7 - Binaries`.

Desça até o sub-menu Choregraphe, e na seção "LINUX (2.8.6 and later)", selecione `Choregraphe 2.8.6 - Binaries`.
<div align=center>
<img src='../overrides/assets/images/choregraphe_v6-1.jpg'/>
</div>

Quando o download for concluído, extraia o arquivo _**tar.gz**_ no diretório de sua escolha.

Expand All @@ -43,37 +51,62 @@ Quando o download for concluído, extraia o arquivo _**tar.gz**_ no diretório d
## Execução do programa

**Executando o Choregraphe 2.8.6**
**Executando o Choregraphe 2.8.7**

- Acesse o terminal e execute o Choregraphe diretamente.

**Exemplo**: se o arquivo extraído (`choregraphe-suite-2.8.6.23-linux64`) está em "/meu/diretorio", execute o Choregraphe com:
**Exemplo**: se o arquivo extraído (`choregraphe-suite-2.8.7.23-linux64`) está em "/meu/diretorio", execute o Choregraphe com:

```
"/meu/diretorio/choregraphe-suite-2.8.6.23-linux64/bin/choregraphe_launcher"
"/meu/diretorio/choregraphe-suite-2.8.7.23-linux64/bin/choregraphe_launcher"
```

> **IMPORTANTE**: lembre-se de alterar o caminho no código acima de acordo com o local de extração do tar.gz dos binários baixados!
**Selecionando o robô virtual NAO**

- Na tela que se abre quando se executa o Choregraphe, clique no botão verde com símbolo de conexão (`Connect to...`).

<div align=center>
<img src='../overrides/assets/images/choregraphe_v6-2.jpg'/>
</div>

- Na janela que se abre, selecione o primeiro robô e clique em `Select`.

<div align=center>
<img src='../overrides/assets/images/choregraphe_v6-3.jpg'/>
</div>

- O robô que aparece por padrão é o **Pepper**, mas vamos mudá-lo para o **NAO**.
- Expanda a janela do Choregraphe (clique no botão do lado do botão de fechar janela).
- Com o mouse em cima da barra superior (cinza) da janela do Choregraphe, as opções File, Edit, Connection, View e Help aparecerão.
- Clique em `Edit` e em `Preferences`.

<div align=center>
<img src='../overrides/assets/images/choregraphe_v6-4.jpg'/>
</div>

- Na aba "Virtual Robot", em "Robot Model", selecione `NAO H25 (V6)` e clique em `OK`. Na janela que se abre, confirme.

<div align=center>
<img src='../overrides/assets/images/choregraphe_v6-5.jpg'/>
</div>

- Espere um pouco e o robô virtual será reinicializado com o NAO v6.

<div align=center>
<img src='../overrides/assets/images/choregraphe_v6-6.jpg'/>
</div>


**CASO TENHA ERRO DE DESCONEXÃO DO ROBÔ**

- Caso apareça esse erro, confirme e feche a janela `Preferences`.
- Clique novamente no botão verde `Connect to...`.
- Selecione o primeiro robô e confirme.
- O robô deve ser reiniciado e atualizado para o modelo NAO v6.

> Nota:
> **Nota:**
> Você pode ter problemas com aceleração gráfica se não tiver com os drivers apropriados. Nesse caso, utilize:
> ```./choregraphe --no-ogre```
133 changes: 133 additions & 0 deletions docs/Instruções/Conceitos_Gerais.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,133 @@
# Conceitos iniciais

Antes de qualquer outro guia da **Robo Connection**, é importante entender alguns conceitos importantes sobre **Terminal do Linux e Scripts**. Esses conceitos servirão como ferramentas na conclusão de passos importantes para a programação do NAO.

<div align=center>
<img src='../overrides/assets/images/conceitos_extra2.png' width=300px>
</div>


## 1. Conceitos iniciais sobre o terminal do Linux

O **terminal** ou **linha de comando** do Linux é a interface onde os comandos de controle do sistema serão inseridos. Através dele, podemos **instalar, desinstalar e atualizar** programas, além de podermos **navegar** pelos diretórios do sistema.

**Como um computador funciona?**

O computador sempre **executa códigos na linha de comando**. Quando clicamos em botões e funcionalidades na tela, um processo acontece através de comandos que rodam no terminal sem que saibamos. Isso traz comodidade ao usuário, que nem sempre deseja saber o que ocorre **por trás dos panos**.

**Usando o terminal:**

Para abri-lo, aperte simultaneamente `CTRL`+`ALT`+`T`.

Uma tela semelhante a essa se abrirá:

<div align=center>
<img src='../overrides/assets/images/conceitos1.jpg'>
</div>

No terminal de exemplo acima:

* `gustavo@gustavo-Latitude-3420` (em verde): identifica o usuário e o apelido da máquina usada, respectivamente;
* `~` (em azul): indica o diretório atual. No terminal, '~' equivale ao diretório `/home/usuario/`.

Um diretório nada mais é do que uma pasta. Todo diretório ou arquivo possui um caminho. **Mas o que isso significa**?
Isso significa que, se navegarmos por esse caminho, podemos chegar ao arquivo em questão.

**Por exemplo**: se quero chegar ao diretório `/home/usuário/`, posso sair de `/`, acessar `/home/` e depois acessar `/home/usuário/`.


**Conhecendo o pip**:

O **pip** é o instalador de pacotes do Python. Através dele, podemos instalar pacotes que usaremos na programação do NAO.
A sintaxe de uso do pip para instalação de programas é `pip install <pacote>`.

---

Em suma, o terminal permite a execução de programas de diversas linguagens, instalação de pacotes, edição de texto, dentre outras possibilidades.


### Comandos básicos do terminal Linux

**Comando `ls`: listando arquivos**

Para ver os arquivos presentes na pasta atual, podemos digitar o comando `ls`. Essa ação irá gerar uma lista de arquivos e pastas que se encontram no diretório atual.

**Por exemplo**:

<div align=center>
<img src='../overrides/assets/images/conceitos2.jpg'>
</div>

No exemplo acima, usamos o comando `ls` no diretório `~` (no caso, `/home/gustavo/`). Isso gerou uma lista de arquivos presentes nesse diretório.

Note também que os arquivos em azul são diretórios (pastas). O arquivo em branco possui outro formato.

**Comando `cd`: navegando entre diretórios**

Para navegar entre diretórios no terminal Linux, usamos o comando `cd <diretório>.` Para voltarmos para o diretório "mãe", usamos o comando `cd ..`.

**Por exemplo**:

<div align=center>
<img src='../overrides/assets/images/conceitos_extra.jpg'>
</div>

No exemplo acima, usamos o comando `ls` para listar os arquivos em `~`. Depois, usamos `cd Downloads` para acessar o diretório `~/Downloads/`. Em seguida, usamos o `cd ..` para retornarmos para o diretório "mãe". Ou seja, voltamos para `~`.

Assim, podemos usar o terminal do Linux para navegar em qualquer diretório do sistema.

> Nota: para acessar diretórios com nomes que contenham espaços (como "Área de Trabalho"), sempre use aspas. Se quero acessar `~/Área de Trabalho/`, devo usar o comando `cd ~/'Área de Trabalho'`
**OBS.:** Podemos acessar caminhos mais profundos de uma vez usando o comando `cd`.

**Por exemplo**: dentro de `~` existe o diretório `Downloads`. Dentro de `Downloads` existe um diretório de nome `Exemplo`. Portanto, o caminho desse diretório é `~/Downloads/Exemplo`.

Para chegarmos em `~/Downloads/Exemplo`, não precisamos acessar pasta a pasta. Podemos acessá-lo de qualquer diretório simplesmente usando o comando `cd ~/Downloads/Exemplo`.

<div align=center>
<img src='../overrides/assets/images/conceitos4.jpg'>
</div>

No exemplo acima, estávamos no diretório `~/Área de Trabalho/`. Usando o comando `cd ~/Downloads/Exemplo`, acessamos esse diretório diretamente.

**Comando `clear`: limpando o terminal**

Podemos usar esse comando para limpar o terminal. Basta digitar `clear` na linha de comando e apertar `ENTER`. Com isso, o terminal será limpo. Isso não muda o diretório atual.

## 2. Conceitos básicos sobre scripts

**O que são scripts?**

<div align=center>
<img src='../overrides/assets/icons/Bash.png' width=200px>
</div>

**Scripts** são instruções em sequência que executam alguma ação. Geralmente, utilizam um **_shell_** para executarem tais ações.
Um **shell** é uma ponte entre o usuário e o sistema operacional. Através do shell, o usuário acessa as funcionalidades do sistema operacional. Um shell pode ser de dois tipos:

1. **CLI (Command Line Interface)** - São interfaces em que podemos **digitar códigos** e ações serão executadas, assim como o Terminal do Linux ou outros ambientes de desenvolvimento.
2. **GUI (Graphical User Interface)** - São interfaces que possuem **recursos visuais (botões, campos, etc.)** para executar ações. Um exemplo é o Windows Explorer, da Microsoft.

Assim, no seguimento dos tutoriais da **Robo Connection**, utilizaremos o **Bash** como linguagem de comando, sendo este o shell CLI padrão do Linux.

Os scripts bash possuem a extensão **".sh"**.

**Ok, mas como executar um script?**

Suponha que queremos executar um script que está em `~/Downloads/`. Seu nome é `meuscript.sh`. Esse script imprime **"Hello World"** na tela.

Para executar o script, precisamos seguir os seguintes passos:

1. Vá até o local do script usando o comando `cd`. No caso, usamos `cd ~/Downloads/`.
2. **(Recomendado)** Use o comando ls para pegar o nome do script corretamente. Erros de escrita no nome do script resultarão em erro.
3. Permita a execução do script como um programa. Para isso, execute o comando `chmod +x <nome_do_script>`. No exemplo, usamos `chmod +x meuscript.sh`.
4. Execute o script como _superuser_. Para fazer isso, utilize o comando `sudo ./<nome_do_script>`. No exemplo, usamos `sudo ./meuscript.sh`.
5. Com esses passos, o script será executado na sua máquina:

<div align=center>
<img src='../overrides/assets/images/conceitos5.jpg'>
</div>

> Nota: a permissão de **_superuser_ (ou _sudo_)** é análogo ao ato de executar um programa como administrador (Windows). Isso garante que não haverão falhas de permissão na execução do programa. **Alguns programas exigirão** a permissão _sudo_ para serem executados.
### Se você chegou até aqui, **parabéns**! Você está apto a prosseguir com os guias da **Robo Connection**!
Loading

0 comments on commit 6e259c1

Please sign in to comment.