nmeasim.exe v1.4 24/12/2023
Developped with Python by jacques Duverger, available as a free program.
Tested on MS Windows 10/11
Best effort support, contact jacques.duverger1***antispam***@gmail.com
See me at www.jduverger.com
******* Explication en français voir plus bas en fin de fichier
-----------------------------------------------------------------------------------------------------
NMEASIM sends NMEA 0183 sentences to a navigation SW such as OpenCpn via a serial com port or a net/UDP channel. These NMEA sentences simulate data coming from a GPS(sentence $GPRMC...) and an AIS receiver(sentence !AIVDM...)
Notes:
-After downloading, save nmeasim.exe in any directory of your choice and launch it.
-All the parameters : name, mmsi, initial position (lat/long), COG, SOG for my boat as well as for AIS targets, and I/O configuration (com port, baud rate, IP adress...) are to be edited in the 'datasimul.json' file (you can use notepad for editing).
The 'datasimul.json' file is created in the directory from where you run nmeasim.exe by the app if it does not exist (from V1.0), it may already exist from a previous download (v0.95).
If you have been messing with this file, just remove it, it will be recreated with default values.
- The communication parameters (com port, IP adress...) can be changed via an option menu (from v1.1) and saved in the datasimul.json file
-In case of net/UDP communication (recommended), configure the navigation SW input with these parameters : 'UDP' ip adress:'localhost' port:'5000'.
-The ip adress can be that of a remote device on the wifi (set the Ip@ accordingly)
-In case of a serial communication, one can use a nullmodem app (such as comOcom, an open source prog.) to send sentences to the navigation SW.
The comOcom app creates a pair of virtual serial com port, and run a nullmodem xcom between these 2 ports.
i.e, with a COM3->COM4 pair, COM3 is the default used for the output of nmeasim and COM4 is configured as the input port for the navigation SW..
-In case of NMEA sentences picked from a file, use the 'simfile.txt' as the name of the file.
An example is available for download in the package.
-I have only coded dynamic AIS data in this version so you will see only the MMSIs. Showing vessel names would require the sending of static AIS data.
-The computations of the ships positions are approximative but OK for a 2D projection on the navigation SW, they are not reliable for latitude > 70deg(South or North).
- The nmeasim.exe file to be downloaded is relatively large (~8MB) so, be patient for a few second! (paticularly if you have a slow PC.
-Some info for the computer geeks : I developped it with the python langage and created the exe with pyinstaller which embeds the python interpretor and large libraries.
The actual size is after some optimization were made (exclude some libs such as TCL, SSL...)
----------------------------------------------------------------------------------------------------------
NMEASIM envoie des phrases NMEA 0183 a un logiciel de navigation tel que OpenCpn via un port série ou un canal UDP. Ces envois simulent des infos venant d'un GPS (£GPRMC..) et un récepteur AIS (!AIVDM).
Notes:
- Aprés téléchargement, sauver nmeasim.exe dans un dossier de votre choix and lancer le.
-tous les paramétres : nom, MMSI, postion (lat/long), COG, SOG, pour mon bateau et pour les cibles AIS ainsi que les parametres de communication (com port, baud rate, IP adress...) peuvent etre éditées avec notepad dans le fichier 'datasimul.json'.
Le fichier 'datasimul.json' est crée par le programme (depuis la v 1.0) dans le dossier ou est nmeasim.exe; il est crée si il n'existe pas déja ou si la version est trop ancienne. si vous faites des erreurs dans ce fichier, détruisez le, il sera recrée avec des valeurs par défaut.
- Les parametres de communication (I/O) tel que port série, IP adresse... peuvent etre changés via le menu "options".
- Dans le cas d'une simulation via net/UDP (recommandé), il faut configurer OpenCpn (ou autre) avec ces valeurs : 'UDP', IP adresse:'localhost' port:'5000'.
-Pour un PC ou une tablette distants sur un réseau wifi, il faut mettre l'adresse IP du destinataire.
-dans le cas d'une communication série, il faut utiliser un logiciel dit "nullmodem" tel que com0com.
Le programme cm0com (disponible en OpenSource) crée une pair de port com virtuels et les fait communiquer.
Par exemple, avec une pair com3->com4, Com3 est la valeur du port de sortie dans nmeasim and com4 est le port d'entrée dans OpenCpn.
-dans le cas d'une simulation depuis un fichier, il faut utiliser un fichier nommé 'simfile.txt' (il y en un a télécharger dans source forge)
- j'ai simplement codé les infos dynamiques pour l'AIS, aussi, vous ne verrez que le MMSi des bateaux cibles (pas les noms).
- Le calcul des positions des bateaux est approximatif mais trés suffisant pour une projection 2D dns un espace de quelques milles.
Ces calculs ne sont pas fiables pour des positions au dela de 70degre de latitude N ou S.
- Le programme a télécharger est relativement gros (~8MB) aussi, soyez patient pour quelques secondes surtout si vous avez un PC lent.
