Skip to navigation

This page covers Helm values that apply to any Holoscan for Media NIM service chart deployment. The same keys appear under nvidia-active-speaker-detection-h4m-service.<key> when the NIM is deployed as part of the end-to-end demo chart.


Global Overrides

Both the NIM service chart and the end-to-end sample (umbrella) chart expose a global section. When a global value is non-empty, it overrides the corresponding per-component key for all subcharts (sender, receiver, and NIM service). Leave a value as "" to use each component’s own setting instead.

ConfigurationHelm KeyOverridesComment
Node placementglobal.nodeSelector.hostname<component>.nodeSelector.hostnameSchedule all pods on the same node.
Image pull secretglobal.image.secret<component>.image.secretSingle docker-registry secret name for nvcr.io across all components.
Multus networkglobal.network.name<component>.network.nameNetworkAttachmentDefinition name; must match for ST 2110 traffic.
Schedulerglobal.schedulerName<component>.schedulerNamePod spec.schedulerName for all components.
HTTP endpoint service typeglobal.service.type<component>.service.typeKubernetes Service type for each component endpoint (sender, receiver, NIM). Supported values: ClusterIP, NodePort, LoadBalancer. Default: NodePort. Use ClusterIP for internal access only and LoadBalancer for external access.

Use global values when deploying the umbrella chart so that node selector, pull secret, network, and scheduler need to be specified only once instead of per component.


Cluster and Workload

ConfigurationHelm KeyComment
Deploy NIM workloadenabledDefault: chart-dependent; set false to skip NIM (for example, partial demo chart installation).
Name prefixappNameDeployment and pod naming.
ReplicasreplicasDefault: 1 for GPU media functions.
Node placementnodeSelector.hostnameMatches kubernetes.io/hostname (or cluster labels).
SchedulerschedulerNameDefault: topo-aware-scheduler.
Container imageimage.repository, image.tagPublished NIM image.
Image pull secretimage.secretdocker-registry secret name for nvcr.io.
Container securitycontainerSecurityContext.*runAsUser, runAsGroup, runAsNonRoot, allowPrivilegeEscalation, capabilities.
Multus network attachmentnetwork.nameDefault: media-a-tx-net; must match your NetworkAttachmentDefinition name.

NGC and Model Download

ConfigurationHelm KeyComment
Model download secretngcModelDownload.secretNameSecret containing NGC_API_KEY.
Secret key namengcModelDownload.secretKeyDefault: NGC_API_KEY.

Model Cache and Logs PVCs

ConfigurationHelm KeyComment
Model cache PVCnimModelCache.*Default path: /opt/nim/.cache.
NIM logs PVCnimLogs.*Default path: /workspace/nim-logs.

Subkeys: enabled, create, size, storageClassName, mountPath, readOnly, subPath. For configuration examples, refer to Advanced Usage.


NMOS

ConfigurationHelm KeyEnvironment VariableComment
NMOS discovery modenmos.enabledAI4M_NMOS_ENABLEDtrue or false; false requires SMPTE ST 2110 static only (fixed IP addresses, ports, sessions).
Advertised hostnamenmos.hostname—mDNS / NMOS IS-04.
Descriptionnmos.description—NMOS description string.
Labelnmos.label—NMOS label string.

NMOS HTTP port 9010 and the Multus network attachment media-a-tx-net are often set in chart templates—confirm for your chart version.


(ancillary-data-payload)=

Ancillary Data Payload

The Active Speaker Detection NIM emits per-frame results on SMPTE ST 2110-40 ancillary data. The application payload is a fixed layout (typically 312 bytes) for up to 12 bounding boxes. Use this reference when parsing ancillary packets in a custom receiver or test harness.

For session and Helm wiring, refer to Pipeline Configuration and Operator Configuration.

Binary Layout (Typical)

Offset (bytes)MemberSize (bytes)
0bounding_boxes[0] (BBox)16
16bounding_boxes[1]16
………
176bounding_boxes[11]16
Subtotal BBox[12]192
192tracking_id[0..11] (uint16)24
216audio_id[0..11] (int16)24
240confidence[0..11] (float)48
288is_speaking[0..11] (uint8)12
300num_bboxes (uint8)1
301–303(padding)3
304seq_no (uint64_t)8
Total (typical)312

Three bytes of padding at offsets 301–303 align the following seq_no field to an 8-byte boundary.

Offsets and total size are typical for the preceding layout. If you rely on this layout in production tools, confirm against your NIM release.


See Also