{"id":19912,"date":"2026-08-11T18:35:07","date_gmt":"2026-08-11T10:35:07","guid":{"rendered":"https:\/\/www.lansitec.com\/?post_type=docs&p=19912"},"modified":"2026-08-11T18:39:36","modified_gmt":"2026-08-11T10:39:36","password":"","slug":"decoder-ntn-livestock-solar-eartag-tracker","status":"publish","type":"docs","link":"https:\/\/www.lansitec.com\/ko\/docs\/decoders\/\ub514\ucf54\ub354-ntn-\uac00\ucd95\uc6a9-\ud0dc\uc591\uad11-\uadc0\ud45c-\ucd94\uc801\uae30\/","title":{"rendered":"NTN \ub514\ucf54\ub354 \u2013 \uac00\ucd95\uc6a9 \ud0dc\uc591\uad11 \uadc0\ud45c \ucd94\uc801\uae30"},"content":{"rendered":"
decode-livestock-tag-tracker-ntn-udp<\/a>\ub2e4\uc6b4\ub85c\ub4dc<\/a><\/div>\n\n\n\n

\uc5c5\ub9c1\ud06c \ubc0f \ub2e4\uc6b4\ub9c1\ud06c \uba54\uc2dc\uc9c0\ub97c \uc790\ub3d9\uc73c\ub85c \uc0dd\uc131\ud558\ub294 \ubc29\ubc95\uc5d0 \ub300\ud574\uc11c\ub294 \uc774 \ud398\uc774\uc9c0\ub97c \ucc38\uc870\ud558\uc2ed\uc2dc\uc624.
Lansitec \ub514\ucf54\ub354 \u2013 \uc2e4\uc2dc\uac04 \uacc4\uc0b0\uae30 \u2013 Lansitec<\/a>
<\/p>\n\n\n\n

\uc544\ub798\ub294 \uc804\uccb4 \ub514\ucf54\ub354 \ucf54\ub4dc\uc785\ub2c8\ub2e4.<\/p>\n\n\n\n

\/\/ Lansitec NTN Livestock Tracking Tag<\/a> - NTN<\/a> UDP Status Report decoder.\n\/\/\n\/\/ The UDP server must pass the raw 21-byte datagram payload, not a printable\n\/\/ hexadecimal string:\n\/\/   decodeNtn({ bytes: [...] })\n\/\/   decodeNtn(Buffer.from(...))\n\n\"use strict\";\n\nfunction decodeNtn(input) {\n  var normalized = normalizeBytes(input);\n  if (normalized.error) {\n    return errorResult(normalized.error);\n  }\n\n  var bytes = normalized.bytes;\n  if (bytes.length !== 21) {\n    return errorResult(\"NTN<\/a> Status Report must be exactly 21 bytes; received \" + bytes.length + \".\");\n  }\n\n  if (bytes[0] !== 0x01) {\n    return errorResult(\"Unsupported NTN<\/a> payload version: \" + toHex(bytes[0], 2) + \".\");\n  }\n\n  var batteryRaw = bytes[5];\n  if (batteryRaw > 100 && batteryRaw !== 0xff) {\n    return errorResult(\"NTN<\/a> battery value must be between 0 and 100, or 0xFF when unavailable.\");\n  }\n\n  var alarmRaw = bytes[8];\n  if ((alarmRaw & 0xf0) !== 0) {\n    return errorResult(\"NTN<\/a> Alarm Flags RFU bits 7 to 4 must be zero.\");\n  }\n\n  var longitude = readFloat32BE(bytes, 9);\n  var latitude = readFloat32BE(bytes, 13);\n  var positionAvailable = !(longitude === 0 && latitude === 0);\n\n  if (!isFiniteNumber(longitude) || longitude < -180 || longitude > 180) {\n    return errorResult(\"NTN<\/a> longitude must be a finite value in the range -180 to 180 degrees.\");\n  }\n  if (!isFiniteNumber(latitude) || latitude < -90 || latitude > 90) {\n    return errorResult(\"NTN<\/a> latitude must be a finite value in the range -90 to 90 degrees.\");\n  }\n\n  var timestamp = readUInt32BE(bytes, 17);\n  var activeAlarms = [];\n  if ((alarmRaw & 0x01) !== 0) activeAlarms.push(\"lowBattery\");\n  if ((alarmRaw & 0x02) !== 0) activeAlarms.push(\"fenceBreach\");\n  if ((alarmRaw & 0x04) !== 0) activeAlarms.push(\"abnormalInactivity\");\n  if ((alarmRaw & 0x08) !== 0) activeAlarms.push(\"highIntensityMotion\");\n\n  var data = {\n    transport: \"NTN_UDP\",\n    messageName: \"statusReport\",\n    payloadVersion: bytes[0],\n    deviceId: toHex(readUInt32BE(bytes, 1), 8),\n    deviceIdNumeric: readUInt32BE(bytes, 1),\n    batteryAvailable: batteryRaw !== 0xff,\n    batteryPercent: batteryRaw === 0xff ? null : batteryRaw,\n    motionDurationSeconds: readUInt16BE(bytes, 6),\n    alarmFlags: {\n      raw: alarmRaw,\n      lowBattery: (alarmRaw & 0x01) !== 0,\n      fenceBreach: (alarmRaw & 0x02) !== 0,\n      abnormalInactivity: (alarmRaw & 0x04) !== 0,\n      highIntensityMotion: (alarmRaw & 0x08) !== 0,\n      active: activeAlarms,\n    },\n    positionAvailable: positionAvailable,\n    longitude: positionAvailable ? longitude : null,\n    latitude: positionAvailable ? latitude : null,\n    timestampAvailable: timestamp !== 0,\n    timestamp: timestamp === 0 ? null : timestamp,\n    timestampIso: timestamp === 0 ? null : unixTimeToIso(timestamp),\n    payloadHex: bytesToHex(bytes),\n  };\n\n  return { data: data };\n}\n\nfunction normalizeBytes(input) {\n  var source = input && typeof input === \"object\" && input.bytes !== undefined ? input.bytes : input;\n  if (!source || typeof source === \"string\" || typeof source.length !== \"number\") {\n    return { error: \"Input must be a raw byte array, Uint8Array, or Buffer. Plain-text HEX is not accepted.\" };\n  }\n\n  var bytes = [];\n  for (var i = 0; i < source.length; i++) {\n    var value = source[i];\n    if (typeof value !== \"number\" || !isFinite(value) || Math.floor(value) !== value || value < 0 || value > 255) {\n      return { error: \"Payload byte at index \" + i + \" is not an unsigned 8-bit integer.\" };\n    }\n    bytes.push(value);\n  }\n  return { bytes: bytes };\n}\n\nfunction readUInt16BE(bytes, offset) {\n  return bytes[offset] * 0x100 + bytes[offset + 1];\n}\n\nfunction readUInt32BE(bytes, offset) {\n  return (\n    bytes[offset] * 0x1000000 +\n    bytes[offset + 1] * 0x10000 +\n    bytes[offset + 2] * 0x100 +\n    bytes[offset + 3]\n  );\n}\n\nfunction readFloat32BE(bytes, offset) {\n  var bits = readUInt32BE(bytes, offset);\n  var sign = bits >= 0x80000000 ? -1 : 1;\n  var exponent = Math.floor(bits \/ 0x800000) & 0xff;\n  var fraction = bits & 0x7fffff;\n\n  if (exponent === 0xff) {\n    return fraction === 0 ? sign * Infinity : NaN;\n  }\n  if (exponent === 0) {\n    return sign * fraction * Math.pow(2, -149);\n  }\n  return sign * (1 + fraction \/ 0x800000) * Math.pow(2, exponent - 127);\n}\n\nfunction unixTimeToIso(seconds) {\n  return new Date(seconds * 1000).toISOString();\n}\n\nfunction bytesToHex(bytes) {\n  var parts = [];\n  for (var i = 0; i < bytes.length; i++) {\n    parts.push(toHex(bytes[i], 2).slice(2));\n  }\n  return parts.join(\"\");\n}\n\nfunction isFiniteNumber(value) {\n  return typeof value === \"number\" && isFinite(value);\n}\n\nfunction toHex(value, width) {\n  var text = Number(value).toString(16).toUpperCase();\n  while (text.length < width) {\n    text = \"0\" + text;\n  }\n  return \"0x\" + text;\n}\n\nfunction errorResult(message) {\n  return { errors: [message] };\n}\n\nif (typeof module !== \"undefined\" && module.exports) {\n  module.exports = {\n    decodeNtn: decodeNtn,\n  };\n}\n<\/code><\/pre>\n\n\n\n
<\/p>","protected":false},"excerpt":{"rendered":"
To create automatically uplink and downlink messages, please refer to this page:Lansitec Decoder \u2013 Live Calculator \u2013 Lansitec Below the full decoder code:<\/p>","protected":false},"author":5,"featured_media":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_acf_changed":false,"neve_meta_sidebar":"","neve_meta_container":"","neve_meta_enable_content_width":"","neve_meta_content_width":0,"neve_meta_title_alignment":"","neve_meta_author_avatar":"","neve_post_elements_order":"","neve_meta_disable_header":"","neve_meta_disable_footer":"","neve_meta_disable_title":"","footnotes":""},"doc_category":[338],"doc_tag":[],"class_list":["post-19912","docs","type-docs","status-publish","hentry","doc_category-decoders"],"acf":[],"year_month":"2026-08","word_count":571,"total_views":"6","reactions":{"happy":"0","normal":"0","sad":"0"},"author_info":{"name":"\ub9c8\uc774\uc9c0","author_nicename":"maizi","author_url":"https:\/\/www.lansitec.com\/ko\/author\/maizi\/"},"doc_category_info":[{"term_name":"Decoders","term_url":"https:\/\/www.lansitec.com\/ko\/doc\/\ub514\ucf54\ub354\/"}],"doc_tag_info":[],"knowledge_base_info":[],"knowledge_base_slug":[],"_links":{"self":[{"href":"https:\/\/www.lansitec.com\/ko\/wp-json\/wp\/v2\/docs\/19912","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.lansitec.com\/ko\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/www.lansitec.com\/ko\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/www.lansitec.com\/ko\/wp-json\/wp\/v2\/users\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/www.lansitec.com\/ko\/wp-json\/wp\/v2\/comments?post=19912"}],"version-history":[{"count":2,"href":"https:\/\/www.lansitec.com\/ko\/wp-json\/wp\/v2\/docs\/19912\/revisions"}],"predecessor-version":[{"id":19918,"href":"https:\/\/www.lansitec.com\/ko\/wp-json\/wp\/v2\/docs\/19912\/revisions\/19918"}],"wp:attachment":[{"href":"https:\/\/www.lansitec.com\/ko\/wp-json\/wp\/v2\/media?parent=19912"}],"wp:term":[{"taxonomy":"doc_category","embeddable":true,"href":"https:\/\/www.lansitec.com\/ko\/wp-json\/wp\/v2\/doc_category?post=19912"},{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/www.lansitec.com\/ko\/wp-json\/wp\/v2\/doc_tag?post=19912"}],"curies":[{"name":"\uc6cc\ub4dc\ud504\ub808\uc2a4","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}