diff libtest/tw5reader.h @ 522:4d2cccaeb4a7

libtest: implement TW-TS-005 reader function Spec reference: https://www.freecalypso.org/specs/tw-ts-005-v010002.txt
author Mychaela Falconia <falcon@freecalypso.org>
date Thu, 19 Sep 2024 03:08:47 +0000
parents libtest/binreader.h@820d88b97924
children
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/libtest/tw5reader.h	Thu Sep 19 03:08:47 2024 +0000
@@ -0,0 +1,21 @@
+/*
+ * This header file defines the interface to our reader function for
+ * hexadecimal RTP frame sequence files in TW-TS-005 format.
+ *
+ * twts005_read_frame() return values are:
+ *  1 = successfully read valid frame
+ *  0 = normal EOF
+ * -1 = read line with invalid content
+ * -2 = line too long or missing newline
+ *
+ * The reader function skips blank, whitespace-only and comment lines,
+ * returning only actual frames.  lineno variable must be initialized to 0
+ * by the application program, but not touched otherwise.  In case of an
+ * error, this variable will hold the line number at which the error was
+ * encountered.
+ */
+
+#define	TWTS005_MAX_FRAME	40
+
+int twts005_read_frame(FILE *hexf, unsigned *lineno, uint8_t *frame,
+			unsigned *lenp);