libdvbtee

dvbtee و libdvbtee

مقدمة

libdvbtee عبارة عن محلل دفق ومكتبة مجمعة لمعلومات الخدمة لتدفقات نقل MPEG2. تتضمن المكتبة محللًا لمعلومات خدمة البرنامج (PSI) ودعمًا لمختلف طرق تدفق الشبكة، وهي على دراية بواجهة برمجة تطبيقات linux-dvb kernel بالإضافة إلى واجهات برمجة تطبيقات تدفق شبكة HDHomeRun.

تحتوي المكتبة على وظائف كافية لتشغيل تطبيق وسيط تلفزيوني كامل الميزات، بما في ذلك القدرة على الحصول على البيانات ودفقها من خلال UDP وTCP وHTTP وDMA وآليات أخرى متنوعة.

يسمح libdvbtee_server بالتحكم في هذه الميزات من جلسة http أو واجهة سطر الأوامر، ويمكن استخدامه للتحكم في موالفات متعددة.

libdvbtee_parser هي مكتبة مبنية من مصادر libdvbtee للاستخدام بواسطة عقدة dvbtee، تتم استضافة libdvbtee_parser داخل نفس مستودع تطوير git مثل libdvbtee ، وعلى هذا النحو، فإنهما يشتركان في نفس ملف README.md الفردي.

يوفر تطبيق dvbtee القابل للتنفيذ مجموعة متنوعة من الميزات، بما في ذلك: المسح والضبط وتصفح EPG واستقبال تدفقات الشبكة الواردة وتدفق تدفقات الشبكة وإدارة الموالفات المتعددة والمزيد...

يمكن الوصول إلى الخادم إما عن طريق telnet أو http. رقم المنفذ الافتراضي هو 64080 ، ولكنه قابل للتكوين. يستخدم server_example رقم المنفذ 62080 .

عند الوصول إلى الخادم عبر http، تسبق الأوامر بـ / والوسيطات بـ =. عند الوصول إلى الخادم عبر telnet، أدخل في النموذج "command=argument" ثم اضغط على Enter.

مايكل ايرا كروفكي
مكروفكي في linuxtv dot org

كيفية البناء/التشغيل

الطريقة الموصى بها لإنشاء libdvbtee هي استخدام البرنامج النصي build-auto.sh :

 ./build-auto.sh
dvbtee/dvbtee < mpegfile.ts

طرق البناء الأخرى

تم تطوير libdvbtee في الأصل باستخدام نظام بناء qmake لدعم إنشاء منصات متعددة بسهولة. لا يزال libdvbtee يدعم نظام qmake، ولكنه يستخدم الآن الأدوات التلقائية كنظام البناء المفضل لأسباب مختلفة.

 autoreconf --install
./configure
make
dvbtee/dvbtee < mpegfile.ts

إذا كنت تريد، لسبب غريب، إنشاء libdvbtee باستخدام الإصدار القديم من وحدة فك ترميز الجدول/الواصف، فحدد --enable-olddecoder للتكوين

 autoreconf --install
./configure --enable-olddecoder
make
dvbtee/dvbtee < mpegfile.ts

إذا كنت تفضل استخدام qmake بدلاً من autotools، فاستخدم الأوامر التالية:

 qmake -r
make
LD_LIBRARY_PATH=libdvbtee:libdvbtee_server dvbtee/dvbtee < mpegfile.ts

إذا كنت تريد، لسبب غريب، إنشاء libdvbtee باستخدام الإصدار القديم من وحدة فك ترميز الجدول/الواصف، فحدد CONFIG+=olddecoder إلى qmake

 qmake -r CONFIG+=olddecoder
make
LD_LIBRARY_PATH=libdvbtee:libdvbtee_server dvbtee/dvbtee < mpegfile.ts

يعتمد libdvbtee على libdvbpsi لتحليل PSIP. على الرغم من أن libdvbtee سيتم إنشاؤه وفقًا لإصدارات libdvbpsi الأقدم، إلا أنه يلزم إنشاء إصدار أحدث لتوفير كافة ميزات libdvbtee الأحدث، مثل دعم ATSC.

نظام بناء libdvbtee قادر على البناء والربط مع أحدث إصدار من libdvbpsi عن طريق وضع نسخة من مستودع libdvbpsi في المستوى الأعلى من شجرة مصدر libdvbtee.

بدلاً من تقديم تعليمات خطوة بخطوة في ملف README هذا، يتم توفير برامج نصية لـ Shell والتي ستجلب أحدث مصادر libdvbpsi، وتكوين نظام البناء، وبناء المكتبتين معًا.

للإنشاء المتكامل لـ libdvbtee مع أحدث إصدار من libdvbpsi باستخدام الأدوات التلقائية (مستحسن):

 ./build-auto.sh
dvbtee/dvbtee < mpegfile.ts

للإنشاء المتكامل لـ libdvbtee مع أحدث إصدار من libdvbpsi باستخدام qmake:

 ./build-qmake.sh
LD_LIBRARY_PATH=libdvbtee:libdvbtee_server dvbtee/dvbtee < mpegfile.ts

وسيطات سطر الأوامر

 -a      adapter id
-A      (1 for ATSC, 2 for ClearQAM)
-b      display bitrates & statistics
-c      channel to tune /
        comma (,) separated list of channels to scan /
        scan minimum channel
-C      channel to tune /
        comma (,) separated list of channels to scan /
        scan maximum channel
-f      frontend id
-F      filename to use as input
-t      timeout
-T      number of tuners (dvb adapters) allowed to use, 0 for all
-s      scan, optional arg when using multiple tuners:
        1 for speed, 2 for redundancy,
        3 for speed AND redundancy,
        4 for optimized speed / partial redundancy
-S      server mode, optional arg 1 for command server,
        2 for http stream server, 3 for both
-i      pull local/remote tcp/udp port for data
-n      bind to a specific network interface
-I      request a service and its associated PES streams by its service id
-E      enable EPG scan, optional arg to limit the number of EITs to parse
-e      enable ETT extended text tables (EPG descriptions, ATSC only)
-o      output filtered data, optional arg is a filename / URI, ie udp://127.0.0.1:1234
-O      output options: (or-able) 1 = PAT/PMT, 2 = PES, 4 = PSIP, 8 = AUDIO, 16 = VIDEO
-H      use a HdHomeRun device, optional arg to specify the device string
-j      enable json output of decoded tables & descriptors
-d      debug level
-q      quiet most logging
-h      display additional help

مثال الاستخدام

لضبط معرف الخدمة 1 للقناة الفعلية 33 ودفقها إلى منفذ UDP:

  dvbtee -c33 -I1 -oudp://192.168.1.100:1234

لضبط الواجهة الأمامية الثانية للمحول 1 ودفق TS الكامل للقناة الفعلية 44 إلى مستمع TCP:

  dvbtee -c44 -otcp://192.168.1.200:5555

للاستماع إلى منفذ TCP والبث إلى منفذ UDP:

  dvbtee -itcp://5555 -oudp://192.168.1.100:1234

لتحليل ملف تم التقاطه وتصفية بيانات PSIP، وحفظ تدفقات PAT/PMT وPES في ملف:

  dvbtee -Finput.ts -O3 -ofile://output.ts

لتحليل دفق UDP لمدة عشر ثوان:

  dvbtee -iudp://127.0.0.1:1234 -t10

للبحث عن الخدمات باستخدام أول موالف متصل:

  dvbtee -s -a0

للبحث عن خدمات ClearQAM باستخدام 5 موالفات محسنة للسرعة والتكرار الجزئي:

  dvbtee -A2 -T5 -s4

للبحث عن خدمات ATSC باستخدام موالفين HdHomeRun محسّنين للسرعة والتكرار:

  dvbtee -A1 -H -T2 -s3

لبدء خادم باستخدام المحول 0:

  dvbtee -a0 -S

لبدء تشغيل خادم باستخدام موالف 1 لجهاز HdHomeRun محدد (على سبيل المثال: ABCDABCD):

  dvbtee -H ABCDABCD-1 -S

مثال الإخراج:

لمسح قناة مع تمكين إخراج JSON، استخدم الأمر التالي:

  dvbtee -s -c13 -j

...يجب أن تولد مخرجات مشابهة لما يلي:

 scan channel 13...
store PAT: v0, ts_id: 2011
           3 | 30
           4 | 40
           5 | 50
store PMT: v12, service_id 3, pcr_pid 49
  es_pid | type
      31 | 0x02 (Video MPEG-2) |
      34 | 0x81 (Audio AC3 (ATSC)) | eng
      35 | 0x81 (Audio AC3 (ATSC)) | spa
      36 | 0x81 (Audio AC3 (ATSC)) | fre
store VCT: v6, ts_id 2011, b_cable_vct 0
  channel | service_id | source_id | service_name
     13.1 |          3 |         1 | WNET-HD | eng, spa, fre
     13.2 |          4 |         2 | KIDS | eng, spa, fre
     13.3 |          5 |         3 | V-Me | eng
store MGT: v6
  table type |   pid  | ver | bytes
    0x0000   | 0x1ffb |   6 | 187
    0x0100   | 0x1d00 |   6 | 1103
    0x0101   | 0x1d01 |   6 | 1105
    0x0102   | 0x1d02 |   6 | 1132
    0x0103   | 0x1d03 |   6 | 1305
    0x0200   | 0x1e00 |   6 | 1197
    0x0201   | 0x1e01 |   6 | 1220
    0x0202   | 0x1e02 |   6 | 1157
    0x0203   | 0x1e03 |   6 | 1213
store PMT: v12, service_id 5, pcr_pid 81
  es_pid | type
      51 | 0x02 (Video MPEG-2) |
      54 | 0x81 (Audio AC3 (ATSC)) | eng
store PMT: v12, service_id 4, pcr_pid 65
  es_pid | type
      41 | 0x02 (Video MPEG-2) |
      44 | 0x81 (Audio AC3 (ATSC)) | eng
      45 | 0x81 (Audio AC3 (ATSC)) | spa
      46 | 0x81 (Audio AC3 (ATSC)) | fre

# channel 13, 213000000,
13.1-WNET-HD:213000000:8VSB:49:52:3
13.2-KIDS:213000000:8VSB:65:68:4
13.3-V-Me:213000000:8VSB:81:84:5
found 3 services

TSID#07db: [ { "programs": [ { "number": 3, "pid": 48 }, { "number": 4, "pid": 64 }, { "number": 5, "pid": 80 } ], "tableId": 0, "tableName": "PAT", "tsId": 2011, "version": 0 }, { "pcrPid": 49, "program": 3, "streams": [ { "pid": 49, "streamType": 2, "streamTypeString": "Video MPEG-2" }, { "descriptors": [ { "bitRateCode": 14, "bsid": 8, "bsmod": 0, "description": "", "descriptorTag": 129, "fullSvc": true, "language": "eng", "numChannels": "2/0", "sampleRate": "48", "surroundMode": "Not indicated" }, { "ISO639Lang": [ { "audioType": 0, "language": "eng" } ], "descriptorTag": 10 } ], "pid": 52, "streamType": 129, "streamTypeString": "Audio AC3 (ATSC)" }, { "descriptors": [ { "bitRateCode": 8, "bsid": 8, "bsmod": 0, "description": "", "descriptorTag": 129, "fullSvc": true, "language": "spa", "numChannels": "2/0", "sampleRate": "48", "surroundMode": "Not indicated" }, { "ISO639Lang": [ { "audioType": 0, "language": "spa" } ], "descriptorTag": 10 } ], "pid": 53, "streamType": 129, "streamTypeString": "Audio AC3 (ATSC)" }, { "descriptors": [ { "bitRateCode": 8, "bsid": 8, "bsmod": 2, "description": "", "descriptorTag": 129, "fullSvc": true, "language": "fre", "numChannels": "2/0", "sampleRate": "48", "surroundMode": "Not indicated" }, { "ISO639Lang": [ { "audioType": 0, "language": "fre" } ], "descriptorTag": 10 } ], "pid": 54, "streamType": 129, "streamTypeString": "Audio AC3 (ATSC)" } ], "tableId": 2, "tableName": "PMT", "version": 12 }, { "channels": [ { "accessControlled": false, "carrierFreq": 0, "descriptors": [ { "descriptorTag": 161, "serviceLocation": [ { "esPid": 49, "streamType": 2, "streamTypeString": "Video MPEG-2" }, { "esPid": 52, "lang": "eng", "streamType": 129, "streamTypeString": "Audio AC3 (ATSC)" }, { "esPid": 53, "lang": "spa", "streamType": 129, "streamTypeString": "Audio AC3 (ATSC)" }, { "esPid": 54, "lang": "fre", "streamType": 129, "streamTypeString": "Audio AC3 (ATSC)" } ] } ], "etmLocation": 0, "hidden": false, "hideGuide": false, "major": 13, "minor": 1, "modulation": 4, "outOfBand": true, "pathSelect": true, "program": 3, "serviceName": "WNET-HD", "serviceType": 2, "sourceId": 1, "tsId": 2011 }, { "accessControlled": false, "carrierFreq": 0, "descriptors": [ { "descriptorTag": 161, "serviceLocation": [ { "esPid": 65, "streamType": 2, "streamTypeString": "Video MPEG-2" }, { "esPid": 68, "lang": "eng", "streamType": 129, "streamTypeString": "Audio AC3 (ATSC)" }, { "esPid": 69, "lang": "spa", "streamType": 129, "streamTypeString": "Audio AC3 (ATSC)" }, { "esPid": 70, "lang": "fre", "streamType": 129, "streamTypeString": "Audio AC3 (ATSC)" } ] } ], "etmLocation": 0, "hidden": false, "hideGuide": false, "major": 13, "minor": 2, "modulation": 4, "outOfBand": true, "pathSelect": true, "program": 4, "serviceName": "KIDS", "serviceType": 2, "sourceId": 2, "tsId": 2011 }, { "accessControlled": false, "carrierFreq": 0, "descriptors": [ { "descriptorTag": 161, "serviceLocation": [ { "esPid": 81, "streamType": 2, "streamTypeString": "Video MPEG-2" }, { "esPid": 84, "lang": "eng", "streamType": 129, "streamTypeString": "Audio AC3 (ATSC)" } ] } ], "etmLocation": 0, "hidden": false, "hideGuide": false, "major": 13, "minor": 3, "modulation": 4, "outOfBand": true, "pathSelect": true, "program": 5, "serviceName": "V-Me", "serviceType": 2, "sourceId": 3, "tsId": 2011 } ], "isCableVCT": false, "tableId": 200, "tableName": "VCT", "tsId": 2011, "version": 6 }, { "tableId": 199, "tableName": "MGT", "tables": [ { "bytes": 187, "pid": 8187, "type": 0, "version": 6 }, { "bytes": 1103, "pid": 7424, "type": 256, "version": 6 }, { "bytes": 1105, "pid": 7425, "type": 257, "version": 6 }, { "bytes": 1132, "pid": 7426, "type": 258, "version": 6 }, { "bytes": 1305, "pid": 7427, "type": 259, "version": 6 }, { "bytes": 1197, "pid": 7680, "type": 512, "version": 6 }, { "bytes": 1220, "pid": 7681, "type": 513, "version": 6 }, { "bytes": 1157, "pid": 7682, "type": 514, "version": 6 }, { "bytes": 1213, "pid": 7683, "type": 515, "version": 6 } ], "version": 6 }, { "pcrPid": 81, "program": 5, "streams": [ { "descriptors": [ { "CaptionService": [ { "digital_cc": "708", "easyReader": false, "iso639lang": "eng", "line21field": true, "serviceNumber": 1, "wideAspectRatio": false } ], "descriptorTag": 134 } ], "pid": 81, "streamType": 2, "streamTypeString": "Video MPEG-2" }, { "descriptors": [ { "bitRateCode": 10, "bsid": 8, "bsmod": 0, "description": "", "descriptorTag": 129, "fullSvc": true, "language": "eng", "numChannels": "2/0", "sampleRate": "48", "surroundMode": "Not indicated" }, { "ISO639Lang": [ { "audioType": 0, "language": "eng" } ], "descriptorTag": 10 } ], "pid": 84, "streamType": 129, "streamTypeString": "Audio AC3 (ATSC)" } ], "tableId": 2, "tableName": "PMT", "version": 12 }, { "pcrPid": 65, "program": 4, "streams": [ { "descriptors": [ { "CaptionService": [ { "digital_cc": "708", "easyReader": false, "iso639lang": "eng", "line21field": true, "serviceNumber": 1, "wideAspectRatio": false } ], "descriptorTag": 134 } ], "pid": 65, "streamType": 2, "streamTypeString": "Video MPEG-2" }, { "descriptors": [ { "bitRateCode": 14, "bsid": 8, "bsmod": 0, "description": "", "descriptorTag": 129, "fullSvc": true, "language": "eng", "numChannels": "2/0", "sampleRate": "48", "surroundMode": "Not indicated" }, { "ISO639Lang": [ { "audioType": 0, "language": "eng" } ], "descriptorTag": 10 } ], "pid": 68, "streamType": 129, "streamTypeString": "Audio AC3 (ATSC)" }, { "descriptors": [ { "bitRateCode": 8, "bsid": 8, "bsmod": 0, "description": "", "descriptorTag": 129, "fullSvc": true, "language": "spa", "numChannels": "2/0", "sampleRate": "48", "surroundMode": "Not indicated" }, { "ISO639Lang": [ { "audioType": 0, "language": "spa" } ], "descriptorTag": 10 } ], "pid": 69, "streamType": 129, "streamTypeString": "Audio AC3 (ATSC)" }, { "descriptors": [ { "bitRateCode": 8, "bsid": 8, "bsmod": 2, "description": "", "descriptorTag": 129, "fullSvc": true, "language": "fre", "numChannels": "2/0", "sampleRate": "48", "surroundMode": "Not indicated" }, { "ISO639Lang": [ { "audioType": 0, "language": "fre" } ], "descriptorTag": 10 } ], "pid": 70, "streamType": 129, "streamTypeString": "Audio AC3 (ATSC)" } ], "tableId": 2, "tableName": "PMT", "version": 12 } ]

أوامر الخادم

 tuner           specify tuner id
feeder          specify feeder id
scan            scan for services, optional arg comma (,) separated list of channels to scan
scanepg         same as 'scan' with EPG data collection enabled during scan
startscan       same as 'scan' but asynchronous
startscanepg    combo of 'scanepg' and 'startscan'
tune            tune to a channel or service, ie:
                tune=33 (full mux) / tune=44~3 (svc id 3)
channels        list channels
channel         tune physical channel (unsafe - use tune instead)
service         select service (unsafe - use tune instead)
stream          add output file / tcp / udp / http stream, ie:
                stream=udp:192.168.1.100:1234
                stream=tcp:192.168.1.200:5555
                stream=file:output.ts
                stream (over http with no arg will begin streaming to current socket)
epg             dump collected EPG data
xmltv           dump collected EPG data in XMLTV format
stop            stop the tuner
stopoutput      stop the tuner and output
check           display debug info if debug is enabled
debug           enable debug
parser          enable / disable the parser for data shovel
listen          listen for TS on a TCP or UDP port
save            save scanned channels
quit            stop the server and exit