NewLife.JT808 1.1.2026.1022-beta0133

NewLife.JT808 - JT/T 808 Vehicle Tracking Protocol

🌐 简体中文 | 繁體中文 | Español | Deutsch | 日本語 | Français | Português | Русский | 한국어 | العربية

A complete implementation of the JT/T 808 vehicle tracking protocol, covering the 2011/2013/2019 versions with 70+ standard message bodies, the SuBiao (Jiangsu) and YueBiao (Guangdong) active-safety extensions, JT/T 1078 audio/video messages, the JT/T 19056 driving-recorder protocol, and message-queue integration.

Source: https://github.com/NewLifeX/NewLife.JT808
NuGet: NewLife.JT808
Docs: Requirements / Architecture / Feature list / User guide / Localization

Key features

• Complete protocol: JT/T 808-2011/2013/2019 frame parsing with 0x7E delimiters, 0x7D escaping, XOR checksum and sub-packet reassembly
• Rich message bodies: 70+ standard message bodies (0x0001~0x8A00) covering both terminal uplink and platform downlink
• Three-version compatibility: automatic field adaptation through the Version field plus [JT2011]/[JT2019] attributes
• Dual serialization modes: attribute-driven reflection for simple bodies, IAccessor for complex bodies that need manual control
• TLV/KLV parsing: built-in Type-Length-Value and Kind-Length-Value codecs with strongly-typed dictionary conversion
• Networking layer: TCP sticky-packet codec JTCodec and JT808Client with automatic handler routing
• SuBiao extension: ADAS/DSM/TPMS/BSD active-safety alarms, peripheral status and attachment protocol
• YueBiao extension: Guangdong active-safety standard with dedicated alarm reporting (0x1FC4), USB pass-through, position extensions and vendor parameters
• JT/T 1078 basics: audio/video message body models and enums
• Driving recorder: JT/T 19056 uplink and downlink packet codec
• BCD encoding: custom serialization attributes for BCD strings and timestamps
• GBK encoding: built-in GBK string codec with automatic CodePagesEncodingProvider registration
• Web API management: unified command delivery, online session management, blacklist and token authentication
• Message queue abstraction: IMessageBus creates producers/consumers, session events and downlink handlers; RedisMessageBus is the built-in internal transport and RocketMQ/Kafka adapters in JT808.Server plug in through the JT808:Messaging config switch
• Cluster command delivery: ClusterState shares online sessions, node heartbeats and the blacklist through Redis, routes commands to the node that owns the terminal, and keeps ICommandBus as an extension point for custom transports
• Client hardening: automatic reconnection, configurable heartbeat and send/receive counters
• Multi-framework support: net45 / net461 / netstandard2.0 / netstandard2.1 / net8.0
• AOT friendly: NativeAOT smoke project covering codec, factory and serialization paths
• Localization: 11 runtime languages out of the box, English source text as fallback, AOT-safe tables
• RocketMQ integration: producer/consumer adapter in the JT808.Server project (not shipped in the NuGet package), supporting Alibaba Cloud, Huawei Cloud, Tencent Cloud and ACL authentication
• Kafka integration: producer/consumer adapter in the JT808.Server project (not shipped in the NuGet package), based on Confluent.Kafka with consumer groups and ACK support

Supported protocol versions

Message matrix

Quick start

Install the NuGet package

dotnet add package NewLife.JT808

Parse an uplink message

using NewLife.JT808.Protocols;
using NewLife.JT808.Models;

// Scan the assembly and register every message type
var factory = MessageFactory.Instance;
factory.Init();

// Raw bytes reported by the terminal
var raw = new Byte[] { 0x7E, 0x02, 0x00, /* ... */, 0x7E };

// Decode the JTMessage frame
var jtMessage = new JTMessage();
var stream = new MemoryStream(raw);
jtMessage.Read(stream, null);

// Materialize the strongly-typed body by message ID
var body = factory.Parse(jtMessage);
if (body is T0200 position)
{
    Console.WriteLine($"Latitude={position.Latitude / 1_000_000.0}");
    Console.WriteLine($"Longitude={position.Longitude / 1_000_000.0}");
    Console.WriteLine($"Speed={position.Speed} km/h");
}

Build a downlink message

// Build a platform general response
var t8001 = new T8001
{
    Sequence = jtMessage.Sequence,
    Kind = jtMessage.Kind,
    Result = ResultKinds.Success
};

// Serialize the body
var ms = new MemoryStream();
var writer = Helper.CreateWriter(ms, jtMessage);
writer.TryWrite(null, ref t8001);

// Wrap it in a JTMessage frame
var reply = new JTMessage
{
    Kind = MessageKinds.平台通用应答,
    Mobile = jtMessage.Mobile,
    Sequence = (UInt16)(jtMessage.Sequence + 1),
    Payload = new ArrayPacket(ms.ToArray()),
    Reply = false
};

// Emit the complete frame
var outMs = new MemoryStream();
reply.Write(outMs, null);
var frameBytes = outMs.ToArray();

Manually serialize a complex body (IAccessor)

[MessageKind(MessageKinds.位置信息汇报)]
public class T0200 : IAccessor
{
    public PositionAlarms Alarm { get; set; }
    public PositionStatus Status { get; set; }
    public Int32 Latitude { get; set; }
    public Int32 Longitude { get; set; }

    public Boolean Read(Stream stream, Object context)
    {
        var reader = context as Binary ?? Helper.CreateReader(stream);
        Alarm = (PositionAlarms)reader.ReadUInt32();
        Status = (PositionStatus)reader.ReadUInt32();
        Latitude = reader.ReadInt32();
        Longitude = reader.ReadInt32();
        // ... remaining fields
        return true;
    }

    public Boolean Write(Stream stream, Object context)
    {
        var writer = context as Binary ?? Helper.CreateWriter(stream);
        writer.Write((UInt32)Alarm);
        writer.Write((UInt32)Status);
        writer.Write(Latitude);
        writer.Write(Longitude);
        // ... remaining fields
        return true;
    }
}

Localization

The library ships 11 runtime languages (Simplified/Traditional Chinese, English, Spanish, German, Japanese, French, Portuguese, Russian, Korean and Arabic). Messages are keyed by the English source text and fall back to it when a translation is missing.

using System.Globalization;
using NewLife;

// Follow the process UI culture by default; pin it explicitly if needed
Localization.Culture = CultureInfo.GetCultureInfo("ja");

// ASP.NET Core hosts can resolve the request language from Accept-Language
using var scope = RequestCultureScope.Create(Request.Headers.AcceptLanguage);

NativeAOT

MessageFactory.Init() discovers message bodies by scanning the protocol assembly. NativeAOT or trimmed apps must keep that assembly:

<ItemGroup>
  <TrimmerRootAssembly Include="NewLife.JT808" />
</ItemGroup>

The AotSmoke project in this repository publishes with NativeAOT and runs 16 scenarios on Windows/Linux (x64 and arm64).

Ecosystem Map

NewLife is a layered ecosystem of independently versioned open-source projects. The map below is shared verbatim by every NewLife repository; each project links to its repository and its primary NuGet package.

Project	What it does	Downloads
Foundation
NewLife.Core	Logging, configuration, caching, networking, serialization, scheduling and APM tracing.
NewLife.XCode	Data middleware: single tables at the tens-of-billions scale, automatic sharding, read-write splitting, 10+ databases.
NewLife.Net	High-performance network library: 1.77M pps / 14.5 Gbps on a single machine (TCP 1KB, 2026-10), 4M long-lived TCP connections.
NewLife.Remoting	Protocol communication and RPC framework for client/server applications and IoT devices.
NewLife.Agent	Installs .NET applications as OS daemons: Windows services and Linux systemd.
NewLife.Templates	dotnet new project templates for console, web, API, service, data and IoT projects.
Data & Messaging
NewLife.Redis	Redis client with microsecond latency, millions of ops/s and built-in message queues.
NewLife.RocketMQ	Pure managed RocketMQ client for Apache RocketMQ and Alibaba Cloud Message Queue.
NewLife.MQTT	MQTT client and server, including Alibaba Cloud IoT connectivity.
NewLife.NovaDb	Hybrid database in C#: embedded or networked, relational, time-series, message queue and KV in one.
NewLife.MySql	MySql driver and helper layer built on the NewLife data stack.
Web, AI & Distributed
NewLife.Cube	Rapid admin-platform framework: permissions, SSO, OAuth server and CRUD scaffolding.
Stardust	Distributed service platform: node management, APM, configuration center, registry and release center.
AntJob	Distributed task and real-time data scheduling platform with sharding, retries and backfill.
NewLife.AI	Unified client for 46 LLM providers plus ChatAI, a ready-to-run web chat application.
Industrial & IoT
NewLife.IoT	IoT standard library defining protocol contracts and device abstractions.
NewLife.Modbus	Modbus TCP/RTU/ASCII implementation on top of NewLife.IoT.
NewLife.Siemens	Siemens PLC protocol on top of NewLife.IoT.
NewLife.Omron	Omron PLC protocol on top of NewLife.IoT.
NewLife.Melsec	Mitsubishi Melsec PLC protocol on top of NewLife.IoT.
NewLife.OPC	OPC client for industrial data access.	—
NewLife.BACnet	BACnet building-automation protocol stack.
ZeroIoT	Lightweight open-source IoT platform with gateway and device management.	—
Vehicle Telematics
NewLife.JT808	JT/T 808 vehicle positioning protocol: 70+ message bodies, 2011/2013/2019.
NewLife.JT809	JT/T 809 platform-to-platform protocol for transport authorities.
NewLife.JT1078	JT/T 1078 in-vehicle video: RTP parsing, FLV/fMP4 remuxing and live streaming.
Domain Components
NewLife.Office	One package for Excel, Word, PPT, PDF and 15+ document formats.
NewLife.Audio	Cross-platform audio: codecs, device I/O, DSP, containers and streaming.
NewLife.Video	Video codecs, container formats, frame processing and streaming.
NewLife.Map	Unified interface over Baidu, AMap, Tencent and Tianditu with geocoding and coordinate conversion.
NewLife.IP	IPv4 geolocation with an offline memory-mapped database and an online API fallback.
Tools & Products
CrazyCoder	Developer toolbox: network, serial port, crypto, regex, Modbus and MQTT.
GitCandy	Self-hosted Git source code management system.	—
LuckyClover	Installs the matching .NET runtime automatically when launched from an older host.	—

Badges show the primary package of each project; theme, extension and satellite packages are listed on their NuGet pages. The 30+ packages not listed here (FTP, LoRa, Office extensions, protocol drivers and more) are available under the NewLifeX organization and on newlifex.com.

Team

<img src="https://newlifex.com/logo.png" width="48" align="right" alt="NewLife" />

Founded in 2002, the NewLife team has spent more than two decades on the .NET and IoT ecosystem, maintains nearly 100 open-source projects (34 of them core to this map), and delivers integrated software and hardware solutions for power, logistics, healthcare, industrial control and internet industries. We live by the motto "learning has no seniority — mastery earns respect".

Open-source components have been downloaded 6.48M times from NuGet (ecosystem-wide, as of 2026-10).

Website: https://newlifex.com · Open source organization: https://github.com/NewLifeX

<details> <summary>WeChat Official Account: 智能大石头 (scan to follow)</summary>

</details>