Rozwiązywanie problemów z usługą Azure Sphere

Ważne

Jest to dokumentacja usługi Azure Sphere (starsza wersja). Usługa Azure Sphere (starsza wersja) zostanie wycofana 27 września 2027 r., a użytkownicy muszą przeprowadzić migrację do usługi Azure Sphere (zintegrowanej) do tej pory. Użyj selektora wersji znajdującego się powyżej spisu treści, aby wyświetlić dokumentację usługi Azure Sphere (zintegrowaną).

Poniżej przedstawiono kilka kroków rozwiązywania problemów, które mogą wystąpić podczas instalacji i instalacji.

Problemy z komunikacją urządzeń

Nie można nawiązać połączenia z urządzeniem z maszyny hosta z wielu powodów i może spowodować wyzwolenie dowolnego z kilku komunikatów o błędach, w zależności od tego, które narzędzia lub aplikacje go napotkają. Następujące komunikaty o błędach mogą wskazywać na nieudane połączenie:

• An error occurred. Please check your device is connected and your PC has been configured correctly, then retry.
• Could not connect to the device. Check if your device is connected to the PC. The device may be unresponsive if it is applying an Azure Sphere operating system update; wait a few minutes and then retry. If this issue persists, try uninstalling and reinstalling the Azure Sphere SDK.
• An unexpected issue occurred. Please try again; if the issue persists, please refer to aka.ms/azurespheresupport for troubleshooting suggestions and support.
• Failed to retrieve device ID from attached device: 'Could not connect to the device; please ensure it is attached.'
• Failed to establish communication with device after recovery.

Istnieją trzy składniki, które mogą powodować problemy z komunikacją urządzenia: (1) sam interfejs wiersza polecenia; (2) usługa komunikacji urządzeń (DCS), która ułatwia komunikację z urządzeniem; i (3) urządzenie.

Aby wyizolować przyczynę, wykonaj następujące kroki diagnostyczne:

1. Sprawdź, czy możesz komunikować się bezpośrednio z urządzeniem. Przejdź do https://192.168.35.2/status witryny w przeglądarce internetowej. Ignoruj i odrzucaj wszystkie przedstawione ostrzeżenia SSL. Powinny zostać wyświetlone dane wyjściowe podobne do: {"uptime":56} w oknie przeglądarki internetowej.

Uwaga

Możesz również wykonać ten krok z poziomu wiersza polecenia przy użyciu polecenia curl https://192.168.35.2/status --insecure.

Uwaga

Ten krok można również wykonać za pomocą programu PowerShell (wersja 6 lub nowsza). Invoke-WebRequest https://192.168.35.2/status -SkipCertificateCheck

2. Upewnij się, że usługa komunikacji urządzeń wykryła urządzenie. Przejdź do http://localhost:48938/api/service/devices w przeglądarce internetowej i upewnij się, że co najmniej jedno urządzenie jest wyświetlane w danych wyjściowych JSON.

Ostrzeżenie

Kontroler domeny systemu Linux jest dołączony tylko do wersji 23.05 i nowszej zestawu SDK. Postępuj zgodnie ze starszymi krokami rozwiązywania problemów dla zestawu SDK w wersji 22.11 i starszych.

Uwaga

Możesz również wykonać ten krok z poziomu programu PowerShell za pomocą polecenia Invoke-WebRequest http://localhost:48938/api/service/devices.

Nie można nawiązać bezpośredniej komunikacji z urządzeniem i urządzenie nie jest wykrywane przez usługę DCS

Jeśli nie można nawiązać połączenia z urządzeniem (krok 1), a urządzenie nie może zostać wykryte przez usługę DCS (krok 2), prawdopodobnie wystąpi problem z konfiguracją urządzenia fizycznego.

Najpierw sprawdź, czy urządzenie zostało wykryte przez maszynę.

Z terminalu:

1. Uruchom polecenie sudo lsusb. Sprawdź, czy w danych wyjściowych pojawi się funkcja Future Technology Devices International, Ltd FT4232H Quad HS USB-UART/FIFO IC .

Korzystanie z okna programu PowerShell:

1. Uruchamianie polecenia Get-PnpDevice -PresentOnly | Where-Object { $_. InstanceId - match '^USB' }. Sprawdź, czy interfejs MSFT MT3620 Std jest wyświetlany w danych wyjściowych.

Jeśli poprzednie polecenie nie zwraca oczekiwanych danych wyjściowych, połącz urządzenie z innym portem USB. Jeśli to nadal nie rozwiąże problemu, sprawdź, czy urządzenie ma prawidłowo skonfigurowane skoczki. Na przykład seeed MT3620 Development Kits są dostarczane z fabryki z nagłówkiem skoczek przez szpilki 2 i 3 z J3, który zasila zegar z głównego zasilacza. Sprawdź, czy nagłówek nie został usunięty ani usunięty.

Nie można nawiązać bezpośredniej komunikacji z urządzeniem, ale urządzenie jest wykrywane przez usługę DCS

Jeśli nie można nawiązać połączenia z urządzeniem (krok 1), ale urządzenie zostało wykryte przez usługę DCS (krok 2), prawdopodobnie urządzenie lub usługa komunikacji urządzenia jest w złym stanie.

Jeśli urządzenie zostało właśnie połączone z Internetem, a system operacyjny urządzenia jest nieaktualny, urządzenie może stosować aktualizację systemu operacyjnego. Istnieje również niewielkie prawdopodobieństwo, że urządzenie przyjmuje aktualizację systemu operacyjnego, jeśli czas zbiega się z oknem wydania. Podczas aktualizacji systemu operacyjnego nie będzie można komunikować się z urządzeniem.

Jeśli podejrzewasz, że urządzenie jest aktualne i/lub nie jest połączone z Internetem, następną najlepszą opcją jest odłączenie i ponowne połączenie urządzenia z komputerem. Powinno to spowodować odnowienie połączenia z urządzeniem przez usługę DCS i zresetowanie urządzenia do stanu początkowego.

Jeśli nie możesz odłączyć i ponownie połączyć urządzenia, następną najlepszą opcją jest ponowne uruchomienie usługi DCS. Z terminalu:

1. Uruchom program sudo azspheredctl restart. Sprawdź, czy polecenie zostało pomyślnie zakończone.
   1. Jeśli polecenie zakończy się niepowodzeniem, uruchom polecenie sudo systemctl restart azsphered.

Jeśli nie możesz odłączyć i ponownie połączyć urządzenia, następną najlepszą opcją jest wydanie polecenia ponownego skanowania dla usługi DCS. Po otrzymaniu tego polecenia usługa DCS będzie cyklicznie i resetuje mikroukład interfejsu FTDI używany do komunikowania się z mt3620. Korzystanie z okna programu PowerShell:

1. Uruchom polecenie azsphere device rescan-attached

Teraz uruchom ponownie polecenie, które początkowo próbowano wykonać. Jeśli problem nadal nie został rozwiązany, następną najlepszą opcją jest próba ponownego uruchomienia usługi DCS. W oknie programu PowerShell na poziomie administratora:

1. Uruchom program Restart-Service -Name AzureSphereDeviceCommunicationService. Sprawdź, czy polecenie zostało pomyślnie zakończone.

Alternatywnie uruchom ponownie usługę DCS przy użyciu graficznego interfejsu użytkownika.

1. Naciśnij przycisk Start i wprowadź pozycję Usługi. Kliknij prawym przyciskiem myszy usługę Azure Sphere Device Communication Service i wybierz polecenie Uruchom ponownie.

Teraz uruchom ponownie polecenie, które początkowo próbowano wykonać.

Jeśli polecenie nadal kończy się niepowodzeniem lub polecenie azsphere device list-attached ma dane wyjściowe podobne do:

1 device attached:
--> Device ID: Cannot get device ID
  --> Is responsive: no
  --> IP address: 192.168.35.2
  --> Connection path: 213

Uruchamianie polecenia azsphere device recover

Może komunikować się bezpośrednio z urządzeniem, a urządzenie jest wykrywane przez usługę DCS

Prawdopodobnie oznacza to problem z interfejsem wiersza polecenia. Upewnij się, że masz najnowszą wersję zestawu SDK.

Jeśli masz najnowszą wersję zestawu SDK i problem nadal nie został rozwiązany, opublikuj pytanie na forum pytań i odpowiedzi.

Porzucone połączenia lub brakujące urządzenia

Jeśli komputer może nawiązać połączenie z urządzeniem usługi Azure Sphere, ale często przerywa połączenie, może wystąpić konflikt w podsieci IP.

Usługa Azure Sphere używa podsieci 192.168.35.*. Jeśli masz inne oprogramowanie korzystające z tej samej podsieci, wyłącz to oprogramowanie lub ogranicz zakres używanych adresów IP. Obecnie nie można zmienić zakresu adresów IP używanych przez usługę Azure Sphere.

Nie można zastosować możliwości urządzenia

Jeśli podczas próby zastosowania funkcji urządzenia do urządzenia usługi Azure Sphere wystąpią błędy, problem może oznaczać, że system operacyjny na urządzeniu jest nieaktualny. Ten problem może wystąpić, jeśli urządzenie było w trybie offline przez dłuższy czas, podczas którego firma Microsoft zaktualizowała klucze wewnętrzne. Następujące błędy są objawami tego problemu:

Polecenia azsphere device enable-development lub azsphere device enable-cloud-test zwracają błąd podobny do następującego:

error: The device did not accept the device capability configuration. Please check the Azure Sphere OS on your device is up-to-date using 'azsphere device show-deployment-status'.

Polecenie azsphere device capability update zwraca błąd podobny do następującego:

error: Could not apply device capability configuration to device.

Jest to spowodowane nieaktualnym zaufanym magazynem kluczy na urządzeniu. Aby rozwiązać ten problem, postępuj zgodnie z instrukcjami podanymi tutaj.

Nie można utworzyć czterech konwerterów szeregowych USB

Po skonfigurowaniu płytki programistycznej MT3620 w Menedżer urządzeń powinny zostać wyświetlone cztery konwertery szeregowe USB. Jeśli widzisz mniej niż cztery, może wystąpić problem ze sterownikiem FTDI.

Uwaga

Jeśli ta tablica została wcześniej użyta do opracowywania aplikacji RTApp, mogą zostać wyświetlone trzy konwertery zamiast czterech. Jest to normalne i nie reprezentuje błędu.

Jeśli sterownik FTDI nie jest poprawnie zainstalowany, konwertery mogą pojawić się w niewłaściwej lokalizacji, takiej jak Inne urządzenia lub w ogóle nie są wyświetlane.

Aby rozwiązać ten problem:

1. Aby otworzyć Menedżer urządzeń, kliknij przycisk Start i wprowadź Menedżer urządzeń.

2. W obszarze Kontrolery uniwersalnej magistrali szeregowej wybierz pozycję Konwerter szeregowy USB A. Kliknij prawym przyciskiem myszy nazwę, wybierz pozycję Odinstaluj urządzenie i usuń sterownik, jeśli podano opcję:

   

   Powtórz ten krok dla konwertera szeregowego USB B przez konwerter szeregowy USB D.

3. Odłącz płytę programową od komputera i podłącz ją ponownie. Komunikat "MSFT MT3620 Std Interface" powinien pojawić się z ikoną ostrzeżenia trójkąta, która wskazuje, że żaden sterownik nie jest dostępny.

4. Kliknij prawym przyciskiem myszy jeden z urządzeń interfejsu MSFT MT3620 Std i wybierz polecenie Aktualizuj sterownik. Wybierz pozycję Wyszukaj automatycznie dla zaktualizowanego oprogramowania sterowników. Aktualizacja powinna naprawić je wszystkie. Powinny być teraz widoczne cztery konwertery szeregowe USB w sekcji Kontrolery uniwersalnej magistrali szeregowej. Jeśli wszystkie cztery konwertery nie są wyświetlane, powtórz ten krok dla każdego konwertera.

Nie można zainstalować sterowników FTDI

Sterowniki FTDI powinny być pobierane i instalowane automatycznie przez system Windows, gdy urządzenie usługi Azure Sphere jest najpierw podłączone do komputera. Jeśli sterowniki są poprawnie zainstalowane, zobaczysz cztery konwertery szeregowe USB wymienione w obszarze Kontrolery uniwersalnej magistrali szeregowej w Menedżer urządzeń, zgodnie z opisem w temacie Konfigurowanie zestawu deweloperskiego.

System Windows 10 w wersji 2004 nie wyszukuje sterowników. W takim przypadku sterowniki nie są pobierane i instalowane automatycznie. Zostaną wyświetlone następujące elementy wymienione w Menedżer urządzeń:

Aby zainstalować sterowniki, ręcznie pobierz sterowniki z future Technology Devices International (FTDI). Wybierz sterownik zgodny z instalacją systemu Windows (32- lub 64-bitowy).

Aby uzyskać informacje o dacie dostępności i numerach kompilacji wersji systemu Windows 10, zobacz Informacje o wersji systemu Windows 10. Te informacje mogą pomóc w ustaleniu, czy wersja systemu Windows 10 jest starsza, czy nowsza niż wersja 2004.

Problemy z połączeniem spowodowane konfiguracją adaptera TAP-Windows

Narzędzia usługi Azure Sphere komunikują się z dołączonymi tablicami programistycznymi przy użyciu sieci IP za pośrednictwem portu USB. Wymaga to adaptera TAP-Windows z technologii OpenVPN. Procedura instalacji zestawu SDK usługi Azure Sphere instaluje tę kartę na komputerze, jeśli nie jest jeszcze obecna.

Zgłoszono dwa różne typy problemów z adapterem TAP-Windows:

• Jeśli jest już zainstalowana inna wersja karty TAP-Windows lub jeśli urządzenie usługi Azure Sphere nie jest połączone z pierwszym wystąpieniem karty TAP-Windows, narzędzia usługi Azure Sphere mogą nie nawiązać połączenia z urządzeniem.

• W przypadku korzystania z wirtualnej sieci prywatnej Cisco AnyConnect (VPN) karta TAP-Windows może wydawać się nieoznakowana, a komunikacja urządzenia może nie działać. Dzieje się tak, ponieważ sieć VPN może przekierowywać ruch z adresu IP karty TAP.

Upewnij się, że urządzenie usługi Azure Sphere jest podłączone do odpowiedniej karty TAP-Windows

Aby ustalić, czy problem jest związany z adapterem TAP, najpierw sprawdź, ile kart TAP jest zainstalowanych na komputerze, a następnie w razie potrzeby zmodyfikuj instalację.

Aby określić, ile kart TAP jest zainstalowanych na komputerze:

1. Otwórz pozycję Ustawienia systemu Windows i wybierz grupę Sieć i Internet .

2. W obszarze Zaawansowane ustawienia sieciowe wybierz pozycję Zmień opcje karty. Powinna zostać wyświetlona tylko jedna karta TAP, jak pokazano na poniższym zrzucie ekranu:

   

   Jeśli widzisz więcej niż jedną kartę TAP lub widzisz tylko jedną kartę TAP, ale jej nazwa nie jest usługą Azure Sphere, wykonaj następujące kroki, aby odinstalować wszystkie karty TAP i ponownie zainstalować zestaw SDK. Jeśli nie widzisz kart TAP, zainstaluj ponownie zestaw SDK.

Aby odinstalować karty TAP:

1. Kliknij przycisk Start i wprowadź Menedżer urządzeń.

2. W Menedżer urządzeń otwórz pozycję Karty sieciowe i wybierz pozycję TAP-Windows adapter:

   

3. Kliknij prawym przyciskiem myszy kartę TAP-Windows i wybierz polecenie Odinstaluj urządzenie. W oknie dialogowym wybierz pozycję Usuń oprogramowanie sterowników dla tego urządzenia, a następnie kliknij przycisk Odinstaluj.

4. Otwórz wiersz polecenia jako administrator i uruchom następujący skrypt instalatora programu PowerShell:

    powershell -ExecutionPolicy RemoteSigned -File "%ProgramData%\Microsoft\Azure Sphere\TapDriverInstaller\TapDriverInstaller.ps1" Install
   

5. Jeśli instalacja zakończy się pomyślnie, uruchom ponownie usługę Azure Sphere Device Communication Service:

   net stop AzureSphereDeviceCommunicationService

   net start AzureSphereDeviceCommunicationService

6. Zainstaluj ponownie zestaw SDK usługi Azure Sphere.

Poprawianie stanu odłączonego podczas korzystania z klienta sieci VPN Cisco AnyConnect

W przypadku korzystania z klienta sieci VPN Cisco AnyConnect karta TAP-Windows może być widoczna jako odłączona, a komunikacja urządzenia może nie działać. Problem można rozwiązać w następujący sposób:

1. Upewnij się, że masz uprawnienia administratora na komputerze.

2. Otwórz pozycję Ustawienia systemu Windows i wybierz grupę Sieć i Internet .

3. W obszarze Zaawansowane ustawienia sieciowe wybierz pozycję Zmień opcje karty.

4. Kliknij prawym przyciskiem myszy pozycję Azure Sphere TAP-Windows Adapter V9 i wybierz polecenie Właściwości.

5. Na karcie Sieć znajdź wpis Sterownik filtru programu Cisco AnyConnect Network Access Manager i wyczyść element.

   

6. Wybierz przycisk OK , aby zapisać ustawienie i zamknąć właściwości.

7. Sprawdź, czy komunikacja z urządzeniem usługi Azure Sphere działa teraz, otwierając wiersz polecenia i wprowadzając azsphere device show-attached polecenie.

Urządzenie nie odpowiada

Co najmniej jeden z następujących błędów z polecenia azsphere może wskazywać, że uruchomienie usługi Azure Sphere Device Communication Service nie powiodło się:

• warn: Device is not responding. Could not perform version check.​
• Device is not responding. Cannot get device ID.​
• error: Could not connect to the Azure Sphere Device Communication Service. If this issue persists, try uninstalling and reinstalling the Azure Sphere SDK.​
• error: The device is not responding. The device may be unresponsive if it is applying an Azure Sphere operating system update; please retry in a few minutes.

Upewnij się, że wykonano kroki rozwiązywania problemów z komunikacją urządzenia.

Jeśli problem nadal nie został rozwiązany, a maszyna niedawno podjęła aktualizację systemu Windows, usługa komunikacji urządzenia może zakończyć się niepowodzeniem po aktualizacji systemu Windows i w przypadkach, gdy jeden z wewnętrznych plików ustawień JSON lub pliku konfiguracji został uszkodzony.

Niepowodzenie po usłudze Windows Update

Te błędy mogą wystąpić po zaktualizowaniu systemu Windows na komputerze. Czasami usługa Windows Update odinstalowuje sterowniki FTDI wymagane przez usługę komunikacji.

Aby rozwiązać problem:

1. Odłącz urządzenie usługi Azure Sphere od usb i podłącz je ponownie. Po ponownym uruchomieniu urządzenia należy ponownie zainstalować odpowiednie sterowniki.
2. Jeśli odłączenie i ponowne odłączenie urządzenia nie rozwiąże problemu, odinstaluj i ponownie zainstaluj zestaw SDK usługi Azure Sphere.

Plik JSON

Jeśli system Windows nie został ostatnio zaktualizowany, przyczyną błędu może być restore.json plik używany w usłudze.

Aby rozwiązać ten problem:

1. Zapisz kopię następującego pliku:

   c:\windows\serviceprofiles\localservice\appdata\local\Azure Sphere Tools\restore.json

2. Usuń plik z oryginalnej lokalizacji.

3. Zatrzymaj, a następnie uruchom ponownie usługę Azure Sphere Device Communication Service:

   net stop AzureSphereDeviceCommunicationService

   net start AzureSphereDeviceCommunicationService

Uszkodzony plik konfiguracji

Jeśli podczas próby uruchomienia polecenia zostanie zgłoszony błąd, uszkodzony plik konfiguracji może uniemożliwić prawidłowe działanie urządzenia.

Aby rozwiązać ten problem, usuń uszkodzony plik konfiguracji znajdujący się w pliku azsphere\config w systemie Windows lub ~/.azsphere/config w systemie Linux.

System Windows ulega awarii podczas podłączania lub odłączania urządzenia

Tablica deweloperów MT3620 ma mikroukład FT4232HQ Future Technology Devices International (FTDI), który ułatwia komunikację między urządzeniem a komputerem. Oficjalny sterownik FTDI, połączony model sterowników (CMD), zawiera dwa sterowniki: jeden zapewnia dostęp za pośrednictwem interfejsu API D2XX, a drugi zapewnia wirtualny port com (VCP) dla tego samego urządzenia. Oba sterowniki są instalowane domyślnie, jeśli mikroukład FTDI ma włączony tryb VCP. Może to spowodować awarię systemu Windows w przypadku cyklu zasilania mikroukładu.

Aby rozwiązać ten problem, możesz wyłączyć tryb VCP dla mikroukładu FTDI. Należy użyć narzędzia FT_PROG, aby przeprogramować EEPROM mikroukładu FTDI.

1. Zobacz narzędzie do programowania FT_PROG FTDI, aby dowiedzieć się, jak pobrać i zainstalować to narzędzie.

2. Uruchom FT_PROG i znajdź dołączone urządzenie zgodnie z opisem w FT_PROG aplikacji graficznego interfejsu użytkownika.

3. W widoku Drzewo urządzeń rozwiń sekcję Hardware Specific (Specyficzne dla sprzętu). Powinny zostać wyświetlone cztery porty.

   

4. Wybierz pozycję Port A i wybierz pozycję D2XX Direct zamiast wirtualnego portu com.

   

5. Powtórz poprzedni krok dla portów C i Port D. Port B powinien być już w trybie bezpośrednim D2XX.

6. Wybierz ikonę Urządzenia programu (przypomina błyskawicę), aby przejść do trybu programowania.

   

7. Wybierz pozycję Program , aby zaprogramować program EEPROM, a następnie poczekaj na jego zakończenie.

   

8. Odłącz urządzenie od portu USB, a następnie ponownie podłącz je do cyklu zasilania urządzenia i powoduje, że zmiana zostanie w życie. W Menedżer urządzeń systemu Windows sekcja Porty (COM i LPT) powinna teraz zawierać trzy mniej portów COM. Liczba urządzeń uniwersalnej magistrali szeregowej powinna pozostać taka sama.

Utracono połączenie z urządzeniami spoza usługi Azure Sphere FTDI po włączeniu debugowania RTApp

Niektórzy użytkownicy usługi Azure Sphere zgłosili, że nie mogą już komunikować się z innymi dołączonymi urządzeniami spoza usługi Azure Sphere FTDI po użyciu polecenia azsphere device enable-development --enable-rt-core-debugowania w celu opracowywania i debugowania aplikacji RTApps z komputera hosta.

Jeśli na przykład masz urządzenie usługi Azure Sphere i inne urządzenie FTDI dołączone do komputera, przed uruchomieniem polecenia mogą zostać wyświetlone dwa uniwersalne kontrolery szeregowe o nazwie USB Serial Converter B w systemie Windows Menedżer urządzeń.

Po wykonaniu polecenia oba urządzenia USB Serial Converter B znikają z sekcji Kontroler uniwersalnej magistrali szeregowej, a dwa nowe urządzenia są wyświetlane na urządzeniach uniwersalnej magistrali szeregowej w Menedżer urządzeń.

Przyczyna

Ten problem występuje, ponieważ polecenie azsphere device enable-development --enable-rt-core-debugging instaluje nowy sterownik dla portu B mikroukładu FTDI na mt3620; port staje się interfejsem MSFT MT3620 Std. Jednak instalacja tego sterownika przypadkowo zmienia sterownik dla portu B innego urządzenia spoza usługi Azure Sphere. Ze względu na ograniczenie w bibliotece bazowej wszystkie urządzenia FTDI z tym samym vid (0x0403) i PID (0x6011) będą miały zastąpiony sterownik Port B.

Rozwiązanie

Wykonaj następujące kroki, aby ręcznie przywrócić sterownik dla wszystkich urządzeń spoza usługi Azure Sphere do poprzedniej wersji:

1. W Menedżer urządzeń wybierz urządzenie spoza usługi Azure Sphere (w tym przykładzie inny quad FTDI Quad GZ), a następnie kliknij prawym przyciskiem myszy i wybierz polecenie Aktualizuj sterownik.

2. W obszarze Update Drivers (Sterowniki aktualizacji) wybierz pozycję Browse my computer for driver software (Przeglądaj mój komputer pod kątem oprogramowania sterowników).

   

3. Wybierz pozycję Pozwól mi wybrać z listy dostępnych sterowników na moim komputerze.

   

4. Wybierz z listy sterownik USB Serial Converter B , a następnie kliknij przycisk Dalej.

   

5. Kliknij przycisk Zamknij w oknie potwierdzenia.

6. Menedżer urządzeń powinien zawierać port B dla innego urządzenia FTDI jako konwerter szeregowy USB B, który wskazuje, że używa oficjalnego sterownika FTDI. Sterownik mt3620 pozostaje interfejsem MSFT MT3620 Std.

   

Dodatkowe informacje

• Jeśli podłączasz inne nowe urządzenie spoza usługi Azure Sphere FTDI po uruchomieniu polecenia azsphere device enable-development --enable-rt-core-debugging , to urządzenie zostanie przypisane do sterownika usługi Azure Sphere MT3620 w ten sam sposób. Powtórz powyższe kroki, aby przywrócić urządzenie do oficjalnego sterownika FTDI.

• Jeśli odłączysz i ponownie podłączasz urządzenie spoza usługi Azure Sphere FTDI po powrocie go do oficjalnego sterownika FTDI, urządzenie zachowa oficjalny sterownik FTDI.

• Jeśli ponownie uruchomisz polecenie azsphere device enable-development --enable-rt-core-debugowanie ponownie po wycofaniu sterownika, urządzenie inne niż FTDI usługi Azure Sphere zostanie ponownie zastąpione jego sterownikiem i należy wykonać kroki opisane w temacie Rozwiązanie , aby przywrócić oficjalny sterownik FTDI. Dzieje się tak niezależnie od tego, czy urządzenie inne niż Azure Sphere FTDI jest dołączone do komputera, gdy polecenie azsphere device enable-development --enable-rt-core-debug jest uruchamiane.

Polecenia nie rozpoznane

Jeśli podczas wprowadzania polecenia azsphere zostanie wyświetlony następujący błąd, upewnij się, że używasz programu PowerShell lub standardowego wiersza polecenia w systemie Windows.

'azsphere' is not recognized as an internal or external command, operable program or batch file.

Instalator zawiesza się na poziomie 60 procent

Instalator zawiesza się na poziomie 60%, a użytkownik jest poinformowany, że uruchomienie usługi device communication service nie powiodło się. Zwykle występuje to, gdy instalacja sterownika TAP kończy się niepowodzeniem w dziwny sposób, pozostawiając system w nieokreślonym stanie.

Upewnij się, że problem dotyczy sterownika TAP

1. Otwórz Podgląd zdarzeń systemu Windows, aby sprawdzić dzienniki.

2. W dzienniku aplikacji i dzienniku usługi Azure Sphere Device Communication Service poszukaj następującego komunikatu o błędzie:

   "SerialSlipToTun.TunInterfaceSetupException: Błąd dostępu do ustawień rejestru tun ---> System.Collections.Generic.KeyNotFoundException: nie znaleziono urządzenia naciśnięcia Tun, ---> System.Security.SecurityException: Żądany dostęp do rejestru jest niedozwolony."

   

3. Podczas sprawdzania dziennika aplikacji przefiltruj dziennik, aby uniknąć wyświetlania wielu niepowiązanych komunikatów. Na karcie Akcja wybierz pozycję Filtruj bieżący dziennik.

4. Wybierz pozycję Błąd, a następnie wybierz pozycję AzureSphereDeviceCommunicationService , aby wyświetlić listę tylko komunikatów o błędach z usługi Azure Sphere Device Communication Service.

   

5. Jeśli nie możesz odnaleźć błędu w dzienniku aplikacji lub dzienniku usługi komunikacji urządzeń usługi Azure Sphere, może to nie być problem ze sterownikiem TAP.

Aby rozwiązać problem ze sterownikiem TAP, wykonaj następujące kroki:

1. Przejdź do Centrum sieci i udostępniania i wybierz pozycję Zmień ustawienia karty.

   

2. W obszarze Połączenia sieciowe w obszarze Azure Sphere wybierz pozycję TAP-WIndows Adapter V9 i otwórz jego właściwości.

   

3. W obszarze Właściwości usługi Azure Sphere wybierz pozycję Protokół internetowy w wersji 4 (TCP/IPv4), a następnie wybierz pozycję Właściwości , aby wyświetlić ustawienia protokołu.

   

4. Upewnij się, że adres IP jest ustawiony na 192.168.35.1, a maska podsieci jest ustawiona na 255.255.255.0.

5. Spróbuj ponownie wykonać instalatora. Jeśli nadal się zawiesza, spróbuj zresetować połączenia sieciowe. Aby przeprowadzić resetowanie, przejdź do pozycji Ustawienia>Stan sieci i Internetu>i wybierz pozycję Resetowanie sieci w dolnej części strony.

   Ważne

   Zresetowanie sieci spowoduje zresetowanie wszystkich ustawień sieciowych.

Zatrzymywanie usługi Azure Sphere Device Communication Service

Jeśli instalator zawiesza się, możesz zatrzymać usługę Azure Sphere Device Communication Service przy użyciu polecenia taskkill .

Wykonaj te kroki:

1. Skopiuj identyfikator PID dla usługi AzureSphereDeviceCommunicationService.

   • Przejdź do karty Usługi Menedżera>zadań i zanotuj identyfikator PID dla usługi AzureSphereDeviceCommunicationService lub
   • W wierszu polecenia wpisz tasklist /fi "SERVICES eq AzureSphereDeviceCommunicationService*" i skopiuj identyfikator PID z danych wyjściowych.

2. Wpisz następujące polecenie w wierszu polecenia, aby zakończyć usługę. Polecenie taskkill kończy proces odpowiadający numerowi identyfikatora procesu. Opcja /f jest używana do wymuszonego zakończenia procesu.

   taskkill /PID <DCS_PID> /f

3. Spróbuj ponownie wykonać instalatora.

Nie można zatrzymać usługi Azure Sphere Device Communication Service

Podczas uaktualniania istniejącego zestawu AZURE Sphere SDK może zostać wyświetlony komunikat "Nie można zatrzymać usługi "Usługa "Azure Sphere Device Communication Service" (AzureSphereDeviceCommunicationService). Sprawdź, czy masz wystarczające uprawnienia, aby zatrzymać usługi systemowe". Jeśli zostanie wyświetlony ten komunikat, uruchom ponownie i uruchom instalatora ponownie.

Komunikacja z urządzeniami jest uszkodzona, gdy jest używane tunelowanie podzielone

Gdy komputer deweloperzy jest połączony z firmową siecią VPN, a tunelowanie podzielone jest wyłączone przez konfigurację sieci VPN, komputer dewelopera może nie być w stanie komunikować się z urządzeniem usługi Azure Sphere.

Aby rozwiązać ten problem, wykonaj jedną z następujących czynności:

• Odłącz się od firmowej sieci VPN i spróbuj ponownie nawiązać połączenie z urządzeniem usługi Azure Sphere.
• Zmień konfigurację sieci VPN, aby zezwolić na tunelowanie podzielone.

Problemy z komunikacją mogą być również spowodowane konfiguracją adaptera TAP-Windows. Zobacz sekcję Problemy z połączeniem spowodowane konfiguracją adaptera TAP-Windows.

Nie można zainstalować ani odinstalować zestawu SDK usługi Azure Sphere w systemie Windows 11

Po uaktualnieniu do systemu Windows 11 użytkownicy nie mogą zainstalować ani odinstalować zestawu SDK usługi Azure Sphere. Aby rozwiązać ten problem, zainstaluj najnowszą wersję zestawu Azure Sphere SDK dla systemu Windows. Po zainstalowaniu wersji 21.07 Update 2 lub nowszej będzie można odinstalować zestaw SDK.

Nie można skompilować ani debugować aplikacji RTApps

Jeśli narzędzie CMake zgłasza błędy odnajdywania łańcuchów narzędzi lub openocd podczas próby skompilowania lub debugowania aplikacji RTApp, upewnij się, że:

• Zainstalowano osadzony łańcuch narzędzi GNU Arm dla środowiska deweloperskiego.
• Podano poprawną ścieżkę do openocd zgodnie z opisem w artykule Samouczek: tworzenie aplikacji obsługującej czas rzeczywisty.

Rozwiązywanie problemów z komunikacją urządzeń przed 23.05

Ostrzeżenie

Te kroki dotyczą użytkowników z zestawem SDK w wersji 22.11 lub starszej. Sprawdź, czy zainstalowana wersja zestawu SDK to 22.11 lub starsza, uruchamiając polecenie azsphere show-version.

W systemach Linux z zestawem SDK w wersji 22.11 lub starszej skrypt azsphere_connect.sh musi być uruchamiany za każdym razem, gdy podłączasz urządzenie lub odłączasz go lub odłączyć. Skrypt odświeża połączenia urządzenia i duplikuje sterownik jądra, który mapuje ruch sieciowy na urządzenie.

Jeśli występują problemy z komunikacją, zacznij od następujących podstawowych kroków:

1. Upewnij się, że urządzenie jest podłączone za pomocą portu USB.

2. Uruchom skrypt azsphere_connect.sh, jeśli jeszcze tego nie zrobiono.

3. Sprawdź, czy możesz komunikować się bezpośrednio z urządzeniem. Przejdź do https://192.168.35.2/status witryny w przeglądarce internetowej. Ignoruj i odrzucaj wszystkie przedstawione ostrzeżenia SSL. Powinny zostać wyświetlone dane wyjściowe podobne do: {"uptime":56} w oknie przeglądarki internetowej.

Uwaga

Możesz również wykonać ten krok z poziomu wiersza polecenia przy użyciu polecenia curl https://192.168.35.2/status --insecure.

1. Jeśli błąd będzie się powtarzać, odłącz urządzenie od portu USB, podłącz je ponownie i zaczekaj na jego ponowne uruchomienie. Następnie uruchom skrypt azsphere_connect.sh .

2. Jeśli błąd będzie nadal występować, upewnij się, że nie ma konfliktów podsieci z innymi narzędziami sieciowymi.