Skip to navigation

This page covers NIM service chart Helm values and environment variables specific to the LipSync pipeline, including model options, media format, and SMPTE ST 2110 session wiring.


LipSync Model and Ancillary Options

ConfigurationHelm KeyComment
Head movement speedmodel.headMovementSpeedModel tuning; default (chart): 0.
Ancillary data inputinput.ancillaryData.enabled, input.ancillaryData.sessionNameOptional ST 2110-40 / SMPTE 291–style metadata input for multi-subject targeting.
Bounding box on output videooutput.boundingBoxEnabledWhen ancillary data input is enabled, draws a bounding box on the active speaker in the output program video.

Video Raster

The video raster defines the fixed picture format of the incoming SMPTE ST 2110-20 stream. These Helm keys specify the raster of the incoming video so that decoding, audio sync, and inference stay consistent.

ConfigurationHelm KeyComment
Width and heightvideo.width, video.heightResolutions: 720p, 1080p, 4K UHD; refer to Support Matrix and Helm Configuration Parameters.
Frame ratevideo.framerateNum, video.framerateDenMust match the upstream sender and downstream receiver.

Audio Format

ConfigurationHelm KeyComment
PCM formataudio.pcmFormatExample: S24BE.
Sample rateaudio.samplingRateExample: 48000 Hz.
Channelsaudio.numChannelsExample: 1; supports a single stream.

SMPTE ST 2110 (Static Mode) Input Sessions

ConfigurationHelm KeyComment
Video sessioninput.video.sessionName, input.video.localInterfaceName, input.video.hostIp, input.video.hostPortSite-specific multicast IP address and port.
Audio sessioninput.audio.sessionName, input.audio.localInterfaceName, input.audio.hostIp, input.audio.hostPortMulticast interface wiring for the incoming audio ST 2110 session.
Ancillary sessioninput.ancillaryData.enabled, input.ancillaryData.sessionName, input.ancillaryData.localInterfaceName, input.ancillaryData.hostIp, input.ancillaryData.hostPortOptional; default (chart): enabled: false: multicast interface wiring for ancillary ST 2110 when enabled.

SMPTE ST 2110 (Static Mode) Output Sessions

ConfigurationHelm KeyComment
Video outoutput.video.sessionName, output.video.localInterfaceName, output.video.hostIp, output.video.hostPortLipSync output video: site-specific multicast session, interface, IP address, and port.
Bounding box overlayoutput.boundingBoxEnabledWith ancillary data input enabled, draws the active speaker bounding box on program video; refer to LipSync Model and Ancillary Options.

NIM Pod Resources

ResourceRequestsLimits
cpu88
hugepages-2Mi4Gi4Gi
memory8Gi8Gi
nvidia.com/gpu11

The cpu value is set to 8 cores by default, tuned for real-time ST 2110 performance. You can reduce it, but the value must be consistent with env.CPU_AFFINITY.

env.CPU_AFFINITY (default "2-7") pins the NIM process to a contiguous range of CPU cores. The chart validates at deploy time that the values of resources.requests.cpu and resources.limits.cpu are each equal to or greater than the number of cores in the affinity range.

SettingHelm KeyDefault
CPU affinity rangeenv.CPU_AFFINITY"2-7" (6 cores)

The default value of cpu (8) is intentionally greater than CPU_AFFINITY ("2-7", 6 cores): The pinned range covers the NIM workload minimum, and the remaining cores are available to Kubernetes. To configure cores, keep resources.requests.cpu, resources.limits.cpu, and env.CPU_AFFINITY aligned. If cpu falls below the affinity range, the chart fails during installation with a descriptive error.


Logging

ConfigurationHelm KeyComment
Log levellogging.levelRange: 0–4. 0 FATAL, 1 ERROR, 2 WARNING, 3 INFO (default), 4 DEBUG.

See Also