DELL Technologies WD19DCS Docking Station

Product Information

Specifications

• Product Name: Dell Docking Station WD19DCS
• Regulatory Model: K20A
• Regulatory Type: K20A001
• Release Date: November 2023
• Revision: A01

Product Usage Instructions

Dell Docking Station Firmware Update

About this task

NOTE: Dell Docking stations are supported with select Dell systems. See the Dell Commercial Docking Compatibility Guide for the list of supported systems and recommended docking.

Updating the Firmware

Prerequisites

1. The system must have over 10% charge capacity or be connected to AC power.
2. Download the WD19DCS update tool from www.dell.com/support.

Steps

1. Windows Operating System:
2. Connect the WD19DCS docking station to the system.
3. Start the WD19DCS update tool in administrative mode.
4. Wait for all the information to be entered into the various GUI panes.
5. Click the Update button when it appears in the bottom-right corner.
6. Wait for all the component firmware updates to complete. A progress bar will be displayed at the bottom.
7. Linux Operating System:
8. Run the binary with the install argument to install the updated firmware: # sudo ./WD19FirmwareUpdateLinux_XX.YY.ZZ.bin install. Resolve any kernel dependency packages as needed.
9. Unplug the type-C cable and plug it back into the system after one minute.
10. Check that the WD19DCS firmware has been upgraded properly: # sudo ./WD19FirmwareUpdateLinux_XX.YY.ZZ.bin get-devices
11. Chrome Operating System:
12. WD19DCS firmware updates will be distributed with the latest Enterprise Chromebook operating system release.
13. To check WD19DCS firmware version, use chrome://system output in a browser.

FAQ

Q: What are the prerequisites for updating the firmware on the Dell Docking Station WD19DCS?

A: The system must have over 10% charge capacity or be connected to AC power, and you need to download the WD19DCS update tool from www.dell.com/support.

Q: How can I update the firmware on different operating systems?

A: For Windows, connect the docking station, run the update tool, and follow on-screen instructions. For Linux, run the binary with the install argument and resolve kernel dependencies. For Chrome OS, updates are distributed with system releases.

Regulatory Model: K20A Regulatory Type: K20A001 November 2023
Rev. A01

Notes, cautions, and warnings

• NOTE: A NOTE indicates important information that helps you make better use of your product.
• CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid the problem.
• WARNING: A WARNING indicates a potential for property damage, personal injury, or death.

© 2021-2023 Dell Inc. or its subsidiaries. All rights reserved. Dell Technologies, Dell, and other trademarks are trademarks of Dell Inc. or its subsidiaries. Other trademarks may be trademarks of their respective owners.

Introduction

This guide is for IT professionals and engineers, to get more information about the following technical topics:

• Step-by-step stand-alone DFU (Dock Firmware Update) and driver update utilities.
• Using DCU (Dell Command | Update) for driver download.
• Dock asset management locally and remotely through DCM (Dell Command | Monitor) and SCCM (System Center Configuration Manager).

Dell docking station firmware update

About this task

NOTE: Dell Docking stations are supported with select Dell systems. See the Dell Commercial Docking Compatibility Guide for the list of supported systems and recommended docking.

Topics

• Updating the firmware
• Update on Disconnect (UoD)
• Command-Line options
• Approximate firmware update duration
• Logging
• Error handling
• Setting Package Version
• Commands for Automation

Updating the firmware
WD19DCS supports multi operating system firmware update for Windows/Linux/Chrome.

Prerequisites

1. The following conditions must be met to update firmware:
   System must have > 10% charge capacity or connected to AC power.

2. Download the WD19DCS update tool, go to www.dell.com/support.

Steps

1. Windows operating system:

   • a. Connect the WD19DCS docking station to the system.
   • b. Start the WD19DCS update tool in administrative mode.
   • c. Wait for all the information to be entered the various GUI panes.
   • d. Update and Exit buttons appear in the bottom-right corner. Click the Update button.
   • e. Wait for all the component firmware update to complete. A progress bar is displayed in the bottom.
   • f. Update status is displayed above the payload information.

2. Linux operating system: This firmware update has both the update tool and binary assembled in a single package. If you already have fwupd 1.2.5 or later installed on your system, you can fetch update directly from the Linux Vendor Firmware Service (LVFS) by plugging in your dock and using fwupdmgr or Gnome Software to check for updates.

   • a. Download the WD19DCS Linux update tool (WD19FirmwareUpdateLinux_XX.YY.ZZ.bin).

   • b. Open a terminal application.

   • c. Modify the permissions on the binary to make it executable.

     sudo chmod +x WD19FirmwareUpdateLinux_XX.YY.ZZ.bin

   • d. Run the binary with the install argument to install updated firmware.

     sudo ./WD19FirmwareUpdateLinux_XX.YY.ZZ.bin install.

• Resolve any kernel dependency packages as needed.

  • e. Unplug the type-C cable and plug it back to the system after one minute.
  • f. Check that the WD19DCS firmware has been upgraded properly.

    sudo ./WD19FirmwareUpdateLinux_XX.YY.ZZ.bin get-devices

  3. Chrome operating system:
     • a. WD19DCS firmware update will be distributed with the latest Enterprise Chrome book operating system release.
     • b. WD19DCS firmware version checking: chrome://system output in browser.

Update on Disconnect (UoD)

Download the Dell WD19DCS dock driver and firmware update from www.dell.com/support. Connect the dock to the system and start the tool in administrative mode.

1. Wait for all the information to be entered in the various Graphical User Interface (GUI) panes.

2. The setting symbol is displayed on the top-right corner. Click the Settings button. Enter /uod command and click Ok

3. Update and Exit buttons are displayed in the bottom-right corner. Click the Update button.

4. Wait for all the component firmware update to complete. A progress bar is displayed in the bottom. The MST/USB Gen1/USB Gen2 firmware is updated.
   NOTE: Only EC/NVM (thunderbolt) supports the disconnect mode

5. Disconnect the dock from the system. The EC starts the updating process, and the process is completed in a minute’s time. Power button LED flashes three times to indicate the update is completed.

6. Connect the dock to the system, and start the tool in administrative mode. The Dell Firmware Update Utility is completed.

Command-Line options

About this task

Table 1. Command line options

Approximate firmware update duration

About this task
The firmware update time duration in the following table is from a measurement running Dock Firmware Utility A03 on a Latitude 5400 with Windows Operating System. These numbers are for reference only and can vary depending on multiple factors including existing firmware and/or devices attached.

Table 2. Approximate firmware update duration

Smart update
About this task
EC, USB Gen1/2 Hub, MST are updated only if incoming version is new.

Logging

About this task

• Dock utility logs to the default file (/s command-line option).
  Default log file is at CurrentDrive: \Dell\UpdatePackage\Log\exename.txt

• Optional logging can be done in any mode using /l=logfilename.txt

• Log message is useful for

  • Debugging
  • Service
  • Component version information

Error handling

Error handling conditions

About this task

Table 3. Error handling conditions

Error Condition| S y m p t o m / S ce n a r i o| Message| CLI options
---|---|---|---
Power Check| If there is no AC adapter or battery that is connected on portable platform.| The AC adapter and battery must be plugged in before the dock Firmware can be updated. Press OK when they are both plugged in or CANCEL to quit.| forceit, power check is skipped.

/s, error message is not displayed and log will have proper error messages.

| If the battery level is less than 10% on portable platform.| The battery must be charged above 10% before the Dock Firmware can be updated.

Press OK when the battery is charged or CANCEL to quit.

|
Dock Detection| Dock is not connected or detected to system.| No dock attached. This firmware update utility only works with a single dock attached.| /s, error message is not displayed, and log has proper error messages.
Error Condition| S y m p t o m / S ce n a r i o| Message| CLI options
---|---|---|---
| Multiple docks that are connected to the system| Too many docks are attached. This update utility only works when a single dock is attached. Only connect a single dock and restart the update utility to download the latest version and update the driver. Then rerun this utility|
Firmware update fails| ●    When one firmware component update fails, the error message shows in the “Progress Details” field for this component.

●    The utility continues to update other firmware.

●    After complete firmware update for all components, show the error mess.

| Firmware update failed| /s, error message is not displayed, and log has proper error messages.

Automatic dock reboot after firmware update

About this task
Dock automatically reboots when one or more of the components are updated.

NOTE: Dock reboots as part of the EC update or the tool sends a reboot command when EC is not updated and at least one of the components is updated.

Setting Package Version

About this task
Package version is 32 bit BCD format (device saves them in reverse byte order). They tool reverses the bytes for the display purpose. The display format is WW.XX.YY.ZZ. Major, minor, and maintenance versions are represented as WW.XX.YY. The LSB in ZZ (or the MSB in 32 bit raw data) represents the status of the dock update.

• 01 – All components are updated and have valid version.
• 00 – Some of the components are not updated.

The Package version is set before any of the components are updated. If the update is failed on any of the components device reports 0 for LSB (invalid package version).

Table 4. Dell Flash Update Utility Exit code and meaning

Commands for Automation

About this task

• Run the tool with administrative privileges with the command-line options /s (silent) /l=filename.txt. The update is run in silent mode without GUI or use command-line options: /uod /l=filename.txt. The update runs and only completes when the dock Type-C cable is unplugged from the system. Automation environment can capture the return code (DUP compliant) from the tool for verifying pass or fail status. The logfile (filename.txt) can be used for parsing the dock data and individual component update information.
• After the update, tool can run with /componentsvers /s /l=verfilename.txt. The command is run in the silent mode. Return code can be captured for pass or fail status (DUP compliant). Verfilename.txt contains the current component information.

Using Dell Command Update

Dell Docking Station drivers (Realtek USB GBE Ethernet Controller Driver) are required to be installed before using the docking station for full functionality. Dell recommends updating the system BIOS, graphics driver, Thunderbolt driver, and Thunderbolt firmware to the latest version before using the docking station. Older BIOS versions and drivers could result in the docking station not being recognized by your system or not functioning optimally.
Dell highly recommends the Dell Command Update to automate the installation of BIOS, firmware, driver, and critical updates specific to your system and docking station.
For more information about Dell command update user guide. See Dell Command | Update for Windows 10

Dock Asset Management

Topics:

• How to inventory Dell Dock, Dell Performance Dock, and Dell Thunderbolt Dock using Dell Command Monitor locally
• How to inventory Dell Dock, Dell Performance Dock, and Dell Thunderbolt Dock using Dell Command | Monitor remotely
• Dell Dock Firmware Update Service Agent
• SCCM Integration

How to inventory Dell Dock, Dell Performance Dock, and Dell Thunderbolt Dock using Dell Command Monitor locally
Prerequisites

1. Follow the steps in the WD19DCS firmware update and retrieve dock information by using Dell command monitor locally.

Steps

1. Install Dell Command Monitor 10.2 or later. For detailed install instructions follow Dell command monitor Installation Guide

2. Run the commands given below:

   • a. For systems running Windows, Using PowerShell: Get-CimInstance -Namespace root\dcim\sysman -ClassName DCIM_Chassis
   • b. For systems running Linux, Using OMICLI: ./ omicli ei root\dcim\sysman DCIM_Chassis
     NOTE: DCIM_Chassis can have multiple instances. For Dock Details, see instance where CreationClassName = DCIM_DockingStation

3. Screenshot of output:
   

4. Key dock properties mapping with cim properties:

Table 5. Key dock

Dock data| Dell command | Monitor mapping
---|---
Dock service tag| DCIM_Chassis::Tag
Dock FW package version| DCIM_Chassis::Version
Dock module type| DCIM_Chassis::Model
Dock marketing name| DCIM_Chassis::Name
Dock module serial| DCIM_Chassis::SerialNumber

How to inventory Dell Dock, Dell Performance Dock, and Dell Thunderbolt Dock using Dell Command |Monitor remotely

About this task
For more information, see Dell Command Monitor User guide

Dell Dock Firmware Update Service Agent
The Dell Dock Firmware Update Service Agent automatically updates the dock to the target firmware once the dock is connected to the system. This agent is intended for Enterprise customers who use Microsoft SCCM (V5.2207.1048.1000).

Prerequisites

1. Before installing Dell Dock Firmware Update Service Agent, download the Dell dock firmware update from www.dell.com/support.
2. Download Dell Dock Firmware Update Service Agent from www.dell.com/support. For a detailed standard operating procedure, see Dell Dock Firmware Update Service Agent SOP.pdf.

Steps

1. Copy the tool DFUWrapper.zip to the SCCM server and extract it. The location is specified in the form \\Server\Share\DFUWrapper.

2. Open the Configuration Manager Console application on the server.

3. Create the application wizard. For detailed process on how to create the application wizard, see Create application wizard in Configuration Manager Console.

4. Set up the client environment. (For example: Add a server domain, install Configuration Manager, and so on).

5. Deploy the application to the server.

6. The DFUWrapper tool becomes available on Software Center after a few minutes.

7. Click Install.

8. To ensure the application is installed successfully, check the following:
   Dell Dock Firmware Update Package shows in Programs and Features.
   Under Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Dell\Dell.DFU.Service, registry DFUToolArgs, and DFUToolPath are created.
   Service Dell Dock Firmware Update Service is running

9. Prepare a dock with older firmware.

10. Connect the dock to the system where the DFUWrapper tool is installed.

11. Wait for up to 6 minutes and reopen the dock firmware utility.
    The new firmware version is displayed confirming the dock firmware update is successful.
    NOTE: For manual installation (not through SCCM), follow Steps 8 to 11.
    NOTE: To update dock firmware right after installing the wrapper tool, connect the dock to the system before Step 7.

Create application wizard in Configuration Manager Console

About this task
To create an application wizard in Configuration Manager Console, do the following:

Steps

1. In the Configuration Manager Console, choose Software Library > Overview >Application Management > Applications.

2. Right-click and select Create Application.
   The Create Application Wizard window is displayed.

3. On the General page of Create Application Wizard, do the following:

   • a. Select Automatically detect information about this application from installation files.
   • b. For Type: Click drop-down and choose Windows Installer (*.msi file) from list.
   • c. For Location: Click Browse and choose the location of the installation file DFUSetup.msi.

4. Click Next.
   The Import Information page is displayed

5. Check the details and click Next.
   The General Information page is displayed.

6. On the General Information page, do the following:

7. a. In the Name field, enter the name DFUWrapper.

8. b. In the Installation program field, enter the command msiexec.exe /i DFUSetup.msi /quiet
   DFUPATH= \\SCCM2022\Dell\DFUWrapper\DFU\DellDockFirmwarePackage_WD19_WD22_Series_HD22_01.00.16.exe
   DFUARGS=”/s”
   NOTE: DFUPATH is the path of the DFU package on the server.

9. Click Next.
   The Summary page is displayed.

10. On the Summary page, check the application settings detail.

11. Click Next.
    The Progress page is displayed.

12. Wait for the application creation wizard process to complete.

13. Click Next.
    The Completion page is displayed.

14. Click Close to complete the wizard.

15. Reconfirm the newly created application. To reconfirm the new created application, do the following:

    • a. In the Software Library workspace, expand Application Management.
    • b. Choose Applications to see the application.

SCCM Integration

About this task
Using the MOF file within Dell Command | Monitor install package, which contains all the Dell Command | Monitor classes and importing to ConfigMgr.
Post Dell Command | Monitor installation, the integration MOF is placed at: C:\Program
Files\Dell\Command_Monitor\ssa\omacim\OMCI_SMS_DEF.mof. For more information about integration watch, SCCM intergration.

Issue: SCCM-Client hardware inventory does not display version information for WD19S\WD19TBS\WD19DCS.
Description: OMCI_SMS_DEF.mof file is missing Version property for DCIM_Chassis Class. SCCM-Client hardware inventory does not display version information for WD19S\WD19TBS\WD19DCS.
Resolution: To resolve this, the user must update the OMCI_SMS_DEF.mof file as suggested in steps below:

Steps

1. Edit OMCI_SMS_DEF.mof file using text editor.
2. Search for “DCIM Chassis and Docking.”
3. At the end, make an entry for [SMS_Report (TRUE)] string Version. As shown in below screenshot.
4. Once edited, reimport the updated OMCI_SMS_DEF.mof file in SCCM to fetch updated Client Hardware Inventory.

SCCM setup for remote deployment

About this task
Information provided in the document available here Dell Catalog to Support Microsoft System Center Configuration Manager for Dell Hardware Updates.
For more information about Dell command update Users Guide. See Dell Command | Monitor version user’s guide.
For more information about Dell command update Installation Guide. See Dell Command | Monitor version installation guide.

Getting help

Topics:
Contacting Dell

Contacting Dell

Prerequisites
NOTE: If you do not have an active Internet connection, you can find contact information on your purchase invoice, packing slip, bill, or Dell product catalog.

About this task
Dell provides several online and telephone-based support and service options. Availability varies by country and product, and some services may not be available in your area. To contact Dell for sales, technical support, or customer service issues:

Steps

1. Go to Dell.com/support.
2. Select your support category.
3. Verify your country or region in the Choose a Country/Region drop-down list at the bottom of the page.
4. Select the appropriate service or support link based on your need.

Read User Manual Online (PDF format)

Download This Manual (PDF format)

Download this manual  >>