Bagikan melalui

Mempersiapkan Azure Sphere untuk Ethernet

  • Artikel

Untuk berkomunikasi melalui Ethernet, perangkat Azure Sphere memerlukan adaptor Ethernet eksternal dan gambar konfigurasi papan. Langkah-langkah berikut diperlukan untuk mempersiapkan perangkat Anda untuk jaringan melalui Ethernet:

  1. Sambungkan adapter ke perangkat Anda.

  2. Buat dan sebarkan gambar konfigurasi papan.

  3. Aktifkan antarmuka Ethernet.

Hati

Jika perangkat Anda tersambung melalui Ethernet, jaringan lalu lintas rendah diperlukan untuk mencegah hilangnya data atau kinerja yang buruk. Perangkat akan kehilangan data dari paket non-TCP masuk ketika terdapat lalu lintas masuk yang signifikan di jaringan. Data biasanya tidak hilang dari paket TCP masuk, terlepas dari volume lalu lintas, karena TCP akan mengirimkan ulang paket yang jatuh. Namun, pemancaran ulang adalah dengan biaya kinerja.

Sambungkan adapter ke perangkat Anda

Lihat Papan adaptor Ethernet yang didukung dan modul untuk daftar adaptor Ethernet yang didukung dan instruksi tentang cara menyambungkannya ke papan pengembangan Azure Sphere.

Membuat dan menyebarkan gambar konfigurasi papan

Gambar konfigurasi papan diperlukan untuk setiap adaptor Ethernet yang digunakan dengan Azure Sphere. Gambar konfigurasi papan berisi informasi bahwa Azure Sphere Security Service harus menambahkan dukungan untuk Ethernet ke Azure Sphere OS. Anda harus membuat paket gambar konfigurasi papan untuk adaptor Ethernet Anda dan menyebarkannya bersama dengan paket gambar aplikasi Anda. Anda dapat memuat sisi paket gambar konfigurasi papan untuk pengembangan dan proses debug. Anda juga dapat menyebarkan paket gambar konfigurasi papan dari awan, bersama dengan aplikasi Azure Sphere, untuk penggunaan bidang. Konfigurasi papan tidak dihitung terhadap memori Flash atau RAM yang disediakan untuk aplikasi tingkat tinggi.

Membuat paket gambar konfigurasi papan

Untuk membuat paket gambar konfigurasi papan, gunakan perintah Azsphere image-package pack-board-config CLI.

Catatan

pack-board-config saat ini tidak didukung di ekstensi Azure CLI.

Memuat sisi paket gambar konfigurasi papan

Untuk menggunakan paket gambar konfigurasi papan selama pengembangan dan proses debug:

  1. Persiapkan perangkat untuk pengembangan dan proses debug:

    az sphere device enable-development --resource-group MyResourceGroup --catalog MyCatalog --device <DeviceIdValue>

  2. Hapus aplikasi apa pun yang sudah ada dari perangkat menggunakan perintah hapus sideload perangkat bola az . Sangatlah penting untuk menghapus aplikasi yang sudah ada sebelum Memuat paket gambar konfigurasi papan untuk menghindari konflik sumber daya antara aplikasi yang sudah ada dan konfigurasi papan.

  3. Muat sisi paket gambar konfigurasi papan. Jika Anda membuat file konfigurasi papan kustom di bagian sebelumnya, yang dapat dimuat samping sekarang. Opsi prasetel meliputi yang berikut ini:

    Melihat MT3620 Ethernet Shield untuk Microchip ENC28J60 NIC:

    az sphere device sideload deploy --image-package lan-enc28j60-isu0-int5.imagepackage

    Modul Klik Avnet Rev1 Devkit untuk Wiznet W5500 NIC:

    az sphere device sideload deploy --image-package lan-w5500-isu1-int2.imagepackage

    Modul Klik Avnet Rev2 Devkit untuk Wiznet W5500 NIC:

    az sphere device sideload deploy --image-package lan-w5500-isu0-int5.imagepackage

  4. Muat sisi aplikasi, baik dengan menggunakan Visual Studio atau dengan menggunakan perintah penyebaran sideload perangkat bola az .

Cloud menyebarkan paket gambar konfigurasi papan

Untuk menyebarkan paket gambar konfigurasi papan melalui awan, perangkat Anda harus memiliki produk, termasuk dalam grup perangkat, dan tidak boleh menginstal kapabilitas AppDevelopment. Lihat Membuat penyebaran untuk mencari tahu cara menyiapkannya.

Setelah perangkat siap, Anda dapat menyebarkan gambar konfigurasi papan beserta gambar aplikasi dalam satu penyebaran.

Untuk membuat penyebaran:

  1. Unggah paket gambar ke katalog Azure Sphere Anda menggunakan add gambar bola az.
  2. Buat penyebaran baru untuk grup perangkat untuk gambar yang diunggah menggunakan pembuatan penyebaran bola az.
az sphere deployment create --resource-group <resource-group-name> --catalog <catalog-name> --product <product-name> --device-group <device-group-name> --images <image-ID>

Ganti <ID-gambar> dengan ID gambar paket gambar.

Menghapus konfigurasi papan muat sisi

Jika anda sideload konfigurasi papan selama pengembangan, Anda mungkin nanti perlu menghapus konfigurasi tersebut sehingga aplikasi lain bisa menggunakan sumber daya yang dicadangkan papan. Jika Anda mencoba menjalankan aplikasi yang menggunakan sumber daya ini saat konfigurasi papan dimuat di perangkat Azure Sphere, kesalahan konflik pin akan terjadi.

Untuk menghapus konfigurasi papan, ikuti langkah-langkah ini:

  1. Cantumkan gambar yang terinstal di perangkat:

    az sphere device image list-installed

  2. Temukan ID komponen untuk konfigurasi papan dalam daftar:

     {
 "does_image_type_require_restart": true,
 "image_type": "Board configuration",
 "images": [
   {
     "length_in_bytes": 428,
     "replica_type": 0,
     "uid": "839e699a-1b23-44de-bc56-f2b19e472098",
     "uncompressed_length_in_bytes": 428
   }
 ],
 "is_update_staged": false,
 "name": "lan-enc28j60-isu0-int5_29f10d",
 "uid": "29f10d1e-29aa-4ae0-a48c-cc24305b288a"
 }

    ID komponen adalah uid yang terkait dengan konfigurasi papan, jadi misalnya di output di atas dimulai "29f10...".

  3. Hapus paket gambar konfigurasi papan dengan menentukan ID komponennya:

    az sphere device sideload delete --component-id 29f10d1e-29aa-4ae0-a48c-cc24305b288a

  4. Hidupkan ulang perangkat dengan menekan tombol Reset atau mengeluarkan perintah mulai ulang perangkat bola az .

Mengaktifkan antarmuka Ethernet

Setelah konfigurasi papan dimuat dan perangkat di-boot ulang, antarmuka akan diaktifkan secara otomatis. Jika Anda ingin menonaktifkan antarmuka, gunakan perintah nonaktifkan jaringan perangkat bola az atau panggil fungsi Networking_SetInterfaceState , yang merupakan bagian dari API konfigurasi jaringan.

Semua antarmuka menggunakan alamat IP dinamis secara default. Lihat Menggunakan layanan jaringan untuk detail tentang tipe layanan yang dapat digunakan aplikasi Azure Sphere.

Mengonfigurasi Azure Sphere untuk Ethernet

Setelah menyambungkan perangkat Azure Sphere ke adaptor Ethernet yang didukung dan menyebarkan gambar konfigurasi papan, Anda dapat mengonfigurasi perangkat Azure Sphere untuk menyambungkan ke jaringan dari baris perintah (CLI) atau dari aplikasi menggunakan Pustaka Aplikasi SDK Azure Sphere (Applibs).

Konfigurasi Ethernet menggunakan CLI

Untuk mengelola konfigurasi Ethernet dari baris perintah, gunakan perintah CLI jaringan perangkat bola az. Misalnya, perintah jaringan perangkat mengaktifkan antarmuka ethernet pada perangkat yang terpasang.

az sphere device network enable --interface "eth0"

Untuk menggunakan jaringan Ethernet yang dikonfigurasi, antarmuka jaringan (eth0) harus aktif. Gunakan perintah daftar antarmuka jaringan perangkat untuk menentukan apakah antarmuka aktif.


az sphere device network list-interfaces

Gunakan perintah aktifkan jaringan perangkat untuk mengaktifkannya jika perlu.


az sphere device network enable --interface eth0

Konfigurasi Ethernet menggunakan Applibs

Untuk mengonfigurasi Ethernet, aplikasi Anda harus menggunakan API jaringan applibs.

Sertakan file header ini dalam aplikasi Anda:

#include <applibs/networking.h>

Manifes aplikasi harus menyertakan kapabilitas NetworkConfig.

 "Capabilities": {
  "NetworkConfig" : true
}

Gunakan fungsi Networking_GetInterfaceConnectionStatus untuk menentukan apakah antarmuka jaringan aktif.

Networking_GetInterfaceConnectionStatus("eth0", &currentInterfaceStatus);

Untuk mengaktifkan antarmuka jaringan, gunakan fungsi Networking_SetInterfaceState .

Networking_SetInterfaceState("eth0", true);

Catatan

Jika kedua antarmuka jaringan (wlan0 dan eth0) aktif dan tersambung, antarmuka tertentu yang akan digunakan perangkat untuk komunikasi tidak deterministik. Jika Anda ingin mengontrol antarmuka jaringan mana yang digunakan pada waktu tertentu aplikasi Anda harus menggunakan fungsi Networking_SetInterfaceState() untuk mengaktifkan antarmuka yang diinginkan secara eksplisit dan antarmuka lainnya nonaktif. Sampel aplikasi tingkat tinggi klien DHCP menunjukkan antara hal-hal lain, cara beralih antar antarmuka dengan menetapkan nilai yang mewakili salah satu dari dua antarmuka ke variabel global.

Sampel

Azure IoT menunjukkan cara menggunakan API Azure IoT SDK C dalam aplikasi Azure Sphere untuk berkomunikasi dengan Azure IoT Hub atau Azure IoT Central.

Aplikasi tingkat tinggi klien DHCP menunjukkan cara memperpanjang atau merilis alamat IP saat ini yang telah ditetapkan server DHCP jaringan ke perangkat MT3620.

HTTPS cURL Easy menunjukkan mengambil konten melalui HTTPS menggunakan API 'mudah' cURL

HTTPS cURL Multi mendemonstrasikan pengambilan konten melalui HTTPS menggunakan API 'multi' cURL.

Power Down aplikasi tingkat tinggi menunjukkan fungsionalitas Power Down untuk platform Azure Sphere.

Layanan jaringan privat menunjukkan cara menyambungkan perangkat Azure Sphere ke jaringan privat dan menggunakan layanan jaringan.

Aplikasi tingkat tinggi WolfSSL menunjukkan penggunaan WolfSSL untuk jabat tangan SSL dalam aplikasi tingkat tinggi.

Catatan

Sampel berikut berasal dari Azure Sphere Gallery, yang merupakan kumpulan sampel perangkat lunak dan perangkat keras yang tidak tertandingi dari Microsoft. Untuk informasi selengkapnya, lihat Galeri Azure Sphere.

Mencetak MAC dan alamat IP antarmuka jaringan mencetak alamat MAC dan IP antarmuka jaringan tertentu.

OSNetworkRequirementChecker-HLApp melakukan dua tes diagnostik jaringan perangkat (MT3620).