sdm api

API Manajer Debug Aman

Repositori ini berisi definisi API untuk Secure Debug Manager (SDM).

SDM adalah komponen sisi host yang mengimplementasikan protokol debug aman. Arsitektur sistem abstrak untuk debug aman ditunjukkan di bawah ini.

Klien Debug adalah proses yang meminta akses debug pada target yang terkunci. Biasanya ini berupa IDE atau debugger mandiri yang digunakan oleh pengembang atau teknisi, namun bisa berupa alat apa pun yang memerlukan akses debug ke target. SDM digunakan oleh Klien Debug untuk membuka kunci akses debug dengan aman.

Persyaratan SDM API adalah sebagai berikut:

• Mendukung protokol debug aman apa pun yang menggunakan tautan debug untuk komunikasi.
• Dapat digunakan untuk klien debug apa pun.
• Tidak bergantung pada tautan debug.
• Debug arsitektur independen.
• OS independen (meskipun perpustakaan bersama untuk implementasi akan bergantung pada OS).

SDM API memungkinkan alat untuk mendukung berbagai implementasi debug yang aman menggunakan satu API. Vendor alat didorong untuk menggunakan API ini untuk meringankan beban dukungan pada penyedia silikon dan perangkat lunak, serta mereka sendiri, dan untuk menyediakan integrasi debug aman yang sederhana dan mudah digunakan bagi penggunanya.

Tujuannya adalah agar vendor silikon atau perangkat lunak menyediakan implementasi API sebagai perpustakaan bersama, yang disertakan dengan alat sebagai bagian dari dukungan perangkat.

SDM API dirancang untuk menjadi agnostik arsitektur debug, sehingga dapat digunakan pada arsitektur debug selain Arm ADI. Namun, implementasi API tertentu hanya akan mendukung arsitektur debug yang digunakan untuk menulisnya. Selain itu, saat ini hanya API untuk Arm ADI yang telah ditentukan.

SDM API mendukung protokol debug aman apa pun. Implementasi referensi disediakan untuk protokol PSA Authenticated Debug Access Control (ADAC). Sebagai bagian dari implementasi referensi ini, API tingkat rendah tambahan direncanakan. Ini akan menentukan lapisan seperti penyedia Kredensial dan antarmuka kotak surat Debug.

Struktur

File header secure_debug_manager.h utama terletak di direktori include/ .

File konfigurasi doxygen tersedia untuk menghasilkan dokumentasi untuk API.

File manifes XML akan disertakan dengan pustaka bersama SDM. File xml/example-manifest.xml yang disertakan adalah contoh manifes untuk tujuan eksperimen.

Manifes memiliki beberapa tujuan:

• Hal ini memungkinkan satu implementasi SDM dikonfigurasikan untuk target yang berbeda.
• Ini memberikan informasi klien debug tentang perpustakaan.
• Ini menjelaskan opsi antarmuka pengguna.

Akhirnya skema akan dibuat untuk manifes.

Status

Struktur keseluruhan API telah didefinisikan dengan baik, dan beberapa detail masih dalam proses. Semua umpan balik dihargai.

API tingkat rendah terkait PSA ADAC belum ditentukan.

Lisensi

File-file tersebut dilindungi oleh lisensi BSD 3-Clause.

Hak Cipta © 2020-2022 Arm Ltd.