Initial FleetGuide implementation

4 files changed, 155 insertions, 0 deletions

diff --git a/setup/default.xml b/setup/default.xml
index fbe63c873..b89e3ebef 100644
--- a/setup/default.xml
+++ b/setup/default.xml
@@ -296,5 +296,6 @@
     <entry key='ramac.port'>5251</entry>
     <entry key='positrex.port'>5252</entry>
     <entry key='dragino.port'>5253</entry>
+    <entry key='fleetguide.port'>5254</entry>
 
 </properties>
diff --git a/src/main/java/org/traccar/protocol/FleetGuideProtocol.java b/src/main/java/org/traccar/protocol/FleetGuideProtocol.java
new file mode 100644
index 000000000..46611c25c
--- /dev/null
+++ b/src/main/java/org/traccar/protocol/FleetGuideProtocol.java
@@ -0,0 +1,36 @@
+/*
+ * Copyright 2024 Anton Tananaev (anton@traccar.org)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.traccar.protocol;
+
+import jakarta.inject.Inject;
+import org.traccar.BaseProtocol;
+import org.traccar.PipelineBuilder;
+import org.traccar.TrackerServer;
+import org.traccar.config.Config;
+
+public class FleetGuideProtocol extends BaseProtocol {
+
+    @Inject
+    public FleetGuideProtocol(Config config) {
+        addServer(new TrackerServer(config, getName(), true) {
+            @Override
+            protected void addProtocolHandlers(PipelineBuilder pipeline, Config config) {
+                pipeline.addLast(new FleetGuideProtocolDecoder(FleetGuideProtocol.this));
+            }
+        });
+    }
+
+}
diff --git a/src/main/java/org/traccar/protocol/FleetGuideProtocolDecoder.java b/src/main/java/org/traccar/protocol/FleetGuideProtocolDecoder.java
new file mode 100644
index 000000000..d63187921
--- /dev/null
+++ b/src/main/java/org/traccar/protocol/FleetGuideProtocolDecoder.java
@@ -0,0 +1,98 @@
+/*
+ * Copyright 2024 Anton Tananaev (anton@traccar.org)
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.traccar.protocol;
+
+import io.netty.buffer.ByteBuf;
+import io.netty.buffer.Unpooled;
+import io.netty.channel.Channel;
+import org.traccar.BaseProtocolDecoder;
+import org.traccar.Protocol;
+import org.traccar.helper.BitUtil;
+import org.traccar.session.DeviceSession;
+
+import java.lang.reflect.Method;
+import java.net.SocketAddress;
+
+public class FleetGuideProtocolDecoder extends BaseProtocolDecoder {
+
+    public FleetGuideProtocolDecoder(Protocol protocol) {
+        super(protocol);
+    }
+
+    public static final int MSG_DATA = 0x10;
+    public static final int MSG_HEARTBEAT = 0x1A;
+    public static final int MSG_RESPONSE = 0x1C;
+
+    @Override
+    protected Object decode(
+            Channel channel, SocketAddress remoteAddress, Object msg) throws Exception {
+
+        ByteBuf buf = (ByteBuf) msg;
+
+        buf.readUnsignedByte(); // signature
+        int options = buf.readUnsignedShort();
+        int length = BitUtil.to(options, 11);
+
+        DeviceSession deviceSession;
+        if (BitUtil.check(options, 11)) {
+            deviceSession = getDeviceSession(channel, remoteAddress, String.valueOf(buf.readUnsignedInt()));
+        } else {
+            deviceSession = getDeviceSession(channel, remoteAddress);
+        }
+        if (deviceSession == null) {
+            return null;
+        }
+
+        int type;
+        if (BitUtil.check(options, 12)) {
+            type = BitUtil.to(buf.readUnsignedByte(), 4);
+        } else {
+            type = 0;
+        }
+
+        if (BitUtil.check(options, 13)) {
+            buf.readUnsignedShort(); // acknowledgement
+        }
+
+        ByteBuf data;
+        if (BitUtil.check(options, 14)) {
+            data = decompress(buf.readSlice(length));
+        } else {
+            data = buf.readRetainedSlice(length);
+        }
+
+        data.release();
+
+        return null;
+    }
+
+    private ByteBuf decompress(ByteBuf input) throws ReflectiveOperationException {
+
+        Class<?> clazz = Class.forName("io.netty.handler.codec.compression.FastLz");
+        Method method = clazz.getDeclaredMethod(
+                "decompress", ByteBuf.class, int.class, int.class, ByteBuf.class, int.class, int.class);
+
+        ByteBuf output = Unpooled.buffer();
+        int result = (Integer) method.invoke(
+                null, input, input.readerIndex(), input.readableBytes(), output, 0, Integer.MAX_VALUE);
+        if (result <= 0) {
+            throw new IllegalArgumentException("FastLz decompression failed");
+        }
+
+        return output;
+    }
+
+}
diff --git a/src/test/java/org/traccar/protocol/FleetGuideProtocolDecoderTest.java b/src/test/java/org/traccar/protocol/FleetGuideProtocolDecoderTest.java
new file mode 100644
index 000000000..010f0d649
--- /dev/null
+++ b/src/test/java/org/traccar/protocol/FleetGuideProtocolDecoderTest.java
@@ -0,0 +1,20 @@
+package org.traccar.protocol;
+
+import org.junit.jupiter.api.Disabled;
+import org.junit.jupiter.api.Test;
+import org.traccar.ProtocolTest;
+
+@Disabled
+public class FleetGuideProtocolDecoderTest extends ProtocolTest {
+
+    @Test
+    public void testDecode() throws Exception {
+
+        var decoder = inject(new FleetGuideProtocolDecoder(null));
+
+        verifyPosition(decoder, binary(
+                "539e598f8a020003020700e378351ac39f040c04ffa92e806a28a13b1f00b638030c000067052c06ffffffff033006808001180003200100000700e478351ac40204303dab2e80cb27a13b1c00ac40021b30e778351ac502043082a72e8054020530bf30021b30e978351ac69f0d0c0433a72e80c123a13b2000df3807002579351ac79f06020a170000df28021b476179351ac8020f30021c81279d79351ac9020f30021c8207d979351aca020f30021c8157157a351acb022b8140517a351acc022b608d7a351acd022b60c97a351ace022b30057b351acf022b30417b351ad0022b307d7b351ad1020f3048021b30b97b351ad2020f3070030c004066021630f57b351ad30213841080021730317c351ad4021330c00217306d7c351ad5020f3050021b30a97c351ad602138170021830e57c351ad7020f3058021b30217d351ad8021385500218305d7d351ad9022b8110997d351ada022b8170d57d351adb022b30117e351adc020f3068030ce184680216304d7e351add020f3060030ce34469021630897e351ade021260e4021830c57e351adf021230e5021830017f351ae002293022f2"));
+
+    }
+
+}