Add CLI tools for parsing data

[smarek]

• Add CLI access tools for each protocol implemented
• Export scripts in setup.py

Eg. what can be now done like this (running from root of Hytera_Homebrew_Bridge)

$ python3 -m hytera_homebrew_bridge.tests.hdap_single_packet 0980a10022000000010a01b2070a03640e4f004c004900560045005200200054004500530054007a03
{'checksum': 122,
 'data': {'_m_option_sum_len': 0,
          'ack_flag': <AckFlags.ack_not_required: 1>,
          'destination_ip': {'radio_id_1': 1,
                             'radio_id_2': 178,
                             'radio_id_3': 7,
                             'subnet': 10},
          'message_length': 34,
          'option_flag': <OptionFlags.option_len_and_field_disabled: 0>,
          'request_id': 1,
          'reserved': 0,
          'service_type': <ServiceTypes.send_private_message: 161>,
          'source_ip': {'radio_id_1': 3,
                        'radio_id_2': 100,
                        'radio_id_3': 14,
                        'subnet': 10},
          'tmdata': 'OLIVER TEST'},
 'message_footer': b'\x03',
 'message_header': <MessageHeaderTypes.text_message_protocol: 9>}

Should be doable like this, for example

• dmr-kaitai-hdap 0980a10022000000010a01b2070a03640e4f004c004900560045005200200054004500530054007a03
• or like this
• dmr-kaitai --hdap 0980a10022000000010a01b2070a03640e4f004c004900560045005200200054004500530054007a03

[smarek]

Final commands are documented in the README, per example in previous post looks currently (with v1.0) like this:

> debug-hytera-hdap 0980a10022000000010a01b2070a03640e4f004c004900560045005200200054004500530054007a03
{'checksum': 122,
 'data': {'_m_option_sum_len': 0,
          'ack_flag': <AckFlags.ack_not_required: 1>,
          'destination_ip': {'radio_id_1': 1,
                             'radio_id_2': 178,
                             'radio_id_3': 7,
                             'subnet': 10},
          'message_length': 34,
          'option_flag': <OptionFlags.option_len_and_field_disabled: 0>,
          'request_id': 1,
          'reserved': 0,
          'service_type': <ServiceTypes.send_private_message: 161>,
          'source_ip': {'radio_id_1': 3,
                        'radio_id_2': 100,
                        'radio_id_3': 14,
                        'subnet': 10},
          'tmdata': 'OLIVER TEST'},
 'is_reliable_message': False,
 'message_footer': b'\x03',
 'message_header': <MessageHeaderTypes.text_message_protocol: 9>}

[kevsgithub]

Hi Marek, does that debug command verify the checksum? I can't see where in hdap you verify this. It looks to me to be a 1 byte crc but etsi etc are two byte.how is it calculated? Any clues? Thanks Kev

…

On Tue, 28 Jun 2022 at 22:37, Marek Sebera ***@***.***> wrote: Final commands are documented in the README, per example in previous post looks currently (with v1.0) like this: > debug-hytera-hdap 0980a10022000000010a01b2070a03640e4f004c004900560045005200200054004500530054007a03 {'checksum': 122, 'data': {'_m_option_sum_len': 0, 'ack_flag': <AckFlags.ack_not_required: 1>, 'destination_ip': {'radio_id_1': 1, 'radio_id_2': 178, 'radio_id_3': 7, 'subnet': 10}, 'message_length': 34, 'option_flag': <OptionFlags.option_len_and_field_disabled: 0>, 'request_id': 1, 'reserved': 0, 'service_type': <ServiceTypes.send_private_message: 161>, 'source_ip': {'radio_id_1': 3, 'radio_id_2': 100, 'radio_id_3': 14, 'subnet': 10}, 'tmdata': 'OLIVER TEST'}, 'is_reliable_message': False, 'message_footer': b'\x03', 'message_header': <MessageHeaderTypes.text_message_protocol: 9>} — Reply to this email directly, view it on GitHub <#2 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/ABF2TUVT54Q6JMAAR7R2PH3VRNWCJANCNFSM5IVPEXYA> . You are receiving this because you are subscribed to this thread.Message ID: ***@***.***>

[smarek]

see https://github.com/OK-DMR/ok-dmrlib/blob/master/okdmr/dmrlib/hytera/pdu/hdap.py#L46

dmr-kaitai is only dissector/disassembler, it does verify only the basics (pdu structure, fields order and length, ...)
ok-dmrlib is where protocol assembling, checksums and others are done