diff --git "a/docs/Instru\303\247\303\265es/Choregraphe_v4.md" "b/docs/Instru\303\247\303\265es/Choregraphe_v4.md" index 1d9b061..aead319 100644 --- "a/docs/Instru\303\247\303\265es/Choregraphe_v4.md" +++ "b/docs/Instru\303\247\303\265es/Choregraphe_v4.md" @@ -4,7 +4,7 @@ ## O que é o Choregraphe?
- +
**Choregraphe** é um programa da **Softbank Robotics** usado para: @@ -41,13 +41,13 @@ 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`.
- +
Na página que se abre, selecione o **setup** do Choregraphe na versão 2.1.4 (versão usada com o NAO v4).
- +
O download será iniciado. @@ -61,7 +61,7 @@ O download será iniciado. - Marque a caixa `Permitir a execução desse arquivo como um programa`.
- +
- No terminal, abra o diretório onde o setup foi baixado. @@ -72,7 +72,7 @@ O download será iniciado. sudo ./choregraphe-suite-2.1.4.13-linux64-setup.run ```
- +
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: @@ -80,13 +80,13 @@ No wizard que se abre, aceite as permissões, selecione a opção **Quick instal > 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 e clique em `Finish`.
- +
> Obs.: Como alternativa ao processo de instalação manual, pode-se executar o seguinte código: @@ -112,5 +112,5 @@ Para executar o Choregraphe 2.1.4, existem duas maneiras diferentes. Caso a seguinte janela se abra, **parabéns**! Você **instalou o Choregraphe 2.1.4 com sucesso.**
- +
\ No newline at end of file diff --git "a/docs/Instru\303\247\303\265es/Choregraphe_v6.md" "b/docs/Instru\303\247\303\265es/Choregraphe_v6.md" index cf9cf59..78a0f5b 100644 --- "a/docs/Instru\303\247\303\265es/Choregraphe_v6.md" +++ "b/docs/Instru\303\247\303\265es/Choregraphe_v6.md" @@ -4,7 +4,7 @@ ## O que é o Choregraphe?
- +
**Choregraphe** é um programa da **Softbank Robotics** usado para: @@ -41,7 +41,7 @@ Para baixar o Choregraphe 2.8.7, acesse o [site da Aldebaran Robotics](https://w Desça até o sub-menu Choregraphe, e na seção "LINUX (2.8.7 and later)", selecione `Choregraphe 2.8.7 - Binaries`.
- +
Quando o download for concluído, extraia o arquivo _**tar.gz**_ no diretório de sua escolha. @@ -68,13 +68,13 @@ Quando o download for concluído, extraia o arquivo _**tar.gz**_ no diretório d - Na tela que se abre quando se executa o Choregraphe, clique no botão verde com símbolo de conexão (`Connect to...`).
- +
- Na janela que se abre, selecione o primeiro robô e clique em `Select`.
- +
- O robô que aparece por padrão é o **Pepper**, mas vamos mudá-lo para o **NAO**. @@ -83,19 +83,19 @@ Quando o download for concluído, extraia o arquivo _**tar.gz**_ no diretório d - Clique em `Edit` e em `Preferences`.
- +
- Na aba "Virtual Robot", em "Robot Model", selecione `NAO H25 (V6)` e clique em `OK`. Na janela que se abre, confirme.
- +
- Espere um pouco e o robô virtual será reinicializado com o NAO v6.
- +
diff --git "a/docs/Instru\303\247\303\265es/Conceitos_Gerais.md" "b/docs/Instru\303\247\303\265es/Conceitos_Gerais.md" index 2754803..79260be 100644 --- "a/docs/Instru\303\247\303\265es/Conceitos_Gerais.md" +++ "b/docs/Instru\303\247\303\265es/Conceitos_Gerais.md" @@ -3,7 +3,7 @@ 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.
- +
@@ -22,7 +22,7 @@ Para abri-lo, aperte simultaneamente `CTRL`+`ALT`+`T`. Uma tela semelhante a essa se abrirá:
- +
No terminal de exemplo acima: @@ -55,7 +55,7 @@ Para ver os arquivos presentes na pasta atual, podemos digitar o comando `ls`. E **Por exemplo**:
- +
No exemplo acima, usamos o comando `ls` no diretório `~` (no caso, `/home/gustavo/`). Isso gerou uma lista de arquivos presentes nesse diretório. @@ -69,7 +69,7 @@ Para navegar entre diretórios no terminal Linux, usamos o comando `cd - + 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 `~`. @@ -85,7 +85,7 @@ Assim, podemos usar o terminal do Linux para navegar em qualquer diretório do s 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`.
- +
No exemplo acima, estávamos no diretório `~/Área de Trabalho/`. Usando o comando `cd ~/Downloads/Exemplo`, acessamos esse diretório diretamente. @@ -99,7 +99,7 @@ Podemos usar esse comando para limpar o terminal. Basta digitar `clear` na linha **O que são scripts?**
- +
**Scripts** são instruções em sequência que executam alguma ação. Geralmente, utilizam um **_shell_** para executarem tais ações. @@ -125,7 +125,7 @@ Para executar o script, precisamos seguir os seguintes passos: 5. Com esses passos, o script será executado na sua máquina:
- +
> 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. diff --git "a/docs/Instru\303\247\303\265es/Maquina_Virtual.md" "b/docs/Instru\303\247\303\265es/Maquina_Virtual.md" index fbd0fbc..4ea3d23 100644 --- "a/docs/Instru\303\247\303\265es/Maquina_Virtual.md" +++ "b/docs/Instru\303\247\303\265es/Maquina_Virtual.md" @@ -2,7 +2,7 @@ ---
- +
Os robôs NAO utilizam diversos programas para configuração, programação e manutenção. Porém, esses programas são compatíveis com diferentes versões do sistema Linux. @@ -77,19 +77,19 @@ sudo systemctl enable libvirtd - Na aba arquivo, selecione a opção "Nova máquina virtual"
- +
- Selecione "Mídia de instalação ISO ou CDROM" e clique em `Forward`. No próximo menu, clique em `Navegar` e procure a opção `Navegar localmente`
- +
- Selecione o arquivo ISO do Ubuntu, deixe marcado "Detectar automaticamente a partir de mídia(...)" ou selecione a versão desejada manualmente
- +
- Caso apareça uma prompt sobre permissão de acesso, clique em `Sim` @@ -97,8 +97,8 @@ sudo systemctl enable libvirtd - Marque a opção "Habilitar armazenamento para esta máquina virtual" e reserve o espaço desejado (recomendação: pelo menos 20GB)
- - + +
@@ -106,7 +106,7 @@ sudo systemctl enable libvirtd - Clique em `Concluir` para criar a VM
- +
@@ -115,13 +115,13 @@ sudo systemctl enable libvirtd Para iniciar a VM, clique duas vezes sobre a listagem da VM no menu principal do Virt Manager.
- +
Em seguida, clique no botão indicado para inicializar a máquina virtual selecionada:
- +
## Instalando Ubuntu na VM @@ -157,13 +157,13 @@ Para criar os snapshots, siga os passos abaixo: - No menu acima (na janela da VM), existe um botão com o ícone de duas telas de computador (Gerenciar os snapshots da VM), clique nele.
- +
- No canto inferior esquerdo, clique no botão com sinal de "+" (Criar novo snapshot)
- +
- Dê um nome ao snapshot (sem espaços) e adicione uma descrição @@ -174,12 +174,12 @@ Para criar os snapshots, siga os passos abaixo: Para acessar os snapshots criados, siga os passos abaixo: - Certifique-se de que o Virt Manager esteja sendo executado com uma VM aberta -- No menu acima (na janela da VM), abra novamente o menu de snapshots com o botão +- No menu acima (na janela da VM), abra novamente o menu de snapshots com o botão - No navegador à esquerda, selecione o snapshot desejado - No canto inferior esquerdo, clique no botão com ícone de seta (Executar snapshot selecionado)
- +
- Clique em `Sim` para confirmar e retornar ao snapshot selecionado @@ -196,7 +196,7 @@ Para isso, siga os passos a seguir: - Selecione a opção `Redirecionar dispositivo USB` e selecione o dispositivo inserido
- +
- Confira no sistema da VM se o dispositivo foi adicionado \ No newline at end of file diff --git "a/docs/Instru\303\247\303\265es/NAO_Flasher.md" "b/docs/Instru\303\247\303\265es/NAO_Flasher.md" index 3d4e0d8..80b4db2 100644 --- "a/docs/Instru\303\247\303\265es/NAO_Flasher.md" +++ "b/docs/Instru\303\247\303\265es/NAO_Flasher.md" @@ -14,7 +14,7 @@ O NAO Flasher é uma ferramenta que permite a realização de updates no sistema - Na aba "LINUX", clique no botão `NAO Flasher 2.1.0 - Setup`.
- +
- O download do NAO Flasher será iniciado. diff --git "a/docs/Instru\303\247\303\265es/NAOqi-overview_v4.md" "b/docs/Instru\303\247\303\265es/NAOqi-overview_v4.md" index 5f987c6..de8355a 100644 --- "a/docs/Instru\303\247\303\265es/NAOqi-overview_v4.md" +++ "b/docs/Instru\303\247\303\265es/NAOqi-overview_v4.md" @@ -2,7 +2,11 @@ Este é um guia de apresentação de conceitos-chave do framework NAOqi, conhecimento necessário para o início na programação dos robôs da **Aldebaran Robotics**. - +
+ + + +
## O que é? @@ -20,8 +24,8 @@ Este é um guia de apresentação de conceitos-chave do framework NAOqi, conheci - **C++**: o código criado precisa ser compilado para o SO alvo. É necessário usar uma ferramenta de cross-compilação para gerar um código que rode no sistema operacional do robô - o NAOqi SO. Entretanto, a programação em C++ possibilita a criação de um código muito mais rápido em termos de velocidade de execução, tornando o robô mais responsivo.
- - + +
## Conceitos-chave: @@ -38,7 +42,7 @@ Este é um guia de apresentação de conceitos-chave do framework NAOqi, conheci **Autoload.ini**: arquivo localizado no SO do robô, responsável por carregar as bibliotecas quando o robô é iniciado. - + **Módulos locais:** Estão em um mesmo ambiente (processo), e portanto podem compartilhar variáveis e métodos com outros módulos locais. Além disso, apenas um broker é necessário para a conexão entre módulos locais, não precisando de internet para tal conexão. É bem mais rápido que a conexão remota entre módulos. diff --git "a/docs/Instru\303\247\303\265es/NAOqi-overview_v6.md" "b/docs/Instru\303\247\303\265es/NAOqi-overview_v6.md" index 5f987c6..de8355a 100644 --- "a/docs/Instru\303\247\303\265es/NAOqi-overview_v6.md" +++ "b/docs/Instru\303\247\303\265es/NAOqi-overview_v6.md" @@ -2,7 +2,11 @@ Este é um guia de apresentação de conceitos-chave do framework NAOqi, conhecimento necessário para o início na programação dos robôs da **Aldebaran Robotics**. - +
+ + + +
## O que é? @@ -20,8 +24,8 @@ Este é um guia de apresentação de conceitos-chave do framework NAOqi, conheci - **C++**: o código criado precisa ser compilado para o SO alvo. É necessário usar uma ferramenta de cross-compilação para gerar um código que rode no sistema operacional do robô - o NAOqi SO. Entretanto, a programação em C++ possibilita a criação de um código muito mais rápido em termos de velocidade de execução, tornando o robô mais responsivo.
- - + +
## Conceitos-chave: @@ -38,7 +42,7 @@ Este é um guia de apresentação de conceitos-chave do framework NAOqi, conheci **Autoload.ini**: arquivo localizado no SO do robô, responsável por carregar as bibliotecas quando o robô é iniciado. - + **Módulos locais:** Estão em um mesmo ambiente (processo), e portanto podem compartilhar variáveis e métodos com outros módulos locais. Além disso, apenas um broker é necessário para a conexão entre módulos locais, não precisando de internet para tal conexão. É bem mais rápido que a conexão remota entre módulos. diff --git "a/docs/Instru\303\247\303\265es/Robot_Settings.md" "b/docs/Instru\303\247\303\265es/Robot_Settings.md" index c31499f..0a72f97 100644 --- "a/docs/Instru\303\247\303\265es/Robot_Settings.md" +++ "b/docs/Instru\303\247\303\265es/Robot_Settings.md" @@ -23,7 +23,7 @@ Os seguintes passos devem ser realizados dentro da VM com Ubuntu 16.04 ou em um - Deixe selecionado "Save file" e clique em `OK`
- +
### Instalação do Robot Settings diff --git a/docs/overrides/assets/images/IMG_NAO.jpg b/docs/overrides/assets/images/IMG_NAO.jpg new file mode 100644 index 0000000..58200d3 Binary files /dev/null and b/docs/overrides/assets/images/IMG_NAO.jpg differ diff --git a/docs/overrides/equipe.html b/docs/overrides/equipe.html index e7ecde8..3e792f1 100644 --- a/docs/overrides/equipe.html +++ b/docs/overrides/equipe.html @@ -4,7 +4,7 @@ {% block tabs %} {{ super() }} - - - + + +
- Foto do Damarcones com algumas de suas informações + Foto do Damarcones com algumas de suas informações

Formando em Engenharia de Software pela Universidade de Brasília (UnB).
Possui interesse na área de Ciência de Dados e Machine Learning.
Atualmente é Pesquisador Colaborador Júnior II, no Parque de Inovação e Sustentabilidade do Ambiente Construído-UnB (PISAC-UNB), extensionista pela UnB e trabalha no projeto Robo Connection da Residência em TIC do Instituto BRISA.

- Foto do Daniel com algumas de suas informações + Foto do Daniel com algumas de suas informações

Graduando em Engenharia de Software pela Universidade de Brasília (UnB), atualmente no 6° semestre, e Técnico em Eletrônica pela Escola Técnica de Brasília (ETB).
Possui interesse na área de Ciência de Dados, Machine Learning e no Planejamento de Inteligência Artificial.
Atualmente fazendo projeto de Iniciação Científica no ramo de Planejamento de Inteligência Artificial e trabalhando no projeto RoboConnection da Residência em TIC da BRISA.

- Foto do Davi com algumas de suas informações + Foto do Davi com algumas de suas informações

Engenheiro em Eletrônica e Engenheiro de Software pela Universidade de Brasília (UnB).
Possui interesse em Sistemas Embarcados e software livre.
Atualmente trabalha no projeto RoboConnection da Residência em TIC da BRISA e no Banco do Brasil.

- Foto do Gustavo com algumas de suas informações + Foto do Gustavo com algumas de suas informações

Aluno do curso de Bacharelado em Ciência da Computação na Universidade de Brasília (UnB), atualmente cursando o 5º semestre.
Possui interesse na área de Ciência de Dados, Inteligência Artificial e Programação Competitiva.
Atualmente trabalha no projeto Robo Connection da Residência em TIC da BRISA.

- Foto do Matheus com algumas de suas informações + Foto do Matheus com algumas de suas informações

Aluno do curso de Bacharelado em Engenharia de Software na Universidade de Brasília (UnB), atualmente cursando o 3º semestre.
Possui interesse na área de robótica aérea e educacional, além do desenvolvimento web.
Atualmente trabalha no projeto Robo Connection da Residência em TIC da BRISA e líder da área de Controle e Sistemas Embarcados da EDRA - Equipe de Robótica Aérea da UnB.

diff --git a/docs/overrides/home.html b/docs/overrides/home.html index 23b3cae..783c8d8 100644 --- a/docs/overrides/home.html +++ b/docs/overrides/home.html @@ -172,6 +172,7 @@ } #section_3 .flex_3{ + padding-top: 20px; display: flex; flex-flow: row nowrap; justify-content: space-evenly; @@ -200,8 +201,8 @@ #section_3 .flex_3 img{ border-radius: 25px; - border: gray solid 3px; - box-shadow: 0px 6px 10px rgb(89, 107, 113); + border: gray solid 2px; + box-shadow: 0px 5px 5px rgb(89, 107, 113); width: calc(94% / 2); max-width: 870px; } @@ -412,6 +413,16 @@

Solução para a SoftBank Robotics

Imagem de um Robô apresentando a logo da softbank + +
+
+

Na fronteira da educação

+

Os robôs NAO são incríveis ferramentas de aprendizado. Atualmente, o cenário educacional mundial, incluindo o brasileiro, conta com oficinas de robótica para alunos.
Algumas escolas e faculdades utilizam o NAO como ferramenta de aprendizado para estudantes. Além do primeiro contato com essa área da tecnologia, os estudantes vislumbram as incontáveis possibilidades que a robótica humanoide proporciona.
Com guias intuitivos e de fácil entendimento, o Robo Connection é capaz de auxiliar novas escolas e projetos na configuração e implantação de um modelo educacional de robótica viável e seguro.

+
+ + Imagem de um Robô NAO + +
diff --git a/docs/release/index.md b/docs/release/index.md index 9a045bb..ffc46d0 100644 --- a/docs/release/index.md +++ b/docs/release/index.md @@ -2,30 +2,32 @@ hide: - navigation - toc -# Release 1 - V1.0 -A Equipe RoboConnection tem o prazer de anunciar o lançamento da primeira release de nossas ferramentas e documentação para os projetos UnBeatables e EMA. Esta release inclui os seguintes recursos: +# Release 2 - V2.0 +**Temos o prazer de anunciar o lançamento da segunda release do Robo Connection!** ## Documentação -- [x] Documentação para Maquina Virtual (Virt Manager) -- [x] Documentação para Robot Settings -- [x] Documentação para NAO Flasher -- [x] Documentação para Choregraphe (NAOv4 e NAOv6) -- [x] Documentação para SDK de C++ (NAOv4 e NAOv6) -- [x] Documentações para ROS1 (PC e Raspberry Pi), ROS2 (PC e Raspberry Pi) +- [x] Imagens em guias que demandavam recursos visuais +- [x] Novo rodapé +- [x] Novo estilo de página +- [x] Setorização intuitiva dos menus de navegação +- [x] Correção de erros nas documentações +- [x] Criação da página "Home", "Equipe" e "Sobre" +- [x] Criação de guias de uso do SDK de C++, incluindo um Hello World testado no robô +- [x] Recursos de versões anteriores ## Scripts -- [x] Scripts automatizado de instalação do ROS1 e ROS2 +- [x] Scripts de programação do NAO v4 usando SDK C++ (2.1) -## Stackholders +## Stakeholders -- [x] Git Page para acompanhamento do Stackholders +- [x] Git Page para acompanhamento do Stakeholders -Para acessar a Release direto no GitHub use o link a seguir +Para acessar a Release direto no GitHub use o link a seguir:
-[Realease 1 - V1.0](https://github.com/ResidenciaTICBrisa/03_Robotica/releases/tag/v1.0){ .md-button .md-button--primary } +[Release 2 - V2.0](#){ .md-button .md-button--primary }
\ No newline at end of file diff --git a/docs/sobre/equipe.md b/docs/sobre/equipe.md index eb46e6c..3a9929f 100644 --- a/docs/sobre/equipe.md +++ b/docs/sobre/equipe.md @@ -2,3 +2,5 @@ template: equipe.html title: Equipe --- + + \ No newline at end of file diff --git a/mkdocs.yml b/mkdocs.yml index a467af9..3ce4c3f 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -49,9 +49,6 @@ theme: favicon: assets/images/robo.png custom_dir: docs/overrides -extra_css: - - stylesheets/style.css - plugins: - search: lang: @@ -71,29 +68,31 @@ markdown_extensions: - pymdownx.tasklist: custom_checkbox: true - pymdownx.emoji: - emoji_index: !!python/name:materialx.emoji.twemoji + emoji_index: !!python/name:material.extensions.emoji.twemoji emoji_generator: !!python/name:materialx.emoji.to_svg nav: - Home: index.md - - Primeiros Passos: Instruções/Maquina_Virtual.md + - Primeiros Passos: + - Conceitos fundamentais: Instruções/Conceitos_Gerais.md + - Trabalhando com máquinas virtuais: Instruções/Maquina_Virtual.md - Trabalhando com o v4: - Introdução ao NAOqi: Instruções/NAOqi-overview_v4.md - - QEMU-based Virtual Machine and installation scripts: vms/ubuntu-14/how-to-use.md - - NAO Flahser: Instruções/NAO_Flasher.md + - Máquina Virtual e scripts de instalação (v4): vms/ubuntu-14/how-to-use.md + - NAO Flasher: Instruções/NAO_Flasher.md - SDK C++: Instruções/CPP_SDK_v4.md - Choregraphe: Instruções/Choregraphe_v4.md - - C++ examples: naoqi-2.1/cpp/about-the-examples.md + - Exemplos NAOqi C++: naoqi-2.1/cpp/about-the-examples.md - Trabalhando com o v6: - Introdução ao NAOqi: Instruções/NAOqi-overview_v6.md - - QEMU-based Virtual Machine and installation scripts: vms/ubuntu-16/how-to-use.md + - Máquina Virtual e scripts de instalação (v6): vms/ubuntu-16/how-to-use.md - Robot Settings: Instruções/Robot_Settings.md - SDK C++: Instruções/CPP_SDK_v6.md - Choregraphe: Instruções/Choregraphe_v6.md - Extra: - ROS1: - - Instruções: Instruções/ROS_1.md + - Instructions: Instruções/ROS_1.md - General: ros1/general-instructions.md - Precompiled: ros1/installing-precompiled-packages.md - Compiling: ros1/compiling-for-amd64-based-systems.md diff --git a/nao-programs/naoqi-2.1/cpp/about-the-examples.md b/nao-programs/naoqi-2.1/cpp/about-the-examples.md index 303dd90..b9047d7 100644 --- a/nao-programs/naoqi-2.1/cpp/about-the-examples.md +++ b/nao-programs/naoqi-2.1/cpp/about-the-examples.md @@ -48,16 +48,22 @@ problems on their joints or FSRs by checking if the robot has been able to approach the desired posture. This example also uses the NAOqi's abstraction to enable the use of the POSIX `sleep` or `msleep` functions. +## How to find the examples + +1. Go to [Robo Connection repository](https://github.com/ResidenciaTICBrisa/03_Robotica). +2. Enter the `03_Robotica/nao-programs/naoqi-2.1/cpp/` directory. +3. All the examples should be listed and separated by their specific folders. + ## How to run the examples -1. copy the desired example to your `qibuild` workspace. If you used our +1. Copy the desired example to your `qibuild` workspace. If you used our scripts, it should be on `/home/softex/NAO4/workspace`. -2. change the directory to the example you wish to run using the `cd` +2. Change the directory to the example you wish to run using the `cd` command. -3. configure the project's toolchain. If you used our scripts, the command +3. Configure the project's toolchain. If you used our scripts, the command `qibuild configure -c "$NAOQI_CPP_QIBUILD_CONFIG"`. -4. compile the project with `qibuild make` or `qibuild make --rebuild`. -5. run the compiled program. It will usually be located inside a directory +4. Compile the project with `qibuild make` or `qibuild make --rebuild`. +5. Run the compiled program. It will usually be located inside a directory structure such as `build-${NAOQI_CPP_QIBUILD_CONFIG}/sdk/bin`. Most of the examples use arguments to set up a broker, and their order is usually NAO's broker IPv4 or hostname followed by its listening port, usually 9559.