🚛Vehicles, Vessels & UAVs
How to use Myncel as the maintenance system for a service-vehicle fleet, a heavy-truck or off-highway operation, a marine fleet of charter boats / workboats / yachts, or a commercial drone / UAV operation. Covers every shipped connector — OBD-II, SAE J1939, NMEA 2000, MAVLink — plus the telematics importers for Geotab, Samsara, Verizon Connect, Motive, and Fleetio, and the regulatory-aligned work-order templates.
Why Myncel works for fleets, vessels, and drones
Myncel's data model is domain-agnostic. A "Machine" is anything with a serial number, a maintenance schedule, and the occasional fault. The same engine that powers preventive and predictive maintenance for a CNC mill works identically for a delivery van, a Class 8 truck, a charter boat, or a survey drone. What changed in this release is that the protocol connectors and the regulatory-aligned workflows now ship out of the box — you no longer need to build a custom integration to bring vehicle, vessel, or UAV telemetry into Myncel.
Pick your domain below and follow the matching step-by-step. The Edge Gateway, Gateway Token model, work-order engine, PM schedules, alert rules, parts inventory, reports, and SuperAdmin views all behave identically across domains; only the connector configuration and the work-order templates change.
- Cars, light trucks, vans, and motorcycles — connect via OBD-II using a $25 ELM327 dongle. Reads RPM, coolant, fuel level, battery voltage, odometer, runtime, and fault codes (DTCs). See the OBD-II protocol page at /docs/edge-gateway/obd2.
- Heavy trucks, buses, ag tractors, dozers, excavators, generators — connect via SAE J1939 over CAN bus. Reads engine, fuel, DEF level, transmission temperature, oil pressure, total hours, total distance, and active DM1 DTCs. See /docs/edge-gateway/j1939.
- Yachts, workboats, charter fleets, sportfishing boats, ferries — connect via NMEA 2000 using an Actisense / Yacht Devices / Maretron gateway. Reads engine room, tank levels, GPS, depth, speed, and rudder angle. See /docs/edge-gateway/nmea2000.
- Commercial drones (PX4 / ArduPilot) — connect via MAVLink. Reads battery, GPS, altitude, ground speed, satellite count, and autopilot status. Read-only telemetry; Myncel never sends commands to the autopilot. See /docs/edge-gateway/mavlink.
- Geotab, Samsara, Verizon Connect, Motive (KeepTruckin), and Fleetio — if you already pay for fleet telematics, you do not need a second device. Forward your existing data to /api/telematics/import and Myncel becomes the CMMS layer on top. See /docs/telematics.
Step-by-step: bring a vehicle, vessel, or UAV into Myncel
The same five-step flow works for every domain. The only thing that changes is the connector type you generate and the regulatory checklist you copy into the WO.
- Create the asset in Admin Machines. Set the category to one of the new options: Car / Light Truck / Van, Heavy Truck / Bus / Construction, Vessel / Boat / Yacht, or Drone / UAV. Add the VIN / hull number / drone serial, license plate or registration, current odometer or engine hours, and the home location. Use a consistent naming pattern such as VEH-LIGHT-23 / VEH-HEAVY-18 / VESSEL-04 / DRONE-07 so reports and search behave well across mixed fleets.
- Generate a Gateway Token. Open the machine detail and click Create Gateway Token. Copy the token once — it is shown in plain text exactly once and stored as a SHA-256 hash thereafter. Paste it into the YAML config you will run on the gateway device, or into the webhook configuration of your existing telematics provider.
- Pick the connector type and generate YAML. Open /docs/edge-gateway and pick the matching connector — OBD-II, SAE J1939, NMEA 2000, or MAVLink. Each protocol page has a Gateway Config Generator that produces a ready-to-edit YAML config. Set the connector type, your endpoint (serial port, CAN interface, UDP host, or telemetry connection string), the gateway token, and download the YAML. If you are using an existing fleet telematics product, skip this step entirely and configure that provider to POST to /api/telematics/import instead.
- Run the gateway or wire the importer. For OBD-II, run the Myncel edge agent on a Raspberry Pi or industrial PC inside the vehicle, on a phone running the mobile app while parked, or in a cellular OBD-II tracker. For J1939 and NMEA 2000, run the agent on a Raspberry Pi or industrial PC connected to the bus via the appropriate hardware (CAN hat for J1939, NMEA gateway for marine). For MAVLink, the agent connects to the autopilot over USB, telemetry radio, Wi-Fi, or UDP. For telematics imports, configure your existing provider (Geotab Add-In, Samsara webhook, Motive Fleet API, etc.) to POST to https://www.myncel.com/api/telematics/import?provider=<name> with the gateway token in the Authorization header.
- Set schedules, thresholds, and templates. Drive PM schedules from the readings the connector emits. For light vehicles use odometer-based or BY_HOURS schedules for oil changes and inspections. For heavy trucks use total_engine_hours for OEM PM intervals (250 / 500 / 1000 hours). For vessels use engine_hours from PGN 127489. For drones use the airframe hour counter from the autopilot. Add Threshold alert rules on coolant_temp, oil_pressure, fuel_level, def_level, battery_voltage, dtc_present, and autopilot_alert to auto-open work orders. Copy the regulatory-aligned checklists from /docs/vehicle-templates into your work orders or PM schedules.
The connector reads dozens of standard signals out of the box (default presets for OBD-II PIDs, J1939 PGNs, NMEA 2000 PGNs, and MAVLink messages). You only need to list the signals you actually care about in the YAML — Myncel will not poll anything you did not ask for, which keeps bus utilization low and dongle batteries from draining the vehicle.
Domain A — service vehicle and light-truck fleets (cars, vans, sprinters)
Best for: car dealerships running courtesy / shuttle fleets, mobile service-tech fleets driving from job to job, courier and last-mile delivery operations, rental fleets, property-management fleets, university and corporate motor pools.
Recommended setup: one ELM327 OBD-II adapter per vehicle. For depots where vehicles return nightly, a $25 USB or $40 Wi-Fi ELM327 plus a small Raspberry Pi or industrial PC is the cheapest path. For always-on telemetry pick a $80–120 cellular OBD-II tracker that pushes directly to /api/telematics/import. Operators / drivers do daily light-vehicle walk-arounds via the mobile app using the shipped Light vehicle / van — daily check template (8 minutes, 12 items).
- Set odometer-based PMs by combining the imported odometer reading with a tiny scheduled job hitting the public REST API to convert distance into a custom counter, then trigger BY_HOURS schedules off that counter. (Native distance-frequency PMs are on the roadmap.)
- Add a Threshold rule on dtc_present >= 1 to auto-open a Diagnostic — DTC detected work order when the check-engine light first appears. The driver does not need to call dispatch; the WO is already on the service writer's board.
- For dealerships running used-car reconditioning, paste the Light vehicle / van — daily check template into the standard recon WO so every vehicle gets the same 12-item walk-around before delivery.
- For mobile service-tech fleets, combine the Light vehicle template with a tools-inventory checklist (in the WO) so the technician confirms both the vehicle and the kit before the first job of the day.
Domain B — heavy-duty truck and off-highway fleets
Best for: trucking and logistics companies running Class 7-8 fleets, public-works departments, school-bus operators, transit agencies with smaller fleets, ag operations with multi-tractor / combine fleets, construction companies with rolling stock, mining operations.
Recommended setup: a Raspberry Pi 4 with an MCP2515 CAN hat (~$80 total), or a PCAN-USB / Kvaser Leaf for higher-reliability fleets, or an off-the-shelf cellular J1939 telematics box for fleets that prefer no on-board host. Connect to the green 9-pin Deutsch diagnostic connector under the dash. Use the SAE J1939 — heavy truck protocol page (/docs/edge-gateway/j1939) for the bring-up sequence and CAN bring-up commands.
- Daily DVIR — paste the DVIR — Pre-trip inspection (15 items, FMCSA 49 CFR §396.11) and DVIR — Post-trip inspection (15 items) checklists from /docs/vehicle-templates into BY_DAYS schedules so each driver completes them at shift start and end on the mobile app, with photos attached for any defect.
- Hours-based PMs — engine hours from PGN 0xFEE5 feed BY_HOURS schedules. Set the OEM 250 / 500 / 1000-hour service intervals; Myncel auto-creates the WO when the threshold is crossed.
- Quarterly PM — paste the Heavy truck — quarterly preventive maintenance template (20 items, ~90 minutes) into a BY_DAYS or BY_HOURS schedule.
- DEF monitoring — Tier 4 diesels derate when DEF runs low. Add a Threshold rule on def_level < 15% so drivers get a heads-up before the truck goes into limp-home.
- DTC auto-WO — DM1 active fault codes set dtc_present = 1. Auto-create a Diagnostic — DTC detected WO with Priority = HIGH for any active code in the engine, after-treatment, or brake-system SPN ranges.
- For mixed fleets — pair J1939 on the heavy units with OBD-II on the light service vehicles. The same Myncel workspace handles both; only the connector type and the templates differ.
Domain C — commercial marine and recreational vessel fleets
Best for: charter operators (sportfishing, dive, day-sail, yacht charter), commercial workboats (tugs, push-boats, offshore service vessels), small ferries, marine research and survey vessels, larger private yachts that are operated semi-professionally, boatyards that maintain customer fleets.
Recommended setup: drop one Actisense W2K-1, Yacht Devices YDEN-02 / YDWG-02, or Maretron USB100 onto the boat's NMEA 2000 backbone. Run the Myncel edge agent (or canboat / Signal K + the agent) on a Raspberry Pi mounted in the helm console or engine room. Use the NMEA 2000 protocol page (/docs/edge-gateway/nmea2000) for hardware specifics and the canboat JSON UDP wiring.
- Pre-departure — paste the Vessel — pre-departure inspection template (24 items, USCG 46 CFR §185.502-style, ~30 minutes) into a BY_DAYS or per-charter schedule so the captain completes it on the mobile app before every trip with photos of fuel level, life jackets, and bilge.
- Return checklist — paste the Vessel — return / shutdown template (15 items, ~20 minutes) so the next crew finds the boat ready and any new issues are documented.
- Engine-hour PMs — engine hours from PGN 127489 (Engine Parameters Dynamic) feed BY_HOURS schedules. Volvo Penta D6 / D11, Cummins QSB / QSC / QSL marine, Yanmar 6LY3 service intervals are easy to model directly.
- Engine-room alerts — Threshold rules on coolant_temp > 95°C, engine_oil_press < 200 kPa at running RPM, alternator_volt < 12.8 V, or fuel_level < 20% auto-create HIGH-priority alerts that page the captain via PagerDuty / SMS.
- Geofence the marina — combine GPS lat / lon readings with a small scheduled job hitting the public REST API to detect when a charter boat exits the marina (charter started) and re-enters (return), and auto-create a fuel-and-walkdown WO on return.
- Multi-engine vessels — twin-engine boats expose two NMEA 2000 engine instances. Treat each engine as its own Machine with its own gateway / instance config; the vessel itself is a third Machine that holds the hull / electronics / safety equipment WOs.
Domain D — commercial drone / UAV operations
Best for: aerial-survey and mapping companies, agricultural-spray operators, public-safety and search-and-rescue UAV programs, infrastructure inspection (cell towers, power lines, wind turbines, solar farms, pipelines, bridges, roofs), film and broadcast production fleets.
Recommended setup: any standard MAVLink telemetry path — 915 / 433 MHz radio modem (RFD900x, SiK telemetry) at the ground station, USB tether for hangar diagnostics, Wi-Fi telemetry bridge for parked-mode log dumps, or a cellular companion computer onboard for live streaming. Use the MAVLink protocol page (/docs/edge-gateway/mavlink) for connection-string examples.
The connector is intentionally read-only telemetry; Myncel never sends commands to the autopilot. Manned aircraft / ARINC 429 is intentionally out of scope: that is FAA Part 43 / 145 / EASA Part-145 regulated software territory and is intentionally not a Myncel feature.
- Pre-flight — paste the UAV / drone — pre-flight checklist template (17 items, FAA 14 CFR Part 107-aligned, ~8 minutes) into a per-flight schedule. The pilot completes it on the mobile app at the launch site with photos of airframe and battery condition.
- Post-flight — paste the UAV / drone — post-flight checklist (11 items, ~5 minutes) so cycle counts and anomaly logs are captured before the airframe is put back in storage.
- Battery as its own Machine — track every LiPo / Li-ion battery as its own Machine (category Drone / UAV) and configure a BY_HOURS schedule that proxies for cycle count. LiPo packs typically retire at 200–300 cycles. Increment the cycle counter via the public REST API at the end of every flight.
- Autopilot fault → WO — STATUSTEXT severity ≤ 3 sets autopilot_alert = 1. Auto-create a Diagnostic WO so the issue is investigated before the next flight.
- Flight-hours-based PMs — total flight hours feed BY_HOURS schedules for prop replacement, ESC inspection, motor bearing checks, and gimbal service.
- Multi-airframe operators — track each airframe as its own Machine and link battery Machines to flight-event WOs via the WO's linked-machines field so a battery's history follows the pack rather than any single airframe.
Telematics importers — when you already pay for Geotab, Samsara, Verizon Connect, Motive, or Fleetio
If your fleet already runs a telematics product, do not pay twice. Forward the data you already have to /api/telematics/import and Myncel becomes the CMMS layer on top of telematics you already trust — odometer-based PMs, fuel-level alerts, fault-code WOs, all without a second device under the dash.
The endpoint authenticates with the same per-machine Gateway Token model as /api/iot/ingest. Each vehicle in Myncel gets a token; the remote provider's webhook or scheduled pusher includes the token as Authorization: Bearer <token>. Provider is detected automatically from payload shape, or pinned via the ?provider=geotab|samsara|verizon|motive|fleetio query parameter.
- Geotab — push from a MyAdmin Add-In or scheduled SDK pull. Diagnostic-keyed events ({ dateTime, diagnostic: { id, name }, value, unit }) are mapped one-to-one onto Myncel readings.
- Samsara — point a Samsara webhook at /api/telematics/import?provider=samsara. Vehicle-stats snapshots ({ gpsOdometerMeters, fuelPercents, engineRpm, engineCoolantTemperatureMilliC, ecuSpeedKilometersPerHour, defLevelPercent, ... }) are flattened into individual readings with proper unit conversion (meters → km, milli-Celsius → C, milli-volts → V).
- Verizon Connect / Reveal — per-signal records ({ time, deviceId, signal: { name, value, unit } }) accepted as one POST per signal or batched as an array.
- Motive (KeepTruckin) — push from the Motive Fleet API. Vehicle current_state shape ({ current_state: { gps_odometer_km, fuel_percent, speed_kph, engine_hours, def_percent, ... } }) is normalized into separate readings.
- Fleetio — push every meter entry as it is created in Fleetio ({ meter_entry: { meter_type, value, units, recorded_at } }).
- Generic — same shape as /api/iot/ingest ({ type, value, unit, recordedAt }). Use this if your telematics provider is not in the list yet, or if you are exporting from a custom in-house system.
See /docs/telematics for full payload examples for every provider, the field-mapping reference table, and the curl recipes you can paste into your provider's scheduled-job UI.