Symulacja aktualizacji oprogramowania układowego wirtualnego urządzenia HID (CFU)

Ten temat zawiera przewodnik po symulowanej aktualizacji oprogramowania układowego na wirtualnym urządzeniu HID.

Kompilowanie i instalowanie przykładowego wirtualnego urządzenia HID CFU

1. Zainstaluj program Visual Studio 2019 i zestaw sterowników systemu Windows (WDK) zgodnie z opisem w temacie Pobieranie zestawu sterowników systemu Windows (WDK).

2. Sklonuj repozytorium Microsoft CFU do katalogu lokalnego repozytorium

   git clone https://github.com/microsoft/CFU.git

3. W lokalnym katalogu repozytorium CFU, w wierszu polecenia uruchom następujące polecenia git, aby pobrać podmoduł Driver Module Framework (DMF) wymagany do zbudowania przykładu:

   git submodule init

   git submodule update

4. Tworzenie rozwiązania urządzenia CfuVirtualHid w programie Visual Studio

   1. Przejdź do lokalizacji pliku CfuVirtualHid.sln w systemie deweloperskim. Przykład:

      C:\<your_repo_folder>\CFU\Host\CFUFirmwareSimulation\CfuVirtualHid.sln

   2. Otwórz plik CfuVirtualHid.sln w programie Visual Studio.

   3. W menu Kompilacja wybierz pozycję Kompiluj rozwiązanie. Powinien zostać wyświetlony tekst wyjściowy wskazujący, że rozwiązanie pomyślnie skompilowane:

      

5. Instalowanie urządzenia CfuVirtualHid i sterownika

   1. Przejdź do lokalizacji pliku cfuvirtualhid.inf na swoim systemie deweloperskim. Przykład:

      C:\<your_repo_folder>\CFU\Host\CFUFirmwareSimulation\x64\Debug\CfuVirtualHid

   2. W wierszu polecenia administracyjnego uruchom następujące polecenie:

      devcon.exe install cfuvirtualhid.inf HID\CFU_VIRTUAL_DEVICE
      

      Powinien zostać wyświetlony tekst wyjściowy wskazujący, że urządzenie wirtualne jest zainstalowane pomyślnie:

      

6. W Panelu sterowania otwórz Menedżera urządzeń, wybierz menu Widok , a następnie wybierz pozycję menu Urządzenia według typu .

7. Na liście urządzeń rozwiń węzeł Oprogramowanie układowe i wybierz urządzenie CfuVirtualHid , jak pokazano poniżej:

   

8. Kliknij prawym przyciskiem myszy urządzenie CfuVirtualHid , aby otworzyć menu kontekstowe, a następnie kliknij element menu Właściwości , aby otworzyć okno dialogowe Właściwości urządzenia CfuVirtualHid .

9. Wybierz kartę Szczegóły w oknie dialogowym Właściwości urządzenia CfuVirtualHid , a następnie wybierz pozycję Identyfikatory sprzętu z listy rozwijanej Właściwość .

   W polu Lista wartości powinna pojawić się HID\CFU_VIRTUAL_DEVICE, jak pokazano poniżej:

   

10. W menu Menedżer urządzeń wybierz menu Widok , a następnie wybierz element menu Urządzenia według połączenia .

    

11. Przejdź do Urządzenia CfuVirtualHid i rozwiń węzeł Urządzenie CfuVirtualHid, rozwiń węzeł Urządzenie Virtual HID Framework (VHF) i wybierz element listy urządzenie zgodne z protokołem HID, jak pokazano poniżej:

    

12. Kliknij prawym przyciskiem myszy urządzenie zgodne z funkcją HID , aby otworzyć menu kontekstowe, a następnie kliknij element menu Właściwości , aby otworzyć okno dialogowe Właściwości urządzenia zgodnego z protokołem HID.

13. Wybierz kartę Szczegóły w oknie dialogowym Właściwości urządzenia zgodnego z protokołem HID, a następnie wybierz pozycję Identyfikatory sprzętu z listy rozwijanej Właściwość .

    W polu listy wartości powinieneś zobaczyć HID\VID_045E&UP:FA00_U:00F5, jak pokazano poniżej:

    

Instalowanie aktualizacji oprogramowania układowego dla wirtualnego urządzenia HID CFU

Ta sekcja zawiera przykład instalacji aktualizacji oprogramowania układowego na przykładowym urządzeniu CfuVirtualHid Device zbudowanym w programie Visual Studio 2019 i zainstalowanym przy użyciu narzędzia wiersza polecenia devcon.exe, zgodnie z opisem w powyższej sekcji.

1. Przejdź do lokalizacji pliku .inf oraz plików .bin z oprogramowaniem układowym i ładunkiem dla urządzenia docelowego. Przykład:

   

2. W edytorze tekstów otwórz plik INF aktualizacji oprogramowania układowego. W tym przykładzie użyjemy pliku CfuVirtualHidDeviceFwUpdate.inf opisanego w konfiguracji INF CFU.

3. W pliku INF aktualizacji oprogramowania układowego przejdź do sekcji [Standard.NTamd64] i sprawdź, czy istnieją następujące informacje dla urządzenia HID\VID_045E&UP:FA00_U:00F5:

   [Standard.NTamd64]
   %CfuVirtualHidDeviceFwUpdate.DeviceDesc%=CfuVirtualHidDeviceFwUpdate, HID\VID_045E&UP:FA00_U:00F5 ; HardwareID for VirtualHidDevice MCU
   
   [CfuVirtualHidDeviceFwUpdate.NT]
   Include            = HidCfu.inf
   Needs              = HidCfu.NT
   CopyFiles          = CfuVirtualHidDeviceFwUpdate.CopyFiles
   
   [CfuVirtualHidDeviceFwUpdate.NT.Wdf]
   Include            = HidCfu.inf
   Needs              = HidCfu.NT.Wdf
   

4. W wierszu polecenia administracyjnego uruchom następujące polecenie:

   pnputil /add-driver CfuVirtualHidDeviceFwUpdate.inf /install

   To polecenie zwróci dane wyjściowe narzędzia PnP . Przykład:

   

5. W Menedżerze urządzeń przejdź do węzła CfuVirtualHid Device , a następnie rozwiń węzeł, aby sprawdzić, czy aktualizacja oprogramowania układowego CfuVirtualHidDevice została zainstalowana, jak pokazano poniżej:

   

6. Wybierz węzeł CfuVirtualHidDevice Firmware Update, a następnie otwórz okno Właściwości CfuVirtualHidDevice Firmware Update, jak pokazano tutaj.

   

7. W oknie Właściwości aktualizacji oprogramowania układowego CfuVirtualHidDevice wybierz kartę Szczegóły, a następnie wybierz pozycję Identyfikatory sprzętu z listy rozwijanej Właściwość, jak pokazano tutaj.

   

8. Sprawdź, czy urządzenie HID\VID_045E&UP:FA00_U:00F5 jest wyświetlane w Identyfikatorach sprzętuwartościAktualizacji oprogramowania układowego CfuVirtualHidDevice.

   

9. Użyj aplikacji TraceView, aby wyświetlić informacje o komunikacie dziennika dla instalacji wirtualnego urządzenia HID CFU. Przykład: