V6 ereader/vario integration and work flow

  • V6 is based on eink device and internal vario/gps module (vario). There is no terminal/monitor settings configuration like it used to be in previous GoFly Projects. Vario has default configuration loaded, and only if SDcard is inserted with configuration file /setup/variosetup.ini, these default values are overwritten by configuration from variosetup.ini file.
  • Hardware: buttons, slots, usbs, usb charging //insert photo with description
  • GPSFIX indication LED is located just next to micro SDcard slot. If LED blinks, it means that GPS has discovered its position and UTC time is resolved.

Eink device drives internal vario/gps module by internal signal, some quick notes:

  • ereader runs tiny Linux operating system, and power on and off stage takes few seconds. Ereader powering OFF process might take up to 10 seconds, so when pilot exits flying application, it takes another few seconds to completely shut down internal Linux operating system. After that, vario module detects that ereader is OFF and also goes OFF.
  • if ereader is ON, vario module stays ON
  • if ereader goes OFF, vario module, after certain time and proper housekeeping (generating G record, closing IGC log file) also goes OFF
  • if flying application hangs, or there is any other issue with ereader, vario module stays ON, as long ereader’s internal electronics stays ON, vario module stays ON
  • pilot can execute hard shut down by holding ereader’s button by more then 10seconds. variosetup.ini contains configuration variable [poweroff_delay=10]. It means that after vario module noticed that ereader is off, it takes additional 10seconds to shut down itself. If ereader is turned ON again, and vario is still in countdown mode, vario continues to operate.

Vario button actions:

  • There are multiple actions mapped to vario button. It can be: clicked, double clicked, triple clicked, also long press has assigned function.
    • It does not power ON, or OFF the ereader device
    • If ereader is turned ON, and ground speed threshold is not detected yet from GPS, vario stays in quiet mode. With first single click, vario exits quiet mode and audio is enabled.
    • If ereader is powered ON, and vario is running, single button click will change LIFT AUDIO VOLUME (lift beeps). Audio volume goes from 3 down to 0 (no audio) with every single click. Every volume change is confined with short multiple beeps sequence.
    •  If vario is running, double button click will change WHISPERER AUDIO VOLUME (beeeeeps around “zero” lift, when your sink rate equals raising air around You ). Volume goes from 3 down to 0 (no audio) with every double click. Every volume change is confined with short multiple beeps sequence.
    • If vario is running and vario button is held for more than 1 second (long click)  // NOT IMPLEMENTED YET

When ereader is turned ON, one second later, vario/gps module boots up, and then

  • if airspeed related sensors are available, vario performs quick sensors calibration. This is required due to pressure sensor error offset. If eink device is powered on during flight, and there is already airflow impacting device, sensor calibration stage is skipped, and calibration value is taken from previous flight/power on cycle, when device was on the ground (not flying).
  • vario reads configuration data from /setup/variosetup.ini file located on sdcard
  • if sdcard or configuration file is not available, or there is read error, vario loads default settings located inside internal memory
  • vario starts endless loop, sampling sensors and sending out baro/airspeed/gps data over serial port, waiting for GPSFIX,
  • vario stays quiet in this stage until: GPSFIX is established, and ground speed detected or pilot clicks vario button
  • when GPXFIX is established, vario sets local time from gps time and creates time stamped file on sdcard with firmware version information. Reading this text file will give pilot information what current firmware version is loaded into vario.
    •  /setup/firmware_ver.txt
    • content: GoFlyProjectV6-DATE,TIME
  • vario creates time stamped IGC file on sdcard, for example 2017-03-02-XGF-PV6-13.igc with pilot information and starts recording pilot’s position, position timestamp, gps altitude,barometric altitude. There might be large difference in both altitudes, because barometric sensor is factory calibrated against seal level pressure. So if today there is different barometric pressure than yesterday, barometric altitude will be different.
  • IGC log file name example:
    • 2017-03-02-XGF-PV6-13.igc  = YEAR-MONTH-DAY-MANUFACTURERCODE-DEVICECODE-TODAY’sFLIGHTNUMBER.igc
  • vario keeps sampling sensors,sending complete baro/airspeed/gps data to eink device and beeps based on altitude change and current audio volume settings (vario lift audio can be adjusted by black round vario button)
  • when pilots turns OFF device, vario starts multiple seconds countdown (countdown is continued as long ereader is turned off)
  • Countdown timer can be set inside /setup/variosetup.ini file located on sdcard . After countdown is finished, vario finalizes IGC file, signs with G records and shuts down.
  • Vario also monitors heartbeat of eink device. If eink device hangs, after hard shutdown (holding power off button for 10secodns), vario will detect this state, and after ~5seconds will finalize IGC file, sign it and power off.
  • NOTE: If countdown is set to large number (~30sec), then pilot has 30 seconds to quickly restart eink device to keep IGC file recorded by vario consistent. IGC log file created by flying app will be broken into multiple pieces, but backup IGC file created by vario will be complete and valid.

XCSoar/LK8000/TopHat DEVICES page settings

/setup/variosetup.ini description and details

#change variables only on the right side of the "=" sign, use only alphanumeric letters
#you can change/add comments after "#" sign
[logger]
#your name
PILOTNAME=Pilot Pilot
#aircraft type (not required,value NOT KNOWN)
GLIDERTYPE=NKN
#aircraft id (not required)
GLIDERID=NKN
#competition class (not required)
COMPETITIONCLASS=NKN
#competition id (not required)
COMPETITIONID=NKN
#time zone UTC offset -12 <> 14,not used in IGC,but file is created based on local time
utcoffset=-6

[vario]
#lift threshold [cm/s] 0 -> 150, 1m/s=100cm/s
lift_threshold=5
#sink threshold [cm/s]-500 -> 0
sink_threshold=-150
#sink alarm, if sink is very large, alarm me with custom sound, [cm/s]-1000 -> sink_threshold
sink_alarm_threshold=-300
#0,1,2 lift beep period, logarithmic, linear or sqrt
cadence=1
#barometric/imu dumping setting, 1-30, more equals slower, less responsive vario accoustics
dumping_power=1

[audio-volume]
#turn ON vario audio after launch detection,it's based on GPS ground speed,set speed 0->10km/h
launch_detect_speed=5
#volume from 0 up to 3, where 0 = OFF, it is also adjusted by vario button
lift_audio_volume=3
#volume from 0 up to 3, where 0 = OFF
sink_audio_volume=1
#volume from 0 up to 3, where 0 = OFF
alarms_volume=1
#base lift audio frequency 300->1000
base_lift_freq=300
#audio whisperer around zero lift 0=OFF, 1=ON
lift_whisperer=0
#volume from 0 up to 3, where 0 = OFF
whisperer_audio_volume=1

[hardware]
#vario module power off timeout [seconds]
poweroff_delay=10
#hardware settings, 0 = OFF, 1 = ON
#enable igc hardware level logger to sdcard
igc_logger=1
#enable serial data for Kobo
en_serial_1=1
#enable second sarial output for additional data
en_serial_2=0
#enable usb serial output
en_usb=0
#enable IMU fuser
en_imu=0
#enable baro + imu fusion
en_imu_baro_fusion=0
#gps dynamic model 0=piedestrian, 1=car,2=slow aircraft 1G,3=fast aircraft 4G
gps_model=2
#only if sensors are available
enable_airpseed=1
#from 1 to 100%,
airspeed_correction=1

Cadence details