diff --git a/dissector/baichuan.lua b/dissector/baichuan.lua index 6657992..aab5d6f 100644 --- a/dissector/baichuan.lua +++ b/dissector/baichuan.lua @@ -7,8 +7,13 @@ bc_protocol = Proto("Baichuan", "Baichuan/Reolink IP Camera Protocol") magic_bytes = ProtoField.int32("baichuan.magic", "magic", base.DEC) message_id = ProtoField.int32("baichuan.msg_id", "messageId", base.DEC) message_len = ProtoField.int32("baichuan.msg_len", "messageLen", base.DEC) -xml_enc_offset = ProtoField.int32("baichuan.xml_encryption_offset", "xmlEncryptionOffset", base.DEC) -xml_enc_used = ProtoField.bool("baichuan.xml_encryption_used", "encrypted", base.NONE) +xml_enc_offset = ProtoField.int8("baichuan.xml_encryption_offset", "xmlEncryptionOffset", base.DEC) +encrypt_xml = ProtoField.bool("baichuan.encrypt_xml", "encrypt_xml", base.NONE) +channel_id = ProtoField.int8("baichuan.channel_id", "channel_id", base.DEC) +stream_id = ProtoField.int8("baichuan.stream_id", "streamID", base.DEC) +unknown = ProtoField.int8("baichuan.unknown", "unknown", base.DEC) +msg_handle = ProtoField.int8("baichuan.message_handle", "messageHandle", base.DEC) +status_code = ProtoField.int16("baichuan.status_code", "status_code", base.DEC) message_class = ProtoField.int32("baichuan.msg_class", "messageClass", base.DEC) f_bin_offset = ProtoField.int32("baichuan.bin_offset", "binOffset", base.DEC) username = ProtoField.string("baichuan.username", "username", base.ASCII) @@ -19,7 +24,12 @@ bc_protocol.fields = { message_id, message_len, xml_enc_offset, - xml_enc_used, + channel_id, + stream_id, + unknown, + msg_handle, + encrypt_xml, + status_code, message_class, f_bin_offset, username, @@ -27,16 +37,99 @@ bc_protocol.fields = { } message_types = { - [1]="login", + [1]="login", -- / / + [2]="logout", [3]=" (video)", - [58]="", - [78]="", - [79]="", + [4]=" (stop)", + [5]=" (replay)", + [7]=" (stop)", + [8]=" (DL Video)", + [10]="", + [13]=" (download)", + [14]="", + [15]="", + [16]="", + [18]="", + [25]=" (write)", + [26]="", -- + [31]="Start Motion Alarm", + [33]="", + [36]=" (write)", + [37]="", -- //// + [38]="", + [39]=" (write)", + [40]="", + [41]=" (write)", + [42]="", + [43]=" (write)", + [44]="", -- + [45]=" (write)", + [46]="", + [47]=" (write)", + [50]="", + [51]=" (write)", + [52]=" (priv mask)", + [53]=" (write)", + [54]="", + [55]=" (write)", + [56]="", + [57]=" (write)", + [58]="", -- + [59]=" (write)", + [65]=" (Export)", + [66]=" (Import)", + [68]="", + [69]=" (write)", + [70]="", + [71]=" (write)", + [76]="", -- // + [77]=" (write)", + [78]=" (IPC desc)", + [79]=" (ptz)", [80]="", + [81]=" (schedule)", + [82]=" (write)", + [83]="", + [84]=" (write)", + [91]="", + [92]=" (write)", + [93]="", + [97]="", + [98]=" (write)", + [100]=" (write)", + [101]="", + [102]="", + [104]="", + [105]=" (write)", + [106]="", + [107]=" (write)", + [108]=" (log)", [114]="", + [115]="", + [120]="", + [122]="", + [123]="", + [132]="", -- + [133]="", + [141]=" (test)", + [142]="", + [145]="", [146]="", [151]="", + [190]="PTZ Preset", + [194]=" (test)", + [199]="", + [208]="", + [209]=" (write)", + [210]="", + [211]=" (write)", + [219]="", + [228]="", + [229]=" (write)", [230]="", + [272]="", + [273]="", + [274]="", } message_classes = { @@ -54,7 +147,7 @@ header_lengths = { } function xml_encrypt(ba, offset) - local key = "\031\045\060\075\090\105\120\255" + local key = "\031\045\060\075\090\105\120\255" -- 1f, 2d, 3c, 4b, 5a, 69, 78 ,ff local e = ByteArray.new() e:set_size(ba:len()) for i=0,ba:len() - 1 do @@ -63,103 +156,231 @@ function xml_encrypt(ba, offset) return e end -function bc_protocol.dissector(buffer, pinfo, tree) - length = buffer:len() - if length == 0 then return end - - if buffer:len() < 20 then - -- Need more bytes but we don't have a header to learn how many bytes - pinfo.desegment_len = DESEGMENT_ONE_MORE_SEGMENT - pinfo.desegment_offset = 0 - return - end - - pinfo.cols.protocol = bc_protocol.name - +function get_header_len(buffer) local magic = buffer(0, 4):le_uint() if magic ~= 0x0abcdef0 then - -- Case 3, capture started in middle of packet, - -- from https://wiki.wireshark.org/Lua/Dissectors#TCP_reassembly - -- The camera always seems to emit a new TCP packet for a new message - return 0 + return -1 -- No header found end - - local msg_type = buffer(4, 4):le_uint() - local msg_type_str = message_types[msg_type] or "unknown" - local msg_len = buffer(8, 4):le_uint() - local enc_offset = buffer(12, 4):le_uint() - local msg_cls = buffer(18, 2):le_uint() - local encrypted = (msg_cls == 0x6414 or buffer(16, 1):le_uint() ~= 0) - local class = message_classes[buffer(18, 2):le_uint()] local header_len = header_lengths[buffer(18, 2):le_uint()] + return header_len +end - if buffer:len() ~= msg_len + header_len then - -- Case 1, need more bytes, - -- from https://wiki.wireshark.org/Lua/Dissectors#TCP_reassembly - pinfo.desegment_len = msg_len + header_len - buffer:len() - pinfo.desegment_offset = 0 - return buffer:len() - end - +function get_header(buffer) -- bin_offset is either nil (no binary data) or nonzero -- TODO: bin_offset is actually stateful! local bin_offset = nil + local status_code = nil + local encrypt_xml = nil + local header_len = header_lengths[buffer(18, 2):le_uint()] + local msg_type = buffer(4, 4):le_uint() if header_len == 24 then - bin_offset = buffer(20, 4):le_uint() - if bin_offset == 0 then bin_offset = nil end + bin_offset = buffer(20, 4):le_uint() -- if NHD-805/806 legacy protocol 30 30 30 30 aka "0000" + status_code = buffer(16, 2):le_uint() + else + encrypt_xml = buffer(16, 1):le_uint() end + local msg_type = buffer(4, 4):le_uint() + local stream_text = "HD (Clear)" + if buffer(13, 1):le_uint() == 1 then + stream_text = "SD (Fluent)" + end + return { + magic = buffer(0, 4):le_uint(), + msg_type = buffer(4, 4):le_uint(), + msg_type_str = message_types[msg_type] or "unknown", + msg_len = buffer(8, 4):le_uint(), + encrypt_xml = encrypt_xml, + channel_id = buffer(12, 1):le_uint(), + enc_offset = buffer(12, 1):le_uint(), + stream_type = stream_text, + unknown = buffer(14, 1):le_uint(), + msg_handle = buffer(15, 1):le_uint(), + msg_cls = buffer(18, 2):le_uint(), + status_code = status_code, + class = message_classes[buffer(18, 2):le_uint()], + header_len = header_lengths[buffer(18, 2):le_uint()], + bin_offset = bin_offset, + } +end - local bc_subtree = tree:add(bc_protocol, buffer(), - "Baichuan IP Camera Protocol, " .. msg_type_str .. " message") - local header = bc_subtree:add(bc_protocol, buffer(0, header_len), - "Baichuan Message Header, length: " .. header_len) - - pinfo.cols['info'] = msg_type_str .. ", type " .. msg_type .. ", " .. msg_len .. " bytes" - +function process_header(buffer, headers_tree) + local header_data = get_header(buffer) + local header = headers_tree:add(bc_protocol, buffer(0, header_len), + "Baichuan Message Header, length: " .. header_data.header_len .. ", type " .. header_data.msg_type) + local stream_text = " HD (Clear)" + if buffer(13, 1):le_uint() == 1 then + stream_text = " SD (Fluent)" + end header:add_le(magic_bytes, buffer(0, 4)) header:add_le(message_id, buffer(4, 4)) - :append_text(" (" .. msg_type_str .. ")") + :append_text(" (" .. header_data.msg_type_str .. ")") header:add_le(message_len, buffer(8, 4)) - header:add_le(xml_enc_offset, buffer(12, 4)) - :append_text(" (& 0xF == " .. bit32.band(enc_offset, 0xF) .. ")") - header:add_le(xml_enc_used, buffer(16, 1)) - header:add_le(message_class, buffer(18, 2)) - :append_text(" (" .. class .. ")") - header:add_le(f_bin_offset, buffer(20, 4)) - if msg_len == 0 then + header:add_le(xml_enc_offset, buffer(12, 1)) + :append_text(" (& 0xF == " .. bit32.band(header_data.enc_offset, 0xF) .. ")") + + header:add_le(channel_id, buffer(12, 1)) + header:add_le(stream_id, buffer(13, 1)) + :append_text(stream_text) + header:add_le(unknown, buffer(14, 1)) + header:add_le(msg_handle, buffer(15, 1)) + + header:add_le(message_class, buffer(18, 2)):append_text(" (" .. header_data.class .. ")") + + if header_data.header_len == 24 then + header:add_le(status_code, buffer(16, 2)) + header:add_le(f_bin_offset, buffer(20, 4)) + else + header:add_le(encrypt_xml, buffer(16, 1)) + end + return header_len +end + +function process_body(header, body_buffer, bc_subtree, pinfo) + if header.msg_len == 0 then return end - local body = bc_subtree:add(bc_protocol, buffer(header_len, nil), - "Baichuan Message Body, " .. class .. ", length: " .. msg_len .. ", encrypted: " .. tostring(encrypted)) + local body = bc_subtree:add(bc_protocol, body_buffer(0,header.msg_len), + "Baichuan Message Body, " .. header.class .. ", length: " .. header.msg_len .. ", type " .. header.msg_type) - if class == "legacy" then - if msg_type == 1 then - body:add_le(username, buffer(header_len, 32)) - body:add_le(password, buffer(header_len + 32, 32)) + if header.class == "legacy" then + if header.msg_type == 1 then + body:add_le(username, body_buffer(0, 32)) + body:add_le(password, body_buffer(0 + 32, 32)) end else - local body_tvb = buffer(header_len, bin_offset):tvb() - body:add(body_tvb(), "XML Payload") - - if encrypted then - local ba = buffer(header_len, bin_offset):bytes() - local decrypted = xml_encrypt(ba, enc_offset) - body_tvb = decrypted:tvb("Decrypted XML") - -- Create a tree item that, when clicked, automatically shows the tab we just created - body:add(body_tvb(), "Decrypted XML") + local xml_len = header.bin_offset + if xml_len == nil then + xml_len = header.msg_len + end + local xml_buffer = body_buffer(0, xml_len) + if xml_len > 0 then + local body_tvb = xml_buffer:tvb("Meta Payload") + body:add(body_tvb(), "Meta Payload") + if xml_len >= 4 then + if xml_encrypt(xml_buffer(0,5):bytes(), header.enc_offset):raw() == " 0 then + local binary_buffer = body_buffer(header.bin_offset, bin_len) -- Don't extend beyond msg size + body_tvb = binary_buffer:tvb("Main Payload"); + body:add(body_tvb(), "Main Payload") + if bin_len > 4 then + if xml_encrypt(binary_buffer(0,5):bytes(), header.enc_offset):raw() == "= 0 then + pinfo.cols['info'] = "Valid header" + -- Valid magic and header found + + -- Ensure min bytes for full header + if sub_buffer:len() < header_len then + pinfo.cols['info'] = "Need even more header" + -- Need more bytes + pinfo.desegment_len = header_len - sub_buffer:len() + pinfo.desegment_offset = 0 + return buffer:len() + end + + + local header = get_header(sub_buffer(0, nil)) + table.insert(table_msg_type_str, header.msg_type_str) + table.insert(table_msg_type, header.msg_type) + + -- Get full header and body + local full_body_len = header.msg_len + header.header_len + if sub_buffer:len() < full_body_len then + -- need more bytes, + -- from https://wiki.wireshark.org/Lua/Dissectors#TCP_reassembly + pinfo.cols['info'] = "Need more body: " .. sub_buffer:len() .. " expected " .. full_body_len + pinfo.desegment_len = full_body_len - sub_buffer:len() + pinfo.desegment_offset = 0 + return buffer:len() + end + + local remaining = sub_buffer:len() - header.header_len + + local bc_subtree = tree:add(bc_protocol, sub_buffer(0, header.msg_len), + "Baichuan IP Camera Protocol, " .. header.msg_type_str .. ":" .. header.msg_type .. " message") + process_header(sub_buffer, bc_subtree) + if header.header_len < sub_buffer:len() then + local body_buffer = sub_buffer(header.header_len,nil) + process_body(header, body_buffer, bc_subtree, pinfo) + + remaining = body_buffer:len() - header.msg_len + end + + -- Remaning bytes? + if remaining == 0 then + continue_loop = false + else + pinfo.cols['info'] = "Another packet" + sub_buffer = sub_buffer(full_body_len, nil) + end + else + pinfo.cols['info'] = "Invalid magic" + return -- Not a valid header + end + end + + local msg_type_strs = table.concat(table_msg_type_str, ",") + local msg_types = table.concat(table_msg_type, ",") + pinfo.cols['info'] = msg_type_strs .. ", type " .. msg_types +end + DissectorTable.get("tcp.port"):add(9000, bc_protocol) +DissectorTable.get("tcp.port"):add(52941, bc_protocol) -- change to your own custom port diff --git a/dissector/mediapacket.md b/dissector/mediapacket.md new file mode 100644 index 0000000..26cf0b5 --- /dev/null +++ b/dissector/mediapacket.md @@ -0,0 +1,111 @@ +# Media Packets + +This file attempts to document the encapsulated stream that makes up the binary +data of message ID 3. This stream represents the video and audio data. + +The are six types of media packets + +- Info V1 + +- Info V2 + +- I Frame + +- P Frame + +- AAC + +- ADPCM + +The I and P frames come in two formats H264 and H265. + +The ADPCM is DVI-4 encoded with an extra header that represents the block size. + +## Magic + +Each packet can be distinguished with the following magic bytes + +- Info V1: 0x31, 0x30, 0x30, 0x31 +- Info V2: 0x31, 0x30, 0x30, 0x32 +- I Frame: 0x30, 0x30, 0x64, 0x63 +- P Frame: 0x30, 0x31, 0x64, 0x63 +- AAC: 0x30, 0x35, 0x77, 0x62 +- ADPCM: 0x30, 0x31, 0x77, 0x62 + + +## Headers + +The full headers for each of these are as follows: + +Most of this information comes from the work of @twisteddx at his +[site](https://www.wasteofcash.com/BCConvert/BC_fileformat.txt) + +- Info V1/V2: + + - 4 bytes magic + - 4 bytes data size of header itself + - 4 bytes video width + - 4 bytes video height + - 1 byte unknown. Known values 00/01 + - 1 byte Frames per second (Reolink=FPS, Swann=Appears to be the index value of the FPS setting) + - 1 byte Start UTC year since 1900 + - 1 byte Start UTC month + - 1 byte Start UTC date + - 1 byte Start UTC hour + - 1 byte Start UTC minute + - 1 byte Start UTC seconds + - 1 byte End UTC year since 1900 + - 1 byte End UTC month + - 1 byte End UTC date + - 1 byte End UTC hour + - 1 byte End UTC minute + - 1 byte End UTC seconds + - 2 bytes reserved + +- I Frame + + - 4 bytes magic + - 4 bytes video type (ASCII text of either H264 or H265) + - 4 bytes data size of payload after header + - 4 bytes unknown. NVR channel count? Known values 1-00/08 2-00 3-00 4-00 + - 4 bytes Microseconds + - 4 bytes unknown. Known values 1-00/23/5A 2-00 3-00 4-00 + - 4 bytes POSIX time_t 32bit UTC time (seconds since 00:00:00 Jan 1 1970) + - 4 bytes unknown. Known values 1-00/06/29 2-00/01 3-00/C3 4-00 + +- P Frame + - 4 bytes magic + - 4 bytes video type (eg H264 or H265) + - 4 bytes data size of payload after header + - 4 bytes unknown. Known values 1-00 2-00 3-00 4-00 + - 4 bytes Microseconds + - 4 bytes unknown. Known values 1-00/5A 2-00 3-00 4-00 + +- AAC + + - 4 bytes magic + - 2 bytes data size of payload after header + - 2 bytes data size of payload after header (Same as previous) + +- ADPCM + + - 4 bytes magic + - 2 bytes data size of payload after header + - 2 bytes data size of payload after header + +### ADPCM + +After the ADPCM header is another header of the form + +- 2 bytes Magic either 0x00 0x01 or 0x00 0x7a +- 2 Bytes DVI-4 Block size + +After this header the adpcm DVI-4 data follows. + +## Processing + +The data in ID 3 messages represents an encapsulated stream. BC messages may +terminate mid media packet messages. Clients should create a buffer of the +BC ID 3 messages then read the media packet magic and expected length. Once +length is known they should wait for more BC message ID 3 packets until a +complete media packet is received before processing it. diff --git a/dissector/messages.md b/dissector/messages.md new file mode 100644 index 0000000..b1f851c --- /dev/null +++ b/dissector/messages.md @@ -0,0 +1,2083 @@ +# BC Messages +--- + +This is an attempt to document the BC messages. It is subject to change +and some aspects of it may not be correct. Please feel free to submit +a PR to improve it. + +- 1: Login Legacy + + - Client + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------| + | f0 de bc 0a | 01 00 00 00 | 2c 07 00 00 | 00 00 00 01 | 01 | dc | 14 65 | + + - Body + + Body is hash of user 32 bytes and password 32 bytes and then a lot of zero pads + + ```hex + MD5USERNAME0MD5PASSWORD00000000000000000000000000000000000000000 + 0000000000000000000000000000000000000000000000000000000000000000 + ....... + ``` + + - Camera + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------| + | f0 de bc 0a | 01 00 00 00 | 91 00 00 00 | 00 00 00 01 | 01 | dd | 14 66 | + + - Body + + ```xml + + + + md5 + 13BCECE33DA453DB + + + ``` + + - **Notes:** Sends back a NONCE used for the modern login message. This is + effectively an upgrade request to use the modern xml style over legacy. + A legacy camera likely replies differently but I don't have one to test on. + +- 1: Login Modern + + - Client + - Header + + | Magic | Message ID | Message Length | Encryption Offset | Encryption Flag | Unknown | Message Class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | f0 de bc 0a | 01 00 00 00 | 28 01 00 00 | 00 00 00 01 | 00 | 00 | 14 64 | 00 00 00 00 | + + - Binary + + ```xml + + + + ... + ... + 1 + + + LAN + 0 + + + ``` + + - Camera + + - Header + + | Magic | Message ID | Message Length | Encryption Offset | Encryption Flag | Unknown | Message Class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | f0 de bc 0a | 01 00 00 00 | 2e 06 00 00 | 00 00 00 01 | c8 | 00 | 00 00 | 00 00 00 00 | + + - Binary + + ```xml + + + + 00000000000000 + 0 + 0 + 0 + wifi_solo_ipc + 1 + 1 + 0 + 1 + + 2304*1296 + 2304 + 1296 + + English + 1 + pt + IPC + 33555019 + 0 + 0 + 0 + 0 + 0 + 0 + NTSC + DMY + 0 + 0 + 1 + + + + 1 + + mainStream + + 2304 + 1296 + + 15 + 2560 + 15,12,10,8,6,4,2 + 1024,1536,2048,2560,3072 + + + subStream + + 896 + 512 + + 15 + 512 + 15,12,10,8,6,4,2 + 128,256,384,512,768,1024 + + + + + ``` + +- 2: logout + + - Client + + - Binary + + ```xml + + + + PlainTextUsername + PlainTextPASSWORD + 1 + + + ``` + +- 3: Stream + + - Client + + - Header + + | Magic | Message ID | Message Length | Encryption Offset | Encryption Flag | Unknown | Message Class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | f0 de bc 0a | 03 00 00 00 | aa 00 00 00 | 00 00 00 09 | 00 | 00 | 14 64 | 00 00 00 00 | + + - Binary + + ```xml + + + + 0 + 0 + mainStream + + + ``` + + - **Notes:** This requests the camera to send this stream + + - Camera + + - Header + + | Magic | Message ID | Message Length | Encryption Offset | Encryption Flag | Unknown | Message Class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | f0 de bc 0a | 03 00 00 00 | 8a 00 00 00 | 00 00 00 09 | c8 | 00 | 00 00 | 6a 00 00 00 | + + - Body + + ```xml + + + 1 + + ``` + + - Binary + + ```hex + 31303032200000000009000010050000000F780A06122422780A061224220000 + ``` + + - **Notes:** Camera then send the stream as a binary payload in all + following messages of id 3 + + - Camera Stream Binary + + - Header + + | Magic | Message ID | Message Length | Encryption Offset | Encryption Flag | Unknown | Message Class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | f0 de bc 0a | 03 00 00 00 | e8 5e 00 00 | 00 00 00 09 | c8 | 00 | 00 00 | 00 00 00 00 | + + - Body + + Body is binary. This binary represents an embedded stream which should + be detailed elsewhere. + +- 4: `` (stop) + + - Client + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 04 | 00 00 00 86 | 2b 00 00 00 | 00 | 00 | 64 14 | 00 00 00 00 | + + - Binary + + ```xml + + + + 0 + 0 + + + ``` + + - Camera + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 04 | 00 00 00 00 | 2b 00 00 00 | c8 | 00 | 00 00 | 00 00 00 00 | + +- 10: `` + + - Client + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 0a | 00 00 00 68 | 0b 00 00 00 | 00 | 00 | 64 14 | 00 00 00 68 | + + - Body + + ```xml + + + 0 + + ``` + + - Camera + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 0a | 00 00 01 f7 | 0b 00 00 00 | c8 | 00 | 00 00 | 00 00 00 00 | + + - Binary + + ```xml + + + + + FDX + + + followVideoStream + + + + 0 + adpcm + 16000 + 16 + 1024 + mono + + + + + ``` + +- 18: `` + + - Client + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 12 | 00 00 00 a4 | 1e 00 00 00 | 00 | 00 | 64 14 | 00 00 00 00 | + + - Binary + + ```xml + + + + 0 + 32 + right + + + ``` + + - Camera + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 12 | 00 00 00 00 | 1e 00 00 00 | c8 | 00 | 00 00 | 00 00 00 00 | + +- 25: `` (write) + + - Client + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 19 | 00 00 05 c2 | 64 00 00 00 | 00 | 00 | 64 14 | 00 00 00 68 | + + - Body + + ```xml + + + 0 + + ``` + + - Binary + + ```xml + + + + 0 + 128 + 128 + 128 + 128 + 166 + + + 0 + 1 + + 50hz + 0 + + + auto + + 1 + 100 + 1 + 62 + + + 0 + 125 + 0 + 125 + + 1/30 + 50 + + + auto + + 0 + 255 + 128 + + + 0 + 255 + 128 + + + + auto + ir + medium + + + 0 + backLight + + 0 + 255 + 128 + + + 0 + 255 + 128 + + + 0 + 0 + + 0 + success + 0 + + + high + 1 + + + + ``` + + - Camera + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 19 | 00 00 00 00 | 64 00 00 00 | c8 | 00 | 00 00 | 00 00 00 00 | + + +- 26: `` + + - Client + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 1a | 00 00 00 68 | 2d 00 00 00 | 00 | 00 | 64 14 | 00 00 00 68 | + + - Body + + ```xml + + + 0 + + ``` + + - Camera + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 1a | 00 00 05 7c | 2d 00 00 00 | c8 | 00 | 00 00 | 00 00 00 00 | + + - Binary + + ```xml + + + + 0 + 128 + 128 + 128 + 128 + 128 + + + 0 + 1 + + 50hz + 0 + + + auto + + 1 + 100 + 1 + 62 + + + 0 + 125 + 0 + 125 + + 1/30 + 50 + + + auto + auto, manual + + 0 + 255 + 128 + + + 0 + 255 + 128 + + + + auto + ir + medium + + + 0 + backLight + + 0 + 255 + 128 + + + 0 + 255 + 128 + + + 0 + 0 + + 0 + success + 0 + + + high + 1 + + + + ``` + +- 31: Start Motion Alarm + + - Client + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 1f | 00 00 00 00 | 05 00 00 00 | 00 | 00 | 64 14 | 00 00 00 00 | + + - Camera + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 1f | 00 00 00 00 | 05 00 00 00 | c8 | 00 | 00 00 | 00 00 00 00 | + + - **Notes:** The camera will not send message 33 to the client until + after this msg has been recieved + +- 33: `` + + - Camera + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 21 | 00 00 00 f0 | 05 00 00 00 | c8 | 00 | 00 00 | 00 00 00 00 | + + - Binary + + ```xml + + + + + 0 + MD + 0 + 0 + + + + ``` + +- 44: `` + + - Client + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 2c | 00 00 00 68 | 30 00 00 00 | 00 | 00 | 64 14 | 00 00 00 68 | + + - Body + + ```xml + + + 0 + + ``` + + - Camera + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 2c | 00 00 01 df | 30 00 00 00 | c8 | 00 | 00 00 | 00 00 00 00 | + + - Binary + + ```xml + + + + 0 + Cammy02 + 1 + 65536 + 65536 + 0 + 0 + + + 0 + 1 + 65537 + 1 + 0 + 0 + Chinese + + + ``` + +- 45: `` (write) + + - Client + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 2d | 00 00 02 23 | 32 00 00 00 | 00 | 00 | 64 14 | 00 00 00 68 | + + - Body + + ```xml + + + 0 + + ``` + + - Binary + + ```xml + + + + 0 + Cammy02 + 0 + 65536 + 65536 + 0 + 0 + + + 0 + 1 + 65537 + 1 + Chinese + + + ``` + + - Camera + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 2d | 00 00 00 00 | 32 00 00 00 | c8 | 00 | 00 00 | 00 00 00 00 | + +- 52: `` + + - Client + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 34 | 00 00 00 68 | 36 00 00 00 | 00 | 00 | 64 14 | 00 00 00 68 | + + - Body + + ```xml + + + 0 + + ``` + + - Camera + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 34 | 00 00 00 96 | 36 00 00 00 | c8 | 00 | 00 00 | 00 00 00 00 | + + - Binary + + ```xml + + + + 0 + 0 + + + + ``` + +- 53: `` + + - Client + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 35 | 00 00 01 d7 | 38 00 00 00 | 00 | 00 | 64 14 | 00 00 00 68 | + + - Body + + ```xml + + + 0 + + ``` + + - Binary + + ```xml + + + + 0 + 1 + + + 0 + 0 + + + 1 + 0 + + + 2 + 0 + + + 3 + 0 + + + + + ``` + + - Camera + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 35 | 00 00 00 00 | 38 00 00 00 | c8 | 00 | 00 00 | 00 00 00 00 | + +- 54: `` + + - Client + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 36 | 00 00 00 68 | 14 00 00 00 | 00 | 00 | 64 14 | 00 00 00 68 | + + - Body + + ```xml + + + 0 + + ``` + + - Camera + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 36 | 00 00 00 ed | 14 00 00 00 | c8 | 00 | 00 00 | 00 00 00 00 | + + - Binary + + ```xml + + + + 0 + 1 + 15 + 10 + 5 + + + ``` + +- 55: `` (write) + + - Client + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 37 | 00 00 01 3b | 16 00 00 00 | 00 | 00 | 64 14 | 00 00 00 68 | + + - Body + + ```xml + + + 0 + + ``` + + - Binary + + ```xml + + + + 0 + 15 + 1 + 5 + + + ``` + + - Camera + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 37 | 00 00 00 00 | 16 00 00 00 | c8 | 00 | 00 00 | 00 00 00 00 | + +- 56: `` + + - Client + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 38 | 00 00 00 68 | 1d 00 00 00 | 00 | 00 | 64 14 | 00 00 00 68 | + + - Body + + ```xml + + + 0 + + ``` + + - Camera + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 38 | 00 00 03 61 | 1d 00 00 00 | c8 | 00 | 00 00 | 00 00 00 00 | + + - Binary + + ```xml + + + + 0 + 1 + + + 2304*1296 + 2304 + 1296 + cbr + 15 + 2560 + high + + + + 896*512 + 896 + 512 + cbr + 15 + 512 + high + + + + + 0 + 0 + vbr + 0 + 0 + default + + + + ``` + +- 57: `` (write) + + - Client + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 39 | 00 00 02 bc | 1f 00 00 00 | 00 | 00 | 64 14 | 00 00 00 68 | + + - Body + + ```xml + + + 0 + + ``` + + - Binary + + ```xml + + + + 0 + + + 2304*1296 + 2304 + 1296 + vbr + 15 + 2560 + high + + + + 896*512 + 896 + 512 + vbr + 15 + 512 + high + + + + ``` + + - Camera + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 39 | 00 00 00 00 | 1f 00 00 00 | c8 | 00 | 00 00 | 00 00 00 00 | + +- 58: `` + + - Client + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 3a | 00 00 00 6b | 03 00 00 00 | 00 | 00 | 64 14 | 00 00 00 6b | + + - Body + + ```xml + + + PlainTextUsername + + ``` + + - Camera + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 3a | 00 00 03 a4 | 03 00 00 00 | c8 | 00 | 00 00 | 00 00 00 00 | + + - Binary + + ```xml + + + + + 1 + 1 + 1 + 1 + 1 + 0 + 1 + 1 + + + 1 + 1 + 1 + + + + 0 + PlainTextUsername + PlainTextPASSWORD + 1 + 0 + none + + + 0 + PlainTextUsername + PlainTextPASSWORD]VX + 0 + 0 + none + + + 0 + PlainTextUsername + PlainTextPASSWORD + 1 + 1 + none + + + + ``` + - **Notes:** The passwords are not sent in some models of cameras namely + RLC-410 4mp, RLC-410 5mp, RLC-520 (fw 200710) in these cases the passwords + are blank. In some older cameras that do not use encryption at all these + passwords are completely visible to any network sniffers. Even the "encrypted" + cameras only have weak encryption that is easily broken since the + decryption key is fixed and well-known. + +- 76: `` + + - Client + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 4c | 00 00 00 00 | 22 00 00 00 | 00 | 00 | 64 14 | 00 00 00 00 | + + - Camera + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 4c | 00 00 01 69 | 22 00 00 00 | c8 | 00 | 00 00 | 00 00 00 00 | + + - Binary + + ```xml + + + + 1 + + + 1 + + + 192.168.1.101 + 255.255.255.0 + 94:E0:D6:E9:89:86 + 192.168.1.1 + + + 1.1.1.1 + 8.8.8.8 + + + ``` + +- 77: `` (write) + + - Client + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 4d | 00 00 01 5b | 25 00 00 00 | 00 | 00 | 64 14 | 00 00 00 00 | + + - Binary + + ```xml + + + + 1 + + + 0 + + + 192.168.1.101 + 255.255.255.0 + 94:E0:D6:E9:89:86 + 192.168.1.1 + + + 1.1.1.1 + 8.8.8.8 + + + ``` + + - Camera + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 4d | 00 00 00 00 | 14 00 00 00 | c8 | 00 | 00 00 | 00 00 00 00 | + +- 78: `` + + - Camera + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 4e | 00 00 00 d3 | 1b 00 00 00 | c8 | 00 | 00 00 | 00 00 00 00 | + + - Binary + + ```xml + + + + 0 + 128 + 128 + 128 + 128 + + + ``` + +- 79: `` (ptz) + + - Camera + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 4f | 00 00 01 3b | 1b 00 00 00 | c8 | 00 | 00 00 | 00 00 00 00 | + + - Binary + + ```xml + + + + 0 + 9600 + CS8 + 1 + none + none + PELCO_D + 1 + + + ``` + +- 80: `` + + - Client + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 50 | 00 00 00 00 | 08 00 00 00 | 00 | 00 | 64 14 | 00 00 00 00 | + + - Camera + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 50 | 00 00 01 f0 | 08 00 00 00 | c8 | 00 | 00 00 | 00 00 00 00 | + + - Binary + + ```xml + + + + Cammy02 + E1 + 00000000000000 + build 19110800 + IPC_517SD5 + v2.0.0.0 + v2.0.0.587_19110800 + IPC_51716M110000000100000 + IEClient + pak + blackPointsLevel=0 + + + ``` + +- 81: `` (schedule) + + - Client + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 51 | 00 00 00 68 | 19 00 00 00 | 00 | 00 | 64 14 | 00 00 00 68 | + + - Body + + ```xml + + + 0 + + ``` + + - Camera + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 51 | 00 00 04 30 | 19 00 00 00 | c8 | 00 | 00 00 | 00 00 00 00 | + + - Binary + + ```xml + + + + 0 + 1 + + + MD + + + 1 + Sunday + 0 + 23 + + + 1 + Monday + 0 + 23 + + + 1 + Tuesday + 0 + 23 + + + 1 + Wednesday + 0 + 23 + + + 1 + Thursday + 0 + 23 + + + 1 + Friday + 0 + 23 + + + 1 + Saturday + 0 + 23 + + + + + + + ``` + +- 82: `` (write) + + - Client + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 52 | 00 00 05 da | 1a 00 00 00 | 00 | 00 | 64 14 | 00 00 00 68 | + + - Body + + ```xml + + + 0 + + ``` + + - Binary + + ```xml + + + + 0 + 1 + + + MD + + + 1 + Sunday + 0 + 23 + + + 1 + Monday + 0 + 23 + + + 1 + Tuesday + 0 + 12 + + + 1 + Tuesday + 14 + 23 + + + 1 + Wednesday + 0 + 23 + + + 1 + Thursday + 0 + 23 + + + 1 + Friday + 0 + 23 + + + 1 + Saturday + 0 + 23 + + + + + none + + + 1 + Tuesday + 13 + 13 + + + + + + + ``` + + - Camera + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 52 | 00 00 00 00 | 1a 00 00 00 | c8 | 00 | 00 00 | 00 00 00 00 | + +- 93: `` + + - Client + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 5d | 00 00 00 00 | 17 00 00 00 | 00 | 00 | 64 14 | 00 00 00 00 | + +- 102: `` + + - Client + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 66 | 00 00 00 00 | 07 00 00 00 | 00 | 00 | 64 14 | 00 00 00 00 | + + - Camera + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 66 | 00 00 00 55 | 07 00 00 00 | c8 | 00 | 00 00 | 00 00 00 00 | + + - Binary + + ```xml + + + + + ``` + +- 104: `` + + - Client + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 68 | 00 00 00 00 | 0a 00 00 00 | 00 | 00 | 64 14 | 00 00 00 00 | + + - Camera + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 68 | 00 00 01 a5 | 0a 00 00 00 | c8 | 00 | 00 00 | 00 00 00 00 | + + - Binary + + ```xml + + + + -25200 + DMY + 2020 + 10 + 6 + 18 + 36 + 34 + 0 + 0 + English + Cammy02 + + + NTSC + + + ``` + +- 115: `` + + - Client + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 73 | 00 00 00 00 | 0c 00 00 00 | 00 | 00 | 64 14 | 00 00 00 00 | + + - Camera + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 73 | 00 00 00 75 | 0c 00 00 00 | c8 | 00 | 00 00 | 00 00 00 00 | + + - Binary + + ```xml + + + + -40 + + + ``` + +- 132: `` + + - Client + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 84 | 00 00 00 68 | 65 00 00 00 | 00 | 00 | 64 14 | 00 00 00 68 | + + - Body + + ```xml + + + 0 + + ``` + + - Camera + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 84 | 00 00 05 7c | 65 00 00 00 | c8 | 00 | 00 00 | 00 00 00 00 | + + - Binary + + ```xml + + + + 0 + 128 + 128 + 128 + 128 + 128 + + + 0 + 1 + + 50hz + 0 + + + auto + + 1 + 100 + 1 + 62 + + + 0 + 125 + 0 + 125 + + 1/30 + 50 + + + auto + auto, manual + + 0 + 255 + 128 + + + 0 + 255 + 128 + + + + auto + ir + medium + + + 0 + backLight + + 0 + 255 + 128 + + + 0 + 255 + 128 + + + 0 + 0 + + 0 + success + 0 + + + high + 1 + + + + ``` + +- 133: `` + + - Client + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 85 | 00 00 00 00 | 06 00 00 00 | 00 | 00 | 64 14 | 00 00 00 00 | + + - Camera + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 85 | 00 00 00 7f | 06 00 00 00 | c8 | 00 | 00 00 | 00 00 00 00 | + + - Binary + + ```xml + + + + 1 + none + + + ``` + +- 146: `` + + - Client + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 92 | 00 00 00 00 | 04 00 00 00 | 00 | 00 | 64 14 | 00 00 00 00 | + + - Camera + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 92 | 00 00 02 fc | 04 00 00 00 | c8 | 00 | 00 00 | 00 00 00 00 | + + - Binary + + ```xml + + + + + 1 + + mainStream + + 2304 + 1296 + + 15 + 2560 + 15,12,10,8,6,4,2 + 1024,1536,2048,2560,3072 + + + subStream + + 896 + 512 + + 15 + 512 + 15,12,10,8,6,4,2 + 128,256,384,512,768,1024 + + + + + ``` + +- 151: `` + + - Client + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 97 | 00 00 00 a7 | 02 00 00 00 | 00 | 00 | 64 14 | 00 00 00 a7 | + + - Body + + ```xml + + + PlainTextUsername + system, network, alarm, record, video, image + + ``` + + - Camera + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 97 | 00 00 03 ac | 02 00 00 00 | c8 | 00 | 00 00 | 00 00 00 00 | + + - Binary + + ```xml + + + + PlainTextUsername + + + general_rw, norm_rw, version_ro, uid_ro, autoReboot_rw, restore_rw, reboot_rw, shutdown_rw, dst_rw, log_ro, performance_ro, upgrade_rw, export_rw, import_rw, bootPwd_rw + + + + + port_rw, dns_rw, email_rw, ipFilter_rw, localLink_rw, pppoe_rw, upnp_rw, wifi_rw, ntp_rw, netStatus_rw, ptop_rw, autontp_rw + + + + + 0 + motion_rw + + + + + 0 + ispBasic_rw, ispAdvance_rw, ledState_rw + + + + + + ``` + +- 190: PTZ Preset + + - Client + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 be | 00 00 00 68 | 0d 00 00 00 | 00 | 00 | 64 14 | 00 00 00 68 | + + - Body + + ```xml + + + 0 + + ``` + + - Camera + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 be | 00 00 00 86 | 0d 00 00 00 | c8 | 00 | 00 00 | 00 00 00 00 | + + - Binary + + ```xml + + + + 0 + + + + ``` + +- 192: + + - Client + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 c0 | 00 00 00 00 | 05 00 00 00 | 00 | 00 | 64 14 | 00 00 00 00 | + + - Camera + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 c0 | 00 00 00 00 | 05 00 00 00 | c8 | 00 | 00 00 | 00 00 00 00 | + +- 199: `` + + - Client + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 c7 | 00 00 00 00 | 02 00 00 00 | 00 | 00 | 64 14 | 00 00 00 00 | + + - Camera + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 c7 | 00 00 05 f6 | 02 00 00 00 | c8 | 00 | 00 00 | 00 00 00 00 | + + - Binary + + ```xml + + + + 0 + 0 + 0 + 1 + 1 + pt + 0 + 0 + 0 + 1 + 0 + 1 + 1 + 5 + 0 + 1 + 0 + 0 + 1 + 0 + 0 + 1 + 1 + 1 + 3 + 1 + 1 + 1 + 0 + 30 + 1 + 0 + 1 + 1 + 0 + + 1 + + googleHome + 1 + + + amazonAlexa + 1 + + + + 0 + 3 + 0 + 0 + 0 + 0 + 0 + 0 + 0 + 0 + 0 + 0 + 1 + 0 + 0 + 15 + 1 + 1 + + + + ``` + +- 208: `` + + - Client + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 d0 | 00 00 00 68 | 2e 00 00 00 | 00 | 00 | 64 14 | 00 00 00 68 | + + - Body + + ```xml + + + 0 + + ``` + + - Camera + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 d0 | 00 00 00 c2 | 2e 00 00 00 | c8 | 00 | 00 00 | 00 00 00 00 | + + - Binary + + ```xml + + + + 0 + 2 + auto + open + + + ``` + +- 209: `` (write) + + - Client + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 d1 | 00 00 01 10 | 85 00 00 00 | 00 | 00 | 64 14 | 00 00 00 68 | + + - Body + + ```xml + + + 0 + + ``` + + - Binary + + ```xml + + + + 0 + close + open + + + ``` + + - Camera + + - Header + + | magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | Binary Offset | + |--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| + | 0a bc de f0 | 00 00 00 d1 | 00 00 00 00 | 85 00 00 00 | c8 | 00 | 00 00 | 00 00 00 00 | diff --git a/dissector/protocol.md b/dissector/protocol.md new file mode 100644 index 0000000..fd81dce --- /dev/null +++ b/dissector/protocol.md @@ -0,0 +1,235 @@ +# BC Protocol + +This is an attempt to document the BC protocol. It is far from complete +but should serve as a good basis for those wishing to develop apps for +BC cameras. + +## Messages + +Each message has the general format: + +- Header: 20-24 bytes + +- Message Body + +### Header + +The header has the format: + +| magic | message id | message length | encryption offset | Encryption flag | Unknown | message class | +|--------------|--------------|----------------|-------------------|-----------------|---------|---------------| +| f0 de bc 0a | 01 00 00 00 | 2c 07 00 00 | 00 00 00 01 | 01 | dc | 14 65 | + +Or + +| Magic | Message ID | Message Length | Encryption Offset | Encryption Flag | Unknown | Message Class | Binary Offset | +|--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| +| f0 de bc 0a | 01 00 00 00 | 28 01 00 00 | 00 00 00 01 | 00 | 00 | 14 64 | 00 00 00 00 | + + +- Magic 4 bytes +- ID 4 bytes +- Message length 4 bytes +- Encryption offset 4 bytes +- Encryption flag (not always honoured by clients) 1 byte +- Unknown 1 byte (always zero) +- Binary offset 4 bytes (Presence depend on message class) + +#### Magic + +The magic bytes for BC messages is always `f0 de bc 0a`. When receiving packet +this should be used to quickly discard invalid packets. + +#### Message ID + +Each function in BC has its own message ID. For example login is 1, video data +is 3, motion detection is 33. + +For a more complete list please see the [messages doc](dissector/messages.md) + +#### Message length + +The message length contains the full length of the data to follow the header +this includes both the XML and binary parts. + +#### Encryption offset + +The encryption offset is used as part of the decoding process. It is combined +with the key to decrypt the data. + +Here is an example decrypter in rust + +```rust +const XML_KEY: [u8; 8] = [0x1F, 0x2D, 0x3C, 0x4B, 0x5A, 0x69, 0x78, 0xFF]; + +pub fn crypt(offset: u32, buf: &[u8]) -> Vec { + let key_iter = XML_KEY.iter().cycle().skip(offset as usize % 8); + key_iter + .zip(buf) + .map(|(key, i)| *i ^ key ^ (offset as u8)) + .collect() +} +``` + +In short the key is offset by the encryption offset in the header. Then each +encrypted byte is paired with the offseted keys bytes (looping the offseted +key as necessary). Then each byte is XORed with the paired key byte and the +offset. + +The key is the same for all cameras. + +Older cameras do not use encryption and all messages are sent as plain text. + +#### Encryption Flag + +This flag is 0 for unencrypted or non zero for encrypted. This flag seems +only to be valid during the login step, and seems to be arbitrary otherwise. + +Clients should decide to use encryption or not based on this byte that the +camera send during login. Then should use that same setting for all further +messages with the camera. + +#### Unknown + +The purpose of this byte is unknown but is always zero. If you figure out +what it does please submit a PR. + +#### Message class + +The message class determines the length of the header. The following classes +and header lengths are known. + +- 0x6514: "legacy" 20 bytes + +- 0x6614: "modern" 20 bytes + +- 0x6414: "modern" 24 bytes + +- 0x0000: "modern" 24 bytes + +#### Binary offset + +For messages that contain the binary offset field this represents where to start +the binary part of the message. The total length of XML + binary is equal +to the message length in the header so Binary Offset is +total_length - this_offset. Where as this field also represents the end of the +XML part of the message. + +Some messages seems to not set this field correctly. For example message ID 1 +sets this to zero meaning that all data in the message is binary, however +it contains XML. This best way to tell is this is binary or XML is to check the +message ID and determine from there. Alternatively you could look for ` + + +0 +0 +mainStream + + +``` + +streamType can be either + +- `mainStream` in which case it will be HD +- `subStream` in which case it will be SD + + +channelId is part of the NVR when multiple cameras use the same IP. In this +case each camera has its own channelId. + +Not sure what handle does. + + +The reply is first a message with the following xml + +```xml + + +1 + +``` + +After which all message bodies of type id 3 are binary. + +The binary represents a stream of data. It can be interrupted by packet +boundaries. Clients should create a buffer and pop bytes for processing when +complete media packets are received. Media packets descriptions can be found in +the [docs](dissector/mediapacket.md) + +# Other Function + +Other data can be received from the camera by sending the appropriate header to +the camera. For example sending the header for ID 78 + +| Magic | Message ID | Message Length | Encryption Offset | Encryption Flag | Unknown | Message Class | Binary Offset | +|--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| +| f0 de bc 0a | 4e 00 00 00 | d3 00 00 00 | 08 db 9c 00 | c8 | 00 | 00 00 | 00 00 00 00 | + +The camera will reply with an xml with brightness and contrast + +```xml + + + +0 +128 +128 +128 +128 + + +``` + +Some message IDs also require input along with the request header. For example + +ID 151 which is the users ability info requires the header + +| Magic | Message ID | Message Length | Encryption Offset | Encryption Flag | Unknown | Message Class | Binary Offset | +|--------------|--------------|----------------|-------------------|-----------------|---------|---------------|---------------| +| f0 de bc 0a | 97 00 00 00 | a7 00 00 00 | 00 00 00 02 | 00 | 00 | 14 64 | a7 00 00 00 | + +and the body of + +```xml + + +... +system, network, alarm, record, video, image + +``` + +Which contains the plain text of the username of interest and the tokens for +abilities you want to know about. + +Details of expected formats should be found from the +[docs](dissector/messages.md)