btsnoop-parser 0.1.0__tar.gz

btsnoop_parser-0.1.0/LICENSE

@@ -0,0 +1,3 @@
+MIT License
+
+Copyright (c) 2025 kranthi

btsnoop_parser-0.1.0/PKG-INFO

@@ -0,0 +1,22 @@
+Metadata-Version: 2.4
+Name: btsnoop-parser
+Version: 0.1.0
+Summary: Bluetooth HCI btsnoop log parser for Android
+Author-email: Your Name <you@example.com>
+License-Expression: MIT
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+### README.md
+
+# btsnoop-parser
+
+A Python library to parse and decode Android Bluetooth `btsnoop_hci.log` files.
+
+## Usage
+
+```bash
+pip install .
+btsnoop_parser path/to/btsnoop_hci.log
+```

btsnoop_parser-0.1.0/README.md

@@ -0,0 +1,12 @@
+### README.md
+
+# btsnoop-parser
+
+A Python library to parse and decode Android Bluetooth `btsnoop_hci.log` files.
+
+## Usage
+
+```bash
+pip install .
+btsnoop_parser path/to/btsnoop_hci.log
+```

btsnoop_parser-0.1.0/btsnoop_parser/__init__.py

@@ -0,0 +1,6 @@
+from .core import parse_btsnoop_file
+from .hci_decoder import decode_hci_packet
+
+__all__ = ["parse_btsnoop_file", "decode_hci_packet"]
+
+

btsnoop_parser-0.1.0/btsnoop_parser/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == "__main__":
+    main()

btsnoop_parser-0.1.0/btsnoop_parser/cli.py

@@ -0,0 +1,14 @@
+import argparse
+from .core import parse_btsnoop_file
+from .hci_decoder import decode_hci_packet
+
+def main():
+    parser = argparse.ArgumentParser(description="Parse Android btsnoop_hci.log files")
+    parser.add_argument("file", help="Path to btsnoop_hci.log")
+    parser.add_argument("--limit", type=int, default=10, help="Limit output")
+    args = parser.parse_args()
+
+    records = parse_btsnoop_file(args.file)
+    for r in records[:args.limit]:
+        decoded = decode_hci_packet(r['packet_type'], r['packet_data'])
+        print(f"[{r['timestamp']}] {r['direction']} {r['packet_type']} - {decoded}")

btsnoop_parser-0.1.0/btsnoop_parser/constants.py

@@ -0,0 +1,14 @@
+HCI_PACKET_TYPES = {
+    0x01: "COMMAND",
+    0x02: "ACL",
+    0x03: "SCO",
+    0x04: "EVENT",
+    0xFF: "VENDOR"
+}
+
+HCI_OPCODE_NAMES = {
+    0x0401: "Inquiry",
+    0x0405: "Create Connection",
+    0x0406: "Disconnect",
+    # Add more opcodes as needed
+}

btsnoop_parser-0.1.0/btsnoop_parser/core.py

@@ -0,0 +1,40 @@
+import struct
+import datetime
+from .constants import HCI_PACKET_TYPES
+
+BTSNOOP_HEADER = b'btsnoop\0'
+BTSNOOP_TIMESTAMP_OFFSET = 0x00E03AB44A676000
+
+
+def parse_btsnoop_file(filename):
+    records = []
+    with open(filename, 'rb') as f:
+        if f.read(8) != BTSNOOP_HEADER:
+            raise ValueError("Invalid BTSnoop file header")
+        _ = struct.unpack('>II', f.read(8))  # version, datalink
+        f.read(8)  # reserved
+
+        while True:
+            header = f.read(24)
+            if len(header) < 24:
+                break
+            orig_len, incl_len, flags, drops, timestamp = struct.unpack('>IIIIQ', header)
+            packet = f.read(incl_len)
+            if not packet:
+                break
+
+            ts = datetime.datetime(1, 1, 1) + datetime.timedelta(
+                microseconds=timestamp - BTSNOOP_TIMESTAMP_OFFSET
+            )
+
+            record = {
+                'timestamp': ts,
+                'flags': flags,
+                'direction': 'RX' if flags == 1 else 'TX',
+                'packet_type': HCI_PACKET_TYPES.get(packet[0], 'UNKNOWN'),
+                'packet_data': packet[1:],
+                'raw': packet
+            }
+            records.append(record)
+
+    return records

btsnoop_parser-0.1.0/btsnoop_parser/hci_decoder.py

@@ -0,0 +1,27 @@
+from .constants import HCI_OPCODE_NAMES
+
+def decode_hci_packet(packet_type, data):
+    if packet_type == 'COMMAND':
+        opcode = int.from_bytes(data[0:2], 'little')
+        plen = data[2]
+        params = data[3:3+plen]
+        return {
+            'type': 'COMMAND',
+            'opcode': opcode,
+            'name': HCI_OPCODE_NAMES.get(opcode, 'Unknown'),
+            'params': params.hex()
+        }
+    elif packet_type == 'EVENT':
+        event_code = data[0]
+        plen = data[1]
+        params = data[2:2+plen]
+        return {
+            'type': 'EVENT',
+            'event_code': event_code,
+            'params': params.hex()
+        }
+    else:
+        return {
+            'type': packet_type,
+            'raw': data.hex()
+        }

btsnoop_parser-0.1.0/btsnoop_parser/tests/test_parser.py

@@ -0,0 +1,2 @@
+def test_placeholder():
+    assert True  # Replace with actual tests later

btsnoop_parser-0.1.0/btsnoop_parser/utils.py

@@ -0,0 +1,2 @@
+def hexify(data):
+    return ' '.join(f'{b:02X}' for b in data)

btsnoop_parser-0.1.0/btsnoop_parser.egg-info/PKG-INFO

@@ -0,0 +1,22 @@
+Metadata-Version: 2.4
+Name: btsnoop-parser
+Version: 0.1.0
+Summary: Bluetooth HCI btsnoop log parser for Android
+Author-email: Your Name <you@example.com>
+License-Expression: MIT
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+### README.md
+
+# btsnoop-parser
+
+A Python library to parse and decode Android Bluetooth `btsnoop_hci.log` files.
+
+## Usage
+
+```bash
+pip install .
+btsnoop_parser path/to/btsnoop_hci.log
+```

btsnoop_parser-0.1.0/btsnoop_parser.egg-info/SOURCES.txt

@@ -0,0 +1,16 @@
+LICENSE
+README.md
+pyproject.toml
+btsnoop_parser/__init__.py
+btsnoop_parser/__main__.py
+btsnoop_parser/cli.py
+btsnoop_parser/constants.py
+btsnoop_parser/core.py
+btsnoop_parser/hci_decoder.py
+btsnoop_parser/utils.py
+btsnoop_parser.egg-info/PKG-INFO
+btsnoop_parser.egg-info/SOURCES.txt
+btsnoop_parser.egg-info/dependency_links.txt
+btsnoop_parser.egg-info/entry_points.txt
+btsnoop_parser.egg-info/top_level.txt
+btsnoop_parser/tests/test_parser.py

btsnoop_parser-0.1.0/btsnoop_parser.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

btsnoop_parser-0.1.0/btsnoop_parser.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+btsnoop_parser = btsnoop_parser.cli:main

btsnoop_parser-0.1.0/btsnoop_parser.egg-info/top_level.txt

@@ -0,0 +1 @@
+btsnoop_parser

btsnoop_parser-0.1.0/pyproject.toml

@@ -0,0 +1,15 @@
+[project]
+name = "btsnoop-parser"
+version = "0.1.0"
+description = "Bluetooth HCI btsnoop log parser for Android"
+authors = [{name="Your Name", email="you@example.com"}]
+license = "MIT"
+readme = "README.md"
+dependencies = []
+
+[project.scripts]
+btsnoop_parser = "btsnoop_parser.cli:main"
+
+[build-system]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta"

btsnoop_parser-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+