wwwelab - User contributions [en]

Kit experimental de polarização da luz com múltiplos polarizadores

2026-05-26T23:35:28Z

Ist1106345: fixed index of software

=Descrição do kit experimental=

{|
|[[File:exploded_kit_view.png|thumb|x250px|Left|Vista explodida do kit experimental.]]
|[[File:exploded_kit_view_1.png|thumb|x250px|Left|Vista explodida do kit experimental.]]
|}

A montagem do kit experimental de polarização da luz com múltiplos polarizadores é composta por três componentes principais: (i) a componente mecânica composta por peças de plástico impressas em 3D, cujos desenhos técnicos estão disponíveis aqui, (ii) um raspberry Pi que executa o software de controlo através da internet e ainda realiza o streaming do vídeo, e (iii) a componente eletrónica do controlador escravo de baixo nível que está responsável pela deteção e motorização do kit experimental.

=Montagem Mecânica=

{|
|[[File:Imagem_Experiência_1.jpg|thumb|x250px|Top|Vista de cima do kit experimental]]
|[[File:Imagem_Experiência_2.jpg|thumb|x250px|Top|Vista frontal do kit experimental]]
|}

Nesta parte, a montagem mecânica do kit experimental é explicada em detalhe para poder ser corretamente montada.

==Ordem de Montagem==

1. Verificar se todas as peças necessárias à montagem estão disponíveis.
{|
|[[File:parts_needed_.png|thumb|x400px|Top|Peças necessárias para a montagem]]
|}

2. Retirar os suportes de impressão das polias com a ajuda de pinças ou de um X-Acto.
{|
|[[File:peeled_support_1.jpg|thumb|x250px|Top|Retirar os suportes]]
|[[File:peeled_support_2.jpg|thumb|x250px|Top|Retirar os suportes]]
|}

3. Colocar as correias nas polias.
{|
|[[File:belt_on_pulley.jpg|thumb|x250px|Top|Correia na polia]]
|}

4. Ligar as polias aos suportes dos polarizadores. Ouvir um “click” para saber que estão bem ligados. Adicionalmente, colocar os polarizadores nos suportes. (Não esquecer de retirar as películas protetoras dos polarizadores, caso seja necessário)
{|
|[[File:pulley_polarizer.jpg|thumb|x250px|Top|Posição de ligação das polias com os polarizadores]]
|[[File:pulley_polarizer_connected.jpg|thumb|x250px|Top|Polia e polarizador ligados]]
|}

5. Repetir os passos 2, 3 e 4 até ter a corrente de polias e polarizadores completa. (Não esquecer de ter as correias nas polias, que não estão representadas na figura.)
{|
|[[File:pulley_polarizer_chain.jpg|thumb|x250px|Top|Corrente de polias e polarizadores]]
|}

6. Cortar as camadas finas de suporte que tapam os furos das placas principais da estrutura.
{|
|[[File:thin_layer_cutting_process.jpg|thumb|x250px|Top|Corte das finas camadas de suporte]]
|[[File:thin_layer_cut.jpg|thumb|x300px|Top|Placas principais depois de cortadas]]
|}

7. Juntar dois dos quatro pilares e colocar as porcas nos buracos específicos no topo dos pilares.
{|
|[[File:nuts_on_pillars.jpg|thumb|x250px|Top|Porcas colocadas nos pilares]]
|}

8. Ligar os dois pilares colocando os parafusos nos furos específicos.
{|
|[[File:bolts_on_pillars.jpg|thumb|x250px|Top|Parafusos colocados]]
|[[File:pillars_bolted_together.jpg|thumb|x250px|Top|Pilares ligados]]
|}

9. Juntar as placas principais nesta posição.
{|
|[[File:junction_placement.jpg|thumb|x250px|Top|Posicionamento das placas principais (igual ao posicionamento da imagem do passo 1]]
|}

10. Colocar os pilares ligados no canto da junção das placas principais.
{|
|[[File:main_plates_placement.jpg|thumb|x250px|Top|Posicionamento dos pilares ligados na junção]]
|}

11. Colocar os suportes da corrente no outro lado das placas principais, de modo a que fiquem em lados opostos. Verificar se o suporte da corrente está colocado em cima dos furos hexagonais.
{|
|[[File:chain_support_opposite_to_pillars.jpg|thumb|x250px|Top|Posicionamento do suporte da corrente]]
|[[File:chain_support_in_position.jpg|thumb|x250px|Top|Posicionamento do suporte da corrente]]
|}

12. Colocar as porcas nas "caixas" mais próximas da "parede" do suporte da corrente.
{|
|[[File:nuts_placement.png|thumb|x250px|Top|Posicionamento das porcas]]
|}

13. Colocar os parafusos nos pilares ligados para aparafusar os pilares às placas e ao suporte da corrente.
{|
|[[File:bolts_placement.png|thumb|x250px|Top|Colocar os parafusos nos furos destacados]]
|}

14. Colocar as porcas no resto das "caixas" do suporte da corrente.

15. Colocar os parafusos através das placas principais para aparafusar o suporte da corrente às placas.
{|
|[[File:bolt_chain_support.jpg|thumb|x250px|Top|Aparafusar os pilares às placas principais e ao suporte da corrente]]
|}

16. Repetir os passos 7 e 8.

17. Ir para o lado oposto das placas principais e colocar os pilares aparafusados debaixo dos furos circulares.

18. Colocar as porcas dentro das "caixas" superiores dos pilares aparafusados.

19. Colocar o parafuso através das placas principais de modo a aparafusá-las aos pilares aparafusados.
{|
|[[File:bolt_the_other_pillars.jpg|thumb|x250px|Top|Aparafusar os outros pilares]]
|}

20. Ligar a corrente aos suportes da corrente, tanto ao aparafusado como ao solto.
{|
|[[File:chain_in_place.jpg|thumb|x250px|Top|Posição da estrutura (corrente + suportes)]]
|}

21. Colocar as porcas dentro das "caixas" próprias do suporte da corrente que está solto.

22. Colocar os parafusos através dos furos das placas principais para ligar o suporte da corrente solto às placas principais.
{|
|[[File:fully_bolted_chain.jpg|thumb|x250px|Top|Estrutura da corrente aparafusada]]
|}

23. Escolher um dos pilares ainda não usados e colocar uma porca na "caixa" do meio.
{|
|[[File:nut_middle_box.jpg|thumb|x250px|Top|Porca na "caixa" do meio]]
|}

24. Colocar o pilar debaixo das placas principais num dos cantos.

25. Colocar um parafuso através do furo nas placas principais para juntá-las ao pilar.
{|
|[[File:corner_placement.jpg|thumb|x250px|Top|Posicionamento do pilar no canto]]
|}

26. Repetir os passos 23, 24 e 25 até que os quatro cantos da estrutura estejam suportados.

27. Remover os pequenos pilares que tapam a entrada das porcas nas "caixas" da superfície inferior das placas principais.
{|
|[[File:remove_small_pillars_1.jpg|thumb|x250px|Top|Remoção dos pequenos pilares]]
|[[File:remove_small_pillars_2.jpg|thumb|x250px|Top|Remoção dos pequenos pilares]]
|}

28. Colocar as porcas dentro dessas "caixas".
{|
|[[File:nuts_on_main_plate_1.jpg|thumb|x250px|Top|Colocação das porcas na placa principal]]
|[[File:nuts_on_main_plate_2.jpg|thumb|x250px|Top|Colocação das porcas na placa principal]]
|}

29. Colocar o suporte do motor de passo por cima dos furos da placa principal onde se puseram as porcas.

30. Colocar os parafusos através dos furos do suporte do motor de passo de modo a ligá-lo à placa principal.
{|
|[[File:stepper_holder_placement.jpg|thumb|x250px|Top|Colocação do suporte do motor de passo na placa principal]]
|}

31. Repetir os passos 28, 29 e 30 para os outros quatro suportes do motor de passo.

32. Colocar o motor de passo no suporte do motor de passo, pondo primeiro os cabos através do furo superior e inferior do suporte. Depois, apertar/colocar o motor de passo até se ouvir um click para garantir que este está fixo na posição correta. NOTA: a ligação dos cabos depende do driver, não é confiável usar as cores dos cabos.
{|
|[[File:wires_placement.jpg|thumb|x250px|Top|Posição de entrada dos cabos]]
|}

33. Repetir o passo 32 para os outros quatro motor de passo.
{|
|[[File:stepper_placement.jpg|thumb|x250px|Top|Posicionamento do motor de passo]]
|}

34. Colocar a correia na polia.

35. Ligar a polia (com a correia) ao motor de passo.
{|
|[[File:motor_placement.jpg|thumb|x250px|Top|Colocação do motor de passo com a correia]]
|}

36. Apertar a polia do motor de passo.
{|
|[[File:motor_tightened.jpg|thumb|x250px|Top|Apertamento da polia]]
|}

37. Ajustar a posição do suporte do motor de passo de modo a garantir que a correia está à tensão.
{|
|[[File:adjust_stepper_holder_position.jpg|thumb|x250px|Top|Suporte do motor de passo demasiado perto da corrente (correia está com folga)]]
|}

38. Apertar os parafusos do suporte do motor de passo de modo a fixá-lo.
{|
|[[File:stepper_holder_position_adjusted.jpg|thumb|x250px|Top|Segurador do motor de passo na posição correta]]
|}

39. Repetir os passos 34, 35, 36, 37 e 38 para os outros quatro suportes dos motores de passo.

40. Montagem Completa.

=Circuito Eletrónico=

Este kit experimental tem duas componentes eletrónicas principais, (i) os drivers para os motores do motor de passo e (ii) a fonte de luz e deteção.

==Montagem da Componente Eletrónica==

1. Verificar se todas as peças necessárias à montagem da componente eletrónica estão disponíveis.
{|
|[[File:electric_assembly_parts.jpg|thumb|Peças necessárias para a montagem da componente eletrónica.]]
|}

2. Pegar na base esquerda da componente eletrónica (verificar a imagem abaixo) e usar um ferro de solda para inserir os insertos roscados nos furos da base, através do processo de inserção térmica.
{|
|[[File:electric_assembly_left_floor.jpg|thumb|Base esquerda da componente eletrónica.]]
|[[File:insercao_termica.jpg|thumb|Inserção térmica.]]
|}

3. Pegar na caixa do Arduino Mega (verificar a imagem abaixo) e aparafusá-la à base da componente eletrónica.
{|
|[[File:arduino_case.jpg|thumb|Caixa do Arduino Mega.]]
|}

4. Usar um ferro de solda para inserir os insertos roscados nos furos da caixa, através do processo de inserção térmica.
{|
|[[File:arduino_case_holes.jpg|thumb|Furos da caixa do Arduino Mega.]]
|}

5. Pegar num dissipador de calor.
{|
|[[File:Heat_Sink.jpg|thumb|Dissipador de Calor.]]
|}

6. Retirar a película de papel.
{|
|[[File:paper_protection_removal.jpg|thumb|Retirar a película de papel.]]
|[[File:paper_removed.jpg|thumb|Retirar a película de papel.]]
|}

7. Colar o dissipador de calor ao driver do motor de passo.
{|
|[[File:heat_sink_placement.jpg|thumb|Colagem do dissipador de calor.]]
|[[File:heat_sink_placed.jpg|thumb|Colocação do dissipador de calor.]]
|}

8. Repetir os passos 1, 2 e 3 para os cinco drivers.

9. Colocar o driver do motor de passo na placa RAMPS 1.4 (RepRap Arduino Mega Pololu Shield)
{|
|[[File:Placa_RAMPS.jpg|thumb|Placa RAMPS 1.4.]]
|[[File:Placa_RAMPS_software.png|thumb|Placa RAMPS 1.4 (vista do software).]]
|}

10. Certificar que o driver fica bem colocado, ou seja que a ligação ao ground está como indicado na imagem e que o parafuso (potenciómetro) se encontra do lado oposto à fonte de alimentação (no caso dos drivers verdes ou encarnados) ou do lado da fonte de alimentação (no caso dos drivers roxos).
{|
|[[File:drivers.png|thumb|Modelos de drivers.]]
|[[File:driver_placement_software.png|thumb|Colocação do driver roxo (vista do software).]]
|[[File:driver_placement_green.png|thumb|Colocação do driver verde e roxo.]]
|}

11. Repetir os passos 5 e 6 para os cinco drivers.
{|
|[[File:driver_placement.jpg|thumb|RAMPS 1.4 com os drivers colocados.]]
|}

12. Ligar os interruptores de curso aos cabos.
{|
|[[File:switches_wires.jpg|thumb|Ligação dos interruptores de curso aos cabos.]]
|}

13. Colocar os interruptores de curso no segurador dos interruptores. Garantir que se houve um "click".
{|
|[[File:switches_placement.png|thumb|Posicionamento dos interruptores no segurador.]]
|}

14. Ligar os cabos dos motores de passo e dos interruptores de curso aos drivers através da placa RAMPS 1.4. Verificar a ligação dos cabos aos pinos da placa de acordo com a informação presente na subsecção [[#Drivers dos motores de passo|Drivers dos motores de passo]].
{|
|[[File:stepper_wires_placement.jpg|thumb|Colocação dos cabos na placa RAMPS 1.4.]]
|[[File:stepper_wires_placement_software.png|thumb|Colocação dos cabos na placa RAMPS 1.4 (vista do software).]]
|[[File:switches_wires_placement_software.png|thumb|Cabos dos interruptores de curso (verde) e cabos dos motores de passo (azul) (vista do software).]]
|}

15. Montar o circuito elétrico do fotodiodo e do detetor.
{|
|[[File:photodiode_circuit.jpg|thumb|Esquema do circuito elétrico do fotodiodo e do detetor.]]
|}

16. Colocar o circuito elétrico no canto da caixa, posicionando-a de acordo com os furos, e aparafusá-la.
{|
|[[File:electric_circuit.jpg|thumb|Posicionamento dos interruptores no segurador.]]
|}

17. Pegar na parte de cima da caixa do Arduino Mega e aparafusá-la à parte de baixo (ter atenção aos cabos ao fechar a caixa).
{|
|[[File:arduino_top_case.jpg|thumb|Parte de cima da caixa do Arduino Mega.]]
|}

18. Repetir o passo 2 para a base direita.
{|
|[[File:electric_assembly_right_floor.jpg|thumb|Base direita da componente eletrónica.]]
|}

19. Colocar a fonte de alimentação na base direita e aparafusá-la.
{|
|[[File:power_supply.jpg|thumb|Fonte de alimentação.]]
|[[File:power_supply_top_view.jpg|thumb|Vista de cima da fonte de alimentação.]]
|}

20. Pegar na parte de baixo da caixa do Raspberry Pi e repetir o passo 4.
{|
|[[File:raspberry_pi_case.jpg|thumb|Caixa do Raspberry Pi.]]
|}

21. Aparafusar o Raspberry Pi à caixa.
{|
|[[File:raspberry_pi.jpg|thumb|Raspberry Pi.]]
|}

22. Prender a parte do meio da caixa do Raspberry Pi à parte de baixo.

23. Colocar a tampa para fechar a caixa.

==Drivers dos motores de passo==
[[file:StepMotorCable.jpg | Numeração das ligações a cabo do motor de passo|thumb|120px]]
Os drivers dos motores de passo podem ter múltiplos designs de output de acordo com cada produtor. Os pinos dos motores de passo estão numerados de 1 a 6, da esquerda para a direita da vista frontal (eixo do montor de frente e conector virado para baixo).
A posição dos drivers no arduino relaciona-se com os motores de passo de acordo com o seguinte esquema:

{| border="1" style="width:150px; height:150px; text-align:center;"
|+ Ligação do driver para o motor de passo
| style="width:66px; height:66px;" | 5
| style="width:66px; height:66px;" | 3
| style="width:66px; height:66px;" | N/A
|-
| style="width:66px; height:66px;" | 1
| style="width:66px; height:66px;" | 2
| style="width:66px; height:66px;" | 4
|}

Usando um cabo próprio, as ligações devem seguir as indicações da tabela em baixo:
{| border="1" style="text-align: center;"
|+ Ligações do driver para o motor de passo
|-
!Pinos da motherboard
!Cor dos cabos
!Pino do motor de passo (A4988)
!Pino do motor de passo (DRV8825)
|-
|2B
|Encarnado
|
|6
|-
|2A
|Verde
|
|3
|-
|1A
|Preto
|
|1
|-
|1B
|Azul
|
|4
|-
|}

==Fonte de luz e deteção==
[[File:NPolarizersElectronicCircuit.png|thumb|Esquema para a ligação LED PWM com o pino A4 da placa de controlo e do filtro.]]

O LED encarnado é alimentado por um pino de output PMW (A4) da placa de controlo principal, o que permite uma intensidade da luz variável. O PWM padrão da placa tem uma modulação de 490Hz em passos de 1/256, permitindo uma resolução inferior a 0.5%.

Após passar pela cascata de polarizadores, o sinal é detetado por um fotodiodo. Este fotodiodo é polarizado inversamente com um resistor ligado ao ground para gerar um sinal nulo quando não há luz presente.

Esta frequência tem de ser filtrada por um filtro RC de primeira ordem passa-baixo. Como a constante do tempo é ~1s, é necessário adiar a primeira aquisição para a configuração das tensões do circuito. Assim sendo, o sinal varia suave e lentamente devido à rotação dos polarizadores, e a sobreamostragem está em vigor, é necessário um tempo de estabilização muito menor.

=Caminho Óptico=
[[File:Polarizer optical circuit.png|thumb|x120px|Top|Caminho óptico mostrando o sistema de colimação que permite que a luz passe através da cascata de polarizadores em raios paralelos.]]
O caminho óptico consiste numa fonte de luz (1) (LED encarnado) colocado no ponto focal de uma lente semiesférica (2) onde os raios de luz são colimados num feixe de luz paralelo.

Depois a luz é polarizada por um polarizador fixo (3) antes de entrar na cascata de polarizadores com inclinação variável (4). Esta cadeia escurece a luz de acordo com cada ângulo do polarizador e, em seguida, passa pela segunda lente para focalizar no detetor, um fotodiodo (6).

Antes de chegar ao fotodiodo, a luz pode passar por um filtro encarnado (5) para diminuir a largura de banda e limitar o ruído externo. Este filtro não é totalmente necessário e pode ser substituído por um papel celofane encarnado ou simplesmente retirado no caso de uma estrutura plástica totalmente opaca.

==Alinhamento do Caminho Óptico==
A estrutura principal do kit experimental tem a luz a propagar-se em raios paralelos através da cascata de polarizadores. Estes raios, posteriomente, são centralizados no sensor (fotodiodo). Para obter uma boa leitura da relação sinal-ruído é crucial ter esta estrutura perfeitamente alinhada. Assim sendo, a posição linear do LED emissor e do fotodiodo deve ser ajustada de acordo com o seguinte procedimento:

#Primeiramente, montar a fonte de luz (LED) e as lentes da estrutura;
#Alimentar o LED e seguir a imagem circular emergente do output, ex. projetá-la numa parede afastada um par de metros;
#Mover a posição do LED de modo a obter uma imagem de output o mais próxima do tamanho do círculo de saída possível (~30mm);
#Instalar a estrutura para a cascata de polarizadores sem colocar as lentes ou películas polarizadoras;
#Para focar a luz no fotodiodo, colocar a segunda lente de colimação;
#Usando um voltímetro para ler a intensidade da luz recebida pelos terminais do fotodiodo, mover para trás e para a frente a posição do fotodiodo a fim de maximizar o sinal;
#Colar firmemente a fonte de luz e o fotodiodo nas suas posições finais.

==Calibração do Caminho Óptico==

Assim que a montagem mecânica estiver completa, é necessário calibrar a posição absoluta de cada polarizador; efetivamente todos os polarizadores vão ter um pequeno offset, resultando num erro sistemático. Deste modo, é importante anotar os valores dos ângulos que maximizam a transmissividade.

O primeiro polarizador é fixo e deve ser posicionado com um pequeno offset com o intuito de evitar começar a experiência a partir de um máximo, permitindo uma fácil observação de tal máximo. Aconselha-se colocá-lo entre os 15 e os 30 graus e prendê-lo eficazmente, se necessário usando até cola.
Depois, começar o procedimento de calibração inserindo o segundo polarizador e rodando-o até que os máximos serem detetados e medidos (normalmente são dois). Anotar o seu valor e deixar o segundo polarizador nessa posição. De seguida, inserir o terceiro polarizador e repetir o procedimento de deteção e anotação dos máximos. Repetir este passo para todos os restantes polarizadores.
Todas as vezes que lentes ou películas polarizadoras são instaladas precisam de ser bem fixas ou coladas. No caso do uso da cola, ''garantir que não danifica as lentes/películas polarizadoras''.

No final, uma tabela com os máximos ângulos de transmissão é obtida, indicando o valor de referência para a intensidade máxima na cascata de polarizadores.

Posteriormente, ao realizar experiências, os valores de offset devem ser tidos em conta de modo a eliminar o erro sistemático do sistema.

= Software =
Para utilizar corretamente a experiência, os comandos e a recolha de dados têm de estar operacionais. Isto pode ser alcançado de duas formas, atuando através da ligação série ao Arduino Mega.

O firmware existente no Arduino é capaz de (i) configurar a experiência, (ii) executar e recolher os dados gerados, e (iii) executar algumas funções especializadas de forma a testar, calibrar e manter a experiência. Para interagir com o firmware, pode-se usar um código proxy em Python (camada de software de alto nível) capaz de comunicar com o servidor FREE, ou um emulador de terminal como o Minicom, disponível para Linux, que permite enviar e receber dados através da ligação série.

== Proxy FREE do Raspberry ==
O Raspberry Pi é responsável por transmitir o feed de vídeo da experiência e estabelecer a comunicação com o Servidor FREE utilizando uma interface proxy. O FREE aloja a interface gráfica do utilizador (GUI) para os clientes. Esta secção fornece uma visão geral concisa do procedimento utilizado para controlar todos os componentes eletrónicos através do Arduino, bem como dos protocolos de comunicação entre o Arduino e o Servidor FREE.

=== Modelo de comunicação entre o Servidor FREE e o Raspberry PI ===
A comunicação entre o servidor e a experiência segue o protocolo estruturado do e-lab que permite a interação e troca de dados em tempo real. O servidor central, Exp Server, atua como um intermediário entre os utilizadores e o aparelho experimental (RPi Server). Os utilizadores interagem com o Exp Server através de uma interface web feita com Django, uma framework web de alto nível em Python, para configurar e controlar os parâmetros da experiência, enquanto o Exp Server retransmite diretamente estes comandos para a configuração experimental.

A comunicação entre o Exp Server e o RPi Server ocorre através da internet utilizando mensagens no formato JSON, garantindo flexibilidade entre diferentes configurações experimentais. A autenticação é realizada na fase de ligação, onde o RPi Server transmite um ID e uma chave secreta para verificação. Uma vez autenticado, o Exp Server envia um ficheiro de configuração específico da experiência para o RPi Server, que depois estabelece a comunicação com o controlador local utilizando o protocolo predefinido [7]. Durante toda a experiência, o RPi Server troca continuamente atualizações de estado, resultados experimentais e mensagens de erro com o servidor XP, garantindo uma operação sincronizada e acessibilidade de dados em tempo real para os utilizadores.

=== Modelo de comunicação entre o Raspberry PI e o Arduino Mega ===
Para permitir uma comunicação perfeita entre o Arduino e o Raspberry Pi 4, foi implementado o protocolo ReC Generic Drive 11, permitindo ao utilizador externo ter controlo total sobre a experiência e o seu estado através de um conjunto de comandos. O ReC Generic Drive é um protocolo de comunicação genérico concebido para laboratórios remotos, facilitando a interação entre um controlador de software (driver) e o hardware experimental. Permite uma comunicação contínua através de portas série (RS232), utilizando mensagens estruturadas onde os comandos do driver estão em minúsculas e as respostas do hardware em maiúsculas.

O protocolo garante a sincronização através do "handshaking" de mensagens e do tratamento de tempos limite (timeouts), suportando funções como identificação, configuração, transmissão de dados, configuração da experiência e relatório de erros.

Ao ler a porta série do Arduino a uma taxa de transmissão (baud rate) de 115200 bits por segundo, o utilizador envia uma cadeia de bits (terminando com o carácter \r).

== Instruções de Configuração para Administradores ==
Para implementar uma nova instância da experiência do multi-polarizador, o proxy do Raspberry Pi e o firmware do Arduino devem ser configurados e compilados. Siga estes passos para garantir uma inicialização correta:

<ol>
<li>Descarregar o repositório da experiência via SSH:
<pre>git clone https://github.com/farrucho/multi-polarizer.git</pre></li>

<li>Modificar o ID da experiência em `main.cpp` para corresponder à configuração do servidor FREE:
<pre>expr.begin("ELAB_FIVEPOLARIZER");</pre></li>

<li>Ajustar as direções dos motores e a tensão de referência em `user_define.cpp`:
<pre>uint8_t resetDir = HIGH; // Direção para acionar o interruptor. Teste movendo para trás para garantir que aciona corretamente.
uint8_t dirToTop = LOW;
int vrefMode = 1;</pre></li>

<li>Identificar a porta série do Arduino:
<pre>ls /dev/tty*</pre>
Atualizar o ficheiro `platformio.ini` com a porta correta (ex., `monitor_port = /dev/ttyACM0`).</li>

<li>Compilar e carregar o firmware utilizando o PlatformIO a partir da pasta `e-lab`:
<pre>pio run -t upload -t monitor -t clean</pre></li>

<li>Configurar o script de arranque do proxy editando `/etc/rc.local`:
<pre>sudo nano /etc/rc.local</pre>
Adicionar as seguintes linhas antes de `exit 0`:
<pre>_IP=$(hostname -I) || true
if [ "$_IP" ]; then
printf "My IP address is %s\n" "$_IP"
fi
sleep 120
cd /home/elab/RPi_Proxy_fivepol
su elab -c "sh start-wp.sh &"</pre></li>

<li>Ativar o serviço `rc-local` no arranque utilizando o `systemctl`:
<pre>sudo systemctl enable rc-local
sudo systemctl start rc-local</pre></li>
</ol>

---

= Firmware =
A programação foi feita em linguagem C++ sem recurso a bibliotecas externas. Para declarar um componente no código, basta fornecer o pino de entrada correspondente e aceder à função de ativação (enable) para o inicializar, bem como à função `isTrigger` para verificar se o valor lógico lido corresponde ao estado de acionamento do componente. Neste caso particular, o interruptor é ativado com um sinal LOW (baixo). Uma vez que todos os objetos e respetivos componentes precisam de ser inicializados e desligados, cada um possui funções correspondentes de enable/disable. Os componentes ligados a pinos de leitura simples, declarados como `pinMode` (como interruptores e fotodíodos), não requerem uma função de desativação, pois o `pinMode` não impede a leitura dos pinos, servindo antes para definir o tipo de entrada a ser processada.

De modo a rodar os motores de passo, a operação consiste em enviar um pulso cada vez que se pretende uma rotação de 1.8º (0.36º efetivos). Como diferentes valores de RPM requerem diferentes intervalos de pulso, a frequência de pulsos enviados tem de ser calculada em conformidade. Para executar uma sequência discreta de passos com base num dado ângulo em graus, foi implementada a função rotate. O motor roda para o múltiplo inteiro inferior mais próximo de 1.8º em relação ao ângulo fornecido.

O intervalo de aquisição de dados é crucial para a experiência final, uma vez que o objetivo é otimizar a utilização, minimizando os tempos de espera na recolha da intensidade da luz e dos dados do ângulo de varrimento. Para contornar isto, foi utilizada uma RPM global de 600 rotações por minuto. Com um limite de varrimento de 324º, o tempo de aquisição de dados medido experimentalmente para varrer um ou mais polarizadores em simultâneo foi de aproximadamente 40 segundos.

Para refinar ainda mais as leituras de tensão do fotodíodo, foi implementada uma média aritmética de N pontos na função de leitura de tensão do fotodíodo. Ao calcular a média aritmética sobre 13 pontos do valor medido, o desvio padrão desta média reduz o desvio padrão original em ≈ 27.14%. Esta redução foi considerada aceitável para a experiência, uma vez que o ajuste de dados efetuado foi bem-sucedido.

== Depuração pelo Utilizador e Comandos Série ==
Para testes manuais de hardware e calibração, os administradores podem enviar comandos série diretos para o Arduino utilizando um emulador de terminal como o Minicom.

Ligue-se ao terminal utilizando a porta correta identificada anteriormente:
<pre>minicom -D /dev/ttyACM0</pre>

Ao enviar um ponto de interrogação `?` e pressionar Enter, o firmware irá devolver um menu de ajuda listando todos os comandos disponíveis. Abaixo encontra-se a explicação para cada comando suportado:

{| class="wikitable"
! Comando !! Parâmetros !! Descrição
|-
| `cur` || Nenhum || Retorna os parâmetros configurados atualmente.
|-
| `str` || Nenhum || Inicia o varrimento da experiência com base nos parâmetros configurados previamente.
|-
| `stp` || Nenhum || Para imediatamente a experiência e interrompe todos os movimentos dos motores.
|-
| `rst` || Nenhum || Repõe e move todos os motores de passo para a posição inicial (home), recuando até que os respetivos interruptores de fim de curso sejam acionados.
|-
| `ids` || Nenhum || Retorna a string de identificação do hardware e do firmware.
|-
| `cfg` || `theta1 theta2 theta3 theta4 theta5` || Configura as posições iniciais ou alvo (em passos) para cada um dos 5 polarizadores. Os limites são restringidos por `MAXIMUM_STEP`.
|-
| `led` || `on [0:255]` ou `off` || Controla a intensidade do LED vermelho utilizando Modulação por Largura de Pulso (PWM). O valor varia de 0 (desligado) a 255 (brilho máximo).
|-
| `lamp` || `on [0:255]` ou `off` || Controla a intensidade da fonte de luz auxiliar utilizando Modulação por Largura de Pulso (PWM). O valor varia de 0 (desligado) a 255 (brilho máximo).
|-
| `set maxstep` || `[0:1000]` || Define o limite mecânico máximo permitido para os polarizadores. Por predefinição, 900 passos correspondem ao limite físico de 900*0.36º=324.0º.
|-
| `set vref` || `[1:3]` || Ajusta a tensão de referência do Conversor Analógico-Digital (ADC) para evitar a saturação do fotodíodo dependendo da intensidade da luz. (1: Vref = 1.1V, 2: Vref = 2.56V, 3: Vref = 5V).
|-
| `move forward` || `polarizer[1:5] steps[0:MAXIMUM_STEP]` || Roda manualmente um polarizador específico para a frente pelo número de passos designado.
|-
| `move backward` || `polarizer[1:5] steps[0:MAXIMUM_STEP]` || Roda manualmente um polarizador específico para trás pelo número de passos designado.
|-
| `go to origin` || `polarizer[1:5]` || Comanda um único polarizador específico a regressar à sua posição zero/inicial até acionar o seu interruptor.
|}
=Links=

*[[Multiple polarizers experimental apparatus | Versão Inglesa (English Version)]]
*[https://elab.vps.tecnico.ulisboa.pt:8000/execution/create/33/14 Link direto à sala de controlo]
*[[Light Polarization with multiple polarizers | Referência teórica]]
*[https://www.printables.com/model/1293618-multi_polarizer_experiment Imprime o teu kit experimental]

Multiple polarizers experimental apparatus

2026-05-26T23:35:08Z

Ist1106345: fixed index of software

=Apparatus description=

{|
|[[File:exploded_kit_view.png|thumb|x250px|Left|Exploded view of the experimental kit.]]
|[[File:exploded_kit_view_1.png|thumb|x250px|Left|Exploded view of the experimental kit.]]
|}

The setup for the construction of the multiple polarizers twin experiment is composed of three main components: (i) the supporting 3D printed plastic parts whose schematics are available here, (ii) a Raspberry Pi running the control software over the internet and performing the video streaming and (iii) the low-level slave controller electronics comprising the sensing and the experiment motorisation.

=Mechanical Assembly=

{|
|[[File:Imagem_Experiência_1.jpg|thumb|x250px|Top|Top view of the experiment]]
|[[File:Imagem_Experiência_2.jpg|thumb|x250px|Top|Front view of the experiment]]
|}

In this section, the mechanical assembly of the experiment is explained in detail so that it can be used correctly.

==Order of assembly==

1. Check if all the parts needed to assemble the mechanical structure of the experiment are available.
{|
|[[File:parts_needed_.png|thumb|x400px|Top|Parts needed for the assembly]]
|}
The following table can be used to check the number of parts to be printed and if supports are needed:
{| class="wikitable"
! Name !! Description !! Folders !! Number of parts !! Material !! Supports: necessary
|-
| Edge || Edge that supports the corners of the box || Structural Components || 6 || PLA || No
|-
| Edge Special Left || Special edge || Structural Components || 1 || PLA || No
|-
| Edge Special Right || Special edge || Structural Components || 1 || PLA || No
|-
| Larger Face || Box face along the length || Lids || 3 || PLA || No
|-
| Face Power Supply || Box face along length with cable hole || Lids || 1 || PLA || No
|-
| Smaller Face || Box face along the width || Lids || 2 || PLA || No
|-
| Power Supply Base || Bottom of the box with the power supply || Eletronics || 1 || PLA || No
|-
| Arduino Base || Arduino case || Eletronics || 1 || PLA || No
|-
| Arduino Case Top || Arduino case || Eletronics || 1 || PLA || No
|-
| Arduino Case Bottom || Arduino case || Eletronics || 1 || PLA || No
|-
| Raspberry Pie Case Middle || Raspberry Pie Box || Eletronics || 1 || PLA || No
|-
| Raspberry Pie Case Top || Raspberry Pie Box || Eletronics || 1 || PLA || No
|-
| Raspberry Pie Case Bottom || Raspberry Pie Box || Eletronics || 1 || PLA || No
|-
| Lid 2 Steppers || Box top that supports two motors || Polarizer Assembly || 1 || PLA || No
|-
| Lid 3 Steppers || Box top that supports two motors || Polarizer Assembly || 1 || PLA || No
|-
| Stepper_holder_left || Stepper motor support, compatible with the box cover with 2 supports || Polarizer Assembly || 1 || PLA || No
|-
| Stepper_holder_right || Stepper motor support, compatible with the box cover with 3 supports || Polarizer Assembly || 1 || PLA || No
|-
| Polarizer Support Detector || Support for the polarizer assembly, detector side || Polarizer Assembly || 1 || PLA || No
|-
| Polarizer Support led || Support for the polarizer assembly, emitter side || Polarizer Assembly || 1 || PLA || yes, for the pins that secure the polarizer
|-
| Bar || Support bar for polarizer supports; adjusts compression exerted || Polarizer Assembly || 1 || PLA || No
|-
| Gear || Gear wheel that fits behind each polarizer || Polarizer Assembly || 5 || PLA || No
|-
| Fixed Polarizer Holder || Fixed polarizer holder that fits into the polarizer Support led || Optical Assembly || 1 || PLA || yes
|-
| Detector Holder || Part that secures the LED adjuster || Optical Assembly || 1 || PLA || No
|-
| Detector Adjuster || Part that secures the LED holder || Optical Assembly || 1 || PLA || No
|-
| Led Ajuster || Part that secures the LED holder || Optical Assembly || 1 || PLA || yes, for the pins that secure the polarizer
|-
| Led Holder || LED and detector holder, which fits into the adjustment parts above || Optical Assembly || 2 || PLA || No
|-
| Base || Base for the camera || Camera_holder || 1 || || yes
|-
| Support || || Camera_holder || 3 || || yes
|-
| Arm || || Camera_holder || 1 || || yes
|-
| Joint || || Camera_holder || 1 || || yes
|}
2. Peel the supports of the pulleys using pliers or an X-Acto knife.
{|
|[[File:peeled_support_1.jpg|thumb|x250px|Top|Peeling the support]]
|[[File:peeled_support_2.jpg|thumb|x250px|Top|Peeling the support]]
|}

3. Put the belt on the peeled pulleys.
{|
|[[File:belt_on_pulley.jpg|thumb|x250px|Top|Belt on pulley]]
|}

4. Connect the pulleys with the polarizer holders. Make sure to hear a “click” as only one side of the polarizer leads to this firm blockade. Additionally, place the polarizer inside the polarizer holder. (Don't forget to remove the polarizer protection if needed)
{|
|[[File:pulley_polarizer.jpg|thumb|x250px|Top|Pulley and polarizer holder connection position]]
|[[File:pulley_polarizer_connected.jpg|thumb|x250px|Top|Pulley and polarizer holder connected]]
|}

5. Repeat steps 2, 3 and 4 until a complete chain is achieved. You will get a cascaded polarizers set capable to move between each one. Do not forget to put the belts on, as they are not represented in the example picture.
{|
|[[File:pulley_polarizer_chain.jpg|thumb|x250px|Top|Chain of connected pulleys and polarizers]]
|}

6. Cut the thin layers covering the holes of the main plates of the structure.
{|
|[[File:thin_layer_cutting_process.jpg|thumb|x250px|Top|Main plates thin layers cutting process]]
|[[File:thin_layer_cut.jpg|thumb|x300px|Top|Main plates thin layers cut]]
|}

7. Place two of the four pillars together and put the nuts in the specific holes on top of one of the pillars.
{|
|[[File:nuts_on_pillars.jpg|thumb|x250px|Top|Nuts placed on the pillar]]
|}

8. Insert the bolts through the holes and bolt the two pillars together.
{|
|[[File:bolts_on_pillars.jpg|thumb|x250px|Top|Bolts placed on the pillar]]
|[[File:pillars_bolted_together.jpg|thumb|x250px|Top|Pillars bolted together]]
|}

9. Place the main plates next to each other.
{|
|[[File:main_plates_placement.jpg|thumb|x250px|Top|Placement of the main plates (same as shown in the step 1 image)]]
|}

10. Place the bolted pillars on the side of the junction of the two plates.
{|
|[[File:junction_placement.jpg|thumb|x250px|Top|Placement of the pillars]]
|}

11. Place the chain support on the other side of the main plates, so that they are in opposite positions. Check if the chain support is placed on top of the hexagonal holes.
{|
|[[File:chain_support_opposite_to_pillars.jpg|thumb|x250px|Top|Placement of the chain support]]
|[[File:chain_support_in_position.jpg|thumb|x250px|Top|Placement of the chain support]]
|}

12. Place the nuts on the chain support inside the “boxes” closest to the chain support “wall”.
{|
|[[File:nuts_placement.png|thumb|x250px|Top|Chain support nuts placement]]
|}

13. Insert the bolts through the holes on the bolted pillars and bolt the pillars, the main plates and the chain support together.
{|
|[[File:bolts_placement.png|thumb|x250px|Top|Insert the bolts through the highlighted holes]]
|}

14. Insert the nuts inside the other holes of the chain support.

15. Insert the bolts through the main plates and fully bolt the chain support to the main plates.
{|
|[[File:bolt_chain_support.jpg|thumb|x250px|Top|Bolt the chain support to the main plates and the pillars]]
|}

16. Repeat steps 7 and 8.

17. Go to the opposite side of the main plates and place the bolted pillars under the circular holes.

18. Place the nuts inside the top holes of the bolted pillars.

19. Insert the bolt through the main plates and bolt them together with the pillars.
{|
|[[File:bolt_the_other_pillars.jpg|thumb|x250px|Top|Bolt the other pillars]]
|}

20. Connect the chain with the bolted chain support and with the loose one, as well.
{|
|[[File:chain_in_place.jpg|thumb|x250px|Top|Chain structure placement]]
|}

21. Place the nuts inside the specific “boxes” of the loose chain support.

22. Insert the bolts through the holes in the main plates to connect the loose chain support to the main plates.
{|
|[[File:fully_bolted_chain.jpg|thumb|x250px|Top|Bolted chain structure]]
|}

23. Pick one of the pillars and place the nut inside the middle “box”.
{|
|[[File:nut_middle_box.jpg|thumb|x250px|Top|Nut inside the middle "box"]]
|}

24. Place it beneath the main plates in one of the corners.

25. Insert the bolt through the main plates to bolt them to the pillar.
{|
|[[File:corner_placement.jpg|thumb|x250px|Top|Corner placement]]
|}

26. Repeat steps 23, 24 and 25 until the four corners of the structure are supported.

27. Remove the small pillars on the surface facing downwards of the main plate to allow nuts to be inserted into those “boxes.”
{|
|[[File:remove_small_pillars_1.jpg|thumb|x250px|Top|Small pillars removal]]
|[[File:remove_small_pillars_2.jpg|thumb|x250px|Top|Small pillars removal]]
|}

28. Insert the nuts inside those “boxes”.
{|
|[[File:nuts_on_main_plate_1.jpg|thumb|x250px|Top|Nuts placement on the main plate]]
|[[File:nuts_on_main_plate_2.jpg|thumb|x250px|Top|Nuts placement on the main plate]]
|}

29. Place the stepper holder above the holes.

30. Insert the bolts through the holes of the stepper holder in order to connect it to the main plates.
{|
|[[File:stepper_holder_placement.jpg|thumb|x250px|Top|Stepper holder placement on the main plate]]
|}

31. Repeat steps 28, 29 and 30 for the other four stepper holders.

32. Place the stepper motor on the stepper holder by first putting the wires through the top and bottom holes. Then, hear a click to ensure the stepper motor is well fixed. NOTE: the cable connection may vary depending on the driver, it is not reliable to use cable colors.
{|
|[[File:wires_placement.jpg|thumb|x250px|Top|Wires entering position]]
|}

33. Repeat step 32 for the other 4 stepper motors.
{|
|[[File:stepper_placement.jpg|thumb|x250px|Top|Stepper motor placement]]
|}

34. Place the belt in the pulley.

35. Connect the pulley (with the belt) to the stepper motor.
{|
|[[File:motor_placement.jpg|thumb|x250px|Top|Pulley placement with the belt on]]
|}

36. Tighten the pulley.
{|
|[[File:motor_tightened.jpg|thumb|x250px|Top|Tightening of the pulley]]
|}

37. Adjust the stepper holder position to ensure the belt is not loose.
{|
|[[File:adjust_stepper_holder_position.jpg|thumb|x250px|Top|Stepper holder too close to the chain (Belt is loose)]]
|}

38. Tighten the bolts of the stepper holder to fix it.
{|
|[[File:stepper_holder_position_adjusted.jpg|thumb|x250px|Top|Stepper holder in the correct position]]
|}

39. Repeat steps 34, 35, 36, 37 and 38 for the other four stepper holders.

40. Assembly completed.

=Electronic circuit=

The experiment has two main electronic parts, the drivers (1) for the step-motors and the light source and detection (2).

==Electronic component assembly==

1. Check if all the parts needed for the electronic component assembly of the experiment are available.
{|
|[[File:electric_assembly_parts.jpg|thumb|Parts needed for the electronic component assembly.]]
|}

2. Get the left floor of the electronic component (see the image below) and use a soldering iron to insert the heat inserts in the floor's holes, through the thermal insertion process.
{|
|[[File:electric_assembly_left_floor.jpg|thumb|Left floor of the electronic component.]]
|[[File:insercao_termica.jpg|thumb|Thermal insertion.]]
|}

3. Get the Arduino Mega box (see the image below) and bolt it to the floor.
{|
|[[File:arduino_case.jpg|thumb|Arduino Mega box.]]
|}

4. Use a soldering iron to insert the heat inserts in the box holes, through the thermal insertion process.
{|
|[[File:arduino_case_holes.jpg|thumb|Holes in the Arduino Mega box.]]
|}

5. Select a heat sink.
{|
|[[File:Heat_Sink.jpg|thumb|Heat Sink.]]
|}

6. Remove the paper protection.
{|
|[[File:paper_protection_removal.jpg|thumb|Remove the paper protection.]]
|[[File:paper_removed.jpg|thumb|Remove the paper protection.]]
|}

7. Glue the heat sink to the step-motor driver.
{|
|[[File:heat_sink_placement.jpg|thumb|Heat sink placement.]]
|[[File:heat_sink_placed.jpg|thumb|Heat sink placed.]]
|}

8. Repeat the steps 1, 2 and 3 for the other five step-motor drivers.

9. Place the step-motor driver on the RAMPS 1.4 (RepRap Arduino Mega Pololu Shield)
{|
|[[File:Placa_RAMPS.jpg|thumb|RAMPS 1.4.]]
|[[File:Placa_RAMPS_software.png|thumb|RAMPS 1.4 (software view).]]
|}

10. Check if the step-motor driver is well placed, meaning its ground connection is as shown in the image below and that the bolt (potentiometer) is on the opposite side of the power supply (in the case of the green and red step-motor drivers) or in the side of the power supply (in the case of the purple step-motor drivers).
{|
|[[File:drivers.png|thumb|Step-motor drivers models.]]
|[[File:driver_placement_software.png|thumb|Purple step-motor driver placement (software view).]]
|[[File:driver_placement_green.png|thumb|Purple and green step-motor driver placement.]]
|}

11. Repeat the steps 5 and 6 for the other five step-motor drivers.
{|
|[[File:driver_placement.jpg|thumb|RAMPS 1.4 with the step-motor drivers in place.]]
|}

12. Connect the switches to the wires.
{|
|[[File:switches_wires.jpg|thumb|Switches connection to the wires.]]
|}

13. Place the switches in the switch holder. Ensure you hear a "click" to confirm they are well positioned.
{|
|[[File:switches_placement.png|thumb|Switches positioning in the holder.]]
|}

14. Connect the step-motor wires to the step-motor drivers through the RAMPS 1.4. Check the pinouts connection through its colour and according to the information provided in the subsection [[#Step-motor drivers|Step-motor drivers]].
{|
|[[File:stepper_wires_placement.jpg|thumb|Wires connection in the RAMPS 1.4.]]
|[[File:stepper_array.png|thumb|Top-view of kit:numbering of thre steppers and respective switches.]]
|[[File:switches_wires_placement_software.png|thumb|Switches' wires (green) and step-motor wires (blue) (software view).]]
|}

15. Assemble the detector and photodiode electric circuit.
{|
|[[File:photodiode_circuit.jpg|thumb|Detector and photodiode electric circuit schematics.]]
|}

16. Place the electric circuit in the box corner, position it according to the holes, and bolt it.
{|
|[[File:electric_circuit.jpg|thumb|Switchers positioning in the switch holder.]]
|}

17. Get the top part of the Arduino Mega box and bolt it to the bottom part (attention to the wires when closing the box).
{|
|[[File:arduino_top_case.jpg|thumb|Top part of the Arduino Mega box.]]
|}

18. Repeat the step 2 for the right floor.
{|
|[[File:electric_assembly_right_floor.jpg|thumb|Right floor of the electronic component.]]
|}

19. Place the power supply on the right floor and secure it with bolts.
{|
|[[File:power_supply.jpg|thumb|Power supply.]]
|[[File:power_supply_top_view.jpg|thumb|Top view of the power supply.]]
|}

20. Get the bottom part of the Raspberry Pi box and repeat the step 4.
{|
|[[File:raspberry_pi_case.jpg|thumb|Raspberry Pi box.]]
|}

21. Bolt the Raspberry Pi to the box.
{|
|[[File:raspberry_pi.jpg|thumb|Raspberry Pi.]]
|}

22. Connect the middle part of the Raspberry Pi box to the bottom part.

23. Place the cover to close the box.

==Step-motor drivers==
[[file:StepMotorCable.jpg | Numbering of the step-motor cable connection|thumb|120px]]
The step-motor drivers can have multiple design outputs according to the producer. The stepper pin-outs are numbered from 1-6, from left to right from the front view (shaft pointing you, connector downwards).
The driver's location on the arduíno mezzanine relates to the step-motor according to the schema below:

{| border="1" style="width:150px; height:150px; text-align:center;"
|+ Driver to step-motor link
| style="width:66px; height:66px;" | 5
| style="width:66px; height:66px;" | 3
| style="width:66px; height:66px;" | N/A
|-
| style="width:66px; height:66px;" | 1
| style="width:66px; height:66px;" | 2
| style="width:66px; height:66px;" | 4
|}

By using a proper cable the connections should follow the table below:
{| border="1" style="text-align: center;"
|+ Driver to step-motor connections
|-
!Motherboard pin-out
!Cable color
!Step-motor pin (A4988)
!Step-motor pin (DRV8825)
|-
|2B
|Red
|
|6
|-
|2A
|Green
|
|3
|-
|1A
|Black
|
|1
|-
|1B
|Blue
|
|4
|-
|}

==Light source and detection==
[[File:NPolarizersElectronicCircuit.png|thumb|Schematic for the LED PWM connection to the A4 pin of the controller board and the filter for the photodiode detection circuit.]]

The red LED is fed by a PWM output pin (A4) from the main controller board, which allows for a variable light intensity. The default PWM from the board has a 490Hz modulation in steps of 1/256, giving a resolution of less than 0.5%.

After passing the cascade of polarizers, the signal is detected by a photodiode. This photodiode is inversely biased with a resistor to ground in order to have a zero signal when no light is present.

As the signal is modulated and its frequency has to be removed we use a low-pass first order RC-filter. As the time constant is ~1s, is necessary to delay the first acquisition for the settling of the circuit voltages. Then, as the signal varies smoothly and slowly due to the polarizer rotation, and oversampling is in place, a much lower settling time is needed.

=Optical path=
[[File:Polarizer optical circuit.png|thumb|x120px|Top|Optical path showing the collimating system to let the light pass through the cascade of polarizers in parallel rays.]]
The optical path consists of a light source (1) (red LED) placed in the focal point of a semi-spherical lens (2) where the light rays are collimated in a parallel beam of light.

Then it is polarized by the fixed polarizer (3) before entering the cascade of variable tilt polarizers (4). This chain will dim the light according to each polarizer angle and it passes the second lens in order to focus on the detector, a photodiode (6).

Before reaching the photodiode, light may pass a red filter (5) to narrow the bandwidth and limit external noise. This filter is not damned necessary and can be replaced by red cellophane paper or even absent in case of a fully opaque plastic structure.

==Optical path alignment==
The main body of the device has the light propagating in parallel rays through the cascade of polarizers. Those rays are later focused on the sensor (photo-diode). It is crucial for a good signal-to-noise reading to have the system perfectly aligned. For that end, the linear position of the emitting LED and the photo-diode receiver can be adjusted according to the following procedure:

#First assemble the system lens and the light source (LED);
#Energize the LED and follow the emerging circular image from the output, eg. projecting it in a wall a couple of meters apart;
#Move the LED position in order to have an output image closer to the size of the exit circle (~30mm);
#Install the structure for the cascade of polarizers without any lens or hard film in it;
#Put in place the second collimating lens in order to focus the light in the photo-diode;
#Using a voltmeter for reading the collected light intensity to the photo-diode terminals, move back and forward the photo-diode position in order to maximize the signal;
#Firmly glue the light source and photo-diode positions in their final position.

==Optical path calibration==

Once the support structure is in place, is necessary to calibrate the absolute position of each polarizer; effectively all the polarizers will have a small offset giving a systematic error. It is important to note these angular value that maximizes the transmissivity.

The first polarizer is fixed and shall be positioned with a couple of degrees in order to avoid starting the experiment from a maximum, allowing for easy observation of such maxima. Consider having it around ~15º to 30º and well secured, eventually with glue.
Then start the calibration procedure by inserting the second polarizer and rotating it until the maximums are detected and measured (usually two). Take note of their value and leave the second polarizer at rest in the measured position. Now insert the third polarizer and repeat the procedure for the detection of the maximums and do this for the rest of them.
Every time a hard film or lens is installed it has to be firmly fixed or glued. If glue is used it ''must not damage the polarizer film''.

You will end up with a table of maximum transmission angles, leading to the reference value of maximum intensity in the cascade of polarizers.

It is provided in the firmware a function able to rotate a set of polarizers in conjunction with each other. With this procedure local maximums can be inferred to confirm the previous determined values. In fact, if a group of the last polarizers are made to rotate in conjunction, the maximum is dictated by the first one to rotate in order to the last one fixed.

Later, when performing the experiments these values of offsets must be considered in order to eliminate the systematic error of the system.

= Software =
To properly use the experiment, commands and data retrieval have to be in place. This can be achieved in two ways acting through the serial connection to the Arduino Mega.

The firmware existing in the Arduino is able to (i) configure the experiment, (ii) run and retrieve the generated data, and (iii) execute some specialized functions in order to test, calibrate, and maintain the experiment. To interface with the firmware, one can use a Python proxy code (high-level software layer) capable of interoperating with the FREE server, or a terminal emulator like Minicom available for Linux that allows you to send and receive data over the serial connection.

== Raspberry FREE proxy ==
The Raspberry Pi is responsible for transmitting the video feed of the experiment and establishing communication with the FREE-Server by using a proxy interface. The FREE hosts the graphical user interface (GUI) to the clients. This section provides a concise overview of the procedure used to control all electronic components via the Arduino, as well as the communication protocols between the Arduino and the FREE-Server.

=== Communication model between the FREE-Server and the Raspberry PI ===
The communication between the server and the experiment follows the elab’s structured protocol that enables real-time interaction and data exchange. The central server, Exp Server, acts as an intermediary between users and the experimental apparatus (RPi Server). Users interact with Exp Server via a web interface made with Django, a high-level Python web framework, to configure and control the experiment parameters, while Exp Server directly relays these commands to the experimental setup.

The communication between Exp Server and RPi Server occurs over the internet using JSON-formatted messages, ensuring flexibility across different experimental configurations. Authentication is performed at the connection stage, where the RPi Server transmits an ID and a secret key for verification. Once authenticated, the Exp Server sends an experiment-specific configuration file to the RPi Server, which then establishes communication with the local controller using the predefined protocol [7]. Throughout the experiment, the RPi Server continuously exchanges status updates, experimental results, and error messages with the XP server, ensuring synchronized operation and real-time data accessibility for users.

=== Communication model between the Raspberry PI and the Arduino Mega ===
To enable seamless communication between the Arduino and the Raspberry Pi 4, the protocol ReC Generic Drive 11 was implemented, allowing the external user to have full control over the experiment and its status through a set of commands. The ReC Generic Drive is a generic communication protocol designed for remote laboratories, facilitating interaction between a software driver and experimental hardware. It enables seamless communication over serial ports (RS232), using structured messages where driver commands are in lowercase and hardware responses in uppercase.

The protocol ensures synchronization through message handshaking and timeout handling, supporting functions like identification, configuration, data transmission, experiment configuration, and error reporting.

By reading the Arduino’s serial port at a baud rate of 115200 bits per second, the user sends a bit string (ending with the character \r).

== Administrator Setup Instructions ==
To deploy a new instance of the multi-polarizer experiment, the Raspberry Pi proxy and the Arduino firmware must be configured and compiled. Follow these steps to ensure proper initialization:

<ol>
<li>Download the experiment repository via SSH:
<pre>git clone https://github.com/farrucho/multi-polarizer.git</pre></li>

<li>Modify the experiment ID in `main.cpp` to match the FREE server configuration:
<pre>expr.begin("ELAB_FIVEPOLARIZER");</pre></li>

<li>Adjust the motor directions and reference voltage in `user_define.cpp`:
<pre>uint8_t resetDir = HIGH; // Direction to trigger the switch. Test by moving backward to ensure it triggers correctly.
uint8_t dirToTop = LOW;
int vrefMode = 1;</pre></li>

<li>Identify the Arduino's serial port:
<pre>ls /dev/tty*</pre>
Update the `platformio.ini` file with the correct port (e.g., `monitor_port = /dev/ttyACM0`).</li>

<li>Compile and upload the firmware using PlatformIO from within the `e-lab` folder:
<pre>pio run -t upload -t monitor -t clean</pre></li>

<li>Configure the startup proxy script by editing `/etc/rc.local`:
<pre>sudo nano /etc/rc.local</pre>
Add the following lines before `exit 0`:
<pre>_IP=$(hostname -I) || true
if [ "$_IP" ]; then
printf "My IP address is %s\n" "$_IP"
fi
sleep 120
cd /home/elab/RPi_Proxy_fivepol
su elab -c "sh start-wp.sh &"</pre></li>

<li>Enable the `rc-local` service on boot using `systemctl`:
<pre>sudo systemctl enable rc-local
sudo systemctl start rc-local</pre></li>
</ol>

= Firmware =
The programming was done using the C++ language without any external libraries. To declare a component in the code, one simply provides the corresponding input pin and accesses the enable function to initialize it, as well as the `isTrigger` function to check whether the logical value read corresponds to the component’s trigger state. In this particular case, the switch is active on a LOW signal. Since all objects and respective components need to be initialized and turned off, each has corresponding enable/disable functions. Components connected to single read pins, declared as `pinMode` (such as switches and photodiodes), do not require a disable function since `pinMode` does not prevent reading the pins but rather helps define the type of input being processed.

In order to rotate the stepper motors, the operation consists of sending a pulse each time a rotation of 1.8º (0.36º effective) is desired. Since different RPM values require different pulse intervals, the frequency of sent pulses must be calculated accordingly. To execute a discrete sequence of steps based on a given angle in degrees, the rotate function was implemented. The motor rotates to the nearest low integer multiple of 1.8º relative to the provided angle.

The data acquisition interval is crucial for the final experiment since the goal is to optimize the user experience by minimizing waiting times when retrieving the intensity of light and scanning angle data. To address this, a global RPM of 600 revolutions per minute was used. With a scanning limit of 324º, the experimentally measured data acquisition time for scanning one or more polarizers simultaneously was approximately 40 seconds.

To further refine the voltage readings from the photodiode, an arithmetic mean of N points was implemented in the photodiode voltage reading function. By computing the arithmetic mean over 13 points of the value being measured, the standard deviation of this mean reduces the original standard deviation by ≈ 27.14%. This reduction was deemed acceptable for the experiment, as the data adjustment performed was successful.

== User Debugging and Serial Commands ==
For manual hardware testing and calibration, administrators can send direct serial commands to the Arduino using a terminal emulator like Minicom.

Connect to the terminal using the correct port identified earlier:
<pre>minicom -D /dev/ttyACM0</pre>

By sending a question mark `?` and pressing Enter, the firmware will return a help menu listing all available commands. Below is the explanation for each supported command:

{| class="wikitable"
! Command !! Parameters !! Description
|-
| `cur` || None || Returns the current configured parameters.
|-
| `str` || None || Starts the experiment sweep based on the previously configured parameters.
|-
| `stp` || None || Immediately stops the experiment and halts all motor movements.
|-
| `rst` || None || Resets and homes all stepper motors by moving them backward until their respective limit switches are triggered.
|-
| `ids` || None || Returns the hardware and firmware identification string.
|-
| `cfg` || `theta1 theta2 theta3 theta4 theta5` || Configures the starting or target positions (in steps) for each of the 5 polarizers. Limits are bound by `MAXIMUM_STEP`.
|-
| `led` || `on [0:255]` or `off` || Controls the red LED intensity using Pulse Width Modulation (PWM). Value ranges from 0 (off) to 255 (maximum brightness).
|-
| `lamp` || `on [0:255]` or `off` || Controls the auxiliar light source intensity using Pulse Width Modulation (PWM). Value ranges from 0 (off) to 255 (maximum brightness).
|-
| `set maxstep` || `[0:1000]` || Defines the maximum allowed mechanical limit for the polarizers. By default, 900 steps corresponds to the 900*0.36º=324.0º physical limit.
|-
| `set vref` || `[1:3]` || Adjusts the Analog-to-Digital Converter (ADC) reference voltage to prevent photodiode saturation depending on light intensity. (1: Vref = 1.1V, 2: Vref = 2.56V, 3: Vref = 5V).
|-
| `move forward` || `polarizer[1:5] steps[0:MAXIMUM_STEP]` || Manually rotates a specific polarizer forward by the designated number of steps.
|-
| `move backward` || `polarizer[1:5] steps[0:MAXIMUM_STEP]` || Manually rotates a specific polarizer backward by the designated number of steps.
|-
| `go to origin` || `polarizer[1:5]` || Commands a single specific polarizer to return to its zero/home position until it triggers its switch.
|}

=Links=

*[[Kit experimental de polarização da luz com múltiplos polarizadores | Portuguese version (Versão em Português)]]
*[https://elab.vps.tecnico.ulisboa.pt:8000/execution/create/33/14 Direct link for the control room]
*[[Light Polarization with multiple polarizers | Reference lesson]]
*[https://www.printables.com/model/1293618-multi_polarizer_experiment Print your experiment]

Kit experimental de polarização da luz com múltiplos polarizadores

2026-05-26T23:33:33Z

Ist1106345: updated software+firmware sections pt (Laranjo)

=Descrição do kit experimental=

{|
|[[File:exploded_kit_view.png|thumb|x250px|Left|Vista explodida do kit experimental.]]
|[[File:exploded_kit_view_1.png|thumb|x250px|Left|Vista explodida do kit experimental.]]
|}

A montagem do kit experimental de polarização da luz com múltiplos polarizadores é composta por três componentes principais: (i) a componente mecânica composta por peças de plástico impressas em 3D, cujos desenhos técnicos estão disponíveis aqui, (ii) um raspberry Pi que executa o software de controlo através da internet e ainda realiza o streaming do vídeo, e (iii) a componente eletrónica do controlador escravo de baixo nível que está responsável pela deteção e motorização do kit experimental.

=Montagem Mecânica=

{|
|[[File:Imagem_Experiência_1.jpg|thumb|x250px|Top|Vista de cima do kit experimental]]
|[[File:Imagem_Experiência_2.jpg|thumb|x250px|Top|Vista frontal do kit experimental]]
|}

Nesta parte, a montagem mecânica do kit experimental é explicada em detalhe para poder ser corretamente montada.

==Ordem de Montagem==

1. Verificar se todas as peças necessárias à montagem estão disponíveis.
{|
|[[File:parts_needed_.png|thumb|x400px|Top|Peças necessárias para a montagem]]
|}

2. Retirar os suportes de impressão das polias com a ajuda de pinças ou de um X-Acto.
{|
|[[File:peeled_support_1.jpg|thumb|x250px|Top|Retirar os suportes]]
|[[File:peeled_support_2.jpg|thumb|x250px|Top|Retirar os suportes]]
|}

3. Colocar as correias nas polias.
{|
|[[File:belt_on_pulley.jpg|thumb|x250px|Top|Correia na polia]]
|}

4. Ligar as polias aos suportes dos polarizadores. Ouvir um “click” para saber que estão bem ligados. Adicionalmente, colocar os polarizadores nos suportes. (Não esquecer de retirar as películas protetoras dos polarizadores, caso seja necessário)
{|
|[[File:pulley_polarizer.jpg|thumb|x250px|Top|Posição de ligação das polias com os polarizadores]]
|[[File:pulley_polarizer_connected.jpg|thumb|x250px|Top|Polia e polarizador ligados]]
|}

5. Repetir os passos 2, 3 e 4 até ter a corrente de polias e polarizadores completa. (Não esquecer de ter as correias nas polias, que não estão representadas na figura.)
{|
|[[File:pulley_polarizer_chain.jpg|thumb|x250px|Top|Corrente de polias e polarizadores]]
|}

6. Cortar as camadas finas de suporte que tapam os furos das placas principais da estrutura.
{|
|[[File:thin_layer_cutting_process.jpg|thumb|x250px|Top|Corte das finas camadas de suporte]]
|[[File:thin_layer_cut.jpg|thumb|x300px|Top|Placas principais depois de cortadas]]
|}

7. Juntar dois dos quatro pilares e colocar as porcas nos buracos específicos no topo dos pilares.
{|
|[[File:nuts_on_pillars.jpg|thumb|x250px|Top|Porcas colocadas nos pilares]]
|}

8. Ligar os dois pilares colocando os parafusos nos furos específicos.
{|
|[[File:bolts_on_pillars.jpg|thumb|x250px|Top|Parafusos colocados]]
|[[File:pillars_bolted_together.jpg|thumb|x250px|Top|Pilares ligados]]
|}

9. Juntar as placas principais nesta posição.
{|
|[[File:junction_placement.jpg|thumb|x250px|Top|Posicionamento das placas principais (igual ao posicionamento da imagem do passo 1]]
|}

10. Colocar os pilares ligados no canto da junção das placas principais.
{|
|[[File:main_plates_placement.jpg|thumb|x250px|Top|Posicionamento dos pilares ligados na junção]]
|}

11. Colocar os suportes da corrente no outro lado das placas principais, de modo a que fiquem em lados opostos. Verificar se o suporte da corrente está colocado em cima dos furos hexagonais.
{|
|[[File:chain_support_opposite_to_pillars.jpg|thumb|x250px|Top|Posicionamento do suporte da corrente]]
|[[File:chain_support_in_position.jpg|thumb|x250px|Top|Posicionamento do suporte da corrente]]
|}

12. Colocar as porcas nas "caixas" mais próximas da "parede" do suporte da corrente.
{|
|[[File:nuts_placement.png|thumb|x250px|Top|Posicionamento das porcas]]
|}

13. Colocar os parafusos nos pilares ligados para aparafusar os pilares às placas e ao suporte da corrente.
{|
|[[File:bolts_placement.png|thumb|x250px|Top|Colocar os parafusos nos furos destacados]]
|}

14. Colocar as porcas no resto das "caixas" do suporte da corrente.

15. Colocar os parafusos através das placas principais para aparafusar o suporte da corrente às placas.
{|
|[[File:bolt_chain_support.jpg|thumb|x250px|Top|Aparafusar os pilares às placas principais e ao suporte da corrente]]
|}

16. Repetir os passos 7 e 8.

17. Ir para o lado oposto das placas principais e colocar os pilares aparafusados debaixo dos furos circulares.

18. Colocar as porcas dentro das "caixas" superiores dos pilares aparafusados.

19. Colocar o parafuso através das placas principais de modo a aparafusá-las aos pilares aparafusados.
{|
|[[File:bolt_the_other_pillars.jpg|thumb|x250px|Top|Aparafusar os outros pilares]]
|}

20. Ligar a corrente aos suportes da corrente, tanto ao aparafusado como ao solto.
{|
|[[File:chain_in_place.jpg|thumb|x250px|Top|Posição da estrutura (corrente + suportes)]]
|}

21. Colocar as porcas dentro das "caixas" próprias do suporte da corrente que está solto.

22. Colocar os parafusos através dos furos das placas principais para ligar o suporte da corrente solto às placas principais.
{|
|[[File:fully_bolted_chain.jpg|thumb|x250px|Top|Estrutura da corrente aparafusada]]
|}

23. Escolher um dos pilares ainda não usados e colocar uma porca na "caixa" do meio.
{|
|[[File:nut_middle_box.jpg|thumb|x250px|Top|Porca na "caixa" do meio]]
|}

24. Colocar o pilar debaixo das placas principais num dos cantos.

25. Colocar um parafuso através do furo nas placas principais para juntá-las ao pilar.
{|
|[[File:corner_placement.jpg|thumb|x250px|Top|Posicionamento do pilar no canto]]
|}

26. Repetir os passos 23, 24 e 25 até que os quatro cantos da estrutura estejam suportados.

27. Remover os pequenos pilares que tapam a entrada das porcas nas "caixas" da superfície inferior das placas principais.
{|
|[[File:remove_small_pillars_1.jpg|thumb|x250px|Top|Remoção dos pequenos pilares]]
|[[File:remove_small_pillars_2.jpg|thumb|x250px|Top|Remoção dos pequenos pilares]]
|}

28. Colocar as porcas dentro dessas "caixas".
{|
|[[File:nuts_on_main_plate_1.jpg|thumb|x250px|Top|Colocação das porcas na placa principal]]
|[[File:nuts_on_main_plate_2.jpg|thumb|x250px|Top|Colocação das porcas na placa principal]]
|}

29. Colocar o suporte do motor de passo por cima dos furos da placa principal onde se puseram as porcas.

30. Colocar os parafusos através dos furos do suporte do motor de passo de modo a ligá-lo à placa principal.
{|
|[[File:stepper_holder_placement.jpg|thumb|x250px|Top|Colocação do suporte do motor de passo na placa principal]]
|}

31. Repetir os passos 28, 29 e 30 para os outros quatro suportes do motor de passo.

32. Colocar o motor de passo no suporte do motor de passo, pondo primeiro os cabos através do furo superior e inferior do suporte. Depois, apertar/colocar o motor de passo até se ouvir um click para garantir que este está fixo na posição correta. NOTA: a ligação dos cabos depende do driver, não é confiável usar as cores dos cabos.
{|
|[[File:wires_placement.jpg|thumb|x250px|Top|Posição de entrada dos cabos]]
|}

33. Repetir o passo 32 para os outros quatro motor de passo.
{|
|[[File:stepper_placement.jpg|thumb|x250px|Top|Posicionamento do motor de passo]]
|}

34. Colocar a correia na polia.

35. Ligar a polia (com a correia) ao motor de passo.
{|
|[[File:motor_placement.jpg|thumb|x250px|Top|Colocação do motor de passo com a correia]]
|}

36. Apertar a polia do motor de passo.
{|
|[[File:motor_tightened.jpg|thumb|x250px|Top|Apertamento da polia]]
|}

37. Ajustar a posição do suporte do motor de passo de modo a garantir que a correia está à tensão.
{|
|[[File:adjust_stepper_holder_position.jpg|thumb|x250px|Top|Suporte do motor de passo demasiado perto da corrente (correia está com folga)]]
|}

38. Apertar os parafusos do suporte do motor de passo de modo a fixá-lo.
{|
|[[File:stepper_holder_position_adjusted.jpg|thumb|x250px|Top|Segurador do motor de passo na posição correta]]
|}

39. Repetir os passos 34, 35, 36, 37 e 38 para os outros quatro suportes dos motores de passo.

40. Montagem Completa.

=Circuito Eletrónico=

Este kit experimental tem duas componentes eletrónicas principais, (i) os drivers para os motores do motor de passo e (ii) a fonte de luz e deteção.

==Montagem da Componente Eletrónica==

1. Verificar se todas as peças necessárias à montagem da componente eletrónica estão disponíveis.
{|
|[[File:electric_assembly_parts.jpg|thumb|Peças necessárias para a montagem da componente eletrónica.]]
|}

2. Pegar na base esquerda da componente eletrónica (verificar a imagem abaixo) e usar um ferro de solda para inserir os insertos roscados nos furos da base, através do processo de inserção térmica.
{|
|[[File:electric_assembly_left_floor.jpg|thumb|Base esquerda da componente eletrónica.]]
|[[File:insercao_termica.jpg|thumb|Inserção térmica.]]
|}

3. Pegar na caixa do Arduino Mega (verificar a imagem abaixo) e aparafusá-la à base da componente eletrónica.
{|
|[[File:arduino_case.jpg|thumb|Caixa do Arduino Mega.]]
|}

4. Usar um ferro de solda para inserir os insertos roscados nos furos da caixa, através do processo de inserção térmica.
{|
|[[File:arduino_case_holes.jpg|thumb|Furos da caixa do Arduino Mega.]]
|}

5. Pegar num dissipador de calor.
{|
|[[File:Heat_Sink.jpg|thumb|Dissipador de Calor.]]
|}

6. Retirar a película de papel.
{|
|[[File:paper_protection_removal.jpg|thumb|Retirar a película de papel.]]
|[[File:paper_removed.jpg|thumb|Retirar a película de papel.]]
|}

7. Colar o dissipador de calor ao driver do motor de passo.
{|
|[[File:heat_sink_placement.jpg|thumb|Colagem do dissipador de calor.]]
|[[File:heat_sink_placed.jpg|thumb|Colocação do dissipador de calor.]]
|}

8. Repetir os passos 1, 2 e 3 para os cinco drivers.

9. Colocar o driver do motor de passo na placa RAMPS 1.4 (RepRap Arduino Mega Pololu Shield)
{|
|[[File:Placa_RAMPS.jpg|thumb|Placa RAMPS 1.4.]]
|[[File:Placa_RAMPS_software.png|thumb|Placa RAMPS 1.4 (vista do software).]]
|}

10. Certificar que o driver fica bem colocado, ou seja que a ligação ao ground está como indicado na imagem e que o parafuso (potenciómetro) se encontra do lado oposto à fonte de alimentação (no caso dos drivers verdes ou encarnados) ou do lado da fonte de alimentação (no caso dos drivers roxos).
{|
|[[File:drivers.png|thumb|Modelos de drivers.]]
|[[File:driver_placement_software.png|thumb|Colocação do driver roxo (vista do software).]]
|[[File:driver_placement_green.png|thumb|Colocação do driver verde e roxo.]]
|}

11. Repetir os passos 5 e 6 para os cinco drivers.
{|
|[[File:driver_placement.jpg|thumb|RAMPS 1.4 com os drivers colocados.]]
|}

12. Ligar os interruptores de curso aos cabos.
{|
|[[File:switches_wires.jpg|thumb|Ligação dos interruptores de curso aos cabos.]]
|}

13. Colocar os interruptores de curso no segurador dos interruptores. Garantir que se houve um "click".
{|
|[[File:switches_placement.png|thumb|Posicionamento dos interruptores no segurador.]]
|}

14. Ligar os cabos dos motores de passo e dos interruptores de curso aos drivers através da placa RAMPS 1.4. Verificar a ligação dos cabos aos pinos da placa de acordo com a informação presente na subsecção [[#Drivers dos motores de passo|Drivers dos motores de passo]].
{|
|[[File:stepper_wires_placement.jpg|thumb|Colocação dos cabos na placa RAMPS 1.4.]]
|[[File:stepper_wires_placement_software.png|thumb|Colocação dos cabos na placa RAMPS 1.4 (vista do software).]]
|[[File:switches_wires_placement_software.png|thumb|Cabos dos interruptores de curso (verde) e cabos dos motores de passo (azul) (vista do software).]]
|}

15. Montar o circuito elétrico do fotodiodo e do detetor.
{|
|[[File:photodiode_circuit.jpg|thumb|Esquema do circuito elétrico do fotodiodo e do detetor.]]
|}

16. Colocar o circuito elétrico no canto da caixa, posicionando-a de acordo com os furos, e aparafusá-la.
{|
|[[File:electric_circuit.jpg|thumb|Posicionamento dos interruptores no segurador.]]
|}

17. Pegar na parte de cima da caixa do Arduino Mega e aparafusá-la à parte de baixo (ter atenção aos cabos ao fechar a caixa).
{|
|[[File:arduino_top_case.jpg|thumb|Parte de cima da caixa do Arduino Mega.]]
|}

18. Repetir o passo 2 para a base direita.
{|
|[[File:electric_assembly_right_floor.jpg|thumb|Base direita da componente eletrónica.]]
|}

19. Colocar a fonte de alimentação na base direita e aparafusá-la.
{|
|[[File:power_supply.jpg|thumb|Fonte de alimentação.]]
|[[File:power_supply_top_view.jpg|thumb|Vista de cima da fonte de alimentação.]]
|}

20. Pegar na parte de baixo da caixa do Raspberry Pi e repetir o passo 4.
{|
|[[File:raspberry_pi_case.jpg|thumb|Caixa do Raspberry Pi.]]
|}

21. Aparafusar o Raspberry Pi à caixa.
{|
|[[File:raspberry_pi.jpg|thumb|Raspberry Pi.]]
|}

22. Prender a parte do meio da caixa do Raspberry Pi à parte de baixo.

23. Colocar a tampa para fechar a caixa.

==Drivers dos motores de passo==
[[file:StepMotorCable.jpg | Numeração das ligações a cabo do motor de passo|thumb|120px]]
Os drivers dos motores de passo podem ter múltiplos designs de output de acordo com cada produtor. Os pinos dos motores de passo estão numerados de 1 a 6, da esquerda para a direita da vista frontal (eixo do montor de frente e conector virado para baixo).
A posição dos drivers no arduino relaciona-se com os motores de passo de acordo com o seguinte esquema:

{| border="1" style="width:150px; height:150px; text-align:center;"
|+ Ligação do driver para o motor de passo
| style="width:66px; height:66px;" | 5
| style="width:66px; height:66px;" | 3
| style="width:66px; height:66px;" | N/A
|-
| style="width:66px; height:66px;" | 1
| style="width:66px; height:66px;" | 2
| style="width:66px; height:66px;" | 4
|}

Usando um cabo próprio, as ligações devem seguir as indicações da tabela em baixo:
{| border="1" style="text-align: center;"
|+ Ligações do driver para o motor de passo
|-
!Pinos da motherboard
!Cor dos cabos
!Pino do motor de passo (A4988)
!Pino do motor de passo (DRV8825)
|-
|2B
|Encarnado
|
|6
|-
|2A
|Verde
|
|3
|-
|1A
|Preto
|
|1
|-
|1B
|Azul
|
|4
|-
|}

==Fonte de luz e deteção==
[[File:NPolarizersElectronicCircuit.png|thumb|Esquema para a ligação LED PWM com o pino A4 da placa de controlo e do filtro.]]

O LED encarnado é alimentado por um pino de output PMW (A4) da placa de controlo principal, o que permite uma intensidade da luz variável. O PWM padrão da placa tem uma modulação de 490Hz em passos de 1/256, permitindo uma resolução inferior a 0.5%.

Após passar pela cascata de polarizadores, o sinal é detetado por um fotodiodo. Este fotodiodo é polarizado inversamente com um resistor ligado ao ground para gerar um sinal nulo quando não há luz presente.

Esta frequência tem de ser filtrada por um filtro RC de primeira ordem passa-baixo. Como a constante do tempo é ~1s, é necessário adiar a primeira aquisição para a configuração das tensões do circuito. Assim sendo, o sinal varia suave e lentamente devido à rotação dos polarizadores, e a sobreamostragem está em vigor, é necessário um tempo de estabilização muito menor.

=Caminho Óptico=
[[File:Polarizer optical circuit.png|thumb|x120px|Top|Caminho óptico mostrando o sistema de colimação que permite que a luz passe através da cascata de polarizadores em raios paralelos.]]
O caminho óptico consiste numa fonte de luz (1) (LED encarnado) colocado no ponto focal de uma lente semiesférica (2) onde os raios de luz são colimados num feixe de luz paralelo.

Depois a luz é polarizada por um polarizador fixo (3) antes de entrar na cascata de polarizadores com inclinação variável (4). Esta cadeia escurece a luz de acordo com cada ângulo do polarizador e, em seguida, passa pela segunda lente para focalizar no detetor, um fotodiodo (6).

Antes de chegar ao fotodiodo, a luz pode passar por um filtro encarnado (5) para diminuir a largura de banda e limitar o ruído externo. Este filtro não é totalmente necessário e pode ser substituído por um papel celofane encarnado ou simplesmente retirado no caso de uma estrutura plástica totalmente opaca.

==Alinhamento do Caminho Óptico==
A estrutura principal do kit experimental tem a luz a propagar-se em raios paralelos através da cascata de polarizadores. Estes raios, posteriomente, são centralizados no sensor (fotodiodo). Para obter uma boa leitura da relação sinal-ruído é crucial ter esta estrutura perfeitamente alinhada. Assim sendo, a posição linear do LED emissor e do fotodiodo deve ser ajustada de acordo com o seguinte procedimento:

#Primeiramente, montar a fonte de luz (LED) e as lentes da estrutura;
#Alimentar o LED e seguir a imagem circular emergente do output, ex. projetá-la numa parede afastada um par de metros;
#Mover a posição do LED de modo a obter uma imagem de output o mais próxima do tamanho do círculo de saída possível (~30mm);
#Instalar a estrutura para a cascata de polarizadores sem colocar as lentes ou películas polarizadoras;
#Para focar a luz no fotodiodo, colocar a segunda lente de colimação;
#Usando um voltímetro para ler a intensidade da luz recebida pelos terminais do fotodiodo, mover para trás e para a frente a posição do fotodiodo a fim de maximizar o sinal;
#Colar firmemente a fonte de luz e o fotodiodo nas suas posições finais.

==Calibração do Caminho Óptico==

Assim que a montagem mecânica estiver completa, é necessário calibrar a posição absoluta de cada polarizador; efetivamente todos os polarizadores vão ter um pequeno offset, resultando num erro sistemático. Deste modo, é importante anotar os valores dos ângulos que maximizam a transmissividade.

O primeiro polarizador é fixo e deve ser posicionado com um pequeno offset com o intuito de evitar começar a experiência a partir de um máximo, permitindo uma fácil observação de tal máximo. Aconselha-se colocá-lo entre os 15 e os 30 graus e prendê-lo eficazmente, se necessário usando até cola.
Depois, começar o procedimento de calibração inserindo o segundo polarizador e rodando-o até que os máximos serem detetados e medidos (normalmente são dois). Anotar o seu valor e deixar o segundo polarizador nessa posição. De seguida, inserir o terceiro polarizador e repetir o procedimento de deteção e anotação dos máximos. Repetir este passo para todos os restantes polarizadores.
Todas as vezes que lentes ou películas polarizadoras são instaladas precisam de ser bem fixas ou coladas. No caso do uso da cola, ''garantir que não danifica as lentes/películas polarizadoras''.

No final, uma tabela com os máximos ângulos de transmissão é obtida, indicando o valor de referência para a intensidade máxima na cascata de polarizadores.

Posteriormente, ao realizar experiências, os valores de offset devem ser tidos em conta de modo a eliminar o erro sistemático do sistema.
== Software ==
Para utilizar corretamente a experiência, os comandos e a recolha de dados têm de estar operacionais. Isto pode ser alcançado de duas formas, atuando através da ligação série ao Arduino Mega.

O firmware existente no Arduino é capaz de (i) configurar a experiência, (ii) executar e recolher os dados gerados, e (iii) executar algumas funções especializadas de forma a testar, calibrar e manter a experiência. Para interagir com o firmware, pode-se usar um código proxy em Python (camada de software de alto nível) capaz de comunicar com o servidor FREE, ou um emulador de terminal como o Minicom, disponível para Linux, que permite enviar e receber dados através da ligação série.

== Proxy FREE do Raspberry ==
O Raspberry Pi é responsável por transmitir o feed de vídeo da experiência e estabelecer a comunicação com o Servidor FREE utilizando uma interface proxy. O FREE aloja a interface gráfica do utilizador (GUI) para os clientes. Esta secção fornece uma visão geral concisa do procedimento utilizado para controlar todos os componentes eletrónicos através do Arduino, bem como dos protocolos de comunicação entre o Arduino e o Servidor FREE.

=== Modelo de comunicação entre o Servidor FREE e o Raspberry PI ===
A comunicação entre o servidor e a experiência segue o protocolo estruturado do e-lab que permite a interação e troca de dados em tempo real. O servidor central, Exp Server, atua como um intermediário entre os utilizadores e o aparelho experimental (RPi Server). Os utilizadores interagem com o Exp Server através de uma interface web feita com Django, uma framework web de alto nível em Python, para configurar e controlar os parâmetros da experiência, enquanto o Exp Server retransmite diretamente estes comandos para a configuração experimental.

A comunicação entre o Exp Server e o RPi Server ocorre através da internet utilizando mensagens no formato JSON, garantindo flexibilidade entre diferentes configurações experimentais. A autenticação é realizada na fase de ligação, onde o RPi Server transmite um ID e uma chave secreta para verificação. Uma vez autenticado, o Exp Server envia um ficheiro de configuração específico da experiência para o RPi Server, que depois estabelece a comunicação com o controlador local utilizando o protocolo predefinido [7]. Durante toda a experiência, o RPi Server troca continuamente atualizações de estado, resultados experimentais e mensagens de erro com o servidor XP, garantindo uma operação sincronizada e acessibilidade de dados em tempo real para os utilizadores.

=== Modelo de comunicação entre o Raspberry PI e o Arduino Mega ===
Para permitir uma comunicação perfeita entre o Arduino e o Raspberry Pi 4, foi implementado o protocolo ReC Generic Drive 11, permitindo ao utilizador externo ter controlo total sobre a experiência e o seu estado através de um conjunto de comandos. O ReC Generic Drive é um protocolo de comunicação genérico concebido para laboratórios remotos, facilitando a interação entre um controlador de software (driver) e o hardware experimental. Permite uma comunicação contínua através de portas série (RS232), utilizando mensagens estruturadas onde os comandos do driver estão em minúsculas e as respostas do hardware em maiúsculas.

O protocolo garante a sincronização através do "handshaking" de mensagens e do tratamento de tempos limite (timeouts), suportando funções como identificação, configuração, transmissão de dados, configuração da experiência e relatório de erros.

Ao ler a porta série do Arduino a uma taxa de transmissão (baud rate) de 115200 bits por segundo, o utilizador envia uma cadeia de bits (terminando com o carácter \r).

== Instruções de Configuração para Administradores ==
Para implementar uma nova instância da experiência do multi-polarizador, o proxy do Raspberry Pi e o firmware do Arduino devem ser configurados e compilados. Siga estes passos para garantir uma inicialização correta:

<ol>
<li>Descarregar o repositório da experiência via SSH:
<pre>git clone https://github.com/farrucho/multi-polarizer.git</pre></li>

<li>Modificar o ID da experiência em `main.cpp` para corresponder à configuração do servidor FREE:
<pre>expr.begin("ELAB_FIVEPOLARIZER");</pre></li>

<li>Ajustar as direções dos motores e a tensão de referência em `user_define.cpp`:
<pre>uint8_t resetDir = HIGH; // Direção para acionar o interruptor. Teste movendo para trás para garantir que aciona corretamente.
uint8_t dirToTop = LOW;
int vrefMode = 1;</pre></li>

<li>Identificar a porta série do Arduino:
<pre>ls /dev/tty*</pre>
Atualizar o ficheiro `platformio.ini` com a porta correta (ex., `monitor_port = /dev/ttyACM0`).</li>

<li>Compilar e carregar o firmware utilizando o PlatformIO a partir da pasta `e-lab`:
<pre>pio run -t upload -t monitor -t clean</pre></li>

<li>Configurar o script de arranque do proxy editando `/etc/rc.local`:
<pre>sudo nano /etc/rc.local</pre>
Adicionar as seguintes linhas antes de `exit 0`:
<pre>_IP=$(hostname -I) || true
if [ "$_IP" ]; then
printf "My IP address is %s\n" "$_IP"
fi
sleep 120
cd /home/elab/RPi_Proxy_fivepol
su elab -c "sh start-wp.sh &"</pre></li>

<li>Ativar o serviço `rc-local` no arranque utilizando o `systemctl`:
<pre>sudo systemctl enable rc-local
sudo systemctl start rc-local</pre></li>
</ol>

---

= Firmware =
A programação foi feita em linguagem C++ sem recurso a bibliotecas externas. Para declarar um componente no código, basta fornecer o pino de entrada correspondente e aceder à função de ativação (enable) para o inicializar, bem como à função `isTrigger` para verificar se o valor lógico lido corresponde ao estado de acionamento do componente. Neste caso particular, o interruptor é ativado com um sinal LOW (baixo). Uma vez que todos os objetos e respetivos componentes precisam de ser inicializados e desligados, cada um possui funções correspondentes de enable/disable. Os componentes ligados a pinos de leitura simples, declarados como `pinMode` (como interruptores e fotodíodos), não requerem uma função de desativação, pois o `pinMode` não impede a leitura dos pinos, servindo antes para definir o tipo de entrada a ser processada.

De modo a rodar os motores de passo, a operação consiste em enviar um pulso cada vez que se pretende uma rotação de 1.8º (0.36º efetivos). Como diferentes valores de RPM requerem diferentes intervalos de pulso, a frequência de pulsos enviados tem de ser calculada em conformidade. Para executar uma sequência discreta de passos com base num dado ângulo em graus, foi implementada a função rotate. O motor roda para o múltiplo inteiro inferior mais próximo de 1.8º em relação ao ângulo fornecido.

O intervalo de aquisição de dados é crucial para a experiência final, uma vez que o objetivo é otimizar a utilização, minimizando os tempos de espera na recolha da intensidade da luz e dos dados do ângulo de varrimento. Para contornar isto, foi utilizada uma RPM global de 600 rotações por minuto. Com um limite de varrimento de 324º, o tempo de aquisição de dados medido experimentalmente para varrer um ou mais polarizadores em simultâneo foi de aproximadamente 40 segundos.

Para refinar ainda mais as leituras de tensão do fotodíodo, foi implementada uma média aritmética de N pontos na função de leitura de tensão do fotodíodo. Ao calcular a média aritmética sobre 13 pontos do valor medido, o desvio padrão desta média reduz o desvio padrão original em ≈ 27.14%. Esta redução foi considerada aceitável para a experiência, uma vez que o ajuste de dados efetuado foi bem-sucedido.

== Depuração pelo Utilizador e Comandos Série ==
Para testes manuais de hardware e calibração, os administradores podem enviar comandos série diretos para o Arduino utilizando um emulador de terminal como o Minicom.

Ligue-se ao terminal utilizando a porta correta identificada anteriormente:
<pre>minicom -D /dev/ttyACM0</pre>

Ao enviar um ponto de interrogação `?` e pressionar Enter, o firmware irá devolver um menu de ajuda listando todos os comandos disponíveis. Abaixo encontra-se a explicação para cada comando suportado:

{| class="wikitable"
! Comando !! Parâmetros !! Descrição
|-
| `cur` || Nenhum || Retorna os parâmetros configurados atualmente.
|-
| `str` || Nenhum || Inicia o varrimento da experiência com base nos parâmetros configurados previamente.
|-
| `stp` || Nenhum || Para imediatamente a experiência e interrompe todos os movimentos dos motores.
|-
| `rst` || Nenhum || Repõe e move todos os motores de passo para a posição inicial (home), recuando até que os respetivos interruptores de fim de curso sejam acionados.
|-
| `ids` || Nenhum || Retorna a string de identificação do hardware e do firmware.
|-
| `cfg` || `theta1 theta2 theta3 theta4 theta5` || Configura as posições iniciais ou alvo (em passos) para cada um dos 5 polarizadores. Os limites são restringidos por `MAXIMUM_STEP`.
|-
| `led` || `on [0:255]` ou `off` || Controla a intensidade do LED vermelho utilizando Modulação por Largura de Pulso (PWM). O valor varia de 0 (desligado) a 255 (brilho máximo).
|-
| `lamp` || `on [0:255]` ou `off` || Controla a intensidade da fonte de luz auxiliar utilizando Modulação por Largura de Pulso (PWM). O valor varia de 0 (desligado) a 255 (brilho máximo).
|-
| `set maxstep` || `[0:1000]` || Define o limite mecânico máximo permitido para os polarizadores. Por predefinição, 900 passos correspondem ao limite físico de 900*0.36º=324.0º.
|-
| `set vref` || `[1:3]` || Ajusta a tensão de referência do Conversor Analógico-Digital (ADC) para evitar a saturação do fotodíodo dependendo da intensidade da luz. (1: Vref = 1.1V, 2: Vref = 2.56V, 3: Vref = 5V).
|-
| `move forward` || `polarizer[1:5] steps[0:MAXIMUM_STEP]` || Roda manualmente um polarizador específico para a frente pelo número de passos designado.
|-
| `move backward` || `polarizer[1:5] steps[0:MAXIMUM_STEP]` || Roda manualmente um polarizador específico para trás pelo número de passos designado.
|-
| `go to origin` || `polarizer[1:5]` || Comanda um único polarizador específico a regressar à sua posição zero/inicial até acionar o seu interruptor.
|}
=Links=

*[[Multiple polarizers experimental apparatus | Versão Inglesa (English Version)]]
*[https://elab.vps.tecnico.ulisboa.pt:8000/execution/create/33/14 Link direto à sala de controlo]
*[[Light Polarization with multiple polarizers | Referência teórica]]
*[https://www.printables.com/model/1293618-multi_polarizer_experiment Imprime o teu kit experimental]

Multiple polarizers experimental apparatus

2026-05-26T23:23:59Z

Ist1106345: updated software+firmware sections (Laranjo)

=Apparatus description=

{|
|[[File:exploded_kit_view.png|thumb|x250px|Left|Exploded view of the experimental kit.]]
|[[File:exploded_kit_view_1.png|thumb|x250px|Left|Exploded view of the experimental kit.]]
|}

The setup for the construction of the multiple polarizers twin experiment is composed of three main components: (i) the supporting 3D printed plastic parts whose schematics are available here, (ii) a Raspberry Pi running the control software over the internet and performing the video streaming and (iii) the low-level slave controller electronics comprising the sensing and the experiment motorisation.

=Mechanical Assembly=

{|
|[[File:Imagem_Experiência_1.jpg|thumb|x250px|Top|Top view of the experiment]]
|[[File:Imagem_Experiência_2.jpg|thumb|x250px|Top|Front view of the experiment]]
|}

In this section, the mechanical assembly of the experiment is explained in detail so that it can be used correctly.

==Order of assembly==

1. Check if all the parts needed to assemble the mechanical structure of the experiment are available.
{|
|[[File:parts_needed_.png|thumb|x400px|Top|Parts needed for the assembly]]
|}
The following table can be used to check the number of parts to be printed and if supports are needed:
{| class="wikitable"
! Name !! Description !! Folders !! Number of parts !! Material !! Supports: necessary
|-
| Edge || Edge that supports the corners of the box || Structural Components || 6 || PLA || No
|-
| Edge Special Left || Special edge || Structural Components || 1 || PLA || No
|-
| Edge Special Right || Special edge || Structural Components || 1 || PLA || No
|-
| Larger Face || Box face along the length || Lids || 3 || PLA || No
|-
| Face Power Supply || Box face along length with cable hole || Lids || 1 || PLA || No
|-
| Smaller Face || Box face along the width || Lids || 2 || PLA || No
|-
| Power Supply Base || Bottom of the box with the power supply || Eletronics || 1 || PLA || No
|-
| Arduino Base || Arduino case || Eletronics || 1 || PLA || No
|-
| Arduino Case Top || Arduino case || Eletronics || 1 || PLA || No
|-
| Arduino Case Bottom || Arduino case || Eletronics || 1 || PLA || No
|-
| Raspberry Pie Case Middle || Raspberry Pie Box || Eletronics || 1 || PLA || No
|-
| Raspberry Pie Case Top || Raspberry Pie Box || Eletronics || 1 || PLA || No
|-
| Raspberry Pie Case Bottom || Raspberry Pie Box || Eletronics || 1 || PLA || No
|-
| Lid 2 Steppers || Box top that supports two motors || Polarizer Assembly || 1 || PLA || No
|-
| Lid 3 Steppers || Box top that supports two motors || Polarizer Assembly || 1 || PLA || No
|-
| Stepper_holder_left || Stepper motor support, compatible with the box cover with 2 supports || Polarizer Assembly || 1 || PLA || No
|-
| Stepper_holder_right || Stepper motor support, compatible with the box cover with 3 supports || Polarizer Assembly || 1 || PLA || No
|-
| Polarizer Support Detector || Support for the polarizer assembly, detector side || Polarizer Assembly || 1 || PLA || No
|-
| Polarizer Support led || Support for the polarizer assembly, emitter side || Polarizer Assembly || 1 || PLA || yes, for the pins that secure the polarizer
|-
| Bar || Support bar for polarizer supports; adjusts compression exerted || Polarizer Assembly || 1 || PLA || No
|-
| Gear || Gear wheel that fits behind each polarizer || Polarizer Assembly || 5 || PLA || No
|-
| Fixed Polarizer Holder || Fixed polarizer holder that fits into the polarizer Support led || Optical Assembly || 1 || PLA || yes
|-
| Detector Holder || Part that secures the LED adjuster || Optical Assembly || 1 || PLA || No
|-
| Detector Adjuster || Part that secures the LED holder || Optical Assembly || 1 || PLA || No
|-
| Led Ajuster || Part that secures the LED holder || Optical Assembly || 1 || PLA || yes, for the pins that secure the polarizer
|-
| Led Holder || LED and detector holder, which fits into the adjustment parts above || Optical Assembly || 2 || PLA || No
|-
| Base || Base for the camera || Camera_holder || 1 || || yes
|-
| Support || || Camera_holder || 3 || || yes
|-
| Arm || || Camera_holder || 1 || || yes
|-
| Joint || || Camera_holder || 1 || || yes
|}
2. Peel the supports of the pulleys using pliers or an X-Acto knife.
{|
|[[File:peeled_support_1.jpg|thumb|x250px|Top|Peeling the support]]
|[[File:peeled_support_2.jpg|thumb|x250px|Top|Peeling the support]]
|}

3. Put the belt on the peeled pulleys.
{|
|[[File:belt_on_pulley.jpg|thumb|x250px|Top|Belt on pulley]]
|}

4. Connect the pulleys with the polarizer holders. Make sure to hear a “click” as only one side of the polarizer leads to this firm blockade. Additionally, place the polarizer inside the polarizer holder. (Don't forget to remove the polarizer protection if needed)
{|
|[[File:pulley_polarizer.jpg|thumb|x250px|Top|Pulley and polarizer holder connection position]]
|[[File:pulley_polarizer_connected.jpg|thumb|x250px|Top|Pulley and polarizer holder connected]]
|}

5. Repeat steps 2, 3 and 4 until a complete chain is achieved. You will get a cascaded polarizers set capable to move between each one. Do not forget to put the belts on, as they are not represented in the example picture.
{|
|[[File:pulley_polarizer_chain.jpg|thumb|x250px|Top|Chain of connected pulleys and polarizers]]
|}

6. Cut the thin layers covering the holes of the main plates of the structure.
{|
|[[File:thin_layer_cutting_process.jpg|thumb|x250px|Top|Main plates thin layers cutting process]]
|[[File:thin_layer_cut.jpg|thumb|x300px|Top|Main plates thin layers cut]]
|}

7. Place two of the four pillars together and put the nuts in the specific holes on top of one of the pillars.
{|
|[[File:nuts_on_pillars.jpg|thumb|x250px|Top|Nuts placed on the pillar]]
|}

8. Insert the bolts through the holes and bolt the two pillars together.
{|
|[[File:bolts_on_pillars.jpg|thumb|x250px|Top|Bolts placed on the pillar]]
|[[File:pillars_bolted_together.jpg|thumb|x250px|Top|Pillars bolted together]]
|}

9. Place the main plates next to each other.
{|
|[[File:main_plates_placement.jpg|thumb|x250px|Top|Placement of the main plates (same as shown in the step 1 image)]]
|}

10. Place the bolted pillars on the side of the junction of the two plates.
{|
|[[File:junction_placement.jpg|thumb|x250px|Top|Placement of the pillars]]
|}

11. Place the chain support on the other side of the main plates, so that they are in opposite positions. Check if the chain support is placed on top of the hexagonal holes.
{|
|[[File:chain_support_opposite_to_pillars.jpg|thumb|x250px|Top|Placement of the chain support]]
|[[File:chain_support_in_position.jpg|thumb|x250px|Top|Placement of the chain support]]
|}

12. Place the nuts on the chain support inside the “boxes” closest to the chain support “wall”.
{|
|[[File:nuts_placement.png|thumb|x250px|Top|Chain support nuts placement]]
|}

13. Insert the bolts through the holes on the bolted pillars and bolt the pillars, the main plates and the chain support together.
{|
|[[File:bolts_placement.png|thumb|x250px|Top|Insert the bolts through the highlighted holes]]
|}

14. Insert the nuts inside the other holes of the chain support.

15. Insert the bolts through the main plates and fully bolt the chain support to the main plates.
{|
|[[File:bolt_chain_support.jpg|thumb|x250px|Top|Bolt the chain support to the main plates and the pillars]]
|}

16. Repeat steps 7 and 8.

17. Go to the opposite side of the main plates and place the bolted pillars under the circular holes.

18. Place the nuts inside the top holes of the bolted pillars.

19. Insert the bolt through the main plates and bolt them together with the pillars.
{|
|[[File:bolt_the_other_pillars.jpg|thumb|x250px|Top|Bolt the other pillars]]
|}

20. Connect the chain with the bolted chain support and with the loose one, as well.
{|
|[[File:chain_in_place.jpg|thumb|x250px|Top|Chain structure placement]]
|}

21. Place the nuts inside the specific “boxes” of the loose chain support.

22. Insert the bolts through the holes in the main plates to connect the loose chain support to the main plates.
{|
|[[File:fully_bolted_chain.jpg|thumb|x250px|Top|Bolted chain structure]]
|}

23. Pick one of the pillars and place the nut inside the middle “box”.
{|
|[[File:nut_middle_box.jpg|thumb|x250px|Top|Nut inside the middle "box"]]
|}

24. Place it beneath the main plates in one of the corners.

25. Insert the bolt through the main plates to bolt them to the pillar.
{|
|[[File:corner_placement.jpg|thumb|x250px|Top|Corner placement]]
|}

26. Repeat steps 23, 24 and 25 until the four corners of the structure are supported.

27. Remove the small pillars on the surface facing downwards of the main plate to allow nuts to be inserted into those “boxes.”
{|
|[[File:remove_small_pillars_1.jpg|thumb|x250px|Top|Small pillars removal]]
|[[File:remove_small_pillars_2.jpg|thumb|x250px|Top|Small pillars removal]]
|}

28. Insert the nuts inside those “boxes”.
{|
|[[File:nuts_on_main_plate_1.jpg|thumb|x250px|Top|Nuts placement on the main plate]]
|[[File:nuts_on_main_plate_2.jpg|thumb|x250px|Top|Nuts placement on the main plate]]
|}

29. Place the stepper holder above the holes.

30. Insert the bolts through the holes of the stepper holder in order to connect it to the main plates.
{|
|[[File:stepper_holder_placement.jpg|thumb|x250px|Top|Stepper holder placement on the main plate]]
|}

31. Repeat steps 28, 29 and 30 for the other four stepper holders.

32. Place the stepper motor on the stepper holder by first putting the wires through the top and bottom holes. Then, hear a click to ensure the stepper motor is well fixed. NOTE: the cable connection may vary depending on the driver, it is not reliable to use cable colors.
{|
|[[File:wires_placement.jpg|thumb|x250px|Top|Wires entering position]]
|}

33. Repeat step 32 for the other 4 stepper motors.
{|
|[[File:stepper_placement.jpg|thumb|x250px|Top|Stepper motor placement]]
|}

34. Place the belt in the pulley.

35. Connect the pulley (with the belt) to the stepper motor.
{|
|[[File:motor_placement.jpg|thumb|x250px|Top|Pulley placement with the belt on]]
|}

36. Tighten the pulley.
{|
|[[File:motor_tightened.jpg|thumb|x250px|Top|Tightening of the pulley]]
|}

37. Adjust the stepper holder position to ensure the belt is not loose.
{|
|[[File:adjust_stepper_holder_position.jpg|thumb|x250px|Top|Stepper holder too close to the chain (Belt is loose)]]
|}

38. Tighten the bolts of the stepper holder to fix it.
{|
|[[File:stepper_holder_position_adjusted.jpg|thumb|x250px|Top|Stepper holder in the correct position]]
|}

39. Repeat steps 34, 35, 36, 37 and 38 for the other four stepper holders.

40. Assembly completed.

=Electronic circuit=

The experiment has two main electronic parts, the drivers (1) for the step-motors and the light source and detection (2).

==Electronic component assembly==

1. Check if all the parts needed for the electronic component assembly of the experiment are available.
{|
|[[File:electric_assembly_parts.jpg|thumb|Parts needed for the electronic component assembly.]]
|}

2. Get the left floor of the electronic component (see the image below) and use a soldering iron to insert the heat inserts in the floor's holes, through the thermal insertion process.
{|
|[[File:electric_assembly_left_floor.jpg|thumb|Left floor of the electronic component.]]
|[[File:insercao_termica.jpg|thumb|Thermal insertion.]]
|}

3. Get the Arduino Mega box (see the image below) and bolt it to the floor.
{|
|[[File:arduino_case.jpg|thumb|Arduino Mega box.]]
|}

4. Use a soldering iron to insert the heat inserts in the box holes, through the thermal insertion process.
{|
|[[File:arduino_case_holes.jpg|thumb|Holes in the Arduino Mega box.]]
|}

5. Select a heat sink.
{|
|[[File:Heat_Sink.jpg|thumb|Heat Sink.]]
|}

6. Remove the paper protection.
{|
|[[File:paper_protection_removal.jpg|thumb|Remove the paper protection.]]
|[[File:paper_removed.jpg|thumb|Remove the paper protection.]]
|}

7. Glue the heat sink to the step-motor driver.
{|
|[[File:heat_sink_placement.jpg|thumb|Heat sink placement.]]
|[[File:heat_sink_placed.jpg|thumb|Heat sink placed.]]
|}

8. Repeat the steps 1, 2 and 3 for the other five step-motor drivers.

9. Place the step-motor driver on the RAMPS 1.4 (RepRap Arduino Mega Pololu Shield)
{|
|[[File:Placa_RAMPS.jpg|thumb|RAMPS 1.4.]]
|[[File:Placa_RAMPS_software.png|thumb|RAMPS 1.4 (software view).]]
|}

10. Check if the step-motor driver is well placed, meaning its ground connection is as shown in the image below and that the bolt (potentiometer) is on the opposite side of the power supply (in the case of the green and red step-motor drivers) or in the side of the power supply (in the case of the purple step-motor drivers).
{|
|[[File:drivers.png|thumb|Step-motor drivers models.]]
|[[File:driver_placement_software.png|thumb|Purple step-motor driver placement (software view).]]
|[[File:driver_placement_green.png|thumb|Purple and green step-motor driver placement.]]
|}

11. Repeat the steps 5 and 6 for the other five step-motor drivers.
{|
|[[File:driver_placement.jpg|thumb|RAMPS 1.4 with the step-motor drivers in place.]]
|}

12. Connect the switches to the wires.
{|
|[[File:switches_wires.jpg|thumb|Switches connection to the wires.]]
|}

13. Place the switches in the switch holder. Ensure you hear a "click" to confirm they are well positioned.
{|
|[[File:switches_placement.png|thumb|Switches positioning in the holder.]]
|}

14. Connect the step-motor wires to the step-motor drivers through the RAMPS 1.4. Check the pinouts connection through its colour and according to the information provided in the subsection [[#Step-motor drivers|Step-motor drivers]].
{|
|[[File:stepper_wires_placement.jpg|thumb|Wires connection in the RAMPS 1.4.]]
|[[File:stepper_array.png|thumb|Top-view of kit:numbering of thre steppers and respective switches.]]
|[[File:switches_wires_placement_software.png|thumb|Switches' wires (green) and step-motor wires (blue) (software view).]]
|}

15. Assemble the detector and photodiode electric circuit.
{|
|[[File:photodiode_circuit.jpg|thumb|Detector and photodiode electric circuit schematics.]]
|}

16. Place the electric circuit in the box corner, position it according to the holes, and bolt it.
{|
|[[File:electric_circuit.jpg|thumb|Switchers positioning in the switch holder.]]
|}

17. Get the top part of the Arduino Mega box and bolt it to the bottom part (attention to the wires when closing the box).
{|
|[[File:arduino_top_case.jpg|thumb|Top part of the Arduino Mega box.]]
|}

18. Repeat the step 2 for the right floor.
{|
|[[File:electric_assembly_right_floor.jpg|thumb|Right floor of the electronic component.]]
|}

19. Place the power supply on the right floor and secure it with bolts.
{|
|[[File:power_supply.jpg|thumb|Power supply.]]
|[[File:power_supply_top_view.jpg|thumb|Top view of the power supply.]]
|}

20. Get the bottom part of the Raspberry Pi box and repeat the step 4.
{|
|[[File:raspberry_pi_case.jpg|thumb|Raspberry Pi box.]]
|}

21. Bolt the Raspberry Pi to the box.
{|
|[[File:raspberry_pi.jpg|thumb|Raspberry Pi.]]
|}

22. Connect the middle part of the Raspberry Pi box to the bottom part.

23. Place the cover to close the box.

==Step-motor drivers==
[[file:StepMotorCable.jpg | Numbering of the step-motor cable connection|thumb|120px]]
The step-motor drivers can have multiple design outputs according to the producer. The stepper pin-outs are numbered from 1-6, from left to right from the front view (shaft pointing you, connector downwards).
The driver's location on the arduíno mezzanine relates to the step-motor according to the schema below:

{| border="1" style="width:150px; height:150px; text-align:center;"
|+ Driver to step-motor link
| style="width:66px; height:66px;" | 5
| style="width:66px; height:66px;" | 3
| style="width:66px; height:66px;" | N/A
|-
| style="width:66px; height:66px;" | 1
| style="width:66px; height:66px;" | 2
| style="width:66px; height:66px;" | 4
|}

By using a proper cable the connections should follow the table below:
{| border="1" style="text-align: center;"
|+ Driver to step-motor connections
|-
!Motherboard pin-out
!Cable color
!Step-motor pin (A4988)
!Step-motor pin (DRV8825)
|-
|2B
|Red
|
|6
|-
|2A
|Green
|
|3
|-
|1A
|Black
|
|1
|-
|1B
|Blue
|
|4
|-
|}

==Light source and detection==
[[File:NPolarizersElectronicCircuit.png|thumb|Schematic for the LED PWM connection to the A4 pin of the controller board and the filter for the photodiode detection circuit.]]

The red LED is fed by a PWM output pin (A4) from the main controller board, which allows for a variable light intensity. The default PWM from the board has a 490Hz modulation in steps of 1/256, giving a resolution of less than 0.5%.

After passing the cascade of polarizers, the signal is detected by a photodiode. This photodiode is inversely biased with a resistor to ground in order to have a zero signal when no light is present.

As the signal is modulated and its frequency has to be removed we use a low-pass first order RC-filter. As the time constant is ~1s, is necessary to delay the first acquisition for the settling of the circuit voltages. Then, as the signal varies smoothly and slowly due to the polarizer rotation, and oversampling is in place, a much lower settling time is needed.

=Optical path=
[[File:Polarizer optical circuit.png|thumb|x120px|Top|Optical path showing the collimating system to let the light pass through the cascade of polarizers in parallel rays.]]
The optical path consists of a light source (1) (red LED) placed in the focal point of a semi-spherical lens (2) where the light rays are collimated in a parallel beam of light.

Then it is polarized by the fixed polarizer (3) before entering the cascade of variable tilt polarizers (4). This chain will dim the light according to each polarizer angle and it passes the second lens in order to focus on the detector, a photodiode (6).

Before reaching the photodiode, light may pass a red filter (5) to narrow the bandwidth and limit external noise. This filter is not damned necessary and can be replaced by red cellophane paper or even absent in case of a fully opaque plastic structure.

==Optical path alignment==
The main body of the device has the light propagating in parallel rays through the cascade of polarizers. Those rays are later focused on the sensor (photo-diode). It is crucial for a good signal-to-noise reading to have the system perfectly aligned. For that end, the linear position of the emitting LED and the photo-diode receiver can be adjusted according to the following procedure:

#First assemble the system lens and the light source (LED);
#Energize the LED and follow the emerging circular image from the output, eg. projecting it in a wall a couple of meters apart;
#Move the LED position in order to have an output image closer to the size of the exit circle (~30mm);
#Install the structure for the cascade of polarizers without any lens or hard film in it;
#Put in place the second collimating lens in order to focus the light in the photo-diode;
#Using a voltmeter for reading the collected light intensity to the photo-diode terminals, move back and forward the photo-diode position in order to maximize the signal;
#Firmly glue the light source and photo-diode positions in their final position.

==Optical path calibration==

Once the support structure is in place, is necessary to calibrate the absolute position of each polarizer; effectively all the polarizers will have a small offset giving a systematic error. It is important to note these angular value that maximizes the transmissivity.

The first polarizer is fixed and shall be positioned with a couple of degrees in order to avoid starting the experiment from a maximum, allowing for easy observation of such maxima. Consider having it around ~15º to 30º and well secured, eventually with glue.
Then start the calibration procedure by inserting the second polarizer and rotating it until the maximums are detected and measured (usually two). Take note of their value and leave the second polarizer at rest in the measured position. Now insert the third polarizer and repeat the procedure for the detection of the maximums and do this for the rest of them.
Every time a hard film or lens is installed it has to be firmly fixed or glued. If glue is used it ''must not damage the polarizer film''.

You will end up with a table of maximum transmission angles, leading to the reference value of maximum intensity in the cascade of polarizers.

It is provided in the firmware a function able to rotate a set of polarizers in conjunction with each other. With this procedure local maximums can be inferred to confirm the previous determined values. In fact, if a group of the last polarizers are made to rotate in conjunction, the maximum is dictated by the first one to rotate in order to the last one fixed.

Later, when performing the experiments these values of offsets must be considered in order to eliminate the systematic error of the system.
== Software ==
To properly use the experiment, commands and data retrieval have to be in place. This can be achieved in two ways acting through the serial connection to the Arduino Mega.

The firmware existing in the Arduino is able to (i) configure the experiment, (ii) run and retrieve the generated data, and (iii) execute some specialized functions in order to test, calibrate, and maintain the experiment. To interface with the firmware, one can use a Python proxy code (high-level software layer) capable of interoperating with the FREE server, or a terminal emulator like Minicom available for Linux that allows you to send and receive data over the serial connection.

== Raspberry FREE proxy ==
The Raspberry Pi is responsible for transmitting the video feed of the experiment and establishing communication with the FREE-Server by using a proxy interface. The FREE hosts the graphical user interface (GUI) to the clients. This section provides a concise overview of the procedure used to control all electronic components via the Arduino, as well as the communication protocols between the Arduino and the FREE-Server.

=== Communication model between the FREE-Server and the Raspberry PI ===
The communication between the server and the experiment follows the elab’s structured protocol that enables real-time interaction and data exchange. The central server, Exp Server, acts as an intermediary between users and the experimental apparatus (RPi Server). Users interact with Exp Server via a web interface made with Django, a high-level Python web framework, to configure and control the experiment parameters, while Exp Server directly relays these commands to the experimental setup.

The communication between Exp Server and RPi Server occurs over the internet using JSON-formatted messages, ensuring flexibility across different experimental configurations. Authentication is performed at the connection stage, where the RPi Server transmits an ID and a secret key for verification. Once authenticated, the Exp Server sends an experiment-specific configuration file to the RPi Server, which then establishes communication with the local controller using the predefined protocol [7]. Throughout the experiment, the RPi Server continuously exchanges status updates, experimental results, and error messages with the XP server, ensuring synchronized operation and real-time data accessibility for users.

=== Communication model between the Raspberry PI and the Arduino Mega ===
To enable seamless communication between the Arduino and the Raspberry Pi 4, the protocol ReC Generic Drive 11 was implemented, allowing the external user to have full control over the experiment and its status through a set of commands. The ReC Generic Drive is a generic communication protocol designed for remote laboratories, facilitating interaction between a software driver and experimental hardware. It enables seamless communication over serial ports (RS232), using structured messages where driver commands are in lowercase and hardware responses in uppercase.

The protocol ensures synchronization through message handshaking and timeout handling, supporting functions like identification, configuration, data transmission, experiment configuration, and error reporting.

By reading the Arduino’s serial port at a baud rate of 115200 bits per second, the user sends a bit string (ending with the character \r).

== Administrator Setup Instructions ==
To deploy a new instance of the multi-polarizer experiment, the Raspberry Pi proxy and the Arduino firmware must be configured and compiled. Follow these steps to ensure proper initialization:

<ol>
<li>Download the experiment repository via SSH:
<pre>git clone https://github.com/farrucho/multi-polarizer.git</pre></li>

<li>Modify the experiment ID in `main.cpp` to match the FREE server configuration:
<pre>expr.begin("ELAB_FIVEPOLARIZER");</pre></li>

<li>Adjust the motor directions and reference voltage in `user_define.cpp`:
<pre>uint8_t resetDir = HIGH; // Direction to trigger the switch. Test by moving backward to ensure it triggers correctly.
uint8_t dirToTop = LOW;
int vrefMode = 1;</pre></li>

<li>Identify the Arduino's serial port:
<pre>ls /dev/tty*</pre>
Update the `platformio.ini` file with the correct port (e.g., `monitor_port = /dev/ttyACM0`).</li>

<li>Compile and upload the firmware using PlatformIO from within the `e-lab` folder:
<pre>pio run -t upload -t monitor -t clean</pre></li>

<li>Configure the startup proxy script by editing `/etc/rc.local`:
<pre>sudo nano /etc/rc.local</pre>
Add the following lines before `exit 0`:
<pre>_IP=$(hostname -I) || true
if [ "$_IP" ]; then
printf "My IP address is %s\n" "$_IP"
fi
sleep 120
cd /home/elab/RPi_Proxy_fivepol
su elab -c "sh start-wp.sh &"</pre></li>

<li>Enable the `rc-local` service on boot using `systemctl`:
<pre>sudo systemctl enable rc-local
sudo systemctl start rc-local</pre></li>
</ol>

= Firmware =
The programming was done using the C++ language without any external libraries. To declare a component in the code, one simply provides the corresponding input pin and accesses the enable function to initialize it, as well as the `isTrigger` function to check whether the logical value read corresponds to the component’s trigger state. In this particular case, the switch is active on a LOW signal. Since all objects and respective components need to be initialized and turned off, each has corresponding enable/disable functions. Components connected to single read pins, declared as `pinMode` (such as switches and photodiodes), do not require a disable function since `pinMode` does not prevent reading the pins but rather helps define the type of input being processed.

In order to rotate the stepper motors, the operation consists of sending a pulse each time a rotation of 1.8º (0.36º effective) is desired. Since different RPM values require different pulse intervals, the frequency of sent pulses must be calculated accordingly. To execute a discrete sequence of steps based on a given angle in degrees, the rotate function was implemented. The motor rotates to the nearest low integer multiple of 1.8º relative to the provided angle.

The data acquisition interval is crucial for the final experiment since the goal is to optimize the user experience by minimizing waiting times when retrieving the intensity of light and scanning angle data. To address this, a global RPM of 600 revolutions per minute was used. With a scanning limit of 324º, the experimentally measured data acquisition time for scanning one or more polarizers simultaneously was approximately 40 seconds.

To further refine the voltage readings from the photodiode, an arithmetic mean of N points was implemented in the photodiode voltage reading function. By computing the arithmetic mean over 13 points of the value being measured, the standard deviation of this mean reduces the original standard deviation by ≈ 27.14%. This reduction was deemed acceptable for the experiment, as the data adjustment performed was successful.

== User Debugging and Serial Commands ==
For manual hardware testing and calibration, administrators can send direct serial commands to the Arduino using a terminal emulator like Minicom.

Connect to the terminal using the correct port identified earlier:
<pre>minicom -D /dev/ttyACM0</pre>

By sending a question mark `?` and pressing Enter, the firmware will return a help menu listing all available commands. Below is the explanation for each supported command:

{| class="wikitable"
! Command !! Parameters !! Description
|-
| `cur` || None || Returns the current configured parameters.
|-
| `str` || None || Starts the experiment sweep based on the previously configured parameters.
|-
| `stp` || None || Immediately stops the experiment and halts all motor movements.
|-
| `rst` || None || Resets and homes all stepper motors by moving them backward until their respective limit switches are triggered.
|-
| `ids` || None || Returns the hardware and firmware identification string.
|-
| `cfg` || `theta1 theta2 theta3 theta4 theta5` || Configures the starting or target positions (in steps) for each of the 5 polarizers. Limits are bound by `MAXIMUM_STEP`.
|-
| `led` || `on [0:255]` or `off` || Controls the red LED intensity using Pulse Width Modulation (PWM). Value ranges from 0 (off) to 255 (maximum brightness).
|-
| `lamp` || `on [0:255]` or `off` || Controls the auxiliar light source intensity using Pulse Width Modulation (PWM). Value ranges from 0 (off) to 255 (maximum brightness).
|-
| `set maxstep` || `[0:1000]` || Defines the maximum allowed mechanical limit for the polarizers. By default, 900 steps corresponds to the 900*0.36º=324.0º physical limit.
|-
| `set vref` || `[1:3]` || Adjusts the Analog-to-Digital Converter (ADC) reference voltage to prevent photodiode saturation depending on light intensity. (1: Vref = 1.1V, 2: Vref = 2.56V, 3: Vref = 5V).
|-
| `move forward` || `polarizer[1:5] steps[0:MAXIMUM_STEP]` || Manually rotates a specific polarizer forward by the designated number of steps.
|-
| `move backward` || `polarizer[1:5] steps[0:MAXIMUM_STEP]` || Manually rotates a specific polarizer backward by the designated number of steps.
|-
| `go to origin` || `polarizer[1:5]` || Commands a single specific polarizer to return to its zero/home position until it triggers its switch.
|}

=Links=

*[[Kit experimental de polarização da luz com múltiplos polarizadores | Portuguese version (Versão em Português)]]
*[https://elab.vps.tecnico.ulisboa.pt:8000/execution/create/33/14 Direct link for the control room]
*[[Light Polarization with multiple polarizers | Reference lesson]]
*[https://www.printables.com/model/1293618-multi_polarizer_experiment Print your experiment]

Admin

2026-03-17T14:14:42Z

Ist1106345: added static_ip of cavidade

== Links for administrative private pages ==

[[Page Template]]

[[Cluster configuration|Node/apparatus table connections]]

[[dsPic-Raspberry programmer interface]]

[[REC Prototype function]]

[[:File:ReC_Generic_Driver.pdf | REC Generic Driver]]

[[Free Quiz Manual]]

== General info ==
=== Table of nodes ===

{| class="wikitable"
!colspan="6"|Control rooms
|-
| '''Hostname
| '''Experiment
| '''Stream
| '''Watch
| '''Serial
| '''Baud rate
|-
| elab100 -
| radiare
| [rtsp://elabmc.ist.utl.pt/radiare.sdp 5006]
| [http://consum.ist.utl.pt/radiare.html Watch]
| /dev/ttyS0
| 4800
|-
| UESC/Ilhéus
| 14º47'S
| 39º10'W
| 220m
| 2705mm +/- 0.5mm @23ºC
| 80.5 +/- 1.0 mm
|-
| Lisbon
| 38º41'N
| 9º12'W
| 20m
| 2677mm +/- 0.5mm @19ºC
| 80.5 +/- 1.0 mm
|-
| Maputo
| 25º56'S
| 32º36'E
| 80m
| 2609.8mm +/- 0.5mm @27ºC
| 80.5 +/- 1.0 mm
|-
| São Tomé
| 0º21'N
| 6º43'E
| 50m
| 2756.5mm +/- 0.5mm @29ºC
| 81.8 +/- 0.5 mm
|-
| Prague - CTU
| 50º5.5'N
| 14º25.0'E
| 150m
| 2850mm +/- 0.5mm @25ºC
| 80.15 +/- 0.5 mm
|-
| Barcelona - UPC
| 41º24.6'N
| 2º13.1'E
| 55
| 2756.5mm +/- 0.5mm
| 81.8mm
|-
| Rio de Janeiro - PUC
| 22º54.1'S
| 43º12'W
| 50
| 2826,0mm +/- 0.5mm
| 81.6mm
|-
| Praia - UniCV
| 14°56'N
| 23°31'W
| 40 m
| 2826,0mm +/- 0.5mm
| 81.6mm
|-
| Bogotá - UniAndes
| 4°36'N
| 74°3'W
| 2650 m
| 2815,3mm +/- 0.5mm
| 82.0mm
|-
| Panama city - UTP
| 9°1.3'N
| 79°31.9'W
| 82 m
| 2825mm +/- 0.5mm @28ºC
| 81.9mm
|-
| Santiago - UChile
| 33°27.5'S
| 70°39.8'W
| 552 m
| 2825mm +/- 0.5mm @27ºC
| 81.9mm
|-
| Valparaiso - UTFSM
| 33°1'S
| 71°37'W
| 30 m
| 2825mm +/- 0.5mm @28ºC
| 81.9mm
|}

===Glassfish===
* Parar o glassfish:
«glassfishv3/bin/asadmin stop-domain»
* Caso este não pare, ao fim de 3 minutos, fazer mesmo o kill ao processo:
«ps aux | grep java», procurar o processo que está sediado em 'glassfishv3/'
* Ver o PID o processo e
«kill PID»
* Iniciar o glassfish:
«glassfishv3/bin/asadmin start-domain»

===Acesso elab===
O endereço é elab.ist.utl.pt e a PORTA é 22xx.

Maquinas Linux

login: elab
pass: jo......

Maquinas windows ser........

Uma vez no e-lab, para reiniciar, executar:
> /usr/local/ReC7.0/scripts/restartAllElab

(esperar que o script termine, antes de desligar sessão remota/putty))

Antes de reiniciar convém perceber se há alguém a fazer experiências:

> tail -n 100 /usr/local/ReC7.0/multicast/logins.txt

Normalmente para monitorizar e ver se há problema basta
Correr o comando anterior.
Se virem que já há algum tempo ninguém faz experiências, tentar
ligar ao eLab e ver se há realmente problemas.
Se por acaso estiver muita gente ligada e não tiverem sido executadas
experiências nos últimos 10->20 mins, é porque o sistema está ''halted''.

Reiniciar :)

No caso de o e-lab estar a funcionar, mas não aparecerem experiências, fazer:

> ping 192.168.0.121

Se não existir resposta, é porque faltou a electricidade e o cluster tem
de ser reiniciado. Se obtiverem resposta, tentem reiniciar toda a
plataforma.

===Video===
START Video

/home/elab/videos/wp_saotome.start

START Hardware server
elab@wp_saotome:~ $ /home/elab/rec-deployment/wpilheus/wpilheusDaemon.sh start

STOP Hardware server
elab@wp_saotome:~ $ /home/elab/rec-deployment/wpilheus/wpilheusDaemon.sh stop

[[technical pages|e-lab technical pages (connections diagrams, schematics, hardware configurations]]
http://www.elab.tecnico.ulisboa.pt/wiki/index.php?title=Technical_pages&action=edit&redlink=1

=== Elab1 Network Hosts ===

{| class="wikitable sortable"
! IP atríbuido do DHCP
! IP Address Estático
! VPN IP
! MAC Address
! Hostname
! Experiment
! Location
! Status
! Notes
|-
| 192.168.0.17
| 192.168.0.210
| 10.7.0.23
| b8:27:eb:3f:c7:c0
| plano-inclinado
| Plano Inclinado
| Lisbon
| On
|
|-
| 192.168.0.14
| 192.168.0.211
| -
| b8:27:eb:89:30:7d
| colisione
| colisione
| Lisbon
| On
|
|-
| 192.168.0.15
| 192.168.0.212
| -
| b8:27:eb:4e:de:b3
| mag3d
| Campo Magnético 3D
| Lisbon
| On
|
|-
| 192.168.0.15
| 192.168.0.212
| -
| b8:27:eb:4e:de:b3
| mag3d
| Light Polarization
| Lisbon
| On
|
|-
| 192.168.0.200
| 192.168.0.213
| -
| b8:27:eb:f9:5d:c2
| elab200
| Sonda de Langmuir
| Lisbon
| On
|
|-
| 192.168.0.200
| 192.168.0.213
| -
| b8:27:eb:f9:5d:c2
| elab200
| elab200
| Lisbon
| -
|
|-
| 192.168.0.200
| 192.168.0.213
| -
| b8:27:eb:f9:5d:c2
| elab200
| pendulo gravitico
| Lisbon
| -
|
|-
| 192.168.0.201
| 192.168.0.214
| -
| b8:27:eb:45:03:1e
| elab201
| -
| Lisbon
| -
|
|-
| 192.168.0.201
| 192.168.0.214
| -
| b8:27:eb:45:03:1e
| elab201
| Planck
| Lisbon
| On
|
|-
| 192.168.0.201
| 192.168.0.214
| -
| b8:27:eb:45:03:1e
| elab201
| Gamma
| Lisbon
| -
|
|-
| 192.168.0.202
| -
| -
| -
| elab202
| -
| Lisbon
| Off
|
|-
| 192.168.0.203
| 192.168.0.215
| -
| b8:27:eb:9d:b8:09
| elab203
| elab203
| Lisbon
| On
|
|-
| 192.168.0.203
| 192.168.0.215
| -
| b8:27:eb:9d:b8:09
| elab203
| Condensador Cilíndrico
| Lisbon
| On
|
|-
| 192.168.0.250
| 192.168.0.216
| -
| b8:27:eb:ac:8c:3b
| fotovoltaico
| Painel Fotovoltaico
| Lisbon
| On
|
|-
| 192.168.0.100
| -
| -
| -
| elab100
| -
| Lisbon
| Off
|
|-
| 192.168.0.101
| -
| -
| -
| elab101
| -
| Lisbon
| Off
|
|-
| 192.168.0.102
| -
| -
| -
| elab102
| -
| Lisbon
| Off
|
|-
| 192.168.0.103
| -
| -
| -
| elab103
| -
| Lisbon
| Off
|
|-
| 192.168.0.104
| -
| -
| -
| elab104
| -
| Lisbon
| Off
|
|-
| 192.168.0.105
| -
| -
| -
| elab105
| -
| Lisbon
| Off
|
|-
| 192.168.0.106
| -
| -
| -
| elab106
| -
| Lisbon
| Off
|
|-
| 192.168.0.150
| -
| -
| -
| elab150
| -
| Lisbon
| On
|
|-
| 192.168.0.151
| -
| -
| -
| elab151
| -
| Lisbon
| Off
|
|-
| 192.168.0.152
| -
| -
| -
| elab152
| -
| Lisbon
| Off
|
|-
| 192.168.0.153
| -
| -
| -
| elab153
| -
| Lisbon
| Off
|
|-
| 192.168.0.154
| -
| -
| -
| elab154
| -
| Lisbon
| Off
|
|-
| -
| -
| 10.7.0.1
| -
| elab1
| -
| Lisbon
| On
|
|-
| -
| -
| 10.7.0.3
| -
| orionte_vpn
| World Pendulum
| Remote
| Off
|
|-
| -
| -
| 10.7.0.4
| -
| planetarium_vpn
| World Pendulum
| Remote
| Off
|
|-
| -
| -
| 10.7.0.5
| -
| espav_vpn
| World Pendulum
| Remote
| Off
|
|-
| -
| -
| 10.7.0.6
| -
| luanda_vpn
| World Pendulum
| Luanda
| Off
|
|-
| -
| -
| 10.7.0.7
| -
| ccvalg_vpn
| World Pendulum
| Remote
| Off
|
|-
| -
| -
| 10.7.0.8
| -
| elab_vpn???
| -
| Remote
| Off
|
|-
| -
| -
| 10.7.0.9
| -
| ecb1_vpn
| World Pendulum
| Remote
| Off
|
|-
| -
| -
| 10.7.0.10
| -
| puc_vpn
| World Pendulum
| Rio de Janeiro
| Off
|
|-
| -
| -
| 10.7.0.11
| -
| ccvsintra_vpn
| World Pendulum
| Sintra
| Off
|
|-
| -
| -
| 10.7.0.12
| -
| epm_vpn
| World Pendulum
| Remote
| Off
|
|-
| -
| -
| 10.7.0.13
| -
| mola_vpn
| -
| Remote
| Off
|
|-
| -
| -
| 10.7.0.16
| -
| saotome_vpn
| World Pendulum
| São Tomé
| Off
|
|-
| -
| -
| 10.7.0.17
| -
| mag3d_vpn
| mag3d
| Remote
| Off
|
|-
| -
| -
| 10.7.0.20
| -
| hidrostat_vpn
| -
| Remote
| Off
|
|-
| -
| -
| 10.7.0.22
| -
| labIE2_vpn
| -
| Remote
| Off
|
|-
| -
| -
| 10.7.0.24
| -
| WP-PRG
| World Pendulum
| Prague
| On
|
|-
| -
| -
| 10.7.0.25
| -
| bsb_vpn
| World Pendulum
| Remote
| Off
|
|-
| -
| -
| 10.7.0.26
| -
| puq_umag_vpn
| World Pendulum
| Remote
| Off
|
|-
| -
| -
| 10.7.0.27
| -
| vap_vpn
| World Pendulum
| Valparaíso
| Off
|
|-
| -
| -
| 10.7.0.28
| -
| bog_unad_vpn
| World Pendulum
| Bogotá
| Off
|
|-
| -
| -
| 10.7.0.29
| -
| bog_uniandes_vpn
| World Pendulum
| Bogotá (Uniandes)
| Off
|
|-
| -
| -
| 10.7.0.30
| -
| pty_utp_vpn
| World Pendulum
| Panama City
| Off
|
|-
| -
| -
| 10.7.0.31
| -
| pty_usma_vpn
| World Pendulum
| Panama City
| Off
|
|-
| -
| -
| 10.7.0.32
| -
| WP-BCN
| World Pendulum
| Barcelona
| On
|
|-
| -
| -
| 10.7.0.33
| -
| WP-MRS
| World Pendulum
| Remote
| On
|
|-
| -
| -
| 10.7.0.34
| -
| rio_puc2_vpn
| World Pendulum
| Rio de Janeiro
| Off
|
|-
| -
| -
| 10.7.0.35
| -
| WP-TAGUS
| World Pendulum
| IST Lisbon Taguspark
| On
|
|-
| -
| -
| 10.7.0.36
| -
| rai_vpn
| -
| Remote
| Off
|
|-
| -
| -
| 10.7.0.37
| -
| scl_vpn
| -
| ?
| Off
|
|-
| 192.168.0.11
| 192.168.0.219
| 10.7.0.38
| -
| rpicavidade
| Cavidade
| Lisbon
| On
|
|-
| -
| -
| 10.7.0.39
| b8:27:eb:62:fe:ab
| WP-DIL
| World Pendulum
| Remote
| On
|
|-
| -
| -
| 10.7.0.39
| b8:27:eb:f4:7e:32
| WP-TAGUS
| World Pendulum
| Tagus
| On
|
|-
| -
| -
| 10.7.0.40
| -
| tagus_vpn
| -
| -
| Off
|
|-
| -
| -
| 10.7.0.41
| -
| dev_vpn
| -
| Lisbon
| Off
|
|-
| 192.168.0.19
| 192.168.0.217
| 10.7.0.42
| d8:3a:dd:e0:a2:75
| elab
| Multi-Polarizer
| Lisbon
| On
|
|-
| -
| -
| 10.7.0.43
| -
| -
| -
| -
| Off
|
|-
| -
| -
| 10.7.0.44
| -
| -
| -
| -
| Off
|
|-
| -
| 192.168.0.218
| 10.7.0.45
| d8:3a:dd:e0:a2:87
| oeiras-elab
| Multi-Polarizer
| Oeiras
| On
|
|-
| -
| -
| 10.7.0.46
| d8:3a:dd:e3:4d:fe
| ictp
| Multi-Polarizer
| Trieste
| On
|
|-
| -
| -
| 200.128.66.240
| -
| ios
| -
| ?
| On
|
|}

[[MediaWiki:Flash]]
[[MediaWiki:Youtube]]
[[MediaWiki:CaixaLigacoes]]
[[MediaWiki:Links]]

Admin

2025-12-06T19:00:24Z

Ist1106345: /* Elab1 Network Hosts */

== Links for administrative private pages ==

[[Page Template]]

[[Cluster configuration|Node/apparatus table connections]]

[[dsPic-Raspberry programmer interface]]

[[REC Prototype function]]

[[:File:ReC_Generic_Driver.pdf | REC Generic Driver]]

[[Free Quiz Manual]]

== General info ==
=== Table of nodes ===

{| class="wikitable"
!colspan="6"|Control rooms
|-
| '''Hostname
| '''Experiment
| '''Stream
| '''Watch
| '''Serial
| '''Baud rate
|-
| elab100 -
| radiare
| [rtsp://elabmc.ist.utl.pt/radiare.sdp 5006]
| [http://consum.ist.utl.pt/radiare.html Watch]
| /dev/ttyS0
| 4800
|-
| UESC/Ilhéus
| 14º47'S
| 39º10'W
| 220m
| 2705mm +/- 0.5mm @23ºC
| 80.5 +/- 1.0 mm
|-
| Lisbon
| 38º41'N
| 9º12'W
| 20m
| 2677mm +/- 0.5mm @19ºC
| 80.5 +/- 1.0 mm
|-
| Maputo
| 25º56'S
| 32º36'E
| 80m
| 2609.8mm +/- 0.5mm @27ºC
| 80.5 +/- 1.0 mm
|-
| São Tomé
| 0º21'N
| 6º43'E
| 50m
| 2756.5mm +/- 0.5mm @29ºC
| 81.8 +/- 0.5 mm
|-
| Prague - CTU
| 50º5.5'N
| 14º25.0'E
| 150m
| 2850mm +/- 0.5mm @25ºC
| 80.15 +/- 0.5 mm
|-
| Barcelona - UPC
| 41º24.6'N
| 2º13.1'E
| 55
| 2756.5mm +/- 0.5mm
| 81.8mm
|-
| Rio de Janeiro - PUC
| 22º54.1'S
| 43º12'W
| 50
| 2826,0mm +/- 0.5mm
| 81.6mm
|-
| Praia - UniCV
| 14°56'N
| 23°31'W
| 40 m
| 2826,0mm +/- 0.5mm
| 81.6mm
|-
| Bogotá - UniAndes
| 4°36'N
| 74°3'W
| 2650 m
| 2815,3mm +/- 0.5mm
| 82.0mm
|-
| Panama city - UTP
| 9°1.3'N
| 79°31.9'W
| 82 m
| 2825mm +/- 0.5mm @28ºC
| 81.9mm
|-
| Santiago - UChile
| 33°27.5'S
| 70°39.8'W
| 552 m
| 2825mm +/- 0.5mm @27ºC
| 81.9mm
|-
| Valparaiso - UTFSM
| 33°1'S
| 71°37'W
| 30 m
| 2825mm +/- 0.5mm @28ºC
| 81.9mm
|}

===Glassfish===
* Parar o glassfish:
«glassfishv3/bin/asadmin stop-domain»
* Caso este não pare, ao fim de 3 minutos, fazer mesmo o kill ao processo:
«ps aux | grep java», procurar o processo que está sediado em 'glassfishv3/'
* Ver o PID o processo e
«kill PID»
* Iniciar o glassfish:
«glassfishv3/bin/asadmin start-domain»

===Acesso elab===
O endereço é elab.ist.utl.pt e a PORTA é 22xx.

Maquinas Linux

login: elab
pass: jo......

Maquinas windows ser........

Uma vez no e-lab, para reiniciar, executar:
> /usr/local/ReC7.0/scripts/restartAllElab

(esperar que o script termine, antes de desligar sessão remota/putty))

Antes de reiniciar convém perceber se há alguém a fazer experiências:

> tail -n 100 /usr/local/ReC7.0/multicast/logins.txt

Normalmente para monitorizar e ver se há problema basta
Correr o comando anterior.
Se virem que já há algum tempo ninguém faz experiências, tentar
ligar ao eLab e ver se há realmente problemas.
Se por acaso estiver muita gente ligada e não tiverem sido executadas
experiências nos últimos 10->20 mins, é porque o sistema está ''halted''.

Reiniciar :)

No caso de o e-lab estar a funcionar, mas não aparecerem experiências, fazer:

> ping 192.168.0.121

Se não existir resposta, é porque faltou a electricidade e o cluster tem
de ser reiniciado. Se obtiverem resposta, tentem reiniciar toda a
plataforma.

===Video===
START Video

/home/elab/videos/wp_saotome.start

START Hardware server
elab@wp_saotome:~ $ /home/elab/rec-deployment/wpilheus/wpilheusDaemon.sh start

STOP Hardware server
elab@wp_saotome:~ $ /home/elab/rec-deployment/wpilheus/wpilheusDaemon.sh stop

[[technical pages|e-lab technical pages (connections diagrams, schematics, hardware configurations]]
http://www.elab.tecnico.ulisboa.pt/wiki/index.php?title=Technical_pages&action=edit&redlink=1

=== Elab1 Network Hosts ===

{| class="wikitable sortable"
! IP atríbuido do DHCP
! IP Address Estático
! VPN IP
! MAC Address
! Hostname
! Experiment
! Location
! Status
! Notes
|-
| 192.168.0.17
| 192.168.0.210
| 10.7.0.23
| b8:27:eb:3f:c7:c0
| plano-inclinado
| Plano Inclinado
| Lisbon
| On
|
|-
| 192.168.0.14
| 192.168.0.211
| -
| b8:27:eb:89:30:7d
| colisione
| colisione
| Lisbon
| On
|
|-
| 192.168.0.15
| 192.168.0.212
| -
| b8:27:eb:4e:de:b3
| mag3d
| Levitação Magnética 3d
| Lisbon
| On
|
|-
| 192.168.0.15
| 192.168.0.212
| -
| b8:27:eb:4e:de:b3
| mag3d
| Light Polarization
| Lisbon
| On
|
|-
| 192.168.0.200
| 192.168.0.213
| -
| b8:27:eb:f9:5d:c2
| elab200
| Sonda de Langmuir
| Lisbon
| On
|
|-
| 192.168.0.200
| 192.168.0.213
| -
| b8:27:eb:f9:5d:c2
| elab200
| elab200
| Lisbon
| -
|
|-
| 192.168.0.200
| 192.168.0.213
| -
| b8:27:eb:f9:5d:c2
| elab200
| pendulogravitico
| Lisbon
| -
|
|-
| 192.168.0.201
| 192.168.0.214
| -
| b8:27:eb:45:03:1e
| elab201
| -
| Lisbon
| -
|
|-
| 192.168.0.201
| 192.168.0.214
| -
| b8:27:eb:45:03:1e
| elab201
| Planck
| Lisbon
| On
|
|-
| 192.168.0.201
| 192.168.0.214
| -
| b8:27:eb:45:03:1e
| elab201
| Gamma
| Lisbon
| -
|
|-
| 192.168.0.202
| -
| -
| -
| elab202
| -
| Lisbon
| Off
|
|-
| 192.168.0.203
| 192.168.0.215
| -
| b8:27:eb:9d:b8:09
| elab203
| elab203
| Lisbon
| On
|
|-
| 192.168.0.203
| 192.168.0.215
| -
| b8:27:eb:9d:b8:09
| elab203
| Condicionador Cilíndrico
| Lisbon
| On
|
|-
| 192.168.0.250
| 192.168.0.216
| -
| b8:27:eb:ac:8c:3b
| fotovoltaico
| Painel Fotovoltaico
| Lisbon
| On
|
|-
| 192.168.0.100
| -
| -
| -
| elab100
| -
| Lisbon
| Off
|
|-
| 192.168.0.101
| -
| -
| -
| elab101
| -
| Lisbon
| Off
|
|-
| 192.168.0.102
| -
| -
| -
| elab102
| -
| Lisbon
| Off
|
|-
| 192.168.0.103
| -
| -
| -
| elab103
| -
| Lisbon
| Off
|
|-
| 192.168.0.104
| -
| -
| -
| elab104
| -
| Lisbon
| Off
|
|-
| 192.168.0.105
| -
| -
| -
| elab105
| -
| Lisbon
| Off
|
|-
| 192.168.0.106
| -
| -
| -
| elab106
| -
| Lisbon
| Off
|
|-
| 192.168.0.150
| -
| -
| -
| elab150
| -
| Lisbon
| On
|
|-
| 192.168.0.151
| -
| -
| -
| elab151
| -
| Lisbon
| Off
|
|-
| 192.168.0.152
| -
| -
| -
| elab152
| -
| Lisbon
| Off
|
|-
| 192.168.0.153
| -
| -
| -
| elab153
| -
| Lisbon
| Off
|
|-
| 192.168.0.154
| -
| -
| -
| elab154
| -
| Lisbon
| Off
|
|-
| -
| -
| 10.7.0.1
| -
| elab1
| -
| Lisbon
| On
|
|-
| -
| -
| 10.7.0.3
| -
| orionte_vpn
| World Pendulum
| Remote
| Off
|
|-
| -
| -
| 10.7.0.4
| -
| planetarium_vpn
| World Pendulum
| Remote
| Off
|
|-
| -
| -
| 10.7.0.5
| -
| espav_vpn
| World Pendulum
| Remote
| Off
|
|-
| -
| -
| 10.7.0.6
| -
| luanda_vpn
| World Pendulum
| Luanda
| Off
|
|-
| -
| -
| 10.7.0.7
| -
| ccvalg_vpn
| World Pendulum
| Remote
| Off
|
|-
| -
| -
| 10.7.0.8
| -
| elab_vpn???
| -
| Remote
| Off
|
|-
| -
| -
| 10.7.0.9
| -
| ecb1_vpn
| World Pendulum
| Remote
| Off
|
|-
| -
| -
| 10.7.0.10
| -
| puc_vpn
| World Pendulum
| Rio de Janeiro
| Off
|
|-
| -
| -
| 10.7.0.11
| -
| ccvsintra_vpn
| World Pendulum
| Sintra
| Off
|
|-
| -
| -
| 10.7.0.12
| -
| epm_vpn
| World Pendulum
| Remote
| Off
|
|-
| -
| -
| 10.7.0.13
| -
| mola_vpn
| -
| Remote
| Off
|
|-
| -
| -
| 10.7.0.16
| -
| saotome_vpn
| World Pendulum
| São Tomé
| Off
|
|-
| -
| -
| 10.7.0.17
| -
| mag3d_vpn
| mag3d
| Remote
| Off
|
|-
| -
| -
| 10.7.0.20
| -
| hidrostat_vpn
| -
| Remote
| Off
|
|-
| -
| -
| 10.7.0.22
| -
| labIE2_vpn
| -
| Remote
| Off
|
|-
| -
| -
| 10.7.0.24
| -
| WP-PRG
| World Pendulum
| Prague
| On
|
|-
| -
| -
| 10.7.0.25
| -
| bsb_vpn
| World Pendulum
| Remote
| Off
|
|-
| -
| -
| 10.7.0.26
| -
| puq_umag_vpn
| World Pendulum
| Remote
| Off
|
|-
| -
| -
| 10.7.0.27
| -
| vap_vpn
| World Pendulum
| Valparaíso
| Off
|
|-
| -
| -
| 10.7.0.28
| -
| bog_unad_vpn
| World Pendulum
| Bogotá
| Off
|
|-
| -
| -
| 10.7.0.29
| -
| bog_uniandes_vpn
| World Pendulum
| Bogotá (Uniandes)
| Off
|
|-
| -
| -
| 10.7.0.30
| -
| pty_utp_vpn
| World Pendulum
| Panama City
| Off
|
|-
| -
| -
| 10.7.0.31
| -
| pty_usma_vpn
| World Pendulum
| Panama City
| Off
|
|-
| -
| -
| 10.7.0.32
| -
| WP-BCN
| World Pendulum
| Barcelona
| On
|
|-
| -
| -
| 10.7.0.33
| -
| WP-MRS
| World Pendulum
| Remote
| On
|
|-
| -
| -
| 10.7.0.34
| -
| rio_puc2_vpn
| World Pendulum
| Rio de Janeiro
| Off
|
|-
| -
| -
| 10.7.0.35
| -
| WP-TAGUS
| World Pendulum
| IST Lisbon Taguspark
| On
|
|-
| -
| -
| 10.7.0.36
| -
| rai_vpn
| -
| Remote
| Off
|
|-
| -
| -
| 10.7.0.37
| -
| scl_vpn
| -
| ?
| Off
|
|-
| 192.168.0.11
| -
| 10.7.0.38
| -
| rpicavidade
| Cavidade
| Lisbon
| On
|
|-
| -
| -
| 10.7.0.39
| b8:27:eb:62:fe:ab
| WP-DIL
| World Pendulum
| Remote
| On
|
|-
| -
| -
| 10.7.0.39
| b8:27:eb:f4:7e:32
| WP-TAGUS
| World Pendulum
| Tagus
| On
|
|-
| -
| -
| 10.7.0.40
| -
| tagus_vpn
| -
| -
| Off
|
|-
| -
| -
| 10.7.0.41
| -
| dev_vpn
| -
| Lisbon
| Off
|
|-
| 192.168.0.19
| 192.168.0.217
| 10.7.0.42
| d8:3a:dd:e0:a2:75
| elab
| Multi-Polarizer
| Lisbon
| On
|
|-
| -
| -
| 10.7.0.43
| -
| -
| -
| -
| Off
|
|-
| -
| -
| 10.7.0.44
| -
| -
| -
| -
| Off
|
|-
| -
| -
| 10.7.0.45
| d8:3a:dd:e0:a2:87
| oeiras-elab
| Multi-Polarizer
| Oeiras
| On
|
|-
| -
| -
| 10.7.0.46
| d8:3a:dd:e3:4d:fe
| ictp
| Multi-Polarizer
| Trieste
| On
|
|-
| -
| -
| 200.128.66.240
| -
| ios
| -
| ?
| On
|
|}

[[MediaWiki:Flash]]
[[MediaWiki:Youtube]]
[[MediaWiki:CaixaLigacoes]]
[[MediaWiki:Links]]

Admin

2025-12-06T18:56:23Z

Ist1106345: /* Elab1 Network Hosts */

== Links for administrative private pages ==

[[Page Template]]

[[Cluster configuration|Node/apparatus table connections]]

[[dsPic-Raspberry programmer interface]]

[[REC Prototype function]]

[[:File:ReC_Generic_Driver.pdf | REC Generic Driver]]

[[Free Quiz Manual]]

== General info ==
=== Table of nodes ===

{| class="wikitable"
!colspan="6"|Control rooms
|-
| '''Hostname
| '''Experiment
| '''Stream
| '''Watch
| '''Serial
| '''Baud rate
|-
| elab100 -
| radiare
| [rtsp://elabmc.ist.utl.pt/radiare.sdp 5006]
| [http://consum.ist.utl.pt/radiare.html Watch]
| /dev/ttyS0
| 4800
|-
| UESC/Ilhéus
| 14º47'S
| 39º10'W
| 220m
| 2705mm +/- 0.5mm @23ºC
| 80.5 +/- 1.0 mm
|-
| Lisbon
| 38º41'N
| 9º12'W
| 20m
| 2677mm +/- 0.5mm @19ºC
| 80.5 +/- 1.0 mm
|-
| Maputo
| 25º56'S
| 32º36'E
| 80m
| 2609.8mm +/- 0.5mm @27ºC
| 80.5 +/- 1.0 mm
|-
| São Tomé
| 0º21'N
| 6º43'E
| 50m
| 2756.5mm +/- 0.5mm @29ºC
| 81.8 +/- 0.5 mm
|-
| Prague - CTU
| 50º5.5'N
| 14º25.0'E
| 150m
| 2850mm +/- 0.5mm @25ºC
| 80.15 +/- 0.5 mm
|-
| Barcelona - UPC
| 41º24.6'N
| 2º13.1'E
| 55
| 2756.5mm +/- 0.5mm
| 81.8mm
|-
| Rio de Janeiro - PUC
| 22º54.1'S
| 43º12'W
| 50
| 2826,0mm +/- 0.5mm
| 81.6mm
|-
| Praia - UniCV
| 14°56'N
| 23°31'W
| 40 m
| 2826,0mm +/- 0.5mm
| 81.6mm
|-
| Bogotá - UniAndes
| 4°36'N
| 74°3'W
| 2650 m
| 2815,3mm +/- 0.5mm
| 82.0mm
|-
| Panama city - UTP
| 9°1.3'N
| 79°31.9'W
| 82 m
| 2825mm +/- 0.5mm @28ºC
| 81.9mm
|-
| Santiago - UChile
| 33°27.5'S
| 70°39.8'W
| 552 m
| 2825mm +/- 0.5mm @27ºC
| 81.9mm
|-
| Valparaiso - UTFSM
| 33°1'S
| 71°37'W
| 30 m
| 2825mm +/- 0.5mm @28ºC
| 81.9mm
|}

===Glassfish===
* Parar o glassfish:
«glassfishv3/bin/asadmin stop-domain»
* Caso este não pare, ao fim de 3 minutos, fazer mesmo o kill ao processo:
«ps aux | grep java», procurar o processo que está sediado em 'glassfishv3/'
* Ver o PID o processo e
«kill PID»
* Iniciar o glassfish:
«glassfishv3/bin/asadmin start-domain»

===Acesso elab===
O endereço é elab.ist.utl.pt e a PORTA é 22xx.

Maquinas Linux

login: elab
pass: jo......

Maquinas windows ser........

Uma vez no e-lab, para reiniciar, executar:
> /usr/local/ReC7.0/scripts/restartAllElab

(esperar que o script termine, antes de desligar sessão remota/putty))

Antes de reiniciar convém perceber se há alguém a fazer experiências:

> tail -n 100 /usr/local/ReC7.0/multicast/logins.txt

Normalmente para monitorizar e ver se há problema basta
Correr o comando anterior.
Se virem que já há algum tempo ninguém faz experiências, tentar
ligar ao eLab e ver se há realmente problemas.
Se por acaso estiver muita gente ligada e não tiverem sido executadas
experiências nos últimos 10->20 mins, é porque o sistema está ''halted''.

Reiniciar :)

No caso de o e-lab estar a funcionar, mas não aparecerem experiências, fazer:

> ping 192.168.0.121

Se não existir resposta, é porque faltou a electricidade e o cluster tem
de ser reiniciado. Se obtiverem resposta, tentem reiniciar toda a
plataforma.

===Video===
START Video

/home/elab/videos/wp_saotome.start

START Hardware server
elab@wp_saotome:~ $ /home/elab/rec-deployment/wpilheus/wpilheusDaemon.sh start

STOP Hardware server
elab@wp_saotome:~ $ /home/elab/rec-deployment/wpilheus/wpilheusDaemon.sh stop

[[technical pages|e-lab technical pages (connections diagrams, schematics, hardware configurations]]
http://www.elab.tecnico.ulisboa.pt/wiki/index.php?title=Technical_pages&action=edit&redlink=1

=== Elab1 Network Hosts ===

{| class="wikitable"
! IP atríbuido do DHCP
! IP Address Estático
! VPN IP
! MAC Address
! Hostname
! Experiment
! Location
! Status
! Notes
|-
| 192.168.0.17
| 192.168.0.210
| 10.7.0.23
| b8:27:eb:3f:c7:c0
| plano-inclinado
| Plano Inclinado
| Lisbon
| On
|
|-
| 192.168.0.14
| 192.168.0.211
| -
| b8:27:eb:89:30:7d
| colisione
| colisione
| Lisbon
| On
|
|-
| 192.168.0.15
| 192.168.0.212
| -
| b8:27:eb:4e:de:b3
| mag3d
| Levitação Magnética 3d
| Lisbon
| On
|
|-
| 192.168.0.15
| 192.168.0.212
| -
| b8:27:eb:4e:de:b3
| mag3d
| Light Polarization
| Lisbon
| On
|
|-
| 192.168.0.200
| 192.168.0.213
| -
| b8:27:eb:f9:5d:c2
| elab200
| Sonda de Langmuir
| Lisbon
| On
|
|-
| 192.168.0.200
| 192.168.0.213
| -
| b8:27:eb:f9:5d:c2
| elab200
| elab200
| Lisbon
| -
|
|-
| 192.168.0.200
| 192.168.0.213
| -
| b8:27:eb:f9:5d:c2
| elab200
| pendulogravitico
| Lisbon
| -
|
|-
| 192.168.0.201
| 192.168.0.214
| -
| b8:27:eb:45:03:1e
| elab201
| -
| Lisbon
| -
|
|-
| 192.168.0.201
| 192.168.0.214
| -
| b8:27:eb:45:03:1e
| elab201
| Planck
| Lisbon
| On
|
|-
| 192.168.0.201
| 192.168.0.214
| -
| b8:27:eb:45:03:1e
| elab201
| Gamma
| Lisbon
| -
|
|-
| 192.168.0.202
| -
| -
| -
| elab202
| -
| Lisbon
| Off
|
|-
| 192.168.0.203
| 192.168.0.215
| -
| b8:27:eb:9d:b8:09
| elab203
| elab203
| Lisbon
| On
|
|-
| 192.168.0.203
| 192.168.0.215
| -
| b8:27:eb:9d:b8:09
| elab203
| Condicionador Cilíndrico
| Lisbon
| On
|
|-
| 192.168.0.250
| 192.168.0.216
| -
| b8:27:eb:ac:8c:3b
| fotovoltaico
| Painel Fotovoltaico
| Lisbon
| On
|
|-
| 192.168.0.100
| -
| -
| -
| elab100
| -
| Lisbon
| Off
|
|-
| 192.168.0.101
| -
| -
| -
| elab101
| -
| Lisbon
| Off
|
|-
| 192.168.0.102
| -
| -
| -
| elab102
| -
| Lisbon
| Off
|
|-
| 192.168.0.103
| -
| -
| -
| elab103
| -
| Lisbon
| Off
|
|-
| 192.168.0.104
| -
| -
| -
| elab104
| -
| Lisbon
| Off
|
|-
| 192.168.0.105
| -
| -
| -
| elab105
| -
| Lisbon
| Off
|
|-
| 192.168.0.106
| -
| -
| -
| elab106
| -
| Lisbon
| Off
|
|-
| 192.168.0.150
| -
| -
| -
| elab150
| -
| Lisbon
| On
|
|-
| 192.168.0.151
| -
| -
| -
| elab151
| -
| Lisbon
| Off
|
|-
| 192.168.0.152
| -
| -
| -
| elab152
| -
| Lisbon
| Off
|
|-
| 192.168.0.153
| -
| -
| -
| elab153
| -
| Lisbon
| Off
|
|-
| 192.168.0.154
| -
| -
| -
| elab154
| -
| Lisbon
| Off
|
|-
| -
| -
| 10.7.0.1
| -
| elab1
| -
| Lisbon
| On
|
|-
| -
| -
| 10.7.0.3
| -
| orionte_vpn
| World Pendulum
| Remote
| Off
|
|-
| -
| -
| 10.7.0.4
| -
| planetarium_vpn
| World Pendulum
| Remote
| Off
|
|-
| -
| -
| 10.7.0.5
| -
| espav_vpn
| World Pendulum
| Remote
| Off
|
|-
| -
| -
| 10.7.0.6
| -
| luanda_vpn
| World Pendulum
| Luanda
| Off
|
|-
| -
| -
| 10.7.0.7
| -
| ccvalg_vpn
| World Pendulum
| Remote
| Off
|
|-
| -
| -
| 10.7.0.8
| -
| elab_vpn???
| -
| Remote
| Off
|
|-
| -
| -
| 10.7.0.9
| -
| ecb1_vpn
| World Pendulum
| Remote
| Off
|
|-
| -
| -
| 10.7.0.10
| -
| puc_vpn
| World Pendulum
| Rio de Janeiro
| Off
|
|-
| -
| -
| 10.7.0.11
| -
| ccvsintra_vpn
| World Pendulum
| Sintra
| Off
|
|-
| -
| -
| 10.7.0.12
| -
| epm_vpn
| World Pendulum
| Remote
| Off
|
|-
| -
| -
| 10.7.0.13
| -
| mola_vpn
| -
| Remote
| Off
|
|-
| -
| -
| 10.7.0.16
| -
| saotome_vpn
| World Pendulum
| São Tomé
| Off
|
|-
| -
| -
| 10.7.0.17
| -
| mag3d_vpn
| mag3d
| Remote
| Off
|
|-
| -
| -
| 10.7.0.20
| -
| hidrostat_vpn
| -
| Remote
| Off
|
|-
| -
| -
| 10.7.0.22
| -
| labIE2_vpn
| -
| Remote
| Off
|
|-
| -
| -
| 10.7.0.24
| -
| WP-PRG
| World Pendulum
| Prague
| On
|
|-
| -
| -
| 10.7.0.25
| -
| bsb_vpn
| World Pendulum
| Remote
| Off
|
|-
| -
| -
| 10.7.0.26
| -
| puq_umag_vpn
| World Pendulum
| Remote
| Off
|
|-
| -
| -
| 10.7.0.27
| -
| vap_vpn
| World Pendulum
| Valparaíso
| Off
|
|-
| -
| -
| 10.7.0.28
| -
| bog_unad_vpn
| World Pendulum
| Bogotá
| Off
|
|-
| -
| -
| 10.7.0.29
| -
| bog_uniandes_vpn
| World Pendulum
| Bogotá (Uniandes)
| Off
|
|-
| -
| -
| 10.7.0.30
| -
| pty_utp_vpn
| World Pendulum
| Panama City
| Off
|
|-
| -
| -
| 10.7.0.31
| -
| pty_usma_vpn
| World Pendulum
| Panama City
| Off
|
|-
| -
| -
| 10.7.0.32
| -
| WP-BCN
| World Pendulum
| Barcelona
| On
|
|-
| -
| -
| 10.7.0.33
| -
| WP-MRS
| World Pendulum
| Remote
| On
|
|-
| -
| -
| 10.7.0.34
| -
| rio_puc2_vpn
| World Pendulum
| Rio de Janeiro
| Off
|
|-
| -
| -
| 10.7.0.35
| -
| WP-TAGUS
| World Pendulum
| IST Lisbon Taguspark
| On
|
|-
| -
| -
| 10.7.0.36
| -
| rai_vpn
| -
| Remote
| Off
|
|-
| -
| -
| 10.7.0.37
| -
| scl_vpn
| -
| ?
| Off
|
|-
| 192.168.0.11
| -
| 10.7.0.38
| -
| rpicavidade
| Cavidade
| Lisbon
| On
|
|-
| -
| -
| 10.7.0.39
| b8:27:eb:62:fe:ab
| WP-DIL
| World Pendulum
| Remote
| On
|
|-
| -
| -
| 10.7.0.39
| b8:27:eb:f4:7e:32
| WP-TAGUS
| World Pendulum
| Tagus
| On
|
|-
| -
| -
| 10.7.0.40
| -
| tagus_vpn
| -
| -
| Off
|
|-
| -
| -
| 10.7.0.41
| -
| dev_vpn
| -
| Lisbon
| Off
|
|-
| 192.168.0.19
| 192.168.0.217
| 10.7.0.42
| d8:3a:dd:e0:a2:75
| elab
| Multi-Polarizer
| Lisbon
| On
|
|-
| -
| -
| 10.7.0.43
| -
| -
| -
| -
| Off
|
|-
| -
| -
| 10.7.0.44
| -
| -
| -
| -
| Off
|
|-
| -
| -
| 10.7.0.45
| d8:3a:dd:e0:a2:87
| oeiras-elab
| Multi-Polarizer
| Oeiras
| On
|
|-
| -
| -
| 10.7.0.46
| d8:3a:dd:e3:4d:fe
| ictp
| Multi-Polarizer
| Trieste
| On
|
|-
| -
| -
| 200.128.66.240
| -
| ios
| -
| ?
| On
|
|}

[[MediaWiki:Flash]]
[[MediaWiki:Youtube]]
[[MediaWiki:CaixaLigacoes]]
[[MediaWiki:Links]]

Admin

2025-12-06T18:56:11Z

Ist1106345: /* Elab1 Network Hosts */

== Links for administrative private pages ==

[[Page Template]]

[[Cluster configuration|Node/apparatus table connections]]

[[dsPic-Raspberry programmer interface]]

[[REC Prototype function]]

[[:File:ReC_Generic_Driver.pdf | REC Generic Driver]]

[[Free Quiz Manual]]

== General info ==
=== Table of nodes ===

{| class="wikitable"
!colspan="6"|Control rooms
|-
| '''Hostname
| '''Experiment
| '''Stream
| '''Watch
| '''Serial
| '''Baud rate
|-
| elab100 -
| radiare
| [rtsp://elabmc.ist.utl.pt/radiare.sdp 5006]
| [http://consum.ist.utl.pt/radiare.html Watch]
| /dev/ttyS0
| 4800
|-
| UESC/Ilhéus
| 14º47'S
| 39º10'W
| 220m
| 2705mm +/- 0.5mm @23ºC
| 80.5 +/- 1.0 mm
|-
| Lisbon
| 38º41'N
| 9º12'W
| 20m
| 2677mm +/- 0.5mm @19ºC
| 80.5 +/- 1.0 mm
|-
| Maputo
| 25º56'S
| 32º36'E
| 80m
| 2609.8mm +/- 0.5mm @27ºC
| 80.5 +/- 1.0 mm
|-
| São Tomé
| 0º21'N
| 6º43'E
| 50m
| 2756.5mm +/- 0.5mm @29ºC
| 81.8 +/- 0.5 mm
|-
| Prague - CTU
| 50º5.5'N
| 14º25.0'E
| 150m
| 2850mm +/- 0.5mm @25ºC
| 80.15 +/- 0.5 mm
|-
| Barcelona - UPC
| 41º24.6'N
| 2º13.1'E
| 55
| 2756.5mm +/- 0.5mm
| 81.8mm
|-
| Rio de Janeiro - PUC
| 22º54.1'S
| 43º12'W
| 50
| 2826,0mm +/- 0.5mm
| 81.6mm
|-
| Praia - UniCV
| 14°56'N
| 23°31'W
| 40 m
| 2826,0mm +/- 0.5mm
| 81.6mm
|-
| Bogotá - UniAndes
| 4°36'N
| 74°3'W
| 2650 m
| 2815,3mm +/- 0.5mm
| 82.0mm
|-
| Panama city - UTP
| 9°1.3'N
| 79°31.9'W
| 82 m
| 2825mm +/- 0.5mm @28ºC
| 81.9mm
|-
| Santiago - UChile
| 33°27.5'S
| 70°39.8'W
| 552 m
| 2825mm +/- 0.5mm @27ºC
| 81.9mm
|-
| Valparaiso - UTFSM
| 33°1'S
| 71°37'W
| 30 m
| 2825mm +/- 0.5mm @28ºC
| 81.9mm
|}

===Glassfish===
* Parar o glassfish:
«glassfishv3/bin/asadmin stop-domain»
* Caso este não pare, ao fim de 3 minutos, fazer mesmo o kill ao processo:
«ps aux | grep java», procurar o processo que está sediado em 'glassfishv3/'
* Ver o PID o processo e
«kill PID»
* Iniciar o glassfish:
«glassfishv3/bin/asadmin start-domain»

===Acesso elab===
O endereço é elab.ist.utl.pt e a PORTA é 22xx.

Maquinas Linux

login: elab
pass: jo......

Maquinas windows ser........

Uma vez no e-lab, para reiniciar, executar:
> /usr/local/ReC7.0/scripts/restartAllElab

(esperar que o script termine, antes de desligar sessão remota/putty))

Antes de reiniciar convém perceber se há alguém a fazer experiências:

> tail -n 100 /usr/local/ReC7.0/multicast/logins.txt

Normalmente para monitorizar e ver se há problema basta
Correr o comando anterior.
Se virem que já há algum tempo ninguém faz experiências, tentar
ligar ao eLab e ver se há realmente problemas.
Se por acaso estiver muita gente ligada e não tiverem sido executadas
experiências nos últimos 10->20 mins, é porque o sistema está ''halted''.

Reiniciar :)

No caso de o e-lab estar a funcionar, mas não aparecerem experiências, fazer:

> ping 192.168.0.121

Se não existir resposta, é porque faltou a electricidade e o cluster tem
de ser reiniciado. Se obtiverem resposta, tentem reiniciar toda a
plataforma.

===Video===
START Video

/home/elab/videos/wp_saotome.start

START Hardware server
elab@wp_saotome:~ $ /home/elab/rec-deployment/wpilheus/wpilheusDaemon.sh start

STOP Hardware server
elab@wp_saotome:~ $ /home/elab/rec-deployment/wpilheus/wpilheusDaemon.sh stop

[[technical pages|e-lab technical pages (connections diagrams, schematics, hardware configurations]]
http://www.elab.tecnico.ulisboa.pt/wiki/index.php?title=Technical_pages&action=edit&redlink=1

=== Elab1 Network Hosts ===

{| class="wikitable"
!colspan="9"
! IP atríbuido do DHCP
! IP Address Estático
! VPN IP
! MAC Address
! Hostname
! Experiment
! Location
! Status
! Notes
|-
| 192.168.0.17
| 192.168.0.210
| 10.7.0.23
| b8:27:eb:3f:c7:c0
| plano-inclinado
| Plano Inclinado
| Lisbon
| On
|
|-
| 192.168.0.14
| 192.168.0.211
| -
| b8:27:eb:89:30:7d
| colisione
| colisione
| Lisbon
| On
|
|-
| 192.168.0.15
| 192.168.0.212
| -
| b8:27:eb:4e:de:b3
| mag3d
| Levitação Magnética 3d
| Lisbon
| On
|
|-
| 192.168.0.15
| 192.168.0.212
| -
| b8:27:eb:4e:de:b3
| mag3d
| Light Polarization
| Lisbon
| On
|
|-
| 192.168.0.200
| 192.168.0.213
| -
| b8:27:eb:f9:5d:c2
| elab200
| Sonda de Langmuir
| Lisbon
| On
|
|-
| 192.168.0.200
| 192.168.0.213
| -
| b8:27:eb:f9:5d:c2
| elab200
| elab200
| Lisbon
| -
|
|-
| 192.168.0.200
| 192.168.0.213
| -
| b8:27:eb:f9:5d:c2
| elab200
| pendulogravitico
| Lisbon
| -
|
|-
| 192.168.0.201
| 192.168.0.214
| -
| b8:27:eb:45:03:1e
| elab201
| -
| Lisbon
| -
|
|-
| 192.168.0.201
| 192.168.0.214
| -
| b8:27:eb:45:03:1e
| elab201
| Planck
| Lisbon
| On
|
|-
| 192.168.0.201
| 192.168.0.214
| -
| b8:27:eb:45:03:1e
| elab201
| Gamma
| Lisbon
| -
|
|-
| 192.168.0.202
| -
| -
| -
| elab202
| -
| Lisbon
| Off
|
|-
| 192.168.0.203
| 192.168.0.215
| -
| b8:27:eb:9d:b8:09
| elab203
| elab203
| Lisbon
| On
|
|-
| 192.168.0.203
| 192.168.0.215
| -
| b8:27:eb:9d:b8:09
| elab203
| Condicionador Cilíndrico
| Lisbon
| On
|
|-
| 192.168.0.250
| 192.168.0.216
| -
| b8:27:eb:ac:8c:3b
| fotovoltaico
| Painel Fotovoltaico
| Lisbon
| On
|
|-
| 192.168.0.100
| -
| -
| -
| elab100
| -
| Lisbon
| Off
|
|-
| 192.168.0.101
| -
| -
| -
| elab101
| -
| Lisbon
| Off
|
|-
| 192.168.0.102
| -
| -
| -
| elab102
| -
| Lisbon
| Off
|
|-
| 192.168.0.103
| -
| -
| -
| elab103
| -
| Lisbon
| Off
|
|-
| 192.168.0.104
| -
| -
| -
| elab104
| -
| Lisbon
| Off
|
|-
| 192.168.0.105
| -
| -
| -
| elab105
| -
| Lisbon
| Off
|
|-
| 192.168.0.106
| -
| -
| -
| elab106
| -
| Lisbon
| Off
|
|-
| 192.168.0.150
| -
| -
| -
| elab150
| -
| Lisbon
| On
|
|-
| 192.168.0.151
| -
| -
| -
| elab151
| -
| Lisbon
| Off
|
|-
| 192.168.0.152
| -
| -
| -
| elab152
| -
| Lisbon
| Off
|
|-
| 192.168.0.153
| -
| -
| -
| elab153
| -
| Lisbon
| Off
|
|-
| 192.168.0.154
| -
| -
| -
| elab154
| -
| Lisbon
| Off
|
|-
| -
| -
| 10.7.0.1
| -
| elab1
| -
| Lisbon
| On
|
|-
| -
| -
| 10.7.0.3
| -
| orionte_vpn
| World Pendulum
| Remote
| Off
|
|-
| -
| -
| 10.7.0.4
| -
| planetarium_vpn
| World Pendulum
| Remote
| Off
|
|-
| -
| -
| 10.7.0.5
| -
| espav_vpn
| World Pendulum
| Remote
| Off
|
|-
| -
| -
| 10.7.0.6
| -
| luanda_vpn
| World Pendulum
| Luanda
| Off
|
|-
| -
| -
| 10.7.0.7
| -
| ccvalg_vpn
| World Pendulum
| Remote
| Off
|
|-
| -
| -
| 10.7.0.8
| -
| elab_vpn???
| -
| Remote
| Off
|
|-
| -
| -
| 10.7.0.9
| -
| ecb1_vpn
| World Pendulum
| Remote
| Off
|
|-
| -
| -
| 10.7.0.10
| -
| puc_vpn
| World Pendulum
| Rio de Janeiro
| Off
|
|-
| -
| -
| 10.7.0.11
| -
| ccvsintra_vpn
| World Pendulum
| Sintra
| Off
|
|-
| -
| -
| 10.7.0.12
| -
| epm_vpn
| World Pendulum
| Remote
| Off
|
|-
| -
| -
| 10.7.0.13
| -
| mola_vpn
| -
| Remote
| Off
|
|-
| -
| -
| 10.7.0.16
| -
| saotome_vpn
| World Pendulum
| São Tomé
| Off
|
|-
| -
| -
| 10.7.0.17
| -
| mag3d_vpn
| mag3d
| Remote
| Off
|
|-
| -
| -
| 10.7.0.20
| -
| hidrostat_vpn
| -
| Remote
| Off
|
|-
| -
| -
| 10.7.0.22
| -
| labIE2_vpn
| -
| Remote
| Off
|
|-
| -
| -
| 10.7.0.24
| -
| WP-PRG
| World Pendulum
| Prague
| On
|
|-
| -
| -
| 10.7.0.25
| -
| bsb_vpn
| World Pendulum
| Remote
| Off
|
|-
| -
| -
| 10.7.0.26
| -
| puq_umag_vpn
| World Pendulum
| Remote
| Off
|
|-
| -
| -
| 10.7.0.27
| -
| vap_vpn
| World Pendulum
| Valparaíso
| Off
|
|-
| -
| -
| 10.7.0.28
| -
| bog_unad_vpn
| World Pendulum
| Bogotá
| Off
|
|-
| -
| -
| 10.7.0.29
| -
| bog_uniandes_vpn
| World Pendulum
| Bogotá (Uniandes)
| Off
|
|-
| -
| -
| 10.7.0.30
| -
| pty_utp_vpn
| World Pendulum
| Panama City
| Off
|
|-
| -
| -
| 10.7.0.31
| -
| pty_usma_vpn
| World Pendulum
| Panama City
| Off
|
|-
| -
| -
| 10.7.0.32
| -
| WP-BCN
| World Pendulum
| Barcelona
| On
|
|-
| -
| -
| 10.7.0.33
| -
| WP-MRS
| World Pendulum
| Remote
| On
|
|-
| -
| -
| 10.7.0.34
| -
| rio_puc2_vpn
| World Pendulum
| Rio de Janeiro
| Off
|
|-
| -
| -
| 10.7.0.35
| -
| WP-TAGUS
| World Pendulum
| IST Lisbon Taguspark
| On
|
|-
| -
| -
| 10.7.0.36
| -
| rai_vpn
| -
| Remote
| Off
|
|-
| -
| -
| 10.7.0.37
| -
| scl_vpn
| -
| ?
| Off
|
|-
| 192.168.0.11
| -
| 10.7.0.38
| -
| rpicavidade
| Cavidade
| Lisbon
| On
|
|-
| -
| -
| 10.7.0.39
| b8:27:eb:62:fe:ab
| WP-DIL
| World Pendulum
| Remote
| On
|
|-
| -
| -
| 10.7.0.39
| b8:27:eb:f4:7e:32
| WP-TAGUS
| World Pendulum
| Tagus
| On
|
|-
| -
| -
| 10.7.0.40
| -
| tagus_vpn
| -
| -
| Off
|
|-
| -
| -
| 10.7.0.41
| -
| dev_vpn
| -
| Lisbon
| Off
|
|-
| 192.168.0.19
| 192.168.0.217
| 10.7.0.42
| d8:3a:dd:e0:a2:75
| elab
| Multi-Polarizer
| Lisbon
| On
|
|-
| -
| -
| 10.7.0.43
| -
| -
| -
| -
| Off
|
|-
| -
| -
| 10.7.0.44
| -
| -
| -
| -
| Off
|
|-
| -
| -
| 10.7.0.45
| d8:3a:dd:e0:a2:87
| oeiras-elab
| Multi-Polarizer
| Oeiras
| On
|
|-
| -
| -
| 10.7.0.46
| d8:3a:dd:e3:4d:fe
| ictp
| Multi-Polarizer
| Trieste
| On
|
|-
| -
| -
| 200.128.66.240
| -
| ios
| -
| ?
| On
|
|}

[[MediaWiki:Flash]]
[[MediaWiki:Youtube]]
[[MediaWiki:CaixaLigacoes]]
[[MediaWiki:Links]]

Admin

2025-12-06T18:55:39Z

Ist1106345: Updated Network Hosts Table 6/12/2025

== Links for administrative private pages ==

[[Page Template]]

[[Cluster configuration|Node/apparatus table connections]]

[[dsPic-Raspberry programmer interface]]

[[REC Prototype function]]

[[:File:ReC_Generic_Driver.pdf | REC Generic Driver]]

[[Free Quiz Manual]]

== General info ==
=== Table of nodes ===

{| class="wikitable"
!colspan="6"|Control rooms
|-
| '''Hostname
| '''Experiment
| '''Stream
| '''Watch
| '''Serial
| '''Baud rate
|-
| elab100 -
| radiare
| [rtsp://elabmc.ist.utl.pt/radiare.sdp 5006]
| [http://consum.ist.utl.pt/radiare.html Watch]
| /dev/ttyS0
| 4800
|-
| UESC/Ilhéus
| 14º47'S
| 39º10'W
| 220m
| 2705mm +/- 0.5mm @23ºC
| 80.5 +/- 1.0 mm
|-
| Lisbon
| 38º41'N
| 9º12'W
| 20m
| 2677mm +/- 0.5mm @19ºC
| 80.5 +/- 1.0 mm
|-
| Maputo
| 25º56'S
| 32º36'E
| 80m
| 2609.8mm +/- 0.5mm @27ºC
| 80.5 +/- 1.0 mm
|-
| São Tomé
| 0º21'N
| 6º43'E
| 50m
| 2756.5mm +/- 0.5mm @29ºC
| 81.8 +/- 0.5 mm
|-
| Prague - CTU
| 50º5.5'N
| 14º25.0'E
| 150m
| 2850mm +/- 0.5mm @25ºC
| 80.15 +/- 0.5 mm
|-
| Barcelona - UPC
| 41º24.6'N
| 2º13.1'E
| 55
| 2756.5mm +/- 0.5mm
| 81.8mm
|-
| Rio de Janeiro - PUC
| 22º54.1'S
| 43º12'W
| 50
| 2826,0mm +/- 0.5mm
| 81.6mm
|-
| Praia - UniCV
| 14°56'N
| 23°31'W
| 40 m
| 2826,0mm +/- 0.5mm
| 81.6mm
|-
| Bogotá - UniAndes
| 4°36'N
| 74°3'W
| 2650 m
| 2815,3mm +/- 0.5mm
| 82.0mm
|-
| Panama city - UTP
| 9°1.3'N
| 79°31.9'W
| 82 m
| 2825mm +/- 0.5mm @28ºC
| 81.9mm
|-
| Santiago - UChile
| 33°27.5'S
| 70°39.8'W
| 552 m
| 2825mm +/- 0.5mm @27ºC
| 81.9mm
|-
| Valparaiso - UTFSM
| 33°1'S
| 71°37'W
| 30 m
| 2825mm +/- 0.5mm @28ºC
| 81.9mm
|}

===Glassfish===
* Parar o glassfish:
«glassfishv3/bin/asadmin stop-domain»
* Caso este não pare, ao fim de 3 minutos, fazer mesmo o kill ao processo:
«ps aux | grep java», procurar o processo que está sediado em 'glassfishv3/'
* Ver o PID o processo e
«kill PID»
* Iniciar o glassfish:
«glassfishv3/bin/asadmin start-domain»

===Acesso elab===
O endereço é elab.ist.utl.pt e a PORTA é 22xx.

Maquinas Linux

login: elab
pass: jo......

Maquinas windows ser........

Uma vez no e-lab, para reiniciar, executar:
> /usr/local/ReC7.0/scripts/restartAllElab

(esperar que o script termine, antes de desligar sessão remota/putty))

Antes de reiniciar convém perceber se há alguém a fazer experiências:

> tail -n 100 /usr/local/ReC7.0/multicast/logins.txt

Normalmente para monitorizar e ver se há problema basta
Correr o comando anterior.
Se virem que já há algum tempo ninguém faz experiências, tentar
ligar ao eLab e ver se há realmente problemas.
Se por acaso estiver muita gente ligada e não tiverem sido executadas
experiências nos últimos 10->20 mins, é porque o sistema está ''halted''.

Reiniciar :)

No caso de o e-lab estar a funcionar, mas não aparecerem experiências, fazer:

> ping 192.168.0.121

Se não existir resposta, é porque faltou a electricidade e o cluster tem
de ser reiniciado. Se obtiverem resposta, tentem reiniciar toda a
plataforma.

===Video===
START Video

/home/elab/videos/wp_saotome.start

START Hardware server
elab@wp_saotome:~ $ /home/elab/rec-deployment/wpilheus/wpilheusDaemon.sh start

STOP Hardware server
elab@wp_saotome:~ $ /home/elab/rec-deployment/wpilheus/wpilheusDaemon.sh stop

[[technical pages|e-lab technical pages (connections diagrams, schematics, hardware configurations]]
http://www.elab.tecnico.ulisboa.pt/wiki/index.php?title=Technical_pages&action=edit&redlink=1

=== Elab1 Network Hosts ===

{| class="wikitable"
!colspan="9"|Elab1 Network Hosts
! IP atríbuido do DHCP
! IP Address Estático
! VPN IP
! MAC Address
! Hostname
! Experiment
! Location
! Status
! Notes
|-
| 192.168.0.17
| 192.168.0.210
| 10.7.0.23
| b8:27:eb:3f:c7:c0
| plano-inclinado
| Plano Inclinado
| Lisbon
| On
|
|-
| 192.168.0.14
| 192.168.0.211
| -
| b8:27:eb:89:30:7d
| colisione
| colisione
| Lisbon
| On
|
|-
| 192.168.0.15
| 192.168.0.212
| -
| b8:27:eb:4e:de:b3
| mag3d
| Levitação Magnética 3d
| Lisbon
| On
|
|-
| 192.168.0.15
| 192.168.0.212
| -
| b8:27:eb:4e:de:b3
| mag3d
| Light Polarization
| Lisbon
| On
|
|-
| 192.168.0.200
| 192.168.0.213
| -
| b8:27:eb:f9:5d:c2
| elab200
| Sonda de Langmuir
| Lisbon
| On
|
|-
| 192.168.0.200
| 192.168.0.213
| -
| b8:27:eb:f9:5d:c2
| elab200
| elab200
| Lisbon
| -
|
|-
| 192.168.0.200
| 192.168.0.213
| -
| b8:27:eb:f9:5d:c2
| elab200
| pendulogravitico
| Lisbon
| -
|
|-
| 192.168.0.201
| 192.168.0.214
| -
| b8:27:eb:45:03:1e
| elab201
| -
| Lisbon
| -
|
|-
| 192.168.0.201
| 192.168.0.214
| -
| b8:27:eb:45:03:1e
| elab201
| Planck
| Lisbon
| On
|
|-
| 192.168.0.201
| 192.168.0.214
| -
| b8:27:eb:45:03:1e
| elab201
| Gamma
| Lisbon
| -
|
|-
| 192.168.0.202
| -
| -
| -
| elab202
| -
| Lisbon
| Off
|
|-
| 192.168.0.203
| 192.168.0.215
| -
| b8:27:eb:9d:b8:09
| elab203
| elab203
| Lisbon
| On
|
|-
| 192.168.0.203
| 192.168.0.215
| -
| b8:27:eb:9d:b8:09
| elab203
| Condicionador Cilíndrico
| Lisbon
| On
|
|-
| 192.168.0.250
| 192.168.0.216
| -
| b8:27:eb:ac:8c:3b
| fotovoltaico
| Painel Fotovoltaico
| Lisbon
| On
|
|-
| 192.168.0.100
| -
| -
| -
| elab100
| -
| Lisbon
| Off
|
|-
| 192.168.0.101
| -
| -
| -
| elab101
| -
| Lisbon
| Off
|
|-
| 192.168.0.102
| -
| -
| -
| elab102
| -
| Lisbon
| Off
|
|-
| 192.168.0.103
| -
| -
| -
| elab103
| -
| Lisbon
| Off
|
|-
| 192.168.0.104
| -
| -
| -
| elab104
| -
| Lisbon
| Off
|
|-
| 192.168.0.105
| -
| -
| -
| elab105
| -
| Lisbon
| Off
|
|-
| 192.168.0.106
| -
| -
| -
| elab106
| -
| Lisbon
| Off
|
|-
| 192.168.0.150
| -
| -
| -
| elab150
| -
| Lisbon
| On
|
|-
| 192.168.0.151
| -
| -
| -
| elab151
| -
| Lisbon
| Off
|
|-
| 192.168.0.152
| -
| -
| -
| elab152
| -
| Lisbon
| Off
|
|-
| 192.168.0.153
| -
| -
| -
| elab153
| -
| Lisbon
| Off
|
|-
| 192.168.0.154
| -
| -
| -
| elab154
| -
| Lisbon
| Off
|
|-
| -
| -
| 10.7.0.1
| -
| elab1
| -
| Lisbon
| On
|
|-
| -
| -
| 10.7.0.3
| -
| orionte_vpn
| World Pendulum
| Remote
| Off
|
|-
| -
| -
| 10.7.0.4
| -
| planetarium_vpn
| World Pendulum
| Remote
| Off
|
|-
| -
| -
| 10.7.0.5
| -
| espav_vpn
| World Pendulum
| Remote
| Off
|
|-
| -
| -
| 10.7.0.6
| -
| luanda_vpn
| World Pendulum
| Luanda
| Off
|
|-
| -
| -
| 10.7.0.7
| -
| ccvalg_vpn
| World Pendulum
| Remote
| Off
|
|-
| -
| -
| 10.7.0.8
| -
| elab_vpn???
| -
| Remote
| Off
|
|-
| -
| -
| 10.7.0.9
| -
| ecb1_vpn
| World Pendulum
| Remote
| Off
|
|-
| -
| -
| 10.7.0.10
| -
| puc_vpn
| World Pendulum
| Rio de Janeiro
| Off
|
|-
| -
| -
| 10.7.0.11
| -
| ccvsintra_vpn
| World Pendulum
| Sintra
| Off
|
|-
| -
| -
| 10.7.0.12
| -
| epm_vpn
| World Pendulum
| Remote
| Off
|
|-
| -
| -
| 10.7.0.13
| -
| mola_vpn
| -
| Remote
| Off
|
|-
| -
| -
| 10.7.0.16
| -
| saotome_vpn
| World Pendulum
| São Tomé
| Off
|
|-
| -
| -
| 10.7.0.17
| -
| mag3d_vpn
| mag3d
| Remote
| Off
|
|-
| -
| -
| 10.7.0.20
| -
| hidrostat_vpn
| -
| Remote
| Off
|
|-
| -
| -
| 10.7.0.22
| -
| labIE2_vpn
| -
| Remote
| Off
|
|-
| -
| -
| 10.7.0.24
| -
| WP-PRG
| World Pendulum
| Prague
| On
|
|-
| -
| -
| 10.7.0.25
| -
| bsb_vpn
| World Pendulum
| Remote
| Off
|
|-
| -
| -
| 10.7.0.26
| -
| puq_umag_vpn
| World Pendulum
| Remote
| Off
|
|-
| -
| -
| 10.7.0.27
| -
| vap_vpn
| World Pendulum
| Valparaíso
| Off
|
|-
| -
| -
| 10.7.0.28
| -
| bog_unad_vpn
| World Pendulum
| Bogotá
| Off
|
|-
| -
| -
| 10.7.0.29
| -
| bog_uniandes_vpn
| World Pendulum
| Bogotá (Uniandes)
| Off
|
|-
| -
| -
| 10.7.0.30
| -
| pty_utp_vpn
| World Pendulum
| Panama City
| Off
|
|-
| -
| -
| 10.7.0.31
| -
| pty_usma_vpn
| World Pendulum
| Panama City
| Off
|
|-
| -
| -
| 10.7.0.32
| -
| WP-BCN
| World Pendulum
| Barcelona
| On
|
|-
| -
| -
| 10.7.0.33
| -
| WP-MRS
| World Pendulum
| Remote
| On
|
|-
| -
| -
| 10.7.0.34
| -
| rio_puc2_vpn
| World Pendulum
| Rio de Janeiro
| Off
|
|-
| -
| -
| 10.7.0.35
| -
| WP-TAGUS
| World Pendulum
| IST Lisbon Taguspark
| On
|
|-
| -
| -
| 10.7.0.36
| -
| rai_vpn
| -
| Remote
| Off
|
|-
| -
| -
| 10.7.0.37
| -
| scl_vpn
| -
| ?
| Off
|
|-
| 192.168.0.11
| -
| 10.7.0.38
| -
| rpicavidade
| Cavidade
| Lisbon
| On
|
|-
| -
| -
| 10.7.0.39
| b8:27:eb:62:fe:ab
| WP-DIL
| World Pendulum
| Remote
| On
|
|-
| -
| -
| 10.7.0.39
| b8:27:eb:f4:7e:32
| WP-TAGUS
| World Pendulum
| Tagus
| On
|
|-
| -
| -
| 10.7.0.40
| -
| tagus_vpn
| -
| -
| Off
|
|-
| -
| -
| 10.7.0.41
| -
| dev_vpn
| -
| Lisbon
| Off
|
|-
| 192.168.0.19
| 192.168.0.217
| 10.7.0.42
| d8:3a:dd:e0:a2:75
| elab
| Multi-Polarizer
| Lisbon
| On
|
|-
| -
| -
| 10.7.0.43
| -
| -
| -
| -
| Off
|
|-
| -
| -
| 10.7.0.44
| -
| -
| -
| -
| Off
|
|-
| -
| -
| 10.7.0.45
| d8:3a:dd:e0:a2:87
| oeiras-elab
| Multi-Polarizer
| Oeiras
| On
|
|-
| -
| -
| 10.7.0.46
| d8:3a:dd:e3:4d:fe
| ictp
| Multi-Polarizer
| Trieste
| On
|
|-
| -
| -
| 200.128.66.240
| -
| ios
| -
| ?
| On
|
|}

[[MediaWiki:Flash]]
[[MediaWiki:Youtube]]
[[MediaWiki:CaixaLigacoes]]
[[MediaWiki:Links]]

Plano Inclinado

2025-11-15T16:06:16Z

Ist1106345:

==Descrição da experiência ==

O plano inclinado é uma das seis [https://pt.wikipedia.org/wiki/M%C3%A1quina_simples máquinas simples clássicas]. Os planos inclinados são geralmente utilizados para mover cargas pesadas sobre obstáculos verticais, tais como rampas para mover carga.

Mover um objeto para cima sobre um plano inclinado requer menos força do que levantá-lo na vertical, como se desmultiplicássemos a gravidade! Esta vantagem mecânica, pela qual a força é reduzida, é igual à razão entre o comprimento da superfície inclinada e a altura do plano.

Nas experiências laboratoriais que recriam esta máquina, na situação em que não é usada uma calha de ar de modo a quase eliminar o atrito de rolamento, o plano tem de ter uma inclinação significativa de forma a que a aceleração gravítica possa ser muito superior ao atrito, impossibilitando que a experiência possa ser realizada num tempo grande, percetível aos sentidos humanos.

Contudo, o atrito é parte integrante da mecânica do problema. Esta experiência permite determinar a função de atrito através duma análise multivariada, ajustando uma função que dependa da inclinação da calha. A experiência, para esse efeito, permite alterar o ângulo de descida e, através deste, separar as forças de atrito da força gravítica, obtendo-se um valor muito próximo de 9,8 ms<sup>-2</sup>.

<div class="toccolours mw-collapsible mw-collapsed" style="width:420px">
'''Ligações'''
<div class="mw-collapsible-content">

*Vídeo: rtsp://elabmc.ist.utl.pt/plinc.sdp
*Laboratório: [http://elab.tecnico.ulisboa.pt Básico]
*Sala de Controlo: Plano inclinado
*Nível: *

</div>
</div>

Propositadamente, nesta experiência é usado um carro equipado com um pára-vento frontal de modo a exacerbar o efeito do atrito e demonstrar que a sua equação pode ser determinada pela análise multivariada de vários percursos, para inclinações diferentes.

[[File:PlanoInclinado.png|thumb|Montagem da experiência do plano inclinado onde se identifica facilmente o isolamento acústico necessário a evitar ecos espúrios que dificultam a detecção da posição pelo sonar.|center|720px]]

===Aparato experimental===

[[File:Promenor_Sonar.jpeg||thumb|Vista geral da experiência com o sonar numa das extremidades, após a mola coletora do embate. |right|border|288px]]

O plano inclinado desta experiência recria essa "desmultiplicação da gravidade". Consiste num veículo, com massa de 63.37 g, que se desloca numa calha com inclinação regulável e que bascula no seu ponto médio. A altura da calha é medida a 1003 mm do eixo da experiência.

Inicialmente a calha bascula para uma posição com um ângulo negativo de modo a recolher e a parquear o carro na origem, a cerca de 1,3m da mola que irá absorver a energia do seu movimento. Este é imobilizado através de um eletroíman e, posteriormente, a calha é elevada até à altura pré-selecionada. Quando atinge esse ponto, o eletroíman liberta o carrinho e este desloca-se livremente sobre a calha até embater na mola.
Um detector ultra-sónico colhe, então, amostras da posição em função do tempo decorrido, permitindo traçar a trajectória do veículo durante a queda e no seu amortecimento final.

==Protocolo==
Com base nos dados pré-seleccionados na experiência, obtenha um gráfico da posição em função do tempo decorrido. Com base nestes dados, determine ainda os gráficos da velocidade e da aceleração. Compare o valor obtido da aceleração com a gravidade.

====Determinação da velocidade em função da distância percorrida====
Com base nos dados anteriores, determine a velocidade em função da distância percorrida, eliminando o tempo nos gráficos anteriores, ou seja, traçando a curva desenhada pelos pares velocidade, distância para cada tempo disponível.

====Determinação da constante de restituição da mola====

Em função das várias parábolas obtidas no amortecimento do veículo, determine a perda relativa de energia em cada embate com a mola e determine a constante de restituição da mola.

===Protocolo avançado===
Como pode ser inferido rapidamente, o ajuste do modelo parabólico ao movimento produz um desvio que só é possivel de entender com a inclusão de um termo de fricção. Com efeito, o carrinho dispõe duma pala frontal destinada a induzir um certo atrito aerodinâmico. Adaptando as equações de modo a incluir um termo de atrito de rolamento (linear com a velocidade) e aerodinâmico (Cx, dependência quadrática com a velocidade), pode-se determinar finalmente um valor mais preciso para a aceleração do veículo.
Normalmente o ''Cx'' só influencia significativamente o movimento a partir dos 25 km/h.

O ajuste duma função de atrito para a aceleração na forma ''a = b + c*v + d*v<sup>2</sup>'' permite extrair a aceleração local da gravidade ao serem utilizadas várias séries de dados para ângulos variados.

====Modelo multivariado====
A análise multivariada utilizada serve para construir um modelo de ajuste numérico para vários ângulos às várias características do movimento obtido. A variação do ângulo permite distinguir o efeito da gravidade do da força de atrito de rolamento, já que este é considerado independente do ângulo. Deste modo, ao fazer um ajuste do tipo ''a = b + c*v + d*v<sup>2</sup>'', o parâmetro ''b'' que detém implicitamente a gravidade e o atrito de rolamento (relacionado com a mecânica do veículo) pode ser resolvido separando-o em ''b=g*sin(θ) + b<sub>atrito</sub>''. Os restantes parâmetros resultam de um modelo da dependência do atrito com a velocidade. Para valores elevados desta (tipicamente superior a 7-10 ms<sup>-1</sup>), o atrito tem uma forte dependência quadrática com a velocidade – atrito aerodinâmico – mas, no nosso caso, também temos de considerar a dependência de atrito mecânico (''b<sub>atrito</sub>+c*v''), uma vez que o carro parte do repouso.

Ao realizar esta análise multivariada estamos a considerar uma associação independente entre os parâmetros, condição necessária para esses parâmetros fazerem parte de um modelo numérico que se provará correto pelo desfecho do ajuste. Para o efeito, deverá ser utilizado um ''solver'' numérico ajustando interativamente as várias co-variáveis, tal como o do MSExcel.

====Determinação rigorosa da constante de restituição da mola====

Uma análise breve permite concluir que a constante de restituição da mola para os vários embates vem ferida de um erro apreciável, tanto maior quanto o percurso percorrido, uma vez que o trabalho realizado pela força de atrito prejudica o cálculo da energia mecânica em cada troço do movimento. No entanto, calculando o trabalho efetuado pela força de atrito com base na equação da força de atrito determinada pelo processo anteriormente descrito, é possível inferir corretamente a energia mecânica antes e depois de cada embate, permitindo calcular corretamente a constante de restituição da mola.

==Pormenores da construção==
[[File:ElectroIma.png||thumb|Eletroíman de atracação do carrinho.|right|border|120px]]
O componente mais curioso desta experiência é o eletroíman que mantém o carrinho seguro na posição de lançamento. Com efeito, este eletroiman pode ser construído enrolando fio esmaltado sobre um núcleo de ferro mole ou usando um eletroíman extraído duma simples torradeira!
Outra inovação é a montagem ser efetuada sobre uma calha basculante que simplifica o recolher do carrinho à posição de lançamento. Como é necessário uma inclinação razoável para vencer o atrito estático, o embate no eletroíman de fixação é significativo mas pode ser resolvido colocando uma espuma autocolante em ambas as faces, entre o ferro de atracação e o carro.

==Ligações==

*[[Inclined Plane | Versão em Inglês (English Version)]]

Inclined Plane

2025-11-15T16:03:08Z

Ist1106345:

==Experiment description==

The inclined plane is one of the six [https://pt.wikipedia.org/wiki/M%C3%A1quina_simples classic simple machines]. Inclined planes are generally used to move heavy loads over vertical obstacles, such as ramps to move cargo.

Moving an object up on an inclined plane requires less force than lifting it vertically, as if we reduced gravity! This mechanical advantage, by which the force is reduced, is equal to the ratio between the length of the inclined surface and the height of the plane.

In laboratory experiments that recreate this machine, when an air chute is not used in order to almost eliminate the rolling friction, the plane must have a significant slope so that the gravitational acceleration can be much higher than the friction, making it impossible for this experience to be carried out in a long time, perceptible to human senses.

However, friction is an integral part of the mechanics of the problem. With this experiment, it is possible to determine the friction function through a multivariate analysis, adjusting a function that depends on the inclination of the rail. For this purpose, the experiment allows changing the descent angle and, through this, separating the frictional forces from the gravitational force, obtaining a value very close to 9,8 ms<sup>-2</sup>.

<div class="toccolours mw-collapsible mw-collapsed" style="width:420px">
'''Links'''
<div class="mw-collapsible-content">

*Laboratory: [http://elab.tecnico.ulisboa.pt Básico]
*Control Room: Inclined Plane
*Level: *

</div>
</div>

On purpose, this experiment uses a car equipped with a frontal windshield in order to exacerbate the effect of friction and demonstrate that its motion equation can be determined by multivariate analysis over several rides, for different inclinations.

[[File:PlanoInclinado.png|thumb| Inclined plane experience assembly where is easy to identify the necessary acoustic insulation to avoid spurious echoes that difficult the detection of the position by the sonar.|center|720px]]

===Experimental apparatus===

[[File:Promenor_Sonar.jpeg||thumb|General view of the experiment with the sonar at one end, after the collision collector spring. |right|border|288px]]

The inclined plane of this experiment recreates this "reduction of gravity". It consists of a vehicle, with mass 67.37 g, that moves on a track with adjustable inclination and that tilts at its midpoint. The height of the chute is measured at 1003 mm from the axis of the experiment.

Initially the chute tilts to a position with a negative angle in order to collect and park the car at the origin, about 1.3 m from the spring that will absorb the energy of its movement. The electromagnet immobilizes the car and, subsequently, the rail is raised to the pre-selected height. When it reaches that point, the electromagnet releases the car and it moves freely on the rail until it hits the spring. An ultrasonic detector collects position samples as a function of the elapsed time, allowing to trace the vehicle's trajectory during the fall and in its final damping.

==Protocol==
Based on the pre-selected data in the experiment, obtain a graph of the position as a function of the elapsed time. Based on this data, determine the speed and acceleration graphs. Compare the acceleration obtained value with gravity.

====Determination of speed as a function of distance traveled====
Based on the previous data, determine the speed as a function of the distance traveled eliminating the time in the previous graphs, that is, tracing the curve drawn by the speed pairs, distance for each available time.

====Determination of the spring restitution constant====
Depending on the various parables obtained in the vehicle's damping, determine the relative energy loss in each collision with the spring and determine the spring restitution constant.

===Advanced protocol===
As can be quickly inferred, the adjustment of the parabolic model to the movement produces a deviation that is only possible to understand with the inclusion of a friction term. In effect, the car has a front flap designed to induce a certain aerodynamic friction. By adapting the equations to include a rolling friction term (Cv, viscous, linear with velocity) and aerodynamic (Cx, quadratic dependence with velocity), a more accurate value for the acceleration of the vehicle can finally be determined. Usually the ''Cx'' only significantly influences the movement after 25 km/h.

The adjustment of a friction function for the acceleration in the form ''a = b + c*v + d*v<sup>2</sup>'' allows to extract the local acceleration of gravity when using several sets of data for various angles as the ''b'' term from the Coulomb friction as the same dimensions as gravity.

====Multivariate model====
The multivariate analysis used serves to build a model of numerical adjustment for various angles to the various characteristics of the movement obtained. The variation of the angle makes it possible to distinguish the effect of gravity from the effect of rolling friction force, since this is considered independent of the angle. Thus, by making a ''a=b+c*v+d*v<sup>2</sup>'' type adjustment, the parameter ''b'' which implicitly deters the gravity and friction of the bearing (related to the mechanics of the vehicle) can be solved by separating it into ''b =g*sin(θ)+b<sub> friction </sub>''. The remaining parameters result from a model of the dependence of friction with speed. For high values of this (typically greater than 7-10 ms<sup>-1</sup>), friction has a strong quadratic dependence on speed - aerodynamic friction - but, in our case, we also have to consider the dependence on mechanical friction (''b<sub>atrito</sub>+c*v''), since the car departs from rest.

When performing this multivariate analysis, we are considering an independent association between the parameters, a necessary condition for these parameters to be part of a numerical model that will prove correct by the outcome of the adjustment. For this purpose, a numerical solver should be used, interactively adjusting the various covariates, such as that of the MSExcel.

====Strict determination of the spring restitution constant====
A brief analysis makes it possible to conclude that the spring restitution constant for the various strikes is affected by an appreciable error, which increases with the distance traveled, since the work carried out by the frictional force affects the calculation of the mechanical energy in each section of the movement. However, by calculating the work performed by the frictional force based on the frictional force equation determined by the previously described process, it is possible to correctly infer the mechanical energy before and after each impact, allowing to correctly calculate the spring restitution constant.

==Construction details==
[[File:ElectroIma.png||thumb| Car mooring electromagnet.|right|border|120px]]
The most curious component of this experience is the electromagnet who keeps the car safe in the launch position. This electromagnet can be built by wrapping enameled wire over a soft iron core or using an electromagnet extracted from a simple toaster!

Another innovation is the fact that the assembly is carried out on a tilting chute that simplifies the return of the car to the launch position. As it is necessary a reasonable inclination to overcome static friction, the impact on the fixing electromagnet is significant but can be resolved by placing a self-adhesive foam on both sides, between the mooring iron and the car.

==Links==

*[[Plano inclinado | Portuguese version (Versão em Português)]]