Manual do altímetro Nano V1
Este manual detalha todos os recursos e operação do nosso pequeno altímetro de foguete Nano V1

Alterar as definições do Nano

PDF

Todas as definições do Nano estão num único ficheiro na sua unidade, device_settings.txt. Pode editá-lo em qualquer editor de texto, ou alterar as definições no navegador com a ferramenta Nano USB Settings.

As alturas estão em metros. Esta página descreve o firmware 2.00; a sua versão aparece em device_information.html.

Definições num relance

Selecione uma definição para saltar para a sua descrição.

DefiniçãoPredefiniçãoIntervalo
Identificação
Nome do dispositivo
device_tag
"MyNano"Até 20 caracteres
Número de concorrente
competitor_tag
"" (vazio)Até 32 caracteres
Números de concorrente adicionais
competitor_tag_2, _3
"" (vazio)Até 32 caracteres
Tipo de dispositivo
device
"NanoV1"Não alterar
Lançamento e gravação
Altura de deteção de lançamento
launch_detect
301 a 199 m
Bloqueio de arranque
startup_lock
00 a 999 s
Proteção de lançamento
launch_protection
20000 a 10000 mG
Paragem da gravação
recording_stop
11, 2 ou 3
Comprimento máximo do registo
max_samples
380004000 a 38000
Amostragem e registo
Taxa de registo
sample_speed
417 Hz104, 208, 417 ou 833 Hz
Rácio de amostras
sample_ratio
11 a 50
Modo híbrido
hybrid_mode
80 ou 1 (desligado), ou 2 a 40
Formato do registo
log_format
1 (ACLZ)0 = CSV, 1 = ACLZ
Incluir pressão
include_pressure
00 ou 1
Sensor de movimento
Sensor de alta velocidade
high_speed_sensor
10, 1 ou 2
Orientação
orientation
9 (auto)9 = auto, 1 a 6
Sincronização dos sensores
sync_enable
20 ou 1 = desligado, 2 = ligado
Alimentação e LED
Modo de energia
emode
11 ou 2
Após a aterragem
maintain_power
00 a 3
Leitura no arranque
show_altitude
10 ou 1
Brilho do LED
led_brightness
51 (mais brilhante) a 10
Manutenção
Compatibilidade com telemóveis
android_compat
00 ou 1
Reposição de fábrica
factoryreset
00 ou 1

Alterar as definições

No ficheiro de definições

  1. Com o interruptor de alimentação desligado, ligue o Nano por USB. Aparece como a unidade ALTCLOUD.
  2. Abra device_settings.txt num editor de texto simples e altere os valores necessários. Mantenha as aspas, os dois pontos e as vírgulas como estão; os valores de texto ficam entre aspas e os números não.
  3. Guarde, ejete a unidade e depois desligue o Nano. As novas definições são lidas no arranque seguinte.
Importante
Se o ficheiro tiver um erro de escrita, ou qualquer valor fora do intervalo, o Nano substitui o ficheiro inteiro pelas predefinições no arranque seguinte. Se as alterações parecerem ter desaparecido, é essa a razão.

Com a ferramenta Nano USB Settings

A ferramenta Nano USB Settings oferece uma lista pendente para cada definição e só aceita valores válidos. Requer firmware 1.60 ou posterior e Chrome, Edge ou Opera num computador de secretária ou portátil.

  1. Ligue o Nano com um cabo de dados USB e clique em Connect altimeter. Escolha a entrada que menciona TinyUSB.
  2. Altere o que precisar e guarde. Tudo o que for recusado fica contornado a vermelho, com a razão.
  3. O LED pisca três vezes a roxo e depois uma vez a verde quando a alteração é aceite. Entra em vigor no arranque seguinte do Nano.

O ficheiro predefinido

Um Nano novo escreve estes valores.

{
  "Important": "Check the manual for correct values",
  "device_tag": "MyNano",
  "competitor_tag": "",
  "competitor_tag_2": "",
  "competitor_tag_3": "",
  "device": "NanoV1",
  "android_compat": 0,
  "log_format": 1,
  "emode": 1,
  "factoryreset": 0,
  "high_speed_sensor": 1,
  "hybrid_mode": 8,
  "include_pressure": 0,
  "launch_detect": 30,
  "launch_protection": 2000,
  "led_brightness": 5,
  "maintain_power": 0,
  "max_samples": 38000,
  "orientation": 9,
  "recording_stop": 1,
  "sample_ratio": 1,
  "sample_speed": 417,
  "show_altitude": 1,
  "startup_lock": 0,
  "sync_enable": 2
}

Identificação

O nome do dispositivo e os três números de concorrente são escritos em cada registo de voo e abrangidos pela sua assinatura digital, por isso não podem ser alterados depois sem que a verificação falhe. Editar o ficheiro de definições só afeta voos futuros.

Nome do dispositivo device_tag

Valores válidos: Até 20 caracteres

Um nome para este altímetro. Aparece na página do voo quando carrega um registo para o Altimeter Cloud.

Número de concorrente competitor_tag

Valores válidos: Até 32 caracteres

O seu número de competição FAI ou NAR, ou um código atribuído no próprio dia. Como está no registo assinado, o registo prova quem voou e que foi gravado depois de o código ser atribuído. Deixe vazio se não estiver a competir.

Números de concorrente adicionais competitor_tag_2, _3

Valores válidos: Até 32 caracteres

Se voar em mais do que uma competição, acrescente aqui os outros números e o Nano fica pronto para todas. A ferramenta USB Settings aceita até 20 caracteres em cada um.

Tipo de dispositivo device

Valores válidos: Não alterar

Deixe como «NanoV1». Se for outro valor, nenhuma das definições é aplicada e o ficheiro é reposto.

Lançamento e gravação

Altura de deteção de lançamento launch_detect

Valores válidos: 1 a 199 m

A altura, em metros, acima da plataforma de lançamento que o foguete tem de subir antes de um lançamento poder ser confirmado. Tem de se manter acima dela durante 1 segundo com impulso contínuo, ou durante 2,5 segundos só pela altura. O registo começa mesmo assim na plataforma, porque o Nano guarda um buffer dos últimos segundos enquanto espera. 25 a 50 m é adequado para a maioria dos voos.

Bloqueio de arranque startup_lock

Valores válidos: 0 a 999 s

Ignora qualquer lançamento durante este número de segundos após ligar, dando tempo para fechar o foguete. 0 desativa-o. Enquanto o bloqueio está ativo, o LED brilha a vermelho entre as piscadelas normais, e o brilho para quando termina.

Proteção de lançamento launch_protection

Valores válidos: 0 a 10000 mG

Permite ao Nano confirmar rapidamente um lançamento, assim que o foguete está acima da altura de deteção, se também detetar impulso contínuo ao longo do eixo do foguete. O valor é a aceleração total em mili-G: um Nano parado lê cerca de 1000, por isso a predefinição de 2000 pede 1 G de impulso real. Pancadas e manuseamento na plataforma não contam, e uma combustão curta que não atinja o valor é confirmada na mesma só pela altura ao fim de 2,5 segundos, sem perder nada.

Defina 4000 se o foguete levar pancadas na plataforma, ou 0 para desativar a verificação.

Paragem da gravação recording_stop

Quando o Nano para de gravar após a aterragem. Também para se o registo encher ou a bateria descer a 3,05 V, e tudo o que foi gravado é guardado.

ValorO que faz
1Após 8 segundos de altitude estável (predefinição)
2Após 16 segundos de altitude estável
3Só quando o registo está cheio

Comprimento máximo do registo max_samples

Valores válidos: 4000 a 38000

O número máximo de amostras que um registo de voo pode conter, incluindo os dados de antes da descolagem. Os registos CSV têm um limite mais baixo, ver formato do registo.

Amostragem e registo

Taxa de registo sample_speed

Valores válidos: 104, 208, 417 ou 833 Hz

Quantas vezes por segundo o Nano regista em voo. Taxas mais altas captam mais pormenor, mas gastam mais bateria e enchem o registo mais depressa. Todas as amostras do sensor de movimento são guardadas, e o barómetro funciona a 80 Hz em qualquer taxa.

Taxa de registoDuração do registo com o modo híbrido desligado
104 HzCerca de 6 minutos
208 HzCerca de 3 minutos
417 HzCerca de 90 segundos
833 HzCerca de 45 segundos

O modo híbrido, ativo por predefinição, torna-os muito mais longos.

Rácio de amostras sample_ratio

Valores válidos: 1 a 50

Guarda uma amostra em cada N; 1 guarda todas. O registo nunca desce abaixo de 10 amostras por segundo, por isso um valor mais alto é aplicado nesse limite. Com o modo híbrido ligado, é o modo híbrido que assume após o apogeu.

Modo híbrido hybrid_mode

Regista as partes importantes do voo à taxa máxima e o resto a uma taxa mais baixa, para que até um voo longo caiba. A subida, o apogeu, os 5 segundos após o apogeu, os últimos 20 m antes da aterragem e qualquer solavanco acima de 7 g (a abertura de um paraquedas principal, por exemplo) são sempre registados por completo.

ValorO que faz
0 ou 1Desligado, todas as amostras são registadas
2 a 40Ligado, guarda uma amostra em N entre as partes importantes. A predefinição de 8 dá cerca de 52 Hz a 417 Hz.

Por exemplo, um voo de 5 km com uma subida de 20 segundos, registado a 417 Hz, grava durante cerca de 8,5 minutos em vez de 90 segundos. A 208 Hz são cerca de 20 minutos.

Formato do registo log_format

ValorO que faz
0CSV. Abre numa folha de cálculo diretamente da unidade, mas limitado a 22 000 amostras.
1ACLZ, o registo comprimido do Nano, que recomendamos. Os mesmos dados com a mesma precisão de um CSV em cerca de um décimo quinto do espaço, mais a altitude do barómetro exatamente como gravada, antes de qualquer processamento. Inclui também uma assinatura para o CSV em que se expande, por isso um CSV reconstruído a partir dele pode continuar a ser verificado. Carregue-o para o Altimeter Cloud para o ver, e transfira daí qualquer um dos formatos. (predefinição)

Consulte a página Formato do registo de voo para mais pormenores.

Incluir pressão include_pressure

ValorO que faz
0Sem coluna de pressão (predefinição)
1Acrescenta uma coluna de pressão (hPa) aos registos CSV, calculada a partir da altitude quando o registo é guardado. O limite do CSV desce para 20 000 amostras.

Sensor de movimento

Sensor de alta velocidade high_speed_sensor

Amostra o sensor de movimento mais depressa do que a taxa de registo e reduz por média, para contrariar o efeito da vibração nas leituras. A aceleração, a rotação e os ângulos registados ficam mais limpos.

ValorO que faz
0Desligado
1Sensor de movimento a 1 667 Hz (predefinição)
2Como 1, com o giroscópio a 3 333 Hz

Custa um ou dois por cento de autonomia da bateria, por isso vale a pena deixá-lo ligado.

Orientação orientation

Como o Nano está montado, para que os ângulos de voo fiquem corretos. Use o número que corresponde ao diagrama, com a seta a apontar para a ogiva.

ValorO que faz
1Na vertical, porta micro-USB virada para baixo
2Na vertical, porta micro-USB virada para cima
3De lado, LED de estado na aresta inferior
4De lado, LED de estado na aresta superior
5Deitado, face para baixo com a bateria virada para cima
6Deitado, face para cima com a bateria virada para baixo
9Automático. Determinada pela gravidade na plataforma de lançamento, ajustando-se à mais próxima das seis posições (o alinhamento a 90 graus mais próximo), atualizada se for mantido parado noutra posição, e fixada no lançamento. (predefinição)

Sincronização dos sensores sync_enable

Com esta opção ligada, o acelerómetro afina o momento da descolagem para o início do impulso, ignorando qualquer pico do ignitor, e as leituras do barómetro, que ficam ligeiramente atrás do sensor de movimento, são alinhadas com ele.

ValorO que faz
0 ou 1Desligado
2Ligado (predefinição)

Alimentação e LED

Modo de energia emode

Quanto o Nano reduz o consumo depois de a plataforma estar calma durante algum tempo. Qualquer movimento repõe imediatamente a taxa máxima, e o registo que guarda para o lançamento é igual em ambos os casos.

ValorO que faz
1Normal. Acorda 52 vezes por segundo. (predefinição)
2Poupança máxima. Acorda 26 vezes por segundo para maior autonomia.

Após a aterragem maintain_power

O que o Nano faz depois de o voo ser guardado.

ValorO que faz
0Pisca a vermelho e entra em suspensão. Abane-o com firmeza durante um ou dois segundos para voltar a ver o número do voo e o apogeu. (predefinição)
1Pisca o apogeu até a bateria se esgotar
2Pisca o apogeu durante 4 minutos e depois entra em suspensão
3Pisca o apogeu durante 10 minutos e depois entra em suspensão

Consulte Altitude por piscadelas para saber ler as piscadelas.

Leitura no arranque show_altitude

ValorO que faz
0Salta a leitura
1Pisca o número do último voo e o apogeu ao ligar (predefinição)

Um toque curto no botão na plataforma de lançamento mostra a leitura em qualquer caso.

Brilho do LED led_brightness

Valores válidos: 1 (mais brilhante) a 10

1 é o mais brilhante e 10 o mais ténue. Um LED mais ténue poupa um pouco de energia.

Manutenção

Compatibilidade com telemóveis android_compat

Alguns telemóveis e tablets não abrem uma unidade que já viram antes.

ValorO que faz
0Aparece sempre como a mesma unidade (predefinição)
1Aparece como uma unidade nova a cada arranque

Reposição de fábrica factoryreset

ValorO que faz
0Normal (predefinição)
1Apaga a unidade e repõe todas as predefinições no arranque seguinte, voltando depois a 0

Outras formas de repor estão na página Reposição de fábrica.

Verificar as alterações

Depois de ligar, abra device_settings.txt outra vez. Se os seus valores ainda lá estiverem, foram aceites. Se tiver voltado às predefinições, havia algo errado, por isso compare-o com a tabela acima.

Verificação de definições padrão
Se alguma definição, além do nome do dispositivo e dos números de concorrente, diferir da predefinição, o Nano mostra no arranque uma sequência de 5 segundos de rosa, roxo e azul. Útil para confirmar numa competição que um Nano está com as definições padrão.

Definições bloqueadas

A pressão ao nível do mar (1013,25 hPa), a temperatura (15 °C) e a filtragem do barómetro são fixas no firmware. Ficheiros mais antigos podem ainda conter chaves como sealevel, fixed_temp ou kalmanfilter; estas são ignoradas.