# GpsInfo

**Repository Path**: donlaki/GpsInfo

## Basic Information

- **Project Name**: GpsInfo
- **Description**: 解析串口的Gps信息
- **Primary Language**: C#
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2022-07-28
- **Last Updated**: 2022-07-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# GpsInfo.dll 使用说明 C# VS2010
2017.11.27
V00.01


---

<span id="index"></span>
## 目录
* [1. 命名空间](#1)
* [2. 接口定义](#2)
* [3. 使用例子](#3)
* [4. 数据结构定义](#4)
* [5. 参考](#5)

<h3 id="1"></h3>
## 1. 命名空间 
GpsInfoNS

<h3 id="2"></h3>
## 2. 接口定义
- public GpsInfo();								构造函数
- public void SaveData(byte [] data);			串口接收中断的回调函数，把串口接收到的数据传给 GpsInfo
- public Gpgga GetGpgga();						获得GPGGA 数据结构
- public Gprmc GetGprmc();						获得GPRMC 数据结构
- public void Quit();							退出解析Gps数据

<h3 id="3"></h3>
## 3.使用例子
参考 GpsInfoView

    gpsInfoObj = new GpsInfo();

    void serialPort_DataReceived(object sender, SerialDataReceivedEventArgs e)
    {
        byte[] receivedData = new byte[serialPort.BytesToRead];
        serialPort.Read(receivedData, 0, receivedData.Length);
        gpsInfoObj.SaveData(receivedData);
    }


    Gpgga gpgga = gpsInfoObj.GetGpgga();
        lblUtcTime.Text = "UTC Time:" + gpgga._utcHour + ":" + gpgga._utcMinute + ":"  + gpgga._utcSecond;

    Gprmc gprmc = gpsInfoObj.GetGprmc();
        lblDate.Text = "Date:" + gprmc._year + gprmc._month + gprmc._day;

**注意：用户需要判断返回的结构体中的域是否为空串。如没信号时，经纬度是空串。**

    gpsInfoObj.Quit();

<h3 id="4"></h3>
## 4. 数据结构定义
    public struct Gpgga
    {
        public string _utcHour;
        public string _utcMinute;
        public string _utcSecond;
        public string _utcMS;
        public string _latitude;
        public string _latitudeDirection;
        public string _longitude;
        public string _longitudeDirection;
        public string _gpsQualityIndicator;
        public string _usedSatellites;
        public string _hdop;//水平衰减因子
        public string _seaLevel;
        public string _seaLevelUnit;
        public string _geoidalSeparation;
        public string _geoidalSeparationUnit;
        public string _ageOfDiffData;
        public string _refStationID;
    }

    public struct Gprmc
    {
        public string _utcHour;
        public string _utcMinute;
        public string _utcSecond;
        public string _utcMS;
        public string _status;
        public string _latitude;
        public string _latitudeDirection;
        public string _longitude;
        public string _longitudeDirection;
        public string _speed;
        public string _cog;//course of ground
        public string _day;
        public string _month;
        public string _year;
        public string _mv;//magnetic variation
        public string _mvd;//magnetic variation degree
        public string _mode;//nmea 2.3 above
        public string _navStatus;//nmea 4.1 above
    }

<h3 id="5"></h3>
## 5.参考 
CASIC多模卫星导航接收机协议规范.pdf

[回目录](#index)