Intel® Media Transport Library v22.06 release.

Signed-off-by: Du, Frank <[email protected]>

Author: frankdjx

CHANGELOG.md

@@ -1,6 +1,19 @@
 # Change log
 
-## Change log for next release:
+## Change log for 22.06:
+* User frame mode with uframe_pg_callback for rx video session.
+* Color format SIMD convert API between RFC4175 YUV422 10bit BE and other LE format, see st_convert_api.h.
+* SIMD build and runtime framework.
+* Migration suppport for tx/rx video session if the cpu lcore usage is too busy, see ST_FLAG_TX_VIDEO_MIGRATE/ST_FLAG_RX_VIDEO_MIGRATE.
+* DMA/DSA helper on SIMD convert API to reduce LLC usage for 4K/8K resolution, see st_convert_api.h.
+* Format auto detect for rx video session, see ST20_RX_FLAG_AUTO_DETECT.
+* rx: add payload type check in the hdr sanity inspection.
+* st22: add frame mode support for tx and rx.
+* st22: add pipeline mode support for both tx and rx, see st_pipeline_api.h for the API, tx_st22_pipeline_sample.c/rx_st22_pipeline_sample.c for the sample code.
+* st22: add encode/decode plugin sample code, see jpegxs_plugin_sample.c for the sample and kahawai.json for the plugin so config.
+* app: json config support for st22 pipeline mode.
+* tx/st20: runtime session create/free features, adding runtime ratelimit support.
+* st30: support 125us and 80us in audio pacing
 
 ## Change log for Beta 22.04:
 * Enabled field mode to support 1080i,PAL,NTSC with narrow pacing.

README.md

@@ -11,11 +11,16 @@ The Media Transport Library(Kahawai) is a solution based on DPDK prepared for tr
 
 ## 2. Build:
 Please refer to [build guide](doc/build.md) for how to build DPDK, the library and the sample application.
+Please refer to [build guide](doc/build_WIN.md) for how to build DPDK, the library and the sample application in Windows.
 
 ## 3. Run:
-Please refer to [run guide](doc/run.md) for how to setup and run the sample app.
+Please refer to [run guide](doc/run.md) for how to setup and run the demo pipeline application.
+Please refer to [run guide](doc/run_WIN.md) for how to setup and run the demo pipeline application in Windows.
 
-## 4. Coding style:
+## 4. Programmers guide:
+For how to develop application quickly based on Kahawai library, pls refer to [sample code](app/sample).
+
+## 5. Coding style:
 Run below command before opening a PR.
 ```bash
 ./format-coding.sh

app/meson.build

@@ -11,22 +11,34 @@
 # express or implied warranties, other than those that are expressly stated
 # in the License.
 
-project('Intel(R) ST DPDK sample app', 'c', default_options: ['c_std=gnu11', 'buildtype=release'], version: '0.1',)
+project('Intel(R) ST DPDK sample app', 'c', default_options: ['c_std=gnu11', 'buildtype=release'], version: '22.06',)
+
+# allow experimental api
+add_global_arguments('-DALLOW_EXPERIMENTAL_API', language : 'c')
+
+#detect os
 exec_env = host_machine.system()
 set_variable('is_windows', exec_env == 'windows')
-#allow experimental api
-add_global_arguments('-DALLOW_EXPERIMENTAL_API', language : 'c')
+
+cc = meson.get_compiler('c')
 
 libst_dpdk = dependency('libst_dpdk', required : true)
+libm = cc.find_library('m', required : true)
+libpthread = cc.find_library('pthread', required : true)
 libjson_c = dependency('json-c', required : true)
 if not is_windows
-libpcap = dependency('pcap', required:true)
+  libpcap = dependency('pcap', required: true)
+endif
+libsdl2 = dependency('sdl2', required: true)
+libsdl2_ttf = dependency('SDL2_ttf', required: false)
+if libsdl2_ttf.found()
+  add_global_arguments('-DAPP_HAS_SDL2_TTF', language : 'c')
+else
+  message('SDL2_ttf not found')
 endif
-libsdl2 = dependency('sdl2', required:true)
-
 libopenssl = dependency('openssl', required : true)
 
-#add source file
+# add source file
 subdir('src')
 subdir('tools')
 subdir('sample')
@@ -37,123 +49,169 @@ app_c_args = []
 #enable warning as error
 app_c_args += ['-Werror']
 app_c_args += ['-Wall']
+
 if is_windows
-libpcap =[]
-mingw_root_dir = 'c:\mingw64'
-app_c_args += ['-DWINDOWSENV']
-app_c_args += ['-Wformat=0']
-app_c_args += ['-D__USE_MINGW_ANSI_STDIO']
-mingw_include_dir = mingw_root_dir + '''\include'''
-windows_include_dir = '..\..\lib\windows'
-app_c_args += ['-I' + mingw_include_dir]
-app_c_args += ['-I' + windows_include_dir]
-
-libdpdkcflags = run_command('pkg-config', '--cflags', 'libdpdk')
-libjsonccflags = run_command('pkg-config', '--cflags', 'json-c')
-libsdl2cflags = run_command('pkg-config', '--cflags', 'sdl2')
-libdpdklinkflags = run_command('pkg-config', '--static', '--libs', 'libdpdk')
-
-app_c_args += [libdpdkcflags.stdout().strip().split()]
-app_c_args += [libjsonccflags.stdout().strip().split()]
-app_c_args += [libsdl2cflags.stdout().strip().split()]
+  libpcap =[]
+  mingw_root_dir = 'c:\mingw64'
+  app_c_args += ['-DWINDOWSENV','-D_WIN32_WINNT=0x0600']
+  app_c_args += ['-Wformat=0']
+  app_c_args += ['-D__USE_MINGW_ANSI_STDIO']
+  mingw_include_dir = mingw_root_dir + '''\include'''
+  windows_include_dir = '..\..\lib\windows'
+  app_c_args += ['-I' + mingw_include_dir]
+  app_c_args += ['-I' + windows_include_dir]
+
+  libdpdkcflags = run_command('pkg-config', '--cflags', 'libdpdk')
+  libjsonccflags = run_command('pkg-config', '--cflags', 'json-c')
+  libsdl2cflags = run_command('pkg-config', '--cflags', 'sdl2')
+  libsdl2_ttfcflags = run_command('pkg-config', '--cflags', 'sdl2-ttf')
+  libdpdklinkflags = run_command('pkg-config', '--static', '--libs', 'libdpdk')
+  libopensslcflags = run_command('pkg-config', '--cflags', 'openssl')
+
+  app_c_args += [libdpdkcflags.stdout().strip().split()]
+  app_c_args += [libjsonccflags.stdout().strip().split()]
+  app_c_args += [libsdl2cflags.stdout().strip().split()]
+  app_c_args += [libsdl2_ttfcflags.stdout().strip().split()]
+  app_c_args += [libopensslcflags.stdout().strip().split()]
 endif
 
-#simd build option, enable sse4.2 default, todo: do we need AVX2/AVX512 for app ?
+# simd build option, enable sse4.2 default, todo: do we need AVX2/AVX512 for app ?
 app_c_args += ['-msse4.2']
 
 app_ld_args = []
 
-app_ld_args += ['-pthread','-lm']
-
 if is_windows
-app_ld_args += ['-lmingw32','-lws2_32','-lDbghelp','-lSetupapi','-ldinput8', '-ldxguid', '-ldxerr8', '-lwinmm', '-limm32','-lversion','-lwpcap','-lPacket','-lSDL2','-lSDL2Main','-lmman','-ljson-c']
-app_ld_args += ['-Wl,--whole-archive']
-app_ld_args += [libdpdklinkflags.stdout().strip().split()]
-app_ld_args += ['-Wl,--no-whole-archive']
+  app_ld_args += ['-lmingw32','-lws2_32','-lDbghelp','-lSetupapi','-ldinput8', '-ldxguid', '-ldxerr8', '-lwinmm', '-limm32','-lversion','-lwpcap','-lPacket','-lSDL2','-lSDL2Main','-lmman','-ljson-c','-ldl']
+  app_ld_args += ['-Wl,--whole-archive']
+  app_ld_args += [libdpdklinkflags.stdout().strip().split()]
+  app_ld_args += ['-Wl,--no-whole-archive']
 endif
 
-#build executable
+# build executable
 executable('RxTxApp', sources,
   c_args : app_c_args,
   link_args: app_ld_args,
-  dependencies: [libst_dpdk, libjson_c, libpcap, libsdl2]
+  dependencies: [libst_dpdk, libjson_c, libpcap, libsdl2, libsdl2_ttf, libm, libpthread]
 )
 
 executable('ConvApp', conv_sources,
   c_args : app_c_args,
   link_args: app_ld_args,
+  dependencies: [libst_dpdk, ]
 )
 
-executable('PerfRfc4175ToYuv422p10le', perf_rfc4175_to_yuv422p10le_sources,
+executable('PerfRfc4175422be10ToP10Le', perf_rfc4175_422be10_to_p10le_sources,
   c_args : app_c_args,
   link_args: app_ld_args,
-  dependencies: [libst_dpdk]
+  dependencies: [libst_dpdk, libpthread]
+)
+
+executable('PerfP10LeToRfc4175422be10', perf_p10le_to_rfc4175_422be10_sources,
+  c_args : app_c_args,
+  link_args: app_ld_args,
+  dependencies: [libst_dpdk, libpthread]
 )
 
 executable('PerfRfc4175422be10ToLe', perf_rfc4175_422be10_to_le_sources,
   c_args : app_c_args,
   link_args: app_ld_args,
-  dependencies: [libst_dpdk]
+  dependencies: [libst_dpdk, libpthread]
+)
+
+executable('PerfRfc4175422le10ToBe', perf_rfc4175_422le10_to_be_sources,
+  c_args : app_c_args,
+  link_args: app_ld_args,
+  dependencies: [libst_dpdk, libpthread]
 )
 
 executable('PerfRfc4175422be10ToLe8', perf_rfc4175_422be10_to_le8_sources,
   c_args : app_c_args,
   link_args: app_ld_args,
-  dependencies: [libst_dpdk]
+  dependencies: [libst_dpdk, libpthread]
 )
 
 executable('PerfRfc4175422be10ToV210', perf_rfc4175_422be10_to_v210_sources,
   c_args : app_c_args,
   link_args: app_ld_args,
-  dependencies: [libst_dpdk]
+  dependencies: [libst_dpdk, libpthread]
+)
+
+executable('PerfV210ToRfc4175422be10', perf_v210_to_rfc4175_422be10_sources,
+  c_args : app_c_args,
+  link_args: app_ld_args,
+  dependencies: [libst_dpdk, libpthread]
 )
 
 executable('TxVideoSample', video_tx_sample_sources,
   c_args : app_c_args,
   link_args: app_ld_args,
-  dependencies: [libst_dpdk]
+  dependencies: [libst_dpdk, libpthread]
 )
 
 executable('TxRtpVideoSample', video_tx_rtp_sample_sources,
   c_args : app_c_args,
   link_args: app_ld_args,
-  dependencies: [libst_dpdk]
+  dependencies: [libst_dpdk, libpthread]
 )
 
 executable('RxVideoSample', video_rx_sample_sources,
   c_args : app_c_args,
   link_args: app_ld_args,
-  dependencies: [libst_dpdk]
+  dependencies: [libst_dpdk, libpthread]
 )
 
 executable('RxRtpVideoSample', video_rx_rtp_sample_sources,
   c_args : app_c_args,
   link_args: app_ld_args,
-  dependencies: [libst_dpdk]
+  dependencies: [libst_dpdk, libpthread]
 )
 
 executable('TxSt22VideoSample', video_tx_st22_sample_sources,
   c_args : app_c_args,
   link_args: app_ld_args,
-  dependencies: [libst_dpdk]
+  dependencies: [libst_dpdk, libpthread]
 )
 
 executable('RxSt22VideoSample', video_rx_st22_sample_sources,
   c_args : app_c_args,
   link_args: app_ld_args,
-  dependencies: [libst_dpdk]
+  dependencies: [libst_dpdk, libpthread]
+)
+
+executable('TxSt22PipelineSample', pipeline_tx_st22_sample_sources,
+  c_args : app_c_args,
+  link_args: app_ld_args,
+  dependencies: [libst_dpdk, libpthread]
+)
+
+executable('RxSt22PipelineSample', pipeline_rx_st22_sample_sources,
+  c_args : app_c_args,
+  link_args: app_ld_args,
+  dependencies: [libst_dpdk, libpthread]
 )
 
 executable('RxSliceVideoSample', video_rx_slice_sample_sources,
   c_args : app_c_args,
   link_args: app_ld_args,
-  dependencies: [libst_dpdk]
+  dependencies: [libst_dpdk, libpthread]
 )
 
 executable('TxSliceVideoSample', video_tx_slice_sample_sources,
   c_args : app_c_args,
   link_args: app_ld_args,
-  dependencies: [libst_dpdk]
+  dependencies: [libst_dpdk, libpthread]
+)
+
+executable('RxSt20TxSt22Fwd', rx_st20_tx_st22_fwd_sources,
+  c_args : app_c_args,
+  link_args: app_ld_args,
+  dependencies: [libst_dpdk, libpthread]
+)
+
+executable('RxSt20TxSt20Fwd', rx_st20_tx_st20_fwd_sources,
+  c_args : app_c_args,
+  link_args: app_ld_args,
+  dependencies: [libst_dpdk, libpthread]
 )
 
 executable('DmaSample', dma_sample_sources,
@@ -166,4 +224,4 @@ executable('PerfDma', perf_dma_sources,
   c_args : app_c_args,
   link_args: app_ld_args,
   dependencies: [libst_dpdk]
-)
+)

app/perf/meson.build

@@ -11,8 +11,11 @@
 # express or implied warranties, other than those that are expressly stated
 # in the License.
 
-perf_rfc4175_to_yuv422p10le_sources = files('rfc4175_to_yuv422p10le.c')
+perf_rfc4175_422be10_to_p10le_sources = files('rfc4175_422be10_to_p10le.c')
+perf_p10le_to_rfc4175_422be10_sources = files('p10le_to_rfc4175_422be10.c')
 perf_rfc4175_422be10_to_le_sources = files('rfc4175_422be10_to_le.c')
+perf_rfc4175_422le10_to_be_sources = files('rfc4175_422le10_to_be.c')
 perf_rfc4175_422be10_to_le8_sources = files('rfc4175_422be10_to_le8.c')
 perf_rfc4175_422be10_to_v210_sources = files('rfc4175_422be10_to_v210.c')
-perf_dma_sources = files('perf_dma.c')
+perf_v210_to_rfc4175_422be10_sources = files('v210_to_rfc4175_422be10.c')
+perf_dma_sources = files('perf_dma.c')