test-case: add test jack detection in D3

Add a new test case to test jack detection when DSP is in D3.
For unplug/plug headset jack is using a USB relay.
https://github.com/darrylb123/usbrelay

Signed-off-by: Wilczak <arturx.wilczak@intel.com>

Author: arikgreen

test-case/test-jack-detection-suspend.sh

@@ -0,0 +1,151 @@
+#!/bin/bash
+
+# SPDX-License-Identifier: BSD-3-Clause
+# Copyright(c) 2025 Intel Corporation. All rights reserved.
+
+source "$(dirname "${BASH_SOURCE[0]}")"/../case-lib/lib.sh
+
+OPT_NAME['t']='tplg'     OPT_DESC['t']="tplg file, default value is env TPLG: $TPLG"
+OPT_HAS_ARG['t']=1         OPT_VAL['t']="$TPLG"
+
+OPT_NAME['r']='round'     OPT_DESC['r']='round count'
+OPT_HAS_ARG['r']=1         OPT_VAL['r']=1
+
+OPT_NAME['d']='duration' OPT_DESC['d']='arecord duration in second'
+OPT_HAS_ARG['d']=1         OPT_VAL['d']=2
+
+OPT_NAME['l']='loop'     OPT_DESC['l']='option of speaker-test'
+OPT_HAS_ARG['l']=1         OPT_VAL['l']=3
+
+OPT_NAME['s']='sof-logger'   OPT_DESC['s']="Open sof-logger trace the data will store at $LOG_ROOT"
+OPT_HAS_ARG['s']=0             OPT_VAL['s']=1
+
+OPT_NAME['x']='relay'     OPT_DESC['x']='name of usbrelay switch, default value is HURTM_2'
+OPT_HAS_ARG['x']=1         OPT_VAL['x']="HURTM_2"
+
+func_opt_parse_option "$@"
+
+tplg=${OPT_VAL['t']}
+duration=${OPT_VAL['d']}
+relay=${OPT_VAL['x']}
+tcnt=${OPT_VAL['l']}
+round_cnt=${OPT_VAL['r']}
+
+FIVE_SECONDS=5
+
+check_control_switch_state()
+{
+    # Check the state of the switch using amixer.
+    # The switch name is passed as the first argument, and the expected state (on/off)
+    # is passed as the second argument.
+    # Returns 0 if the state matches, 1 otherwise.
+    local switch_name="$1"
+    local expected_switch_state="$2"
+    local switch_state
+
+    switch_state=$(echo -e $(amixer -c 0 contents | grep -i "$switch_name .* *jack" -A 2) | sed -n '1s/^.*values=//p')
+    dlogi "$switch_name switch is: $switch_state"
+
+    if [[ "$expected_switch_state" == "$switch_state" ]]; then
+        return 0
+    else
+        return 1
+    fi
+}
+
+# func_check_dsp_status()
+# {
+#     dlogi "wait dsp power status to become suspended"
+#     for i in $(seq 1 $1)
+#     do
+#         # Here we pass a hardcoded 0 to python script, and need to ensure
+#         # DSP is the first audio pci device in 'lspci', this is true unless
+#         # we have a third-party pci sound card installed.
+#         [[ $(sof-dump-status.py --dsp_status 0) == "suspended" ]] && break
+#         sleep 1
+#         if [ $i -eq $1 ]; then
+#             die "dsp is not suspended after $1s, end test"
+#         fi
+#     done
+#     dlogi "dsp suspended in ${i}s"
+# }
+
+main()
+{
+    # logger_disabled || func_lib_start_log_collect
+    start_test
+    
+    setup_kernel_check_point
+    func_pipeline_export "$tplg" "type:playback"
+
+    # check if usbrelay tool is installed
+    command -v usbrelay >/dev/null 2>&1 || {
+        skip_test "usbrelay command not found. Please install usbrelay to control the mic privacy switch."
+    }
+
+    dlogi "Current DSP status is $(sof-dump-status.py --dsp_status 0)" || {
+        skip_test "platform doesn't support runtime pm, skip test case"
+    }
+    
+    # dlogi "Reset - plug jack audio"
+    # usbrelay_switch "$relay" 0
+
+    for round in $(seq 1 "$round_cnt")
+    do
+        for idx in $(seq 0 $((PIPELINE_COUNT - 1)))
+        do
+            initialize_audio_params "$idx"
+
+            [[ "$pcm" == *Jack* ]] || {
+                dlogi "PCM $pcm is not a Jack, skipping..."
+                continue
+            }
+            
+            dlogi "===== Testing: (Round: $round/$round_cnt) (PCM: $pcm [$dev]<$type>) ====="
+            dlogi "DEVICE: $dev, TYPE: $type, PCM: $pcm, RATE: $rate, CHANNEL: $channel"
+
+            # aplay_opts -D"$dev" -r "$rate" -c "$channel" -f "$fmt" -d "$duration" "/dev/zero" -q || {
+            #     func_lib_lsof_error_dump "$snd"
+            #     die "aplay on PCM $dev failed."
+            # }
+
+            dlogi "Current DSP status is $(sof-dump-status.py --dsp_status 0)"
+
+            dlogi "Unplug jack audio."
+            usbrelay_switch "$relay" 1
+
+            dlogi "Wait for $FIVE_SECONDS to ensure jack detection is off"
+            sleep $FIVE_SECONDS
+
+            check_control_switch_state "headset" "off" || {
+                die "unplug headset jack failed."
+            }
+
+            check_control_switch_state "headphone" 'off' || {
+                die "unplug headphone jack failed."
+            }
+
+            dlogi "Current DSP status is $(sof-dump-status.py --dsp_status 0)"
+
+            dlogi "Plug jack audio."
+            usbrelay_switch "$relay" 0
+
+            dlogi "Wait for $FIVE_SECONDS to ensure jack detection is on"
+            sleep $FIVE_SECONDS
+
+            check_control_switch_state "headset" "on" || {
+                die "Plug headset jack failed."
+            }
+
+            check_control_switch_state "headphone" "on" || {
+                die "Plug headphone jack failed."
+            }
+        done
+    done
+
+    sof-kernel-log-check.sh "$KERNEL_CHECKPOINT"
+}
+
+{
+    main "$@"; exit "$?"
+}