A Python-based NMEA simulator for generating and testing NMEA maritime messages. This tool allows you to simulate various NMEA messages for testing marine electronics and applications.
- Generate standard NMEA messages
- Configurable message parameters
- Real-time simulation of vessel data
- Support for multiple NMEA sentence types
- GUI interface for easy control
- Customizable simulation scenarios
This project uses Poetry for dependency management. To install:
-
Clone the repository:
git clone https://github.com/yourusername/nmea-simulator.git cd nmea-simulator -
Install Poetry if you haven't already:
curl -sSL https://install.python-poetry.org | python3 - -
Install dependencies:
poetry install
- Python 3.12 or higher
- Dependencies (automatically installed by Poetry):
- bitstring
- numpy
- tkinter
- PyYAML
-
Activate the Poetry virtual environment:
poetry shell
-
Run the simulator:
python main.py
The simulator can be configured using YAML files in the config directory. Example configuration:
nmea-simulator/
├── config/ # Configuration files
├── src/ # Source code
├── tests/ # Test files
├── main.py # Main entry point
Contributions are welcome! Please feel free to submit a Pull Request.
This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.
Sebastien Rosset
Copyright (C) 2024 Sebastien Rosset