Skip to content

02. Tracker Configuration # Configuracion del Tracker

Ricardo Guzman (Richonguzman) edited this page Sep 18, 2024 · 12 revisions

explorer project 01

01

In Platformio(inside VSCODE), there should be a folder with the Firmware you imported. Inside this folder you should find the "data" folder. Press it and you will find "tracker_conf.json" file. Now its time to edit it to configure your Tracker:

callsign

Change all callsigns from “NOCALL-7” to your Callsign and SSID. You could use 3 different Callsigns+SSID or the same Callsigns with different SSIDs or even the same Callsign+SSID and only change Symbols and smartBeacon data. Once it´s operational, with the buttons you change from one profile to another, so that it controls the beacon with different parameters depending on use, speeds, ...

symbol and overlay

Change them to your needs. Usually only changing Symbol is needed. (for the special event of wanting to use “\” as overlay you should use “\\” as this is the way the firmware would process it)

Mic-E

Add it if you want to send Mic-E gps encoded aprs packets. By default is empty "", but if you add the 3 Mic-E Message Type identification it will send in Mic-E encoding. For example, Mic-E encodings are "111" Off Duty, "110" en Route. For more information: http://www.aprs.org/doc/APRS101.PDF (page 45).

comment

Text that will be sended each time you send a beacon. It this isn’t necessary, please leave it empty (“”) as this will shorten the LoRa packet and increase success of being listened and uses less time in RF.

smartBeaconActive

It calculates the time between beacons as a product of speed, course, time, distance and angle of your movement. When “false” is selected “nonSmartBeaconRate” will be used as a time between beacons.

smartBeaconSetting

It will have all needed values already set for each speed of the moving Tracker/Station

  • 0 for walking / runner
  • 1 for bicycle speed
  • 2 for faster moving stations: car , motorbikes, etc.

En el módulo de Platformio (dentro del programa VSCODE), debería haber una carpeta con el firmware que importaste con anterioridad. Dentro de esta carpeta deberías de tener la carpeta "data". Haz clickc en ella y encontrarás el archivo "tracker_conf.json". Ahora es el momento de editarlo para configurar y personalizar tu Tracker:

Indicativo

Cambia todos los indicativos de “NOCALL-7” a su indicativo y SSID que estimes conveniente según su uso. Puedes utilizar hasta 3 indicativos diferentes+SSID o los mismos indicativos con diferentes SSID, o incluso el mismo indicativo+SSID y solo cambiar símbolos y datos de la baliza. Cuando ya esté operativo, con los botones cambias de un perfil a otro, para que mande la baliza con distintos parámetros según el uso, velocidades, etc ...

Símbolo y textos

Cámbialos según tus necesidades. Por lo general, sólo es necesario cambiar el símbolo. (para el caso especial de querer usar “\” como superposición, debes de usar “\\” ya que esta es la forma en que el firmware lo procesaría)

Mic-E

Si quieres enviar con compression Mic-E packets aprs debes cambiar de default "" (vacuo) a algunos de los tipos de mensaje Mic-E. Por ejemplo "111" Off Duty, "110" en Route. Para mas informacion: http://www.aprs.org/doc/APRS101.PDF (pagina 45).

comentario superpuesto

Es el texto que se enviará cada vez que envíes una baliza. Si esto no es necesario, dejalo vacío (“”) ya que esto acortará el paquete LoRa emitido, por lo que aumentará el éxito de la escucha y utilizará menos tiempo en radio frecuencia.

smartBeaconActive

Calcula el tiempo entre beacons en función de la velocidad, cambio de curso, tiempo y distancia que recorre el tracker. Cuando se selecciona "false" el tiempo es entre beacons sera el “nonSmartBeaconRate”.

smartBeaconSetting

Tendra todos los valores ya pre-seteados para las distintas velocidades en que se mueva el Tracker.

  • 0 para quien camina o corre.
  • 1 para velocidades de una bicicleta.
  • 2 para estaciones de posible alta velocidad como autos y motocicletas.

02

Display

showSymbol

For showing on screen the symbol instead of the letter/character of the symbol

ecoMode

For turning the screen of after the "timeout" time to use less current. When pressing user button screen will be turned on for a while.

timeout

Time the screen stays on if "ecoMode" is set to true

turn180

For turning 180 degrees the screen on certain trackers.


Display/Pantalla

showSymbol

Para mostrar en pantalla el symbol como figura o letra.

ecoMode

Para apagar la pantalla despues de "timeout" segundos para usar menos corriente. Al apretar baton la pantalla se prendera unos segundos.

timeout

Tiempo que durara encendida la pantalla antes de apagarse para economizar corriente.

turn180

Para girar 180 grados la pantalla en algunos trackers.

"showSymbol": true, "ecoMode": false, "timeout": 4, "turn180" : false Los valores “frequency”, “spreadingFactor”, “signalBandwidth”, “codingRate4” y “power” deben dejarse como están a menos que en tu país / zona, tengas que cambiar esto para cumplir con las reglas de transmisión locales.

03

Battery

sendVoltage

Send Battery Voltage info in GPS Beacon of the Tracker.

voltageAsTelemetry

Send Battery Voltage encoded as Telemetry in Base91 (APRS1.2b)

sendVoltageAlways

Send Battery Voltage in each Packet instead of waiting for "sendCommentAfterXBeacons".


Bateria

sendVoltage

Enviar el Voltaje de la Bateria en el packet de GPS del Tracker.

voltageAsTelemetry

Enviar el Voltaje de la Bateria codificado en Base91 (APRS1.2b)

sendVoltageAlways

Enviar el Voltaje de la Bateria en cada packet en vez de espear a "sendCommentAfterXBeacons".

04

LoRa

“frequency”, “spreadingFactor”, “signalBandwidth”, “codingRate4” and “power” should be left as they are unless your country needs to change this to use it according to their RF rules.


LoRa

Los valores “frequency”, “spreadingFactor”, “signalBandwidth”, “codingRate4” y “power” deben dejarse como están a menos que en tu país / zona, tengas que cambiar esto para cumplir con las reglas de transmisión locales.

05

Other

(here are more custom configuration options)

"simplifiedTrackerMode": true was created to users who just want to send Gps packets and not use the Menu of the Tracker. Default is false.

“showSymbolOnScreen”: true enables seeing the Symbol next to the Callsign+SSID on the Oled Screen. Default is true. If you only see a letter of the symbol selected and not a drawn symbol is that I have not yet drawn it and you should write me in the "issues" to add it to the "custom_characters.h" file to be able to be seen on the Oled-Screen.

“sendCommentAfterXBeacons”: the Tracker can send comment at each beacon but with this setting you can choose to send the comment text only after a number of beacons. Default is 10. This means that only after 10 beacons the "comment" text will be transmitted also.

“displayEcoMode”: false will let the screen stay always on (although you can choose to turn if of with displayEcoMode in the tracker Menu later. true will force the tracker to have the screen turned off right at the bootup to avoid being activated each time with the menu. Default is false.

“displayTimeOut”: seconds that the tracker will wait to turn the screen off when “displayEcoMode” is activated (by configuration or by Menu). Default is 4.

“path”: WIDE1-1 is being used as the default path for sending beacons and messages.

“nonSmartBeaconState”: when “smart_beacon” is not active this will be the time in minutes at which each beacon will be sended at a fixed rate. Default is 15.

“rememberStationTime”: time in minutes that the tracker remembers a station being heard to show it on the Listening Menu of other trackers around before being dropped from the list. Default is 30.

“maxDistanceToTracker”: distance in kilometers for a future function not implemented (leave this as is please).

“standingUpdateTime”: time in minutes that the tracker waits to send a beacon if the tracker has not move outside the “minDistTx” to force a beacon transmission. Default is 15.

“sendAltitude”: if true the tracker sends altitude+course in the encoded gps data, if false the tracker will send velocity+course. Remember that APRS calculates speed automatically even when sending altitude+course. Default is true.

“bluetoothType”: 1 selects the type of connection for using the tracker as TNC. 1 is for Android and Aprsdroid. 0 is for iPhone and. APRS.fi app..

“bluetoothActive": true enables the tracker to connect to BT devices like Phones and Apps over TNC2 or KISS TNC. Default is true.

“disableGPS”: true turns off the GPS of the board if the tracker is used with the GPS of the Phone over Bluetooth or when using a LoRa32 board which hasn’t gps module attached. Default is false.


Otro (aquí hay más opciones de configuración personalizadas)

"simplifiedTrackerMode": false ( falso ) fue creado para usuarios que solo quieren enviar paquetes Gps y no usar el menú del rastreador. El valor predeterminado es false.

“showSymbolOnScreen”: true ( verdadero ) permite ver el símbolo junto al indicativo+SSID en la propia pantalla Oled. El valor predeterminado es verdadero. En el caso de que solo veas una letra del símbolo seleccionado, y no un símbolo dibujado, es porque aún no lo he dibujado y deberías escribirme en los "issues" para agregarlo al archivo "custom_characters.h", para poder tenerlo correctamente.

“sendCommentAfterXBeacons”: 10 el Tracker puede enviar comentarios en cada baliza, pero con esta configuración puede elegir enviar el texto del comentario solo después de varias balizas emitidas. El valor predeterminado es 10. Esto significa que sólo después de 10 balizas también se transmitirá el texto del "comentario" asignado.

“displayEcoMode”: false ( falso ) permitirá que la pantalla permanezca siempre encendida (aunque puede optar por desactivarla con displayEcoMode en el menú del rastreador más tarde. Con true ( verdadero ) se le obligará al rastreador a tener la pantalla apagada justo en el inicio, para evitar que se active cada vez con el menú. El valor predeterminado es false.

“displayTimeOut”: estos son los segundos que esperará el monitor, para apagar la pantalla cuando se active “displayEcoMode” (por configuración o por Menú). El valor predeterminado es 4.

“path”: WIDE1-1 se utiliza como la ruta predeterminada para enviar balizas y mensajes.

“nonSmartBeaconState”: cuando *“smart_beacon” no esté activo, este será el tiempo en minutos en el que se enviará cada baliza a una intervalo fijo. El valor predeterminado es 15.

“rememberStationTime”: Es el tiempo en minutos en el que el rastreador recuerda una estación que se está escuchando, para mostrarla en el menú de escucha de otros rastreadores antes de eliminarla de la lista. El valor predeterminado es 30.

“maxDistanceToTracker”: Esta es la distancia en kilómetros para una función futura no implementada todavía (dejarlo como está por favor).

“standingUpdateTime”: Es el tiempo en minutos que el rastreador espera para enviar una baliza si el rastreador no se ha movido fuera del “minDistTx” para forzar una transmisión de baliza si o si. El valor predeterminado es 15.

“enviarAltitud”: si es true ( verdadero ), el rastreador envía altitud+rumbo en los datos gps codificados, si es falso, el rastreador enviará velocidad+rumbo. Recuerde que APRS calcula la velocidad automáticamente incluso cuando envía altitud+rumbo. El valor predeterminado es true.

“bluetoohType”: 1 Si es 1 conectara Tracker como TNC con Android y Aprsdroid. Si es 0 servida para conectar por BLE a iPhone y usar la app APRS.fi.

“bluetoohActive”: Si es true ( verdadero ) permite que el rastreador se conecte a dispositivos como teléfonos y aplicaciones a través de BT o BLE.

“disableGPS”: Se desactiva el GPS de la placa, para que el Tracker use el GPS del teléfono a través de Bluetooth, o mismamente cuando se utiliza una placa LoRa32 que no tiene módulo gps conectado. El valor predeterminado es false ( falso ).

06

PTT Trigger

(used for external power amps to boost the power in Tx)

“active”: true enables the following configurations. Default is false.

“io_pin”: pin number at which the trigger is connected. Default is 4.

“preDelay”: number of milliseconds to wait before activating “io_pin” and transmiting. Default is 0.

“postDelay”: number of milliseconds to wait after transmiting to turn off “io_pin”. Default is 0.

“reverse”: some triggers need “io_pin” to start HIGH of LOW. Adjust to your needs.


Activador PTT

( se utiliza para activar amplificadores de potencia externos, para tener mayor potencia en emisión )

“activo”: false ( falso ), al ponerlo en true ( verdadero ) habilitaría las siguientes configuraciones. El valor predeterminado es falso.

“io_pin”: El número de pin al que está conectado el disparador. El valor predeterminado es 4.

“preDelay”: El número de milisegundos a esperar antes de activar “io_pin” y transmitir. El valor predeterminado es 0.

“postDelay”: El número de milisegundos que se deben esperar después de transmitir para desactivar “io_pin”. El valor predeterminado es 0.

“inversa”: algunos activadores necesitan “io_pin” para iniciar ALTO o BAJO; ajustar a tus necesidades concretas.

07

BME (Wx Data)

“active”: true enables the Wx data (Temperature, Humidity and Pressure) to be showed on the Oled Screen. Default is false.

"sendTelemetry": true enables Wx data to be transmitted to APRS-IS servers and appears as telemetry. Default is false. To Send Telemetry you need both "active":true and "sendTelemetry":true. Please be aware that this forces 10min between Wx data Tx (without affecting the usual GPS data beacon Tx) and also uses a momentary different Symbol for APRS-IS servers to process the beacon packet as Wx data.

"heightCorrection": 0 number of meter you want to change the reference of height for certain places when measuring altitude. Default is 0.


BME (datos Wx)

“activo”: false ( falso ) permite mostrar los datos meterorológicos de una placa externa conectada al Tracker (Temperatura, Humedad y Presión) en la pantalla Oled. El valor predeterminado es falso.

"sendTelemetry": true ( verdadero ) permite que los datos meteorológicos se transmitan a servidores APRS-IS y que aparezcan como telemetría. El valor predeterminado es falso. Para ello se necesita tanto "active":true como "sendTelemetry":true. Hay que tener en cuenta, que cada 10 minutos se fuerza la transmisión de datos meteorológicos, sin afectar la transmisión habitual de baliza de datos GPS), contando que también, esta utiliza un símbolo momentáneamente diferente para que los servidores APRS-IS entiendan lo que se le manda, y procesen el paquete de baliza como datos meteorológicos.

"heightCorrection": 0 Es el número en metros para cambiar la referencia de altura para ciertos lugares al medir la altitud. El valor predeterminado es 0.

08

Notification (Led + Buzzer)

(This is by adding YL44 buzzer Module and Leds to the io_pins of the Tracker to add visual and sound notifications)

"ledTx": true flashes the Tx-Led when a LoRa packet is being transmited. Default is false.

"ledTxPin": io_pin where the Tx-Led (+) pin should be connected. Default is io_13. Use 470 ohms resistor in series with the led when using difuminaste Led or 10K when using ultra bright led.

"ledMessage": true flashes Message-Led when a message is received. Default is false.

"ledMessagePin": io_pin where the Message-Led (+) pin should be connected. Default is io_ 2. Use 470 ohms resistor in series with the led when using difuminaste Led or 10K when using ultra bright led.

"buzzerActive": true is to activate sound notifications using YL44 module. Default is false.

"buzzerPinTone": io_pin where the I/O pin of the YL44 module should be connected. Default is io_33.

"buzzerPinVcc": io_pin where the VCC pin of the YL44 module should be connected. Default is io_25.

"bootUpBeep": true enables buzzer notification at BootUp of the tracker. Default is false.

"txBeep": true enables buzzer notification at LoRa packet Transmission. Default is false.

"messageRxBeep": true enables buzzer notification at LoRa Message received. Default is false.

"stationBeep": true enables buzzer notification when another LoRa Station GPS packet is received (Tracker or iGate/Digi). Default is false.

"lowBatteryBeep": true enables buzzer notification when Battery is lower than 20%. Default is false. When lower than 5% it will buzz twice.


Notificación (Led + Zumbador)

(Esto se consigue agregandole el módulo de zumbador YL44 y los LED a los io_pins del Tracker para agregar notificaciones visuales y sonoras)

"ledTx": false ( falso ) Hace parpadear el Tx-Led cuando se transmite un paquete LoRa. El valor predeterminado es falso.

"ledTxPin": Es el io_pin donde se debe conectar el pin Tx-Led (+). El valor predeterminado es io_13. Conectar con una resistencia de 470 ohmios en serie con el LED cuando utilice LED difuminado o una de 10K cuando utilice LED ultrabrillante.

"ledMessage": false ( falso ) Hace parpadear Message-Led cuando se recibe un mensaje. El valor predeterminado es falso.

"ledMessagePin": io_pin Es donde se debe conectar el pin Message-Led (+). El valor predeterminado es io_ 2. Conectar con una resistencia de 470 ohmios en serie con el LED cuando utilice LED difuminado o una de 10K cuando utilice LED ultrabrillante.

"buzzerActive": false ( falso ) Activa las notificaciones sonoras usando el módulo YL44. El valor predeterminado es falso.

"buzzerPinTone": Es el io_pin donde se debe conectar el pin I/O del módulo YL44. El valor predeterminado es io_33.

"buzzerPinVcc": Es el io_pin donde se debe conectar el pin VCC del módulo YL44. El valor predeterminado es io_25.

"bootUpBeep": false ( falso )Se habilita la notificación mediante timbre en el arranque del rastreador. El valor predeterminado es falso.

"txBeep": false ( falso ) Se habilita la notificación mediante zumbador en la transmisión de paquetes LoRa. El valor predeterminado es falso.

"messageRxBeep": false ( falso ) Se habilita la notificación mediante timbre cuando se recibe el mensaje LoRa. El valor predeterminado es falso.

"stationBeep": false ( falso ) Se habilita la notificación por timbre cuando se recibe otro paquete GPS de la estación LoRa (Tracker o iGate/Digi). El valor predeterminado es falso.

"lowBatteryBeep": false ( falso ) Se habilita la notificación mediante timbre cuando la batería es inferior al 20 %. El valor predeterminado es falso. Cuando sea inferior al 5%, sonará dos veces.