Skip to content

Commit

Permalink
Merge pull request makerplane#245 from e100/vfr_course
Browse files Browse the repository at this point in the history
Added option to enable/disable the buttons
  • Loading branch information
e100 authored Aug 17, 2024
2 parents aa60610 + f80d407 commit 83df1d4
Show file tree
Hide file tree
Showing 15 changed files with 410 additions and 163 deletions.
80 changes: 34 additions & 46 deletions INSTALLING.md
Original file line number Diff line number Diff line change
Expand Up @@ -84,16 +84,20 @@ sudo snap connect fixgateway:serial-port snapd:serial-name-here

### Managing auto start
By default fixgateway and pyefis will auto start on reboot.<br>
To disable this edit the config files and change `auto start` to `false`
To disable this edit the config files and change `AUTOSTART` to `false`
```
enabled:
AUTO_START: true
```

pyefis config:
```
~/makerplane/pyefis/config/default.yaml
~/makerplane/pyefis/config/preferences.yaml.custom
```

fixgateway config:
```
~/makerplane/fixgw/config/default.yaml
~/makerplane/fixgw/config/preferences.yaml.custom
```

Below are commands to start/stop pyefis and fixgateway
Expand All @@ -120,66 +124,50 @@ sudo snap start fixgateway.daemon
### Customizing or using different configuration file
Currently it is not possible to change the configuration filename with the auto start feature.<br>
You can edit the default, your changes will not be overwritten when the system is updated.<br>
In my case I have a `left.yaml` and `right.yaml` file for the left and right screens. I simply created a `default.yaml` symlink to the correct file on each side.
In my case I have a `preferences.yaml.custom.left` and `preferences.yaml.custom.right` file for the left and right screens. I simply created a `preferences.yaml.custom` symlink to the correct file on each side.

On the left side I did:
```
cd ~/makerplane/pyefis/config
rm default.yaml
ln -s left.yaml default.yaml
```

Now when it auto starts it uses the `left.yaml` config



### Get data needed for Virtual VFR
The virtual VFR feature uses FAA data to display runways and glide slop indicators in the atitude indicator.

#### Create directory for the CIFP data
```
mkdir ~/makerplane/pyefis/CIFP/
cd ~/makerplane/pyefis/CIFP/
rm preferences.yaml.custom
ln -s preferences.yaml.custom.left preferences.yaml.custom
```

#### Download the CIFP Data
Visit https://www.faa.gov/air_traffic/flight_info/aeronav/digital_products/cifp/download/ and copy the link to the latest data.
Now when it auto starts it uses the `preferences.yaml.custom.left` config

Download the latest data using the link you copied and unzip it
```
wget https://aeronav.faa.gov/Upload_313-d/cifp/CIFP_231228.zip
unzip CIFP_231228.zip
```

Create the index:
```
pyefis.makecifpindex FAACIFP18
```
If you are starting new or only have a single display just edit the `preferences.yaml.custom` file to make customizations.
<br>
For more information on how to customize the display see [Screen Builder Documentation](https://github.com/makerplane/pyEfis/blob/master/docs/screenbuilder.md)

When updating in the future just delete the CIFP directory and start over at the beginning of this section

### Data needed for Virtual VFR
The virtual VFR feature uses FAA CIFP data to display runways and glide slop indicators in the atitude indicator.<br>
When using the snap installation method, outlined above, this data is automatically downloaded and periodically auto updated.

### Important information:
NOTE: Upon starting a folder named makerplane will be created in your home folder and default configs copied into that folder.<br>
It will not overwrite any file that currently exists so your customizations are safe. If you would like to get updated default configs you could delete the old configs and then start pyefis and fixgateway.<br>

Directories you need to know:
pyefis configs: ~/makerplane/pyefis/config
fixgateway configs: ~/makerplane/fixgw/config
flight data recorder logs: ~/makerplane/pyefis/fdr

* pyefis configs: ~/makerplane/pyefis/config
* fixgateway configs: ~/makerplane/fixgw/config
* flight data recorder logs: ~/makerplane/pyefis/fdr

Commands:
* stop fixgateway: `sudo snap stop fixgateway.daemon`
* start fixgateway: `sudo snap start fixgateway.daemon`
* stop pyefis: `sudo snap stop pyefis.daemon`
* start pyefis: `sudo snap start pyefis.daemon`
* While stopped you can run them manually to see real time debug output:
* pyefis: `pyefis.server --config-file=$HOME/makerplane/pyefis/config/default.yaml --debug`
* fixgateway: `fixgateway.server --config-file=$HOME/makerplane/fixgw/config/default.yaml --debug`
* fixgateway client: `fixgateway.client`
* CIFP index builder: `pyefis.makecifpindex`

Installing pyefis and fixgateway updates:

* stop fixgateway: `sudo snap stop fixgateway.daemon`
* start fixgateway: `sudo snap start fixgateway.daemon`
* stop pyefis: `sudo snap stop pyefis.daemon`
* start pyefis: `sudo snap start pyefis.daemon`
* While stopped you can run them manually to see real time debug output:
* pyefis: `pyefis.server --config-file=$HOME/makerplane/pyefis/config/default.yaml --debug`
* fixgateway: `fixgateway.server --config-file=$HOME/makerplane/fixgw/config/default.yaml --debug`
* fixgateway client: `fixgateway.client`
* running fixgateway in FDR playback mode: `sudo snap start fixgateway.daemon; fixgateway.server --playback-start-time 2024-07-13-18:51:10`
* CIFP index builder: `pyefis.makecifpindex`

Installing pyefis, FAA CIFP data, and fixgateway updates:
```
snap refresh
```
Expand Down
1 change: 1 addition & 0 deletions src/pyefis/config/preferences.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -99,6 +99,7 @@ enabled:
CYLINDER_3: true
CYLINDER_4: true
DIMMER: false
BUTTONS: true # enabled/disable navigation buttons

# Here you can define what include files are used to render some
# portion of the screen so you can customize as needed easily
Expand Down
1 change: 1 addition & 0 deletions src/pyefis/config/preferences.yaml.custom
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@ style:
segmented: true

enabled:
AUTO_START: true
VSI_BALL: false
VSI_TAPE: true

Expand Down
12 changes: 12 additions & 0 deletions src/pyefis/config/screens/android-left-buttons.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -48,9 +48,21 @@ ANDROID:
args:
- show-full-ui
- type: include,includes/arcs/vertical/four_high_two_states_preferences_ARC1-8.yaml
disabled: BUTTONS
row: 0
column: 14.5
span:
rows: 70
columns: 30
- type: include,includes/arcs/vertical/four_high_two_states_preferences_ARC1-8.yaml
disabled: not BUTTONS
row: 0
column: 0
span:
rows: 70
columns: 44.5
- type: include,BUTTON_GROUP1
disabled: BUTTONS
row: 0
column: 0
- type: include,includes/bars/vertical/six_wide_preferences_BAR1-6.yaml
Expand Down
12 changes: 12 additions & 0 deletions src/pyefis/config/screens/android.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -48,9 +48,21 @@ ANDROID:
args:
- show-full-ui
- type: include,includes/arcs/vertical/four_high_two_states_preferences_ARC1-8.yaml
disabled: BUTTONS
row: 0
column: 155
span:
columns: 30
rows: 70
- type: include,includes/arcs/vertical/four_high_two_states_preferences_ARC1-8.yaml
disabled: not BUTTONS
row: 0
column: 155
span:
columns: 45
rows: 70
- type: include,BUTTON_GROUP1
disabled: BUTTONS
row: 0
column: 185.5
- type: include,includes/bars/vertical/six_wide_preferences_BAR1-6.yaml
Expand Down
Loading

0 comments on commit 83df1d4

Please sign in to comment.