cyrozap / tools-for-tdc
Reverse engineering and documenting the ".tdc" capture file format used by Total Phase Data Center (TPDC) / Beagle USB analyzers.
📥 Clone
https://github.com/cyrozap/tools-for-tdc.git
Tools for TDC
This project is an effort to reverse engineer and document the .tdc capture file format used by Total Phase Data Center.
Total Phase Data Center (TPDC) is proprietary software needed to use Total Phase's protocol analyzer products, including their Beagle USB 5000 SuperSpeed Protocol Analyzer.
The goal of this project is to understand enough of the .tdc capture file format to write a tool to be able to convert them to PCAP-NG format, to enable users of Beagle USB protocol analyzers to take advantage of Wireshark's wide array of protocol dissectors and plugin ecosystem.
This project was started in large part because Total Phase has a webpage that "explains" how to export USB captures to PCAP, but their "explanation" leaves the writing of the code to do the conversion as an exercise to the reader.
Disclaimer
This project is not affiliated with, sponsored by, endorsed by, or in any way associated with Total Phase, Inc., the developer of Total Phase Data Center and associated protocol analyzer products. This project makes no claim to ownership of the proprietary rights (including patents, trademarks, copyrights, trade secrets, etc.) of Total Phase, Inc. and its products or software.
Project Status
Done:
- The header format of the
.tdcfiles is partially understood and documented with Kaitai Struct in doc/tdc.ksy. - The format of the compressed capture data in
.tdcfiles is (nearly) completely understood, and can be correctly decompressed using the algorithm described in doc/Compression.md. The algorithm is FastLZ. - The format of the decompressed data is partly understood, and is described in doc/Decompressed-Data.md.
- Finish reverse engineering the format of the decompressed capture data.
- Write a tool to parse a
.tdcfile and generate a.pcapngfile from it.
License
Except where stated otherwise:
- All software in this repository is made available under the GNU General Public License, version 3 or later.
- All copyrightable content that is not software (e.g., reverse engineering notes, this README file, etc.) is licensed under the Creative Commons Attribution-ShareAlike 4.0 International License.