Ubuntu Certified Docking Stations Coverage for 22.04 LTS¶

Introduction¶

Although docking stations are currently out of scope of the general Ubuntu Desktop Certified Hardware programme at Canonical, we have an extension to the programme to enable and certify a particular docking station with an already Ubuntu certified system. This programme does not certify a particular docking station to work with all Ubuntu certified systems, nor will a docking station be tested and/or certified in isolation, but always as part of the certification of a full system.

This document lists the coverage for certification of docking stations for Ubuntu Desktop 22.04 LTS. This coverage will remain as it is for Ubuntu Desktop 22.04 LTS through the life cycle of Ubuntu Desktop 22.04 LTS.

For each test job, one of the following certification statuses is specified:

Blocking: Features that are required for certification. If any of the blocking tests fails, the certification will fail.
Non-blocking: Features that are tested but not mandatory for certification. Failure in non-blocking tests will not prevent certification. However, a note will be added to the certificate to inform potential customers or users.

Note

Only categories of hardware are tested and not specific types of hardware. For example, tests are run to verify USB controllers work, but the type of peripheral(s) used during those tests are not specified.

Coverage is flexible based on customer requirements (for example, if a device’s use cases don’t require LEDs, then LEDs can be non-blocking)

Full test descriptions can be found in Canonical certification site for partners:

https://certification.canonical.com

Note

At the time of this writing, only wired docks are supported. Wireless docking requires functionality that is not known to be supported by IHVs.

Note

This also does not cover “smart” docks, i.e. docks that contain additional components (like graphics adapters, etc.).

Main testing flow¶

Once the connected components like DP monitors, HDMI monitors, and ethernet cables have been plugged, they will remain plugged in throughout testing. However, for user-removable components such as USB drives or Thunderbolt storage devices, hotplugging functionality will be tested. The testing process will follow a flow similar to:

Plug all the components into the docking station
Unplug the storage when meet the storage test
Start storage testing(Insert, auto, remove)
Plug it back when finish the storage test

dock-cert-full¶

Note

The certification tests presented in this document are validated by Checkbox version 4.2.0.dev76.

Blocking¶

Docking station audio tests¶

Output sound needs to be undistorted between 0%-100%. Output lines tested:

3.5mm headphones
HDMI audio output
DisplayPort audio output

Input needs to be recorded undistorted between 0%-100%. Input lines tested:

3.5mm microphone

The following test units are covered in this category:

dock/all-hotplug-audio-alsa-record-playback-external

External microphone plugged to the dock to record sound test

Category ID:	dock-audio
Status:	Blocking
Purpose:	This test will check that recording sound using an external microphone works correctly. (Skip this test if the dock does not have a microphone connector)
Steps:	Connect a microphone to the dock’s microphone port. 2. Go to the Sound settings and make sure the correct Output is selected. 3. Click “Test”, then speak into the external microphone. 4. After a few seconds, your speech will be played back to you.
Verification:	Did you hear your speech played back?
After-suspend:	True
Plugin:	user-interact-verify

dock/all-hotplug-audio-microphone-plug-detection

Microphone recognized when plugged to the dock test

Category ID:	dock-audio
Status:	Blocking
Purpose:	Check that system detects a microphone being plugged in. (Skip this test if the dock does not have a microphone connector)
Steps:	Prepare a microphone with a standard 3.5mm jack. 2. Locate the microphone jack on the dock under test. Keep in mind that it may be shared with the headphone jack. 3. Run the test (you have 30 seconds from now on) 4. Plug the microphone into the appropriate jack. 5. Unplug the device for subsequent tests.
Verification:	Verification is automatic, no action is required. The test times out after 30 seconds (and fails in that case).
Plugin:	user-interact

dock/all-hotplug-audio-playback-headphones

Headphones output test

Category ID:	dock-audio
Status:	Blocking
Purpose:	This test will check that headphones connector works correctly. (Skip this test if there is no headphone connector on the dock)
Steps:	Connect a pair of headphones to the dock. 2. Go to the Sound settings and make sure the correct Output is selected. 3. Click the Test button to play a sound to your audio device.
Verification:	Did you hear a sound through the headphones and did the sound play without any distortion, clicks or other strange noises from your headphones?
After-suspend:	True
Plugin:	user-interact-verify

dock/all-hotplug-audio-speaker-headphone-plug-detection

Headphones recognized when plugged to the dock test

Category ID:	dock-audio
Status:	Blocking
Purpose:	Check that system detects speakers or headphones being plugged in. (Skip this test if the dock does not have headphones connector)
Steps:	Prepare a pair of headphones or speakers with a standard 3.5mm jack. 2. Locate the speaker / headphone jack on the dock under test. 3. Run the test (you have 30 seconds from now on). 4. Plug headphones or speakers into the appropriate jack. 5. Unplug the device for subsequent tests.
Verification:	Verification is automatic, no action is required. The test times out after 30 seconds (and fails in that case).
Plugin:	user-interact

dock/all-hotplug-monitor-multi-head-audio-playback

Multiple monitor audio test

Category ID:	dock-audio
Status:	Blocking
Purpose:	This test is to check if every external monitor on the dock can play sound.
Steps:	Launch the test to play sound on every monitor.
Verification:	Can every external monitor play sound? If no sound output, try: 1. Go to Settings > Sound > Output > Test > Try Front Left and Front Right. 2. Repeat Step 1 for each monitor.
Plugin:	user-interact-verify

dock/all-init-audio-alsa-record-playback-external

External microphone plugged to the dock to record sound test

Category ID:	dock-audio
Status:	Blocking
Purpose:	This test will check that recording sound using an external microphone works correctly. (Skip this test if the dock does not have a microphone connector)
Steps:	Connect a microphone to the dock’s microphone port. 2. Go to the Sound settings and make sure the correct Output is selected. 3. Click “Test”, then speak into the external microphone. 4. After a few seconds, your speech will be played back to you.
Verification:	Did you hear your speech played back?
After-suspend:	True
Plugin:	user-interact-verify

dock/all-init-audio-microphone-plug-detection

Microphone recognized when plugged to the dock test

Category ID:	dock-audio
Status:	Blocking
Purpose:	Check that system detects a microphone being plugged in. (Skip this test if the dock does not have a microphone connector)
Steps:	Prepare a microphone with a standard 3.5mm jack. 2. Locate the microphone jack on the dock under test. Keep in mind that it may be shared with the headphone jack. 3. Run the test (you have 30 seconds from now on) 4. Plug the microphone into the appropriate jack. 5. Unplug the device for subsequent tests.
Verification:	Verification is automatic, no action is required. The test times out after 30 seconds (and fails in that case).
Plugin:	user-interact

dock/all-init-audio-playback-headphones

Headphones output test

Category ID:	dock-audio
Status:	Blocking
Purpose:	This test will check that headphones connector works correctly. (Skip this test if there is no headphone connector on the dock)
Steps:	Connect a pair of headphones to the dock. 2. Go to the Sound settings and make sure the correct Output is selected. 3. Click the Test button to play a sound to your audio device.
Verification:	Did you hear a sound through the headphones and did the sound play without any distortion, clicks or other strange noises from your headphones?
After-suspend:	True
Plugin:	user-interact-verify

dock/all-init-audio-speaker-headphone-plug-detection

Headphones recognized when plugged to the dock test

Category ID:	dock-audio
Status:	Blocking
Purpose:	Check that system detects speakers or headphones being plugged in. (Skip this test if the dock does not have headphones connector)
Steps:	Prepare a pair of headphones or speakers with a standard 3.5mm jack. 2. Locate the speaker / headphone jack on the dock under test. 3. Run the test (you have 30 seconds from now on). 4. Plug headphones or speakers into the appropriate jack. 5. Unplug the device for subsequent tests.
Verification:	Verification is automatic, no action is required. The test times out after 30 seconds (and fails in that case).
Plugin:	user-interact

dock/all-init-monitor-multi-head-audio-playback

Multiple monitor audio test

Category ID:	dock-audio
Status:	Blocking
Purpose:	This test is to check if every external monitor on the dock can play sound.
Steps:	Launch the test to play sound on every monitor.
Verification:	Can every external monitor play sound? If no sound output, try: 1. Go to Settings > Sound > Output > Test > Try Front Left and Front Right. 2. Repeat Step 1 for each monitor.
Plugin:	user-interact-verify

dock/all-poweroff-audio-alsa-record-playback-external

External microphone plugged to the dock to record sound test

Category ID:	dock-audio
Status:	Blocking
Purpose:	This test will check that recording sound using an external microphone works correctly. (Skip this test if the dock does not have a microphone connector)
Steps:	Connect a microphone to the dock’s microphone port. 2. Go to the Sound settings and make sure the correct Output is selected. 3. Click “Test”, then speak into the external microphone. 4. After a few seconds, your speech will be played back to you.
Verification:	Did you hear your speech played back?
After-suspend:	True
Plugin:	user-interact-verify

dock/all-poweroff-audio-microphone-plug-detection

Microphone recognized when plugged to the dock test

Category ID:	dock-audio
Status:	Blocking
Purpose:	Check that system detects a microphone being plugged in. (Skip this test if the dock does not have a microphone connector)
Steps:	Prepare a microphone with a standard 3.5mm jack. 2. Locate the microphone jack on the dock under test. Keep in mind that it may be shared with the headphone jack. 3. Run the test (you have 30 seconds from now on) 4. Plug the microphone into the appropriate jack. 5. Unplug the device for subsequent tests.
Verification:	Verification is automatic, no action is required. The test times out after 30 seconds (and fails in that case).
Plugin:	user-interact

dock/all-poweroff-audio-playback-headphones

Headphones output test

Category ID:	dock-audio
Status:	Blocking
Purpose:	This test will check that headphones connector works correctly. (Skip this test if there is no headphone connector on the dock)
Steps:	Connect a pair of headphones to the dock. 2. Go to the Sound settings and make sure the correct Output is selected. 3. Click the Test button to play a sound to your audio device.
Verification:	Did you hear a sound through the headphones and did the sound play without any distortion, clicks or other strange noises from your headphones?
After-suspend:	True
Plugin:	user-interact-verify

dock/all-poweroff-audio-speaker-headphone-plug-detection

Headphones recognized when plugged to the dock test

Category ID:	dock-audio
Status:	Blocking
Purpose:	Check that system detects speakers or headphones being plugged in. (Skip this test if the dock does not have headphones connector)
Steps:	Prepare a pair of headphones or speakers with a standard 3.5mm jack. 2. Locate the speaker / headphone jack on the dock under test. 3. Run the test (you have 30 seconds from now on). 4. Plug headphones or speakers into the appropriate jack. 5. Unplug the device for subsequent tests.
Verification:	Verification is automatic, no action is required. The test times out after 30 seconds (and fails in that case).
Plugin:	user-interact

dock/all-poweroff-monitor-multi-head-audio-playback

Multiple monitor audio test

Category ID:	dock-audio
Status:	Blocking
Purpose:	This test is to check if every external monitor on the dock can play sound.
Steps:	Launch the test to play sound on every monitor.
Verification:	Can every external monitor play sound? If no sound output, try: 1. Go to Settings > Sound > Output > Test > Try Front Left and Front Right. 2. Repeat Step 1 for each monitor.
Plugin:	user-interact-verify

dock/all-reboot-audio-alsa-record-playback-external

External microphone plugged to the dock to record sound test

Category ID:	dock-audio
Status:	Blocking
Purpose:	This test will check that recording sound using an external microphone works correctly. (Skip this test if the dock does not have a microphone connector)
Steps:	Connect a microphone to the dock’s microphone port. 2. Go to the Sound settings and make sure the correct Output is selected. 3. Click “Test”, then speak into the external microphone. 4. After a few seconds, your speech will be played back to you.
Verification:	Did you hear your speech played back?
After-suspend:	True
Plugin:	user-interact-verify

dock/all-reboot-audio-microphone-plug-detection

Microphone recognized when plugged to the dock test

Category ID:	dock-audio
Status:	Blocking
Purpose:	Check that system detects a microphone being plugged in. (Skip this test if the dock does not have a microphone connector)
Steps:	Prepare a microphone with a standard 3.5mm jack. 2. Locate the microphone jack on the dock under test. Keep in mind that it may be shared with the headphone jack. 3. Run the test (you have 30 seconds from now on) 4. Plug the microphone into the appropriate jack. 5. Unplug the device for subsequent tests.
Verification:	Verification is automatic, no action is required. The test times out after 30 seconds (and fails in that case).
Plugin:	user-interact

dock/all-reboot-audio-playback-headphones

Headphones output test

Category ID:	dock-audio
Status:	Blocking
Purpose:	This test will check that headphones connector works correctly. (Skip this test if there is no headphone connector on the dock)
Steps:	Connect a pair of headphones to the dock. 2. Go to the Sound settings and make sure the correct Output is selected. 3. Click the Test button to play a sound to your audio device.
Verification:	Did you hear a sound through the headphones and did the sound play without any distortion, clicks or other strange noises from your headphones?
After-suspend:	True
Plugin:	user-interact-verify

dock/all-reboot-audio-speaker-headphone-plug-detection

Headphones recognized when plugged to the dock test

Category ID:	dock-audio
Status:	Blocking
Purpose:	Check that system detects speakers or headphones being plugged in. (Skip this test if the dock does not have headphones connector)
Steps:	Prepare a pair of headphones or speakers with a standard 3.5mm jack. 2. Locate the speaker / headphone jack on the dock under test. 3. Run the test (you have 30 seconds from now on). 4. Plug headphones or speakers into the appropriate jack. 5. Unplug the device for subsequent tests.
Verification:	Verification is automatic, no action is required. The test times out after 30 seconds (and fails in that case).
Plugin:	user-interact

dock/all-reboot-monitor-multi-head-audio-playback

Multiple monitor audio test

Category ID:	dock-audio
Status:	Blocking
Purpose:	This test is to check if every external monitor on the dock can play sound.
Steps:	Launch the test to play sound on every monitor.
Verification:	Can every external monitor play sound? If no sound output, try: 1. Go to Settings > Sound > Output > Test > Try Front Left and Front Right. 2. Repeat Step 1 for each monitor.
Plugin:	user-interact-verify

dock/all-suspend-audio-alsa-record-playback-external

External microphone plugged to the dock to record sound test

Category ID:	dock-audio
Status:	Blocking
Purpose:	This test will check that recording sound using an external microphone works correctly. (Skip this test if the dock does not have a microphone connector)
Steps:	Connect a microphone to the dock’s microphone port. 2. Go to the Sound settings and make sure the correct Output is selected. 3. Click “Test”, then speak into the external microphone. 4. After a few seconds, your speech will be played back to you.
Verification:	Did you hear your speech played back?
After-suspend:	True
Plugin:	user-interact-verify

dock/all-suspend-audio-microphone-plug-detection

Microphone recognized when plugged to the dock test

Category ID:	dock-audio
Status:	Blocking
Purpose:	Check that system detects a microphone being plugged in. (Skip this test if the dock does not have a microphone connector)
Steps:	Prepare a microphone with a standard 3.5mm jack. 2. Locate the microphone jack on the dock under test. Keep in mind that it may be shared with the headphone jack. 3. Run the test (you have 30 seconds from now on) 4. Plug the microphone into the appropriate jack. 5. Unplug the device for subsequent tests.
Verification:	Verification is automatic, no action is required. The test times out after 30 seconds (and fails in that case).
Plugin:	user-interact

dock/all-suspend-audio-playback-headphones

Headphones output test

Category ID:	dock-audio
Status:	Blocking
Purpose:	This test will check that headphones connector works correctly. (Skip this test if there is no headphone connector on the dock)
Steps:	Connect a pair of headphones to the dock. 2. Go to the Sound settings and make sure the correct Output is selected. 3. Click the Test button to play a sound to your audio device.
Verification:	Did you hear a sound through the headphones and did the sound play without any distortion, clicks or other strange noises from your headphones?
After-suspend:	True
Plugin:	user-interact-verify

dock/all-suspend-audio-speaker-headphone-plug-detection

Headphones recognized when plugged to the dock test

Category ID:	dock-audio
Status:	Blocking
Purpose:	Check that system detects speakers or headphones being plugged in. (Skip this test if the dock does not have headphones connector)
Steps:	Prepare a pair of headphones or speakers with a standard 3.5mm jack. 2. Locate the speaker / headphone jack on the dock under test. 3. Run the test (you have 30 seconds from now on). 4. Plug headphones or speakers into the appropriate jack. 5. Unplug the device for subsequent tests.
Verification:	Verification is automatic, no action is required. The test times out after 30 seconds (and fails in that case).
Plugin:	user-interact

dock/all-suspend-monitor-multi-head-audio-playback

Multiple monitor audio test

Category ID:	dock-audio
Status:	Blocking
Purpose:	This test is to check if every external monitor on the dock can play sound.
Steps:	Launch the test to play sound on every monitor.
Verification:	Can every external monitor play sound? If no sound output, try: 1. Go to Settings > Sound > Output > Test > Try Front Left and Front Right. 2. Repeat Step 1 for each monitor.
Plugin:	user-interact-verify

Docking station display tests¶

Multi-monitors should be supported following the specifications of the docking station and DUT. The amount of monitors and which ports are going to be used is not specified, it depends on the hardware limitation of the docking station and DUT.

The following test units are covered in this category:

dock/all-hotplug-monitor-multi-head

Dual monitors test while docked

Category ID:	dock-display
Status:	Blocking
Purpose:	This test is to verify that multi-monitor output works using the dock. You will need multiple external monitors to perform this test. Depends on the specification of the device to use 4K monitor or FHD monitor.
Steps:	Skip this test if your video card or the dock do not support multiple monitors. 1. If your dock provides more than one monitor outputs, connect multiple monitors. 2. Open the “Displays” tool (open the dash and search for “Displays”). 3. Configure your output to provide one desktop across all the monitors. 4. Open any application and drag its window from one monitor to the next.
Verification:	Was the stretched desktop displayed correctly across all the screens?
Plugin:	manual

dock/all-init-monitor-multi-head

Dual monitors test while docked

Category ID:	dock-display
Status:	Blocking
Purpose:	This test is to verify that multi-monitor output works using the dock. You will need multiple external monitors to perform this test. Depends on the specification of the device to use 4K monitor or FHD monitor.
Steps:	Skip this test if your video card or the dock do not support multiple monitors. 1. If your dock provides more than one monitor outputs, connect multiple monitors. 2. Open the “Displays” tool (open the dash and search for “Displays”). 3. Configure your output to provide one desktop across all the monitors. 4. Open any application and drag its window from one monitor to the next.
Verification:	Was the stretched desktop displayed correctly across all the screens?
Plugin:	manual

dock/all-poweroff-monitor-multi-head

Dual monitors test while docked

Category ID:	dock-display
Status:	Blocking
Purpose:	This test is to verify that multi-monitor output works using the dock. You will need multiple external monitors to perform this test. Depends on the specification of the device to use 4K monitor or FHD monitor.
Steps:	Skip this test if your video card or the dock do not support multiple monitors. 1. If your dock provides more than one monitor outputs, connect multiple monitors. 2. Open the “Displays” tool (open the dash and search for “Displays”). 3. Configure your output to provide one desktop across all the monitors. 4. Open any application and drag its window from one monitor to the next.
Verification:	Was the stretched desktop displayed correctly across all the screens?
Plugin:	manual

dock/all-reboot-monitor-multi-head

Dual monitors test while docked

Category ID:	dock-display
Status:	Blocking
Purpose:	This test is to verify that multi-monitor output works using the dock. You will need multiple external monitors to perform this test. Depends on the specification of the device to use 4K monitor or FHD monitor.
Steps:	Skip this test if your video card or the dock do not support multiple monitors. 1. If your dock provides more than one monitor outputs, connect multiple monitors. 2. Open the “Displays” tool (open the dash and search for “Displays”). 3. Configure your output to provide one desktop across all the monitors. 4. Open any application and drag its window from one monitor to the next.
Verification:	Was the stretched desktop displayed correctly across all the screens?
Plugin:	manual

dock/all-suspend-monitor-multi-head

Dual monitors test while docked

Category ID:	dock-display
Status:	Blocking
Purpose:	This test is to verify that multi-monitor output works using the dock. You will need multiple external monitors to perform this test. Depends on the specification of the device to use 4K monitor or FHD monitor.
Steps:	Skip this test if your video card or the dock do not support multiple monitors. 1. If your dock provides more than one monitor outputs, connect multiple monitors. 2. Open the “Displays” tool (open the dash and search for “Displays”). 3. Configure your output to provide one desktop across all the monitors. 4. Open any application and drag its window from one monitor to the next.
Verification:	Was the stretched desktop displayed correctly across all the screens?
Plugin:	manual

Docking station network tests¶

Ethernet (RJ-45 Network Jack). Connections are tested for functionality, but not for performance.

The following test units are covered in this category:

dock/all-hotplug-networking-gateway-ping

Ping test using dock’s Ethernet connectivity

Category ID:	dock-network
Status:	Blocking
Purpose:	Tests whether the system has a working Internet connection.
Steps:	Make sure the dock is connected to network using an Ethernet cable. 2. Make sure the laptop itself is not connected to any Ethernet cable. 3. Launch the test.
Verification:	Was the test able to ping the network using the Ethernet connection?
Plugin:	user-interact-verify

dock/all-hotplug-networking-ntp

NTP sync test using dock’s Ethernet connectivity

Category ID:	dock-network
Status:	Blocking
Purpose:	Test to see if we can sync local clock to an NTP server
Steps:	Make sure the dock is connected to network using an Ethernet cable. 2. Make sure the laptop itself is not connected to any Ethernet cable. 3. Launch the test.
Verification:	Was the test able to synchronize system time using the Ethernet connection?
User:	root
Plugin:	user-interact-verify

dock/all-init-networking-gateway-ping

Ping test using dock’s Ethernet connectivity

Category ID:	dock-network
Status:	Blocking
Purpose:	Tests whether the system has a working Internet connection.
Steps:	Make sure the dock is connected to network using an Ethernet cable. 2. Make sure the laptop itself is not connected to any Ethernet cable. 3. Launch the test.
Verification:	Was the test able to ping the network using the Ethernet connection?
Plugin:	user-interact-verify

dock/all-init-networking-ntp

NTP sync test using dock’s Ethernet connectivity

Category ID:	dock-network
Status:	Blocking
Purpose:	Test to see if we can sync local clock to an NTP server
Steps:	Make sure the dock is connected to network using an Ethernet cable. 2. Make sure the laptop itself is not connected to any Ethernet cable. 3. Launch the test.
Verification:	Was the test able to synchronize system time using the Ethernet connection?
User:	root
Plugin:	user-interact-verify

dock/all-poweroff-networking-gateway-ping

Ping test using dock’s Ethernet connectivity

Category ID:	dock-network
Status:	Blocking
Purpose:	Tests whether the system has a working Internet connection.
Steps:	Make sure the dock is connected to network using an Ethernet cable. 2. Make sure the laptop itself is not connected to any Ethernet cable. 3. Launch the test.
Verification:	Was the test able to ping the network using the Ethernet connection?
Plugin:	user-interact-verify

dock/all-poweroff-networking-ntp

NTP sync test using dock’s Ethernet connectivity

Category ID:	dock-network
Status:	Blocking
Purpose:	Test to see if we can sync local clock to an NTP server
Steps:	Make sure the dock is connected to network using an Ethernet cable. 2. Make sure the laptop itself is not connected to any Ethernet cable. 3. Launch the test.
Verification:	Was the test able to synchronize system time using the Ethernet connection?
User:	root
Plugin:	user-interact-verify

dock/all-reboot-networking-gateway-ping

Ping test using dock’s Ethernet connectivity

Category ID:	dock-network
Status:	Blocking
Purpose:	Tests whether the system has a working Internet connection.
Steps:	Make sure the dock is connected to network using an Ethernet cable. 2. Make sure the laptop itself is not connected to any Ethernet cable. 3. Launch the test.
Verification:	Was the test able to ping the network using the Ethernet connection?
Plugin:	user-interact-verify

dock/all-reboot-networking-ntp

NTP sync test using dock’s Ethernet connectivity

Category ID:	dock-network
Status:	Blocking
Purpose:	Test to see if we can sync local clock to an NTP server
Steps:	Make sure the dock is connected to network using an Ethernet cable. 2. Make sure the laptop itself is not connected to any Ethernet cable. 3. Launch the test.
Verification:	Was the test able to synchronize system time using the Ethernet connection?
User:	root
Plugin:	user-interact-verify

dock/all-suspend-networking-gateway-ping

Ping test using dock’s Ethernet connectivity

Category ID:	dock-network
Status:	Blocking
Purpose:	Tests whether the system has a working Internet connection.
Steps:	Make sure the dock is connected to network using an Ethernet cable. 2. Make sure the laptop itself is not connected to any Ethernet cable. 3. Launch the test.
Verification:	Was the test able to ping the network using the Ethernet connection?
Plugin:	user-interact-verify

dock/all-suspend-networking-ntp

NTP sync test using dock’s Ethernet connectivity

Category ID:	dock-network
Status:	Blocking
Purpose:	Test to see if we can sync local clock to an NTP server
Steps:	Make sure the dock is connected to network using an Ethernet cable. 2. Make sure the laptop itself is not connected to any Ethernet cable. 3. Launch the test.
Verification:	Was the test able to synchronize system time using the Ethernet connection?
User:	root
Plugin:	user-interact-verify

Docking station tests¶

The following test units are covered in this category:

dock/all-hotplug-thunderbolt3-insert

Thunderbolt3 storage insertion detection

Category ID:	dock
Status:	Blocking
Purpose:	This test will check if the connection of a Thunderbolt3 HDD to the dock could be detected
Steps:	Click ‘Test’ to begin the test. This test will timeout and fail if the insertion has not been detected within 40 seconds. 2. Plug a Thunderbolt3 HDD into an available Thunderbolt3 port on the dock. If it’s not mounted automatically, please click the HDD icon to mount it.
Verification:	The verification of this test is automated. Do not change the automatically selected result.
After-suspend:	True
Plugin:	user-interact

dock/all-hotplug-thunderbolt3-remove

Thunderbolt3 storage removal detection

Category ID:	dock
Status:	Blocking
Purpose:	This test will check the system can detect the removal of a Thunderbolt3 storage.
Steps:	Click ‘Test’ to begin the test. This test will timeout and fail if the removal has not been detected within 20 seconds. 2. Remove the previously attached Thunderbolt3 HDD from the Thunderbolt3 port.
Verification:	The verification of this test is automated. Do not change the automatically selected result
After-suspend:	True
Plugin:	user-interact

dock/all-hotplug-thunderbolt3-storage-automated

Thunderbolt3 storage test

Category ID:	dock
Status:	Blocking
Purpose:	<missing purpose>
Description:	This is an automated test which performs read/write operations on an attached Thunderbolt storage.
After-suspend:	True
User:	root
Plugin:	shell

dock/all-init-thunderbolt3-insert

Thunderbolt3 storage insertion detection

Category ID:	dock
Status:	Blocking
Purpose:	This test will check if the connection of a Thunderbolt3 HDD to the dock could be detected
Steps:	Click ‘Test’ to begin the test. This test will timeout and fail if the insertion has not been detected within 40 seconds. 2. Plug a Thunderbolt3 HDD into an available Thunderbolt3 port on the dock. If it’s not mounted automatically, please click the HDD icon to mount it.
Verification:	The verification of this test is automated. Do not change the automatically selected result.
After-suspend:	True
Plugin:	user-interact

dock/all-init-thunderbolt3-remove

Thunderbolt3 storage removal detection

Category ID:	dock
Status:	Blocking
Purpose:	This test will check the system can detect the removal of a Thunderbolt3 storage.
Steps:	Click ‘Test’ to begin the test. This test will timeout and fail if the removal has not been detected within 20 seconds. 2. Remove the previously attached Thunderbolt3 HDD from the Thunderbolt3 port.
Verification:	The verification of this test is automated. Do not change the automatically selected result
After-suspend:	True
Plugin:	user-interact

dock/all-init-thunderbolt3-storage-automated

Thunderbolt3 storage test

Category ID:	dock
Status:	Blocking
Purpose:	<missing purpose>
Description:	This is an automated test which performs read/write operations on an attached Thunderbolt storage.
After-suspend:	True
User:	root
Plugin:	shell

dock/all-poweroff-thunderbolt3-insert

Thunderbolt3 storage insertion detection

Category ID:	dock
Status:	Blocking
Purpose:	This test will check if the connection of a Thunderbolt3 HDD to the dock could be detected
Steps:	Click ‘Test’ to begin the test. This test will timeout and fail if the insertion has not been detected within 40 seconds. 2. Plug a Thunderbolt3 HDD into an available Thunderbolt3 port on the dock. If it’s not mounted automatically, please click the HDD icon to mount it.
Verification:	The verification of this test is automated. Do not change the automatically selected result.
After-suspend:	True
Plugin:	user-interact

dock/all-poweroff-thunderbolt3-remove

Thunderbolt3 storage removal detection

Category ID:	dock
Status:	Blocking
Purpose:	This test will check the system can detect the removal of a Thunderbolt3 storage.
Steps:	Click ‘Test’ to begin the test. This test will timeout and fail if the removal has not been detected within 20 seconds. 2. Remove the previously attached Thunderbolt3 HDD from the Thunderbolt3 port.
Verification:	The verification of this test is automated. Do not change the automatically selected result
After-suspend:	True
Plugin:	user-interact

dock/all-poweroff-thunderbolt3-storage-automated

Thunderbolt3 storage test

Category ID:	dock
Status:	Blocking
Purpose:	<missing purpose>
Description:	This is an automated test which performs read/write operations on an attached Thunderbolt storage.
After-suspend:	True
User:	root
Plugin:	shell

dock/all-reboot-thunderbolt3-insert

Thunderbolt3 storage insertion detection

Category ID:	dock
Status:	Blocking
Purpose:	This test will check if the connection of a Thunderbolt3 HDD to the dock could be detected
Steps:	Click ‘Test’ to begin the test. This test will timeout and fail if the insertion has not been detected within 40 seconds. 2. Plug a Thunderbolt3 HDD into an available Thunderbolt3 port on the dock. If it’s not mounted automatically, please click the HDD icon to mount it.
Verification:	The verification of this test is automated. Do not change the automatically selected result.
After-suspend:	True
Plugin:	user-interact

dock/all-reboot-thunderbolt3-remove

Thunderbolt3 storage removal detection

Category ID:	dock
Status:	Blocking
Purpose:	This test will check the system can detect the removal of a Thunderbolt3 storage.
Steps:	Click ‘Test’ to begin the test. This test will timeout and fail if the removal has not been detected within 20 seconds. 2. Remove the previously attached Thunderbolt3 HDD from the Thunderbolt3 port.
Verification:	The verification of this test is automated. Do not change the automatically selected result
After-suspend:	True
Plugin:	user-interact

dock/all-reboot-thunderbolt3-storage-automated

Thunderbolt3 storage test

Category ID:	dock
Status:	Blocking
Purpose:	<missing purpose>
Description:	This is an automated test which performs read/write operations on an attached Thunderbolt storage.
After-suspend:	True
User:	root
Plugin:	shell

dock/all-suspend-thunderbolt3-insert

Thunderbolt3 storage insertion detection

Category ID:	dock
Status:	Blocking
Purpose:	This test will check if the connection of a Thunderbolt3 HDD to the dock could be detected
Steps:	Click ‘Test’ to begin the test. This test will timeout and fail if the insertion has not been detected within 40 seconds. 2. Plug a Thunderbolt3 HDD into an available Thunderbolt3 port on the dock. If it’s not mounted automatically, please click the HDD icon to mount it.
Verification:	The verification of this test is automated. Do not change the automatically selected result.
After-suspend:	True
Plugin:	user-interact

dock/all-suspend-thunderbolt3-remove

Thunderbolt3 storage removal detection

Category ID:	dock
Status:	Blocking
Purpose:	This test will check the system can detect the removal of a Thunderbolt3 storage.
Steps:	Click ‘Test’ to begin the test. This test will timeout and fail if the removal has not been detected within 20 seconds. 2. Remove the previously attached Thunderbolt3 HDD from the Thunderbolt3 port.
Verification:	The verification of this test is automated. Do not change the automatically selected result
After-suspend:	True
Plugin:	user-interact

dock/all-suspend-thunderbolt3-storage-automated

Thunderbolt3 storage test

Category ID:	dock
Status:	Blocking
Purpose:	<missing purpose>
Description:	This is an automated test which performs read/write operations on an attached Thunderbolt storage.
After-suspend:	True
User:	root
Plugin:	shell

Docking station usb tests¶

USB controllers are tested using storage devices in all available USB ports.

USB 2.0
USB 3.0 SuperSpeed mode

USB 3.1 (Type C)

USB Type C (USB3.1) are tested using various adapters/peripherals , as the new USB Type C interface supports more types of devices (i.e. Video, Storage, etc). The following adapters/peripherals should work(Video is not necessary).

Storage devices

The following test units are covered in this category:

dock/all-hotplug-usb-c/insert

Verify the correct detection of a USB 3 storage device insertion into a USB Type-C port on the dock.

Category ID:	dock-usb
Status:	Blocking
Purpose:	This test will check that the system correctly detects the insertion of a USB 3 storage device in a USB Type-C connector on the dock. NOTE: Make sure the USB storage device has a partition before starting the test.
Steps:	Click “Test” and insert a USB 3 storage device into a USB Type-C port on the dock. (Note: this test will time out after 20 seconds.) 2. Do not unplug the device after the test.
Verification:	The verification of this test is automated. Do not change the automatically selected result.
Plugin:	user-interact

dock/all-hotplug-usb-c/remove

Check the system’s detection of USB 3 storage device removal on a USB Type-C port.

Category ID:	dock-usb
Status:	Blocking
Purpose:	This test will check that the system correctly detects the removal of a USB 3 storage device connected to a USB Type-C port.
Steps:	Click “Test” and remove the USB 3 device. (Note: this test will time-out after 20 seconds.)
Verification:	The verification of this test is automated. Do not change the automatically selected result.
Plugin:	user-interact

dock/all-hotplug-usb-c/storage-automated

Automatically test USB-C storage functionality after the usb-c/insert test.

Category ID:	dock-usb
Status:	Blocking
Purpose:	This test executes automatically after the usb-c/insert test is run.
User:	root
Plugin:	shell

dock/all-hotplug-usb3-insert

USB3 drive insertion test

Category ID:	dock-usb
Status:	Blocking
Purpose:	This test will check that the system correctly detects the insertion of a USB 3.0 storage device. NOTE: Make sure the USB storage device has a partition before starting the test.
Steps:	Click “Test” and insert a USB 3.0 storage device, preferably a HDD, in one of the dock’s USB 3.0 port. Although a USB 3.0 pen drive may be used it might cause performance related tests to fail. (Note: this test will time-out after 20 seconds.) 2. Do not unplug the device after the test.
Verification:	The verification of this test is automated. Do not change the automatically selected result.
Plugin:	user-interact

dock/all-hotplug-usb3-remove

USB3 drive removal test

Category ID:	dock-usb
Status:	Blocking
Purpose:	This test will check that the system correctly detects the removal of a USB 3.0 storage device
Steps:	Click “Test” and remove the USB 3.0 device from the dock. (Note: this test will time-out after 20 seconds.)
Verification:	The verification of this test is automated. Do not change the automatically selected result.
Plugin:	user-interact

dock/all-hotplug-usb3-storage-automated

USB3 drive storage test

Category ID:	dock-usb
Status:	Blocking
Purpose:	This test is automated and executes after the dock/usb3_insert test is run.
User:	root
Plugin:	shell

dock/all-init-usb-c/insert

Verify the correct detection of a USB 3 storage device insertion into a USB Type-C port on the dock.

Category ID:	dock-usb
Status:	Blocking
Purpose:	This test will check that the system correctly detects the insertion of a USB 3 storage device in a USB Type-C connector on the dock. NOTE: Make sure the USB storage device has a partition before starting the test.
Steps:	Click “Test” and insert a USB 3 storage device into a USB Type-C port on the dock. (Note: this test will time out after 20 seconds.) 2. Do not unplug the device after the test.
Verification:	The verification of this test is automated. Do not change the automatically selected result.
Plugin:	user-interact

dock/all-init-usb-c/remove

Check the system’s detection of USB 3 storage device removal on a USB Type-C port.

Category ID:	dock-usb
Status:	Blocking
Purpose:	This test will check that the system correctly detects the removal of a USB 3 storage device connected to a USB Type-C port.
Steps:	Click “Test” and remove the USB 3 device. (Note: this test will time-out after 20 seconds.)
Verification:	The verification of this test is automated. Do not change the automatically selected result.
Plugin:	user-interact

dock/all-init-usb-c/storage-automated

Automatically test USB-C storage functionality after the usb-c/insert test.

Category ID:	dock-usb
Status:	Blocking
Purpose:	This test executes automatically after the usb-c/insert test is run.
User:	root
Plugin:	shell

dock/all-init-usb3-insert

USB3 drive insertion test

Category ID:	dock-usb
Status:	Blocking
Purpose:	This test will check that the system correctly detects the insertion of a USB 3.0 storage device. NOTE: Make sure the USB storage device has a partition before starting the test.
Steps:	Click “Test” and insert a USB 3.0 storage device, preferably a HDD, in one of the dock’s USB 3.0 port. Although a USB 3.0 pen drive may be used it might cause performance related tests to fail. (Note: this test will time-out after 20 seconds.) 2. Do not unplug the device after the test.
Verification:	The verification of this test is automated. Do not change the automatically selected result.
Plugin:	user-interact

dock/all-init-usb3-remove

USB3 drive removal test

Category ID:	dock-usb
Status:	Blocking
Purpose:	This test will check that the system correctly detects the removal of a USB 3.0 storage device
Steps:	Click “Test” and remove the USB 3.0 device from the dock. (Note: this test will time-out after 20 seconds.)
Verification:	The verification of this test is automated. Do not change the automatically selected result.
Plugin:	user-interact

dock/all-init-usb3-storage-automated

USB3 drive storage test

Category ID:	dock-usb
Status:	Blocking
Purpose:	This test is automated and executes after the dock/usb3_insert test is run.
User:	root
Plugin:	shell

dock/all-poweroff-usb-c/insert

Verify the correct detection of a USB 3 storage device insertion into a USB Type-C port on the dock.

Category ID:	dock-usb
Status:	Blocking
Purpose:	This test will check that the system correctly detects the insertion of a USB 3 storage device in a USB Type-C connector on the dock. NOTE: Make sure the USB storage device has a partition before starting the test.
Steps:	Click “Test” and insert a USB 3 storage device into a USB Type-C port on the dock. (Note: this test will time out after 20 seconds.) 2. Do not unplug the device after the test.
Verification:	The verification of this test is automated. Do not change the automatically selected result.
Plugin:	user-interact

dock/all-poweroff-usb-c/remove

Check the system’s detection of USB 3 storage device removal on a USB Type-C port.

Category ID:	dock-usb
Status:	Blocking
Purpose:	This test will check that the system correctly detects the removal of a USB 3 storage device connected to a USB Type-C port.
Steps:	Click “Test” and remove the USB 3 device. (Note: this test will time-out after 20 seconds.)
Verification:	The verification of this test is automated. Do not change the automatically selected result.
Plugin:	user-interact

dock/all-poweroff-usb-c/storage-automated

Automatically test USB-C storage functionality after the usb-c/insert test.

Category ID:	dock-usb
Status:	Blocking
Purpose:	This test executes automatically after the usb-c/insert test is run.
User:	root
Plugin:	shell

dock/all-poweroff-usb3-insert

USB3 drive insertion test

Category ID:	dock-usb
Status:	Blocking
Purpose:	This test will check that the system correctly detects the insertion of a USB 3.0 storage device. NOTE: Make sure the USB storage device has a partition before starting the test.
Steps:	Click “Test” and insert a USB 3.0 storage device, preferably a HDD, in one of the dock’s USB 3.0 port. Although a USB 3.0 pen drive may be used it might cause performance related tests to fail. (Note: this test will time-out after 20 seconds.) 2. Do not unplug the device after the test.
Verification:	The verification of this test is automated. Do not change the automatically selected result.
Plugin:	user-interact

dock/all-poweroff-usb3-remove

USB3 drive removal test

Category ID:	dock-usb
Status:	Blocking
Purpose:	This test will check that the system correctly detects the removal of a USB 3.0 storage device
Steps:	Click “Test” and remove the USB 3.0 device from the dock. (Note: this test will time-out after 20 seconds.)
Verification:	The verification of this test is automated. Do not change the automatically selected result.
Plugin:	user-interact

dock/all-poweroff-usb3-storage-automated

USB3 drive storage test

Category ID:	dock-usb
Status:	Blocking
Purpose:	This test is automated and executes after the dock/usb3_insert test is run.
User:	root
Plugin:	shell

dock/all-reboot-usb-c/insert

Verify the correct detection of a USB 3 storage device insertion into a USB Type-C port on the dock.

Category ID:	dock-usb
Status:	Blocking
Purpose:	This test will check that the system correctly detects the insertion of a USB 3 storage device in a USB Type-C connector on the dock. NOTE: Make sure the USB storage device has a partition before starting the test.
Steps:	Click “Test” and insert a USB 3 storage device into a USB Type-C port on the dock. (Note: this test will time out after 20 seconds.) 2. Do not unplug the device after the test.
Verification:	The verification of this test is automated. Do not change the automatically selected result.
Plugin:	user-interact

dock/all-reboot-usb-c/remove

Check the system’s detection of USB 3 storage device removal on a USB Type-C port.

Category ID:	dock-usb
Status:	Blocking
Purpose:	This test will check that the system correctly detects the removal of a USB 3 storage device connected to a USB Type-C port.
Steps:	Click “Test” and remove the USB 3 device. (Note: this test will time-out after 20 seconds.)
Verification:	The verification of this test is automated. Do not change the automatically selected result.
Plugin:	user-interact

dock/all-reboot-usb-c/storage-automated

Automatically test USB-C storage functionality after the usb-c/insert test.

Category ID:	dock-usb
Status:	Blocking
Purpose:	This test executes automatically after the usb-c/insert test is run.
User:	root
Plugin:	shell

dock/all-reboot-usb3-insert

USB3 drive insertion test

Category ID:	dock-usb
Status:	Blocking
Purpose:	This test will check that the system correctly detects the insertion of a USB 3.0 storage device. NOTE: Make sure the USB storage device has a partition before starting the test.
Steps:	Click “Test” and insert a USB 3.0 storage device, preferably a HDD, in one of the dock’s USB 3.0 port. Although a USB 3.0 pen drive may be used it might cause performance related tests to fail. (Note: this test will time-out after 20 seconds.) 2. Do not unplug the device after the test.
Verification:	The verification of this test is automated. Do not change the automatically selected result.
Plugin:	user-interact

dock/all-reboot-usb3-remove

USB3 drive removal test

Category ID:	dock-usb
Status:	Blocking
Purpose:	This test will check that the system correctly detects the removal of a USB 3.0 storage device
Steps:	Click “Test” and remove the USB 3.0 device from the dock. (Note: this test will time-out after 20 seconds.)
Verification:	The verification of this test is automated. Do not change the automatically selected result.
Plugin:	user-interact

dock/all-reboot-usb3-storage-automated

USB3 drive storage test

Category ID:	dock-usb
Status:	Blocking
Purpose:	This test is automated and executes after the dock/usb3_insert test is run.
User:	root
Plugin:	shell

dock/all-suspend-usb-c/insert

Verify the correct detection of a USB 3 storage device insertion into a USB Type-C port on the dock.

Category ID:	dock-usb
Status:	Blocking
Purpose:	This test will check that the system correctly detects the insertion of a USB 3 storage device in a USB Type-C connector on the dock. NOTE: Make sure the USB storage device has a partition before starting the test.
Steps:	Click “Test” and insert a USB 3 storage device into a USB Type-C port on the dock. (Note: this test will time out after 20 seconds.) 2. Do not unplug the device after the test.
Verification:	The verification of this test is automated. Do not change the automatically selected result.
Plugin:	user-interact

dock/all-suspend-usb-c/remove

Check the system’s detection of USB 3 storage device removal on a USB Type-C port.

Category ID:	dock-usb
Status:	Blocking
Purpose:	This test will check that the system correctly detects the removal of a USB 3 storage device connected to a USB Type-C port.
Steps:	Click “Test” and remove the USB 3 device. (Note: this test will time-out after 20 seconds.)
Verification:	The verification of this test is automated. Do not change the automatically selected result.
Plugin:	user-interact

dock/all-suspend-usb-c/storage-automated

Automatically test USB-C storage functionality after the usb-c/insert test.

Category ID:	dock-usb
Status:	Blocking
Purpose:	This test executes automatically after the usb-c/insert test is run.
User:	root
Plugin:	shell

dock/all-suspend-usb3-insert

USB3 drive insertion test

Category ID:	dock-usb
Status:	Blocking
Purpose:	This test will check that the system correctly detects the insertion of a USB 3.0 storage device. NOTE: Make sure the USB storage device has a partition before starting the test.
Steps:	Click “Test” and insert a USB 3.0 storage device, preferably a HDD, in one of the dock’s USB 3.0 port. Although a USB 3.0 pen drive may be used it might cause performance related tests to fail. (Note: this test will time-out after 20 seconds.) 2. Do not unplug the device after the test.
Verification:	The verification of this test is automated. Do not change the automatically selected result.
Plugin:	user-interact

dock/all-suspend-usb3-remove

USB3 drive removal test

Category ID:	dock-usb
Status:	Blocking
Purpose:	This test will check that the system correctly detects the removal of a USB 3.0 storage device
Steps:	Click “Test” and remove the USB 3.0 device from the dock. (Note: this test will time-out after 20 seconds.)
Verification:	The verification of this test is automated. Do not change the automatically selected result.
Plugin:	user-interact

dock/all-suspend-usb3-storage-automated

USB3 drive storage test

Category ID:	dock-usb
Status:	Blocking
Purpose:	This test is automated and executes after the dock/usb3_insert test is run.
User:	root
Plugin:	shell

Non-blocking¶

Docking station tests¶

The following test units are covered in this category:

dock/all-hotplug

Verify the device functionality after hotplug actions with the docking station.

Category ID:	dock
Status:	Non-blocking
Purpose:	This test checks if the device is still working after hotplug.
Steps:	Unplug the docking station. 2. Wait for 30 seconds. 3. Plug in the docking station.
Verification:	Mark it Pass if you have hotplugged the docking station.
Plugin:	manual

dock/all-init

Prepare all I/O ports on the dock by connecting all devices it supports.

Category ID:	dock
Status:	Non-blocking
Purpose:	This test is to set up the initial status for all I/O ports on the docking station. Note: Try to meet the limitations in the spec of the dock. If there’s no port as described below, you can just skip it.
Steps:	If the laptop is currently undocked, dock it now. 2. Connect an Ethernet cable to the docking station. 3. Connect a DP monitor to the docking station. 4. Connect an HDMI monitor to the docking station. 5. Connect a Thunderbolt monitor to the docking station. 6. Connect a Thunderbolt3 storage to the docking station. 7. Connect a USB Type-C storage to the docking station. 8. Connect a USB3.0 storage to the docking station. 9. Connect a headset to the docking station.
Verification:	Mark it Pass if you have connected all I/O ports as mentioned above.
Plugin:	manual

dock/all-poweroff

Test device functionality after powering off and on.

Category ID:	dock
Status:	Non-blocking
Purpose:	This test is to check if the device is still working after power-off.
Steps:	Power off the system. 2. Wait for 30 seconds. 3. Power on the system.
Verification:	Mark it Pass if you have powered off and powered on the system.
Plugin:	manual

dock/all-reboot

Category ID:	dock
Status:	Non-blocking
Purpose:	This test is to check if the device is still working after reboot.
Steps:	Reboot the system.
Verification:	Mark it Pass if you have rebooted the system.
Plugin:	manual

dock/all-suspend

Test the system’s functionality after suspend and resume.

Category ID:	dock
Status:	Non-blocking
Purpose:	This test is to check if the device is still functional after suspend.
Steps:	Suspend the system. 2. Wait for 30 seconds. 3. Resume the system.
Verification:	Mark it as Pass if you have successfully suspended and resumed the system.
Plugin:	manual