以vsomeip-local.json為例:
{ "unicast" : "10.0.2.15", "logging" : { "level" : "debug", "console" : "true", "file" : { "enable" : "false", "path" : "/tmp/vsomeip.log" }, "dlt" : "false" }, "applications" : [ { "name" : "service-sample", "id" : "0x1277" }, { "name" : "client-sample", "id" : "0x1344" } ], "services" : [ { "service" : "0x1234", "instance" : "0x5678", "unreliable" : "30509", "multicast" : { "address" : "224.225.226.233", "port" : "32344" }, "events" : [ { "event" : "0x0777", "is_field" : "true", "update-cycle" : 2000 }, { "event" : "0x0778", "is_field" : "true", "update-cycle" : 0 }, { "event" : "0x0779", "is_field" : "true" } ], "eventgroups" : [ { "eventgroup" : "0x4455", "events" : [ "0x777", "0x778" ] }, { "eventgroup" : "0x4465", "events" : [ "0x778", "0x779" ], "is_multicast" : "true" }, { "eventgroup" : "0x4555", "events" : [ "0x777", "0x779" ] } ] } ], "routing" : "service-sample", "service-discovery" : { "enable" : "true", "multicast" : "224.244.224.245", "port" : "30490", "protocol" : "udp", "initial_delay_min" : "10", "initial_delay_max" : "100", "repetitions_base_delay" : "200", "repetitions_max" : "3", "ttl" : "3", "cyclic_offer_delay" : "2000", "request_response_delay" : "1500" } }
*'unicast':主機系統的IP地址。
'*netmask':用於指定主機系統子網的網絡掩碼。
*'device' (optional):如果指定,IP端點將綁定到此設備
*'diagnosis':用於構建客戶端標識符的診斷地址(byte)。如果沒有另外指定標識符,這個診斷地址分配給所有客戶端中最重要的字節(例如通過預定義的客戶端ID)。
*'diagnosis_mask':診斷掩碼(2字節)用於控制允許的最大診斷量ECU上的並發vsomeip客戶端和客戶端ID的起始值。
默認值為“0xFF00”,意思是客戶端ID的最高有效字節保留用於診斷地址和客戶端ID將以指定的診斷地址開始。最大客戶端數為255,作為反轉掩碼的漢明權重是8(2^8=256-1(對於路由管理器)=255)。生成的客戶端ID診斷地址為0x45的范圍為0x4501到0x45ff。將掩碼設置為“0xFE00”會將客戶端ID范圍加倍,將其設置為511個客戶端倒置面罩的漢明重量增加1。有診斷地址在0x45中,當0x4500中的位8被屏蔽時,客戶端ID的起始值為0x4401,這將產生0x4400到0x45ff的客戶機ID范圍。
*'network':用於在一台主機上支持多個路由管理器的網絡標識符。這設置會更改“/dev/shm”中共享內存段和“/tmp/”中的unix域套接字。默認為“vsomeip”,表示共享內存將被命名為“/dev/shm/vsomeip”,unix域套接字將被命名為`/tmp/vsomeip-$CLIENTID`
*'logging':用於日志記錄
**'level':指定日志級別(有效值:_trace_, _debug_, _info_, _warning_,_error_, _fatal_)
**'console':指定是否啟用通過控制台的日志記錄(有效值:_true,false_)
**'file':log文件
***'enable':指定是否應創建日志文件(有效值:_true,false_)。
***'path':日志文件的絕對路徑。
**'dlt':指定是否啟用診斷日志和跟蹤(DLT)(有效值:_true,false_)。
**'version':配置vsomeip版本的日志記錄
***'enable':啟用或禁用vsomeip版本的循環日志記錄,默認為true(有效值:_true,false_)
***'interval':以秒為單位配置間隔以記錄vsomeip版本。默認值為10。
**'memory_log_interval':配置路由管理器記錄其使用內存的時間間隔(以秒為單位)。當使用時,設置大於零的值將啟用日志記錄。
**'status_log_interval':配置路由管理器記錄其內部狀態日志的時間間隔(以秒為單位)。設置大於零的值將啟用日志記錄。
*anchor:config-tracing[]'tracing':配置跟蹤,可選
**'enable':指定是否啟用對SOME/IP消息的跟蹤(有效值:_true,false_)。默認值為_false_。如果啟用了跟蹤,消息將通過<traceconnector,Trace Connector>
**'sd_enable':指定是否對SOME/IP服務發現消息進行跟蹤已啟用(有效值:_true,false_)。默認值為_false。
** 'channels (array)' (optional):包含指向DLT的通道,注意:您可以設置多個到DLT的通道,以便轉發信息。
***'name':通道的名字
***'id':通道的ID
**'filters (array)' (optional):消息的過濾器,只有經過過濾的消息才會被轉發DLT
***'channel' (optional):過濾后的消息轉發到DLT的通道id。如果未指定任何通道,則使用默認通道(TC)。如果你想使用在多個不同的通道中進行篩選,可以提供一組通道ID。注意:如果使用多個通道的正濾波器,則相同的消息將被多次進入DLT
*** 'matches' (optional):在跟蹤中包含/排除消息的標准規范。
*** 'type' (optional):
*'applications (array)':包含使用此配置文件的主機系統的應用程序
**'name':應用程序的名稱。
**'id':應用程序的id。通常其高位字節等於診斷地址。在這個低字節必須與零不同。因此,如果診斷地址為0x63,則有效值的范圍從0x6301到0x63FF。也可以使用高字節的id值與診斷地址不同。
** 'max_dispatchers' (optional):應用於執行應用程序回調的最大線程數。默認值為10
** 'max_dispatch_time' (optional):應用程序回調最大阻塞時間,默認值為100ms。
** 'threads' (optional):在應用程序內處理消息和事件的內部線程數。有效值為1-255。默認值為2。
** 'io_thread_nice' (optional):內部線程處理消息和事件的良好級別。僅限POSIX/Linux。有關實際值,請參閱nice()文檔。
**'request_debounce_time' (optional):指定request-service 消息發送到路由管理器的去抖動時間間隔(毫秒)。如果一個應用程序在短時間內請求多個服務向路由管理器發送消息的負載,以及來自路由管理器(包含請求服務的路由信息,如果可用)可以大幅減少。如果未指定,默認值為10ms。
**'plugins' (optional array):
***'name':插件的名稱。
***'type':插件的類型。(有效值 _application_plugin_)。應用程序插件擴展了應用程序級別的功能。通過vsomeip和基本應用程序狀態(INIT/START/STOP)和can得到通知,基於這些通知,運行時可以訪問標准的“應用程序”API。
** 'overlay' (optional):包含覆蓋特定配置元素的配置的路徑(單播、網絡掩碼、設備、網絡、診斷地址和掩碼、服務發現)應用這允許從單個進程管理不同的網絡地址。當編譯時配置了ENABLE_CONFIGURATION_OVERLAYS才可用。
*`services` (array):服務提供列表
**`service`:服務的id
**`instance`:服務實例的id。
**`protocol` (optional):用於實現服務實例的協議。默認是is _someip_,如果提供了不同的設置,vsomeip不會打開指定的端口(服務器端)或未連接到指定端口(客戶端)。因此此選項可用於讓服務發現宣布一個正在運行的服務外部實現。
**`unicast` (optional):主機服務實例的單播。注:如果需要使用外部服務實例,則需要單播地址,但服務發現被禁用。在這種情況下,提供的單播地址用於訪問服務實例。
**`reliable`:指定與服務的通信分別是可靠的TCP協議用於通信。
***`port`:TCP端點的端口。
***`enable-magic-cookies`:指定是否啟用了magic Cookie(有效值:_true_,_false_)。
** `unreliable`:分別指定與服務的通信不可靠UDP協議用於通信(有效值:UDP端點的port)。
**`events` (array):包含服務的事件列表
***`event`:事件id
***`is_field`:指定事件是否為字段類型。字段是getter、setter和notification event的組合。至少包含一個getter、setter或notifier。通知程序發送一個事件傳輸更改時字段的當前值的消息。
***`is_reliable`:分別指定通信是否可靠,事件是否與TCP協議一起發送(有效值:_true_,_false_)。如果值為_false ,將使用UDP協議。
**`eventgroups` (array):事件組列表
***`eventgroup`:事件組的id
***`events` (array):事件id列表
***`multicast`:指定用於發布事件組的多播
****`address`:多播地址
****`port`:多播端口
***`threshold`:指定何時使用多播以及何時使用單播發送通知事件。此值必須設置為非負數。如果設置為零,則eventgroup的所有事件將通過單播發送。否則,只要訂閱數低於閾值事件將通過單播發送,如果訂閱數大於或等於閾值,將多播發送。這意味着,閾值為1將導致所有事件正在通過多播發送。默認值為0。
**`debounce-times` (object):用於配置nPDU功能。這將在中詳細描述<<npdu,vSomeIP nPDU feature>>.
**`someip-tp` (object):用於配置SOME/IP-TP功能。這里有一個例子<<someiptp, SOME/IP-TP>>.
***`service-to-client` (array):包含從節點發送的響應、字段和事件的ID到通過 SOME/IP-TP 分段的遠程客戶端,如果超過UDP通信的最大消息大小且此處未列出ID否則,將丟棄消息。
***`client-to-service` (array):如果超過UDP通信的最大消息大小,包含從節點發送請求的ID到一個通過 SOME/IP-TP 分段的遠程服務。如果此處未列出ID且超過最大消息大小,消息將被丟棄。請注意,單播密鑰必須設置為服務器的遠程提供節點的IP地址,以使此設置生效。
`clients` (array):用於連接特定服務的客戶端端口。對於每個服務,一組端口用於可靠/不可靠的通信。vsomeip將占用列表空閑的端口。如果找不到空閑端口,連接將失敗。如果
要求vsomeip連接到沒有指定端口的服務實例,端口將由系統選擇。這意味着用戶已經確保此處配置的端口不會與端口重疊由IP堆棧自動選擇。
**`service`:
**`instance`:
它們一起指定端口配置應用於的服務實例。
**`reliable` (array):用於與給定服務器進行可靠(TCP)通信的客戶端端口列表服務實例。
** `unreliable` (array):用於與給定服務器進行不可靠(UDP)通信的客戶端端口列表服務實例。此外,還可以配置客戶端范圍之間的映射遠程服務端口的端口和范圍。(如果為特定服務/實例配置了客戶端端口,則忽略端口范圍映射)
**`reliable_remote_ports`:指定一系列可靠的遠程服務端口
**`unreliable_remote_ports`:指定一系列不可靠的遠程服務端口
**`reliable_client_ports`:指定要映射到reliable_remote_ports范圍的可靠客戶端端口的范圍
**`unreliable_client_ports`:指定要映射到unreliable_remote_ports范圍的不可靠客戶端端口的范圍
**`first`:指定端口范圍的下限
** `last`:指定端口范圍的上限
*`payload-sizes` (array):數組以限制每個IP和端口允許的最大有效負載大小。如果不指定,允許的有效負載大小是無限的。數組中的設置僅影響TCP上的通信。限制本地有效負載大小可以使用max-payload-size-local。
**`unicast`:在客戶端:遠程服務的IP,其有效負載大小應為要有限度。在服務端:提供的服務的IP,其有效負載大小為接收和發送應該受到限制。
** `ports` (array):其中包含成對的端口和有效負載大小的描述。
***`port`:在客戶端:遠程服務的端口,其有效負載大小應為要有限度。在服務端:提供的服務的IP,其有效負載大小為接收和發送應該受到限制。
***`max-payload-size`:在客戶端:發送到客戶端的消息的有效負載大小限制(字節)托管在預先指定的IP和端口上的遠程服務。在服務端:接收和發送的消息的有效負載大小限制(以字節為單位)通過以前指定的IP和端口提供的服務。如果多個服務托管在同一個端口上,它們都會共享限制明確規定
`max-payload-size-local`:節點內部通信允許的最大有效負載大小(字節)。通過默認情況下,節點內部通信的有效負載大小是無限的。有可能通過此設置進行限制。
`max-payload-size-reliable`:TCP通信允許的最大有效負載大小字節。默認情況下,TCP通信的有效負載大小為無限的可以通過此設置進行限制。
`max-payload-size-unreliable`:通過某些/IP-TP進行UDP通信所允許的最大有效負載大小字節。默認情況下,通過某些/IP-TP通信的UDP有效負載大小為無限的可以通過此設置進行限制。此設置僅適用於一些啟用/IP-TP的方法/事件/字段(否則UDP默認值為1400)字節(適用)。有關配置示例,請參見<<someiptp,SOME/IP-TP>>。
`endpoint-queue-limits` (array):限制每秒緩存的傳出消息的最大允許大小(以字節為單位)IP和端口(每個端點的消息隊列大小)的數組。如果未另行規定允許的隊列大小是無限的。此數組中的設置僅影響外部設置表達要限制本地隊列大小`endpoint queue limit local`可以被利用。
**`unicast`:在客戶端:為其發送隊列大小的遠程服務的IP請求應該受到限制。在服務端:提供的服務的IP,其隊列大小為發送的響應應該是有限的。因此,這個IP地址是與通過網絡頂層的“單播”設置指定的IP地址相同json文件。
**`ports` (array):其中包含成對的端口和隊列大小描述
***`port`:在客戶端:遠程服務的端口,在服務端:所提供服務的端口。
***`queue-size-limit`:在客戶端:發送到客戶端的消息的隊列大小限制(以字節為單位)托管在預先指定的IP和端口上的遠程服務。在服務端:服務發送的響應的隊列大小限制(字節)在以前指定的IP和端口上提供。如果多個服務托管在同一個端口上,它們都會共享限制明確規定。
* `endpoint-queue-limit-external`:設置以限制緩存傳出消息的最大允許大小(以字節為單位)用於外部通信(每個端點的消息隊列大小)。默認情況下外部通信的隊列大小是無限的。它可以通過這個來限制背景在“endpoint queue limits”數組中進行的設置會覆蓋此設置。
*`endpoint-queue-limit-local`:設置以限制緩存傳出消息的最大允許大小(以字節為單位)用於本地通信(每個端點的消息隊列大小)。默認情況下,隊列節點內部通信的大小是無限的。它可以通過這個來限制設置。
*`buffer-shrink-threshold`:已處理消息的數量,其大小為分配的緩沖區用於在緩沖區的內存被釋放之前處理它們釋放並再次開始動態增長。此設置在以下情況下很有用:在這種情況下,只有一小部分的整體消息要大得多然后,剩余的部分和分配給處理它們的內存應該在一段時間內釋放及時地。如果該值設置為零,則不會重置緩沖區大小,並且與最大的已處理郵件一樣大。(默認值為5)。示例:設置為50。包含500字節的消息必須進行處理,緩沖區相應增長。在此消息之后,連續50次必須先處理小於250字節的消息,然后才能更改緩沖區大小減少,並再次開始動態增長。
* `tcp-restart-aborts-max`:設置以限制由於未完成的TCP握手而導致的TCP客戶端終結點重新啟動中止的次數。達到限制后,如果連接嘗試仍處於掛起狀態,則會強制重新啟動TCP客戶端終結點。
*`tcp-connect-time-max`:用於定義完成TCP客戶端端點連接嘗試之前的最長時間的設置。如果“tcp連接時間上限”已過,則如果連接嘗試仍處於掛起狀態,tcp客戶端終結點將強制重新啟動。
*`udp-receive-buffer-size`:指定用於存儲的套接字接收緩沖區(“SO_RCVBUF”)的大小UDP客戶端和服務器端點(字節)。(默認值:1703936)
*`internal_services` (optional array):指定純內部服務實例的服務/實例范圍。vsomeip使用此信息來避免發送查找服務消息當客戶端請求不可用的服務時,通過服務發現-例子它可以在服務/實例級別或服務級別上完成僅包含0x0000-0xffff中的所有實例。
**`first`:內部服務范圍的最低入口。
* ***`service`:內部服務范圍內以十六進制表示的最低服務ID。
***`instance` (optional):內部服務實例范圍中以十六進制表示的最低實例ID。如果未指定,則最低實例ID為0x0000。
**`last`:內部服務范圍的最高入口。
***`service`:內部服務范圍中以十六進制表示的最高服務ID。
***`instance` (optional):內部服務實例范圍中以十六進制表示的最高實例ID。如果未指定,則最高實例ID為0xFFFF。
*`debounce` (optional array):外部設備發送的事件/字段將轉發給僅當可配置函數的計算結果為true時,應用程序才會啟動。這個函數檢查事件/字段有效負載是否已更改,以及自上次轉發以來已過指定的時間間隔。
**`service`:托管要取消公告的事件的服務ID。
**`instance`:承載要取消公告的事件的實例ID。
**`events`:應根據以下內容取消公告的一系列事件配置選項。
***`event`:事件ID
***`on_change`:指定是否僅對事件進行預告有效數據是不是變了。 (valid values: _true_, _false_).
***`ignore`:具有給定位掩碼的有效負載索引數組(可選)在有效載荷變化評估中被忽略。不能指定索引/位掩碼對,只能定義paylaod索引在評估中應忽略這一點。
****`index`:要使用給定位掩碼檢查的有效負載索引
****`mask`:1字節位掩碼應用於給定有效負載索引的字節。示例掩碼:0x0f忽略給定索引處字節低半字節的有效負載變化
***`interval`:指定是否應根據經過的時間間隔取消對事件的播音。(valid values: _time in ms_, _never_).
***`on_change_resets_interval_` (optional):指定檢測到負載變化時是否重置間隔計時器。(valid values: _false_, _true_).
*`routing`:負責路由的應用程序的名稱。
*`routing-credentials`:充當路由管理器的應用程序的UID/GID。(如果使用_check_credentials_設置為_true_以成功檢查在connect上傳遞的路由管理器憑據,則必須指定憑據檢查)
**`uid`:路由管理器UID
**`gid`:路由管理器GID
* `shutdown_timeout`:配置本地客戶端等待確認的時間(毫秒)他們在關機期間從路由管理器注銷。默認為5000毫秒。
*`warn_fill_level`:路由管理器會定期檢查發送緩沖區的填充級別,以確保其正常運行客戶。該變量以百分比形式定義了導致正在記錄警告。默認為67。
* `service-discovery`:包含與主機應用程序的服務發現相關的設置。
**`enable`:指定服務發現是否已啟用(valid values: _true_,_false_)。默認值為_true_。
**`multicast`:將發送服務發現消息的多播地址,默認值為_224.0.0.1。
**`port`:服務發現的端口。默認設置為_30490 _。
**`protocol`:用於發送服務發現消息的協議(valid values: _tcp_, _udp_)。默認設置為_udp_u。
**`initial_delay_min`:第一次提供信息前的最小延遲。
**`initial_delay_max`:首次提供信息前的最大延遲。
**`repetitions_base_delay`:在重復階段發送要約消息的基本延遲。
** `repetitions_max`:在重復階段的服務范圍內提供服務的最大重復次數。
**`ttl`:提供的服務以及已使用的服務和事件組的條目的生存期
** `ttl_factor_offers` (optional array):保存傳入遠程報價的修正系數的數組。如果一個值為服務實例指定的TTL字段大於1相應的服務條目將乘以指定的系數。示例:收到服務要約時,TTL為3秒,TTL為系數設置為5。遠程節點停止提供服務,而不發送停止報盤信息。服務將在15秒后過期(標記為不可用)在收到最后一份報價后。
*** `service`:服務的id。
***`instance`:服務實例的id。
***`ttl_factor`:TTL校正系數
**`ttl_factor_subscriptions` (optional array):保存傳入遠程訂閱的校正因子的數組。如果為服務實例指定大於1的值,即相應的eventgroup條目將與指定的因子相乘+示例:收到對所提供服務的遠程訂閱時,TTL為3秒,TTL系數設置為5。遠程節點停止重新訂閱不發送StopSubscribeEventgroup消息的服務。訂閱將然后在收到最后一次重新預訂后15秒過期。
***`service`:服務的id。
***`instance`:服務實例的id。
***`ttl_factor`:TTL校正系數
**`cyclic_offer_delay`:主階段中OfferService消息的周期。
**`request_response_delay`:單播消息到多播消息的最小延遲提供服務和活動組。
**`offer_debounce_time`:堆棧在進入新服務之前收集新服務的時間重復階段。這可以用來減少在啟動期間發送消息。默認設置為500毫秒。
//Watchdog
*anchor:config-watchd*og[]`watchdog` (optional):看門狗定期向所有已知的本地客戶端發送ping。如果客戶機在配置的時間內沒有響應,則會出現大量的PONG看門狗注銷此應用程序/客戶端。如果未配置,則不會激活看門狗。
**`enable`:指定是啟用還是禁用看門狗(valid values: _true, false_), (default is _false_).
**`timeout`:指定在ping時啟動看門狗的超時時間(毫秒)當地客戶在這段時間內沒有用乒乓球回答。(有效值:2-2^32),(默認值為5000毫秒)。
**`allowed_missing_pongs`:指定允許丟失的乒乓球數量。(有效值:_1-2^32_uu),(默認值為_3_upongs)。
//CAPI-Selective Broadcasts support
*anchor:config-supports_selective_broadcasts[]`supports_selective_broadcasts` (optional array):該節點允許添加支持CAPI選擇性廣播功能的IP地址列表。如果未指定,則無法使用該功能,堆棧的訂閱行為與正常事件。
**`address`:指定支持“選擇性”功能的IP地址(IPv4或IPv6表示法)。可以配置多個地址。
//Security
*anchor:config-policy[]`security` (optional):如果指定,憑證傳遞機制將被激活。但是,只要_check _credentials uu未設置為_true u,就不會進行憑證或安全檢查,但如果指定了安全標簽,則必須配置路由管理器客戶端ID,並且不應設置為0x6300。如果_check_credentials_uu設置為_true_u,則需要使用_routing-credentials_u標記指定路由管理器UID和GID。
**`check_credentials` (optional):指定安全檢查是否處於活動狀態。這包括對connect的憑據檢查,以及在follow中配置的所有策略檢查。(valid values: _true, false_), (default is _false_).
**`allow_remote_clients` (optional):指定是否允許將傳入的遠程請求/訂閱發送到本地代理/客戶端。如果未指定,則默認情況下允許接收所有遠程請求/訂閱。(有效值為'true'和'false')
** `policies` (array):指定安全策略。每個策略至少需要指定“允許”或“拒絕”。
***`credentials`:指定將應用安全策略的憑據。如果_check_credentials_uu設置為_true_u,則需要正確指定本地應用程序的憑據,以確保本地套接字身份驗證能夠成功。
****`uid`:將客戶端應用程序的LINUX用戶id指定為十進制數。作為通配符,可以使用“any”。
**** `gid`:將客戶端應用程序的LINUX組id指定為十進制數。作為通配符,可以使用“any”。
****`allow` / `deny` (optional):指定策略允許還是拒絕LINUX用戶和組ID。
.`uid`(數組)指定LINUX用戶ID的列表。這些可以指定為十進制數或范圍。范圍由第一個和最后一個有效id指定(參見下面的示例)。
.`gid`(數組)指定LINUX組ID的列表。這些可以指定為十進制數或范圍。范圍由第一個和最后一個有效id指定(參見下面的示例)。
*** `allow` / `deny`:此標簽指定_allow_uuuu或_deny_uuu,具體取決於所需的白名單或黑名單。因此,不允許在一個策略中指定“允許”和“拒絕”條目。有了_allow u,可以做什么的白名單,這意味着一個空的_allow u標簽意味着一切都被拒絕。有了_deny u,允許做的事情就可以被列入黑名單,這意味着一個空的_deny u標簽意味着一切都是允許的。
**** `requests` (array):指定允許/拒絕使用上述憑據的上述客戶端應用程序與之通信的一組服務實例對。
. `service`:為請求指定服務
. `instance` (deprecated):指定請求的實例_作為通配符,可以使用“any”,這意味着從實例ID 0x01到0xFFFF的范圍這也意味着方法ID的范圍從0x01到0xFFFF。
. `instances` (array):指定一組允許/拒絕與之通信的實例ID和方法ID范圍對。如果下面的'ids'標記未用於指定方法ID級別上的允許/拒絕請求,則還可以僅指定一組允許/拒絕請求的實例ID范圍,類似於允許/拒絕“報價”部分。如果未指定方法ID,則默認情況下,允許/拒絕的方法的范圍為0x01到0xFFFF。
.. `ids`: 指定一組允許/拒絕與之通信的實例ID范圍。還可以將單個實例ID指定為數組元素,而無需給出上限/下限。作為通配符,可以使用“any”,這意味着從實例ID 0x01到0xFFFF的范圍。
first` - The lower bound of the method range.
`last` - The upper bound of the method range.
**** `offers` (array):指定一組服務實例對,客戶端應用程序使用上述憑據允許/拒絕提供這些服務實例對。
. `service`:指定offer的服務
. `instance` (deprecated):指定offer的instance,作為通配符,可以使用“any”,這意味着從實例ID 0x01到0xFFFF的范圍。
`instances` (array):指定一組實例ID范圍,客戶端應用程序使用上述憑據允許/拒絕提供這些范圍。還可以將單個實例ID指定為數組元素,而無需給出上限/下限。作為通配符,可以使用“any”,這意味着從實例ID 0x01到0xFFFF的范圍。
.. `first`:實例范圍的下限。
.. `last`:實例范圍的上限
