View source for Little navmap Add-on

{{Incomplete}}

{{Infobox Software
| title                  = Little Navmap Add-on
| logo                   = Fgaddonslogo202x89.png
| image                  = LMN menu2.png 
| alt                    = Little Navmap addon settings window
| developedby            = Sławek Mikuła (slawekmikula)
| initialrelease         = 
| latestrelease          = 
| writtenin              = Nasal, Canvas
| developmentstatus      = 100% 
| type                   = Addon
| platform               = Tested on FG version 2024.1.3
| license                = [[GNU General Public License]] v2
| website                = https://github.com/slawekmikula/flightgear-addon-littlenavmap
}}

The '''Little Navmap''' extension allows [[FlightGear]] to send real-time data to the [https://albar965.github.io/littlenavmap.html Little Navmap] software so that it can plot the aircraft's position on its map.

Little Navmap is a free and open-source flight planner, navigation tool, mobile map, airport search system, and airport information provider. It is compatible with Windows 7/8/10/11, macOS (High Sierra 10.13 or later), and Linux (64-bit only).

[[File:LNM interface.jpg|center|thumb|Little Navmap software interface]]

== How does it work? ==

FlightGear exports its data in real time via a UDP network connection to a gateway program called FGconnect. FGconnect then relays the data to the Little Navmap software, also via a UDP network connection.

Thus, the Navmap map displays the aircraft's movement in real time in three dimensions.

[[File:LMN Datas.png|center|thumb|Little Navmap displays the data sent by FlightGear.]]

== Installation ==

===Installing the add-on===
The installation of this add-on is done as follows:

# [https://github.com/slawekmikula/flightgear-addon-littlenavmap Download] the latest version of the Little Navmap add-on and extract it to a local folder.
# In the launcher, open the "'''Add-ons'''" tab. Click the "'''Add'''" button in the "'''''Add-on Folders'''''" section and select the folder extracted in step 1 (or add the following option in the command line: <code>--addon=/path/to/little-navmap-addon</code>).
# Click on '''"Fly!'''".

=== Installing Python ===

[https://www.python.org/downloads/ Download Python] and perform a default installation.

=== Installing FGconnect ===

The FGconnect module consists of Python scripts and provides the link between the FlightGear and Little Navmap software.

# Download the latest version of [https://github.com/Em-Ant/fgconnect FGconnect] .
# Unzip the downloaded archive into a local folder that does not require elevated user rights (e.g., /home/my_user or c:\users\my_profile).
# Open a terminal window and navigate to this directory. It contains, among other things, the fgconnect.py file (Python script).
# Create a Python virtual environment there:<code>python3 -m venv venv</code>
# Activate this environment:<code>.\venv\scripts\activate</code>
# Install the Python modules required by FGconnect: <code>pip3 install wxpython</code>and<code>pip3 install xmltodict</code>

== Preliminary checks ==

Before configuring anything, check that your operating system is not using the following network ports;

* 5400: This is the port used by FlightGear's HTTP server.
* 7755: This is the default port used by FlightGear to send its data to Little Navmap.
* 51968: This is the port used by Little Navmap to receive data from FlightGear.

To help you determine if these ports are in use, open a terminal (or console) window and run the following command:

* '''Linux / Mac'''  :<code>netstat -an | grep <n° port></code>
* '''Windows''' :<code>netstat -an | findstr <n° port></code>

If the ports are free, these orders should not return anything.

== Use ==

Launch FlightGear.

'''The new " Little Navmap''' " menu appears in the menu bar displayed at the top:

[[File:FGFS Barre de menus.png|center|frame|FlightGear Menu Bar]]

Selecting it opens the Little Navmap dialog box:

[[File:LMN menu1.png|center|frame|Little Navmap dialog box main menu]]

Click on button 1 to configure the extension:

[[File:LMN menu2.png|center|frame|Little Navmap settings menu]]

'''Verify that the " Enable export''' " checkbox is active.

If Little Navmap and FlightGear are running on the same machine, leave the default settings.

If Little Navmap and FlightGear are on different machines, replace " '''localhost''' " with the IP address of the machine where Little Navmap is running.

Confirm the configuration by clicking on '''Save''' then '''Close''' .

From the terminal window, once the virtual Python environment has launched, run:<code>.\venv\scripts\python fgconnect.py -s</code>{{Note|The developer of this FGconnect module indicates in his release note <ref>[https://gitlab.com/tgasiba/fgconnect/-/blob/master/readme.txt?ref_type=heads Note de version de FGconnect par son auteur Tiago Gasiba]</ref> that he has only tested it on MacOS and that it should work under Windows and Linux.

On Windows, I found in a forum <ref>[https://forum.flightgear.org/viewtopic.php?f=89&t=38535&p=417657&hilit=fgconnect.py#p417657 Post du forum relatif au script fgconnect.py]</ref> that I needed to modify the fgconnect.py file and add the following after the IMPORT line 15:

<syntaxhighlight lang="python">
sys.path.append(os.path.dirname(__file__))
</syntaxhighlight>

Of course, after making a backup of the original script.}}

Open the Little Navmap software. In the '''Tools''' menu , click on " '''''Connect to Flight Simulator...''''' " and then go to the " '''''Remote/Network''''' " tab. If FlightGear and Little Navmap are running on the same machine, leave the default settings and click the '''Connect''' button .

Alternatively, replace '''''localhost''''' with the IP address where FGconnect and FlightGear are running. Then click '''connect''' .

== Afterwards... ==

At this stage, the FlightGear and Little Navmap software communicate. FlightGear sends real-time data relating to the aircraft: its type, registration, magnetic heading, true heading, position, speed, altitude, etc.

Little Navmap takes this data and reflects the situation on its map.

This allows you to visualize the route followed in relation to the flight plan.

{{Appendix}}

[[Category:FlightGear addons]]
[[Category:Nasal software]]
[[Category:Canvas GUI]]

[[fr:Little navmap Add-on]]