This PowerShell script suite is designed to retrieve and display GPS data from Location COM devices on Windows systems. It utilizes:

• Windows Location API 🌍🧭 to fetch processed location data if available.
• COM Port Reading 🔌📟 to capture raw NMEA sentences from GPS devices connected via serial ports.

AI-Assisted Development 🤝💡 This script was created with significant assistance from AI technologies. As the creator is not a professional PowerShell or software developer, the code reflects a collaborative approach between human intent and AI-generated solution.

• Automatic COM Port Detection 📋🔎: Scans for and lists all available COM ports.
• Multiple Data Sources 🔄🌈:
  • Windows Location Service for high-level location data.
  • Direct COM port reading for raw GPS data (NMEA sentences).

• Windows OS with PowerShell 5.1 or higher 💻
• Administrative privileges might be necessary for accessing COM ports 🔐

No installation required; just run the script from PowerShell:

1. Download or copy the script 📥 to your local machine.
2. Open PowerShell 🖥️ as an Administrator if you encounter permission issues.

1. Open PowerShell and navigate to the directory containing the script:

   cd "path\to\your\script\directory"

2. Run the script:

   .\GPSDataReader.ps1

• Try to fetch location data via the Windows Location API. 🗺️
• Scan for all available COM ports and attempt to read NMEA data from each.🔍

• COM Ports: 🔌 The script assumes a baud rate of 9600. Adjust this in the script if your device uses a different rate.
• Data Output: 📊 Raw NMEA data might not be formatted; you'll see whatever comes through the port.
• Error Handling: 🚨 Basic error handling is implemented, but you might encounter issues if ports are in use or not configured correctly.

• Baud Rate: Change the $baudRate parameter in the Get-NmeaDataFromComPort function.
• Timeout: Adjust the ReadTimeout in the COM port reading function to optimize for your hardware.

No Data Detected 📡❌

• Verify GPS sensor power and connection 🔋🔌
• Check Device Manager for port conflicts 💻🚧
• Ensure no other applications are using the COM port 🖥️🔒

• Run PowerShell as Administrator 👑💻
• Verify user has necessary system permissions 🛡️👤
• Check Windows Location Service settings ⚙️🌐

• Increase ReadTimeout for slower devices 🕰️🐢
• Verify device-specific communication parameters 📊🔧

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/.

Pull requests are welcome! 🎉 For major changes, please open an issue first to discuss what you would like to change.

Happy GPS tracking! 🚀🌍🛰️