Tiêu chuẩn quốc gia TCVN 10176-8-15:2018 về Công nghệ thông tin - Phần 8-15

• Số hiệu: TCVN10176-8-15:2018
• Loại văn bản: Tiêu chuẩn Việt Nam
• Nơi ban hành: ***
• Người ký: ***
• Ngày ban hành: Năm 2018

TIÊU CHUẨN QUỐC GIA

TCVN 10176-8-15:2018

ISO/IEC 29341-8-15:2008

CÔNG NGHỆ THÔNG TIN - KIẾN TRÚC THIẾT BỊ UPnP - PHẦN 8-15: GIAO THỨC ĐIỀU KHIỂN THIẾT BỊ INTERNET GATEWAY - DỊCH VỤ CẤU HÌNH GIAO DIỆN CHUNG MẠNG DIỆN RỘNG

Information technology - UPnP device architecture - Part 8-15: Internet gateway device control protocol - Wide area network common interface configuration service

Lời nói đầu

TCVN 10176-8-15:2018 hoàn toàn tương đương với ISO/IEC 29341-8-15:2008

TCVN 10176-8-15:2018 do Tiểu Ban kỹ thuật tiêu chuẩn quốc gia TCVN/JTC 1/SC 35 Giao diện người sử dụng biên soạn, Tổng cục Tiêu chuẩn Đo lường Chất lượng đề nghị, Bộ Khoa học và Công nghệ công bố.

...

...

...

- TCVN 10176-8-1:2017 (ISO/IEC 29341-8-1:2008), Phần 8-1: Giao thức điều khiển thiết bị internet gateway - Thiết bị internet gateway

- TCVN 10176-8-2:2017 (ISO/IEC 29341-8-2:2008), Phần 8-2: Giao thức điều khiển thiết bị internet gateway - Thiết bị mạng cục bộ

- TCVN 10176-8-3:2017 (ISO/IEC 29341-8-3:2008), Phần 8-3: Giao thức điều khiển thiết bị internet gateway - Thiết bị mạng diện rộng

- TCVN 10176-8-4:2017 (ISO/IEC 29341-8-4:2008), Phần 8-4: Giao thức điều khiển thiết bị internet gateway - Thiết bị kết nối mạng diện rộng

- TCVN 10176-8-5:2017 (ISO/IEC 29341-8-5:2008), Phần 8-5: Giao thức điều khiển thiết bị internet gateway - Thiết bị điểm truy cập mạng cục bộ không dây

- TCVN 10176-8-10:2017 (ISO/IEC 29341-8-10:2008), Phần 8-10: Giao thức điều khiển thiết bị internet gateway - Dịch vụ quản lý cấu hình host mạng cục bộ

- TCVN 10176-8-11:2017 (ISO/IEC 29341-8-11:2008), Phần 8-11: Giao thức điều khiển thiết bị internet gateway - Dịch vụ chuyển tiếp tầng 3

- TCVN 10176-8-12:2017 (ISO/IEC 29341-8-12:2008), Phần 8-12: Giao thức điều khiển thiết bị internet gateway - Dịch vụ xác thực liên kết

- TCVN 10176-8-13:2017 (ISO/IEC 29341-8-13:2008), Phần 8-13: Giao thức điều khiển thiết bị internet gateway - Dịch vụ radius từ máy trạm

...

...

...

- TCVN 10176-8-15:2018 (ISO/IEC 29341-8-15:2008), Phần 8-15: Giao thức điều khiển thiết bị internet gateway - Dịch vụ cấu hình giao diện chung mạng diện rộng

- TCVN 10176-8-16:2018 (ISO/IEC 29341-8-16:2008), Phần 8-16: Giao thức điều khiển thiết bị internet gateway - Dịch vụ cấu hình đường thuê bao số mạng diện rộng

- TCVN 10176-8-17:2018 (ISO/IEC 29341-8-17:2008), Phần 8-17: Giao thức điều khiển thiết bị internet gateway - Dịch vụ cấu hình liên kết Ethernet mạng diện rộng

- TCVN 10176-8-18:2018 (ISO/IEC 29341-8-18:2008), Phần 8-18: Giao thức điều khiển thiết bị internet gateway - Dịch vụ kết nối giao thức Internet mạng diện rộng

- TCVN 10176-8-19:2018 (ISO/IEC 29341-8-19:2008), Phần 8-19: Giao thức điều khiển thiết bị internet gateway - Dịch vụ cấu hình liên kết dịch vụ điện thoại thông thường mạng diện rộng

- TCVN 10176-8-20:2018 (ISO/IEC 29341-8-20:2008), Phần 8-20: Giao thức điều khiển thiết bị internet gateway - Dịch vụ kết nối giao thức điểm-điểm mạng diện rộng

- TCVN 10176-8-21:2018 (ISO/IEC 29341-8-21:2008), Phần 8-21: Giao thức điều khiển thiết bị internet gateway - Dịch vụ cấu hình mạng cục bộ không dây

CÔNG NGHỆ THÔNG TIN - KIẾN TRÚC THIẾT BỊ UPnP - PHẦN 8-15: GIAO THỨC ĐIỀU KHIỂN THIẾT BỊ INTERNET GATEWAY - DỊCH VỤ CẤU HÌNH GIAO DIỆN CHUNG MẠNG DIỆN RỘNG

...

...

...

1  Phạm vi áp dụng

Tiêu chuẩn này phù hợp với kiến trúc thiết bị UPnP, phiên bản 1.0.

Tiêu chuẩn này mô hình hóa các đặc tính tầng vật lý của giao diện WAN trên Internet gateway sử dụng để truy cập Internet.

Dịch vụ này là Bắt buộc và được quy định trong urn:schemas-upnp-org:device:WANDevice

Một trong các thể hiện của dịch vụ này được quy định theo thiết bị gốc urn:schemas-upnp-org:device:InternetGatewayDevice.

2  Xác định mô hình dịch vụ

2.1  Kiểu dịch vụ

Kiểu dịch vụ sau đây định danh dịch vụ phù hợp với mẫu này:

urn:schemas-upnp-org:service:WANCableLinkCommonInterfaceConfig:1

...

...

...

Bảng 1 - Các biến trạng thái

Tên biến

Bắt buộc hoặc tùy chọn

Kiểu dữ liệu

Giá trị cho phép^1

Giá trị mặc định^1

Đơn vị

WANAccessType

Bắt buộc

...

...

...

Xem bảng 1.1

Chuỗi ký tự rỗng

Không xác định

Layer1UpstreamMaxBitRate

Bắt buộc

Ui4

Dãy giá trị là thiết bị WAN, công nghệ và/hoặc kịch bản triển khai

Chưa xác định

Bit/giây

...

...

...

Bắt buộc

Ui4

Dãy giá trị là thiết bị WAN, công nghệ và/hoặc kịch bản triển khai

Chưa xác định

Bit/giây

PhysicalLinkStatus

Bắt buộc

String

Xem bảng 1.4

...

...

...

Không xác định

WANAccessProvider

Tùy chọn

String

Không có dãy giá trị nào được xác định

Chuỗi ký tự rỗng

Không xác định

MaximumActiveConnections

Tùy chọn

...

...

...

Số cố định, phụ thuộc vào sản phẩm

Số cố định, phụ thuộc vào sản phẩm

Không xác định

NumberOfActiveConnections

Tùy chọn

Ui2

Không xác định

Không quy định

Không xác định

...

...

...

Tùy chọn

String

Không xác định

Chuỗi ký tự rỗng

Không xác định

ActiveConnectionServiceID

Tùy chọn

String

Không xác định

...

...

...

Không xác định

TotalBytesSent

Tùy chọn

Ui4

Không xác định

Không quy định

Không xác định

TotalBytesReceived

Tùy chọn

...

...

...

Không xác định

Không quy định

Không xác định

TotalPacketsSent

Tùy chọn

Ui4

Không xác định

Không quy định

Không xác định

...

...

...

Tùy chọn

Ui4

Không xác định

Không quy định

Không xác định

EnabledForInternet

Tùy chọn

Boolean

0, 1

...

...

...

Không xác định

Các biến trạng thái không theo chuẩn do nhà cung cấp cài đặt

Không theo chuẩn

Sẽ xác định

Sẽ xác định

Sẽ xác định

Sẽ xác định

^1 các giá trị liệt kê trong cột này là bắt buộc. Để quy định các giá trị tùy chọn chuẩn hoặc để ủy quyền việc ấn định các giá trị cho nhà cung cấp, phải tham chiếu thể hiện cụ thể của bảng thích hợp dưới đây

CHÚ THÍCH: Các giá trị mặc định không được quy định trong DCP. Tuy nhiên, nhà cung cấp có thể quyết định cung cấp các giá trị mặc định cho các biến SST khi thích hợp.

...

...

...

Giá trị

Bắt buộc hoặc tùy chọn

Mô tả

DSL

Bắt buộc

Chỉ áp dụng cho các modem DSL (Digital Subscriber Link - Liên kết thuê bao số)

POTS

Bắt buộc

Chỉ áp dụng cho POTS (Plain old telephone service - Dịch vụ điện thoại thông thường)

...

...

...

Bắt buộc

Chỉ áp dụng cho các modem cáp

Ethernet

Bắt buộc

Chỉ áp dụng cho các modem Ethernet được gắn bên ngoài.

Biến WANAccessType phải được thiết lập cho một trong các giá trị được liệt kê trong bảng, cho thiết bị phần cứng khi thích hợp.

Bảng 1.2 - Danh mục giá trị cho phép đối với biến PhysicalLinkStatus

Giá trị

Bắt buộc hoặc tùy chọn

...

...

...

Bắt buộc

Down

Bắt buộc

Initializing

Tùy chọn

Unavailable

Tùy chọn

2.2.1  WANAccessType

Biến này quy định kiểu truy cập WAN (modem) giữa mạng thường trực và nhà cung cấp dịch vụ Internet (Internet service provider - ISP). Ethernet được tham chiếu đến một modem Ethernet gắn bên ngoài. Các giá trị khác không phải giải thích gì thêm.

...

...

...

Biến này quy định tốc độ bit (tính theo bit/giây) tải lên tối đa theo lý thuyết (từ WANDevice đến ISP) cho thiết bị WAN. Ví dụ, 33600 đối với modem POTS V.90.

2.2.3  Layer1DownstreamMaxBitRate

Biến này quy định tốc độ bit (tính theo bit/giây) tải xuống tối đa theo lý thuyết (từ ISP WANDevice) cho thiết bị WAN. Ví dụ, 56000 đối với modem POTS V.90.

2.2.4  PhysicalLinkStatus

Biến này cho biết trạng thái của kết nối (liên kết) vật lý từ thiết bị WAN đến thực thể kết nối (có thể là ISP CO cho modem tích hợp và tình trạng liên kết Ethernet cho modem Ethernet kết nối bên ngoài)

2.2.5  WANAccessProvider

Đây là tên chuỗi ký tự mô tả của nhà cung cấp dịch vụ cung cấp tính kết nối của liên kết trên giao diện WAN. Nhà cung cấp này Có thể hoặc Không thể là nhà cung cấp dịch vụ Internet. Ví dụ, khách hàng Có thể có dịch vụ DSL từ công ty điện thoại và dịch vụ truy cập Internet từ công ty điện thoại khác. Trong trường hợp này, dịch vụ có trước sẽ được định danh bởi biến này. Định dạng của văn bản phụ thuộc việc cài đặt. Việc cài đặt có thể cung cấp thông tin như là các số điện thoại hỗ trợ khách hàng vì vậy người sử dụng có thể được giúp đỡ khi cần thiết.

2.2.6  MaximumActiveConnections

Biến này cho biết số các kết nối hoạt động tối đa mà gateway có thể hỗ trợ đồng thời. Điều này khác với số các thể hiện của dịch vụ WAN*Connection được khởi tạo bởi gateway. Ví dụ, tài liệu mô tả có thể cung cấp 10 thể hiện tĩnh của WANPPPConnection. Nếu giá trị của biến này là 5 thì không có nhiều hơn 5 kết nối có thể hoạt động cùng lúc trên WANDevice này.

...

...

...

2.2.7  NumberOfActiveConnections

Số các thể hiện của dịch vụ WAN*Connection hiện hoạt động trên giao diện WAN.

2.2.8  ActiveConnectionDeviceContainer và ActiveConnectionServiceID

Các kết nối hoạt động được biểu diễn dưới dạng mảng các mục nhập - mỗi mục nhập bao gồm 2 giá trị được biểu diễn bởi các biển trạng thái sau đây:

ActiveConnectionDeviceContainer - định danh bộ chứa WANConnectionDevice cho thể hiện của dịch vụ kết nối hoạt động. Có dạng sau: uuid:device-UUID:WANConnectionDevice:v

ActiveConnectionServiceID - ID dịch vụ của dịch vụ kết nối hoạt động. Có dạng sau: urn:upnp-org:serviceID:serviceID.

Biến cho biết tổng số (phần tử trong mảng) của các kết nối hoạt động đồng thời, (các phần tử trong mảng) trên WANDevice này. Để trích xuất tất cả các mảng mục nhập thì máy trạm nên lặp lại việc gọi hoạt động GetActiveConnection với chỉ số của mảng tăng từ 0 đến [NumberOfActiveConnections-1]

2.2.9  TotalBytesSent

Biến này biểu diễn bộ đếm tích lũy cho tổng số các byte đã gửi tải lên qua tất cả các thể hiện của dịch vụ kết nối trên WANDevice. Bộ đếm về giá trị 0 sau khi đạt tới giá trị tối đa (2^32)-1.

...

...

...

Biến này biểu diễn bộ đếm lũy tích cho tổng số các byte đã nhận tải xuống qua tất cả các thể hiện của dịch vụ kết nối trên WANDevice. Bộ đếm về giá trị 0 sau khi đạt tới giá trị tối đa (2^32)-1.

2.2.11  TotalPacketsSent

Biến này biểu diễn bộ đếm lũy tích cho tổng số gói IP hoặc PPP đã gửi tải lên qua tất cả các thể hiện của dịch vụ kết nối trên WANDevice. Bộ đếm về giá trị 0 sau khi đạt tới giá trị tối đa (2^32)-1.

2.2.12  TotalPacketsReceived

Biến này biểu diễn bộ đếm lũy tích cho tổng số gói IP hoặc PPP đã nhận tải xuống qua tất cả các thể hiện của dịch vụ kết nối trên WANDevice. Bộ đếm về giá trị 0 sau khi đạt tới giá trị tối đa (2^32)-1.

2.2.13  EnabledForInternet

Biến này có thể được sử dụng để kích hoạt hoặc không kích hoạt truy cập đến và từ Internet, qua tất cả các thể hiện của kết nối. Biến này có thể được đặt là 0 để tắt truy cập đến Internet. Trong trường hợp các công nghệ Always-On, Always-Connected (AOAC - luôn bật, luôn kết nối) như là DSL hoặc các modem cáp, các phiên IP hoặc PPP sẽ bị hủy tại WANDevice.

2.2.14  Mối quan hệ giữa các biến trạng thái

Nếu biến EnabledForInternet được đặt là 0 thì biến NumberOfActiveConnections sẽ bị bỏ qua. Giá trị của biến NumberOfActiveConnections không thể vượt quá biến MaximumActiveConnections.

...

...

...

2.3  Ghi thành sự kiện và kiểm duyệt

Bảng 2 - Kiểm duyệt sự kiện

Tên biến

Ghi thành sự kiện

Sự kiện kiểm duyệt

Tỉ lệ sự kiện tối đa^1

Liên kết logic

Delta tối thiểu mỗi sự kiện^2

WANAccessType

...

...

...

Không

Không xác định

Không xác định

Không xác định

Layer1UpstreamMaxBitRate

Không

Không

Không xác định

Không xác định

...

...

...

Layer1DownstreamMaxBitRate

Không

Không

Không xác định

Không xác định

Không xác định

PhysicalLinkStatus

Có

Không

...

...

...

Không xác định

Không xác định

WANAccessProvider

Không

Không

Không xác định

Không xác định

Không xác định

MaximumActiveConnections

...

...

...

Không

Không xác định

Không xác định

Không xác định

NumberOfActiveConnections

Có

Không

Không xác định

Không xác định

...

...

...

ActiveConnectionDeviceContainer

Không

Không

Không xác định

Không xác định

Không xác định

ActiveConnectionServiceID

Không

Không

...

...

...

Không xác định

Không xác định

TotalBytesSent

Không

Không

Không xác định

Không xác định

Không xác định

TotalBytesReceived

...

...

...

Không

Không xác định

Không xác định

Không xác định

TotalPacketsSent

Không

Không

Không xác định

Không xác định

...

...

...

TotalPacketsReceived

Không

Không

Không xác định

Không xác định

Không xác định

EnabledForInternet

Có

Không

...

...

...

Không xác định

Không xác định

Các biến trạng thái không theo chuẩn do nhà cung cấp UPnP cài đặt

Sẽ xác định

Sẽ xác định

Sẽ xác định

Sẽ xác định

Sẽ xác định

^1 Được xác định bởi N, trong đó Tỷ lệ =(Sự kiện)/(N giây)

...

...

...

2.3.1  Mô hình sự kiện

Mô hình ghi thành sự kiện khá đơn giản và không được kiểm duyệt. Người dùng đăng ký các sự kiện trên dịch vụ này có thể sử dụng các cập nhật trên các biến PhysicalLinkStatus, NumberOfActiveConnections và EnabledForInternet để cung cấp phản hồi của người sử dụng và quản lý các kết nối từ ứng dụng cục bộ.

2.4  Các hoạt động

Bảng sau đây là thông tin chi tiết về các hoạt động, bao gồm các mô tả ngắn của các hoạt động, kết quả của hoạt động trên biến trạng thái và các mã lỗi xác định bởi các hoạt động.

Bảng 3- Các hoạt động

Tên

Bắt buộc hoặc tùy chọn

SetEnabledForInternet

Tùy chọn

...

...

...

Tùy chọn

GetCommonLinkProperties

Bắt buộc

GetWANAccessProvider

Tùy chọn

GetMaximumActiveConnection

Tùy chọn

GetTotalByteSent

Tùy chọn

...

...

...

Tùy chọn

GetTotalPacketsSent

Tùy chọn

GetTotalPacketsReceived

Tùy chọn

GetActiveConnection

Tùy chọn

Các hoạt động không theo chuẩn do nhà cung cấp UPnP cài đặt

Không theo chuẩn

...

...

...

Hoạt động này kích hoạt hoặc không kích hoạt truy cập đến Internet trên WANDevice.

2.4.1.1  Các đối số

Bảng 4 - Các đối số cho SetEnabledForInternet

Đối số

Hướng

Biến trạng thái liên quan

NewEnabledForInternet

IN

EnabledForInternet

...

...

...

2.4.1.3  Ảnh hưởng đến trạng thái (nếu có)

Đặt biến này là 0 để tắt truy cập đến Internet trên WANDevice. Các hoạt động trong các dịch vụ khác có thể trở thành các thao tác “Don’t Care” trong trạng thái này.

2.4.1.4  Các lỗi

Mã lỗi

Mô tả lỗi

Mô tả

401

Invalid Action

Không có hoạt động nào

...

...

...

Invalid Args

Bao gồm các lỗi sau: không đủ các đối số IN, quá nhiều đối số IN, không có đối số IN nào xác định bởi tên đó, một hoặc nhiều đối số IN có kiểu dữ liệu sai. Xem Kiến trúc thiết bị UPnP.

501

Action Failed

Có thể trả về trạng thái hiện tại nếu dịch vụ ngăn chặn việc gọi hoạt động đó.

2.4.2  GetEnabledForInternet

Hoạt động này trích xuất giá trị của biến EnabledForInternet.

2.4.2.1  Các đối số

Bảng 5 - Các đối số cho GetEnabledForInternet

...

...

...

Hướng

Biến trạng thái liên quan

NewEnabledForInternet

OUT

EnabledForInternet

2.4.2.2  Phụ thuộc vào trạng thái (nếu có)

2.4.2.3  Ảnh hưởng đến trạng thái (nếu có)

Không có thông tin.

2.4.2.4  Các lỗi

...

...

...

Mô tả lỗi

Mô tả

401

Invalid Action

Không có hoạt động nào

402

Invalid Args

Bao gồm các lỗi sau: không đủ các đối số IN, quá nhiều đối số IN, không có đối số IN nào xác định bởi tên đó, một hoặc nhiều đối số IN có kiểu dữ liệu sai. Xem Kiến trúc thiết bị UPnP.

501

...

...

...

Có thể trả về trạng thái hiện tại nếu dịch vụ ngăn chặn việc gọi hoạt động đó.

2.4.3  GetCommonLinkProperties

Hoạt động này trích xuất các đặc tính liên kết vật lý của giao diện WAN (WANDevice).

2.4.3.1  Các đối số

Bảng 6 - Các đối số cho GetCommonLinkProperties

Đối số

Hướng

Biến trạng thái liên quan

NewWANAccessType

...

...

...

WANAccessType

New Layer1UpstreamMaxBitRate

OUT

Layer1UpstreamMaxBitRate

NewLayer1DownstreamMaxBitRate

OUT

Layer1DownstreamMaxBitRate

NewPhysicalLinkStatus

OUT

...

...

...

2.4.3.2  Phụ thuộc vào trạng thái (nếu có)

2.4.3.3  Ảnh hưởng đến trạng thái (nếu có)

Không có thông tin.

2.4.3.4  Các lỗi

Mã lỗi

Mô tả lỗi

Mô tả

402

Invalid Args

...

...

...

2.4.4  GetWANAccessProvider

Hoạt động này trích xuất mô tả chuỗi ký tự của nhà cung cấp dịch vụ liên kết, chung cho tất cả các thể hiện của kết nối trên WANDevice.

2.4.4.1  Các đối số

Bảng 7 - Các đối số cho GetWANAccessProvider

Đối số

Hướng

Biến trạng thái liên quan

NewWANAccessProvider

OUT

...

...

...

2.4.4.2  Phụ thuộc vào trạng thái (nếu có)

2.4.4.3  Ảnh hưởng đến trạng thái (nếu có)

Không có thông tin.

2.4.4.4  Các lỗi

Mã lỗi

Mô tả lỗi

Mô tả

402

Invalid Args

...

...

...

2.4.5  GetMaximumActiveConnections

Hoạt động này trích xuất số lượng tối đa các kết nối hoạt động có thể xảy ra qua tất cả các thể hiện của kết nối trên WANDevice.

2.4.5.1  Các đối số

Bảng 8 - Các đối số cho GetMaximumActiveConnections

Đối số

Hướng

Biến trạng thái liên quan

NewMaximumActiveConnections

OUT

...

...

...

2.4.5.2  Phụ thuộc vào trạng thái (nếu có)

2.4.5.3  Ảnh hưởng đến trạng thái (nếu có)

Không có thông tin.

2.4.5.4  Các lỗi

Mã lỗi

Mô tả lỗi

Mô tả

402

Invalid Args

...

...

...

2.4.6  GetTotalBytesSent

Hoạt động này trích xuất bộ đếm lũy tích của các byte đã gửi tải lên qua tất cả các thể hiện của kết nối trên WANDevics.

2.4.6.1  Các đối số

Bảng 9 - Các đối số cho GetTotalBytesSent

Đối số

Hướng

Biến trạng thái liên quan

NewTotalBytes Sent

OUT

...

...

...

2.4.6.2  Phụ thuộc vào trạng thái (nếu có)

2.4.6.3  Ảnh hưởng đến trạng thái (nếu có)

Không có thông tin.

2.4.6.4  Các lỗi

Mã lỗi

Mô tả lỗi

Mô tả

402

Invalid Args

...

...

...

2.4.7  GetTotalBypesReceived

Hoạt động này trích xuất bộ đếm lũy tích của các byte đã nhận tải xuống qua tất cả các thể hiện của kết nối trên WANDevice.

2.4.7.1  Các đối số

Bảng 10 - Các đối số cho GetTotalBypesReceived

Đối số

Hướng

Biến trạng thái liên quan

NewTotalBypesReceived

OUT

...

...

...

2.4.7.2  Phụ thuộc vào trạng thái (nếu có)

2.4.7.3  Ảnh hưởng đến trạng thái (nếu có)

Không có thông tin.

2.4.7.4  Các lỗi

Mã lỗi

Mô tả lỗi

Mô tả

402

Invalid Args

...

...

...

2.4.8  GetTotalPacketsSent

Hoạt động này trích xuất bộ đếm lũy tích của các gói IP hoặc PPP đã gửi tải lên qua tất cả các thể hiện của kết nối trên WANDevice.

2.4.8.1  Các đối số

Bảng 11 - Các đối số cho GetTotalPacketsSent

Đối số

Hướng

Biến trạng thái liên quan

NewTotalPacketsSent

OUT

...

...

...

2.4.8.2  Phụ thuộc vào trạng thái (nếu có)

2.4.8.3  Ảnh hưởng đến trạng thái (nếu có)

Không có thông tin.

2.4.8.4  Các lỗi

Mã lỗi

Mô tả lỗi

Mô tả

402

Invalid Args

...

...

...

2.4.9  GetTotalPacketsReceived

Hoạt động này trích xuất bộ đếm lũy tích của các gói IP hoặc PPP đã nhận tải xuống qua tất cả các thể hiện của kết nối trên WANDevice.

2.4.9.1  Các đối số

Bảng 12 - Các đối số cho GetTotalPacketsReceived

Đối số

Hướng

Biến trạng thái liên quan

NewTotalPacketsReceived

OUT

...

...

...

2.4.9.2  Phụ thuộc vào trạng thái (nếu có)

2.4.9.3  Ảnh hưởng đến trạng thái (nếu có)

Không có thông tin.

2.4.9.4  Các lỗi

Mã lỗi

Mô tả lỗi

Mô tả

402

Invalid Args

...

...

...

2.4.10  GetActiveConnection

Hoạt động này trích xuất ID dịch vụ của kết nối hoạt động cụ thể. Các kết nối hoạt động được biểu diễn dưới dạng mảng. Nếu máy trạm muốn nhận được tất cả các phần từ của mảng thì mảng sẽ lặp lại hoạt động này bằng cách móc nối trên chỉ số mảng từ 0 đến (NumberOfActiveConnections-1) Hoặc đến khi gặp lỗi bị trả về. Chú ý rằng máy trạm nên đánh giá lại vòng lặp của nó nếu NumberOfActiveConnections được ghi vào sự kiện trong suốt quá trình nhận toàn bộ mục nhập.

2.4.10.1  Các đối số

Bảng 13 - Các đối số cho GetActiveConnection

Đối số

Hướng

Biến trạng thái liên quan

NewActiveConnectionIndex

IN

...

...

...

NewActiveConnectionContainer

OUT

ActiveConnectionContainer

NewActiveConnectionServiceID

OUT

ActiveConnectionServiceID

2.4.10.2  Phụ thuộc vào trạng thái (nếu có)

2.4.10.3  Ảnh hưởng đến trạng thái (nếu có)

Không có thông tin.

...

...

...

Mã lỗi

Mô tả lỗi

Mô tả

402

Invalid Args

Bao gồm các lỗi sau: không đủ các đối số IN, quá nhiều đối số IN, không có đối số IN nào xác định bởi tên đó, một hoặc nhiều đối số IN có kiểu dữ liệu sai. Xem Kiến trúc thiết bị UPnP phần Điều khiển.

501

Action Failed

Có thể trả về trạng thái hiện tại nếu dịch vụ ngăn chặn việc gọi hoạt động đó

...

...

...

NullValueAtSpecifiedArrayIndex

Chỉ số mảng đã quy định nắm giữ giá trị NULL

2.4.11  Các hoạt động không theo tiêu chuẩn thực thi bởi nhà cung cấp UPnP

Các hoạt động không theo chuẩn thực thi bởi nhà cung cấp UPnP nên được đề cập đến trong tiêu chuẩn này nhằm tạo thuận lợi cho việc chứng nhận. Kiến trúc thiết bị UPnP liệt kê các yêu cầu đặt tên cho các hoạt động không theo chuẩn (xem phần Mô tả lỗi).

2.4.12  Mối quan hệ giữa các hoạt động

Nếu hoạt động SetEnabledForInternet đặt biến EnabledForInternet là 0 thì việc các hoạt động set cố gắng khởi tạo các kết nối trong các dịch vụ khác có thể trả về các lỗi.

2.4.13  Các mã lỗi thông thường

Bảng sau đây liệt kê các mã lỗi thông thường cho các hoạt động về kiểu dịch vụ này. Nếu một hoạt động dẫn đến nhiều lỗi thì lỗi cụ thể nhất sẽ được trả về.

Bảng 14- Các mã lỗi thông thường

...

...

...

Mô tả lỗi

Mô tả

401

Invalid Action

Xem Kiến trúc thiết bị UPnP phần Điều khiển

402

Invalid Args

Bao gồm các lỗi sau: không đủ các đối số IN, quá nhiều đối số IN, không có đối số IN nào xác định bởi tên đó, một hoặc nhiều đối số IN có kiểu dữ liệu sai. Xem Kiến trúc thiết bị UPnP phần Điều khiển.

404

...

...

...

Xem Kiến trúc thiết bị UPnP phần Điều khiển

501

Action Failed

Có thể trả về trạng thái hiện tại nếu dịch vụ ngăn chặn việc gọi hoạt động đó. Xem Kiến trúc thiết bị UPnP phần Điều khiển

600-699

TBD

Các lỗi hoạt động chung do Ban kỹ thuật UPnP Forum xác định

701-799

...

...

...

800-899

TBD

(do nhà cung cấp UPnP quy định)

2.5  Lý thuyết vận hành

Dịch vụ WANCommonInterfaceConfig phải được cài đặt cho mỗi WANDevice. Dịch vụ này mô hình hóa các đặc tính giao diện WAN chung cho tất cả các thể hiện của dịch vụ kết nối.

Biến MaximumActiveConnection dành riêng cho kiểu giao diện WAN. Mối quan hệ giữa số lượng thể hiện tĩnh của dịch vụ WAN*Connection trong tài liệu mô tả và giá trị của các biến MaximumActiveConnections and NumberOfActiveConnections được minh họa rõ nét nhất bằng một ví dụ cụ thể.

Giả sử một gateway hỗ trợ modem POTS trên giao diện WAN. Để hỗ trợ khả năng xảy ra của nhiều thể hiện kết nối (một thể hiện cho mỗi tài khoản người sử dụng với một ISP), nhà cung cấp gateway có thể quy định số lượng các thể hiện của WANPPPConnection tĩnh. Tuy nhiên, do chỉ có một thể hiện kết nối có thể hoạt động trên modem POTS tại bất kỳ thời điểm nào cho nên biến MaximumActiveConnections sẽ được đặt là 1. Biến ActiveConnectionServiceID tương ứng với mục nhập đầu tiên (trong mảng các kết nối hoạt động) sẽ định rõ ID dịch vụ của WANPPPConnection là active (đang hoạt động).

3  Mô tả thiết bị bằng XML

...

...

...

4  Kiểm thử

SetEnabledForInternet/GetEnabledForInternet

Dãy kiểm thử 1: để kiểm thử luồng thành công

Lớp ngữ nghĩa: 2

Các điều kiện tiên quyết: Tiếp theo dãy các hoạt động được phác thảo trong mô tả dịch vụ WANPPP hoặc WANIPConnection nhằm đảm bảo rằng biến ConnectionStatus là Disconnected.

CHÚ THÍCH: Việc kiểm thử này chỉ có thể được áp dụng nếu nhà cung cấp có cài đặt tính năng.

...

...

...

Đối số In

Giá trị

Biến trạng thái

Giá trị hiện tại

Giá trị mong đợi

EnabledForInternet

1

...

...

...

Đối số Out

Giá trị mong đợi

Mã lỗi (nếu có)

Không xác định

...

...

...

GetEnabledForInternet                                                 Thành công = 200

Đối số In

Giá trị

Biến trạng thái

Trạng thái hiện tại

Trạng thái mong đợi

...

...

...

Đối số Out

Giá trị mong đợi

EnabledForlntemet

1

Mã lỗi (nếu có)

...

...

...

Không xác định

Kiểm thử này nên được nhắc lại với giá trị đặt là 0.

Phụ lục A

(Tham khảo)

Các tiêu chuẩn gốc về UPnP

Trong tiêu chuẩn này, có thể tạo ra tham chiếu đến các tiêu chuẩn gốc về UPnP. Các tham chiếu này nhằm mục đích duy trì tính nhất quán giữa các đặc tả do ISO/IEC và hiệp hội các nhà thực thi UPnP công bố. Bảng sau đây chỉ ra các tiêu đề tiêu chuẩn UPnP và phần tương ứng của TCVN 10176 (ISO/IEC 29341)

Tiêu đề tiêu chuẩn về UPnP

Tiêu chuẩn tương ứng

...

...

...

(ISO/IEC 29341-1)

Thiết bị cơ sở UPnP

(ISO/IEC 29341-2)

Kiến trúc âm thanh và hình ảnh

(ISO/IEC 29341-3-1)

Thiết bị kết xuất media

(ISO/IEC 29341-3-2)

Thiết bị máy chủ media

(ISO/IEC 29341-3-3)

...

...

...

(ISO/IEC 29341-3-10)

Dịch vụ quản lý kết nối

(ISO/IEC 29341-3-11)

Dịch vụ thư mục nội dung

(ISO/IEC 29341-3-12)

Dịch vụ kiểm soát kết xuất

(ISO/IEC 29341-3-13)

Thiết bị kết xuất media mức 2

(ISO/IEC 29341-4-2)

...

...

...

(ISO/IEC 29341-4-3)

Khuôn mẫu cấu trúc dữ liệu

(ISO/IEC 29341-4-4)

Dịch vụ vận tải âm thanh và hình ảnh mức 2

(ISO/IEC 29341-4-10)

Dịch vụ quản lý kết nối mức 2

(ISO/IEC 29341-4-11)

Dịch vụ thư mục nội dung mức 2

(ISO/IEC 29341-4-12)

...

...

...

(ISO/IEC 29341-4-13)

Ghi chép định kỳ mức 2

(ISO/IEC 29341-4-14)

Thiết bị camera an ninh số

(ISO/IEC 29341-5-1)

Dịch vụ chụp ảnh động an ninh số

(ISO/IEC 29341-5-10)

Dịch vụ cài đặt camera an ninh số

(ISO/IEC 29341-5-11)

...

...

...

(ISO/IEC 29341-5-12)

Thiết bị hệ thống

TCVN 10176-6-1 (ISO/IEC 29341-6-1)

Thiết bị điều nhiệt theo vùng

TCVN 10176-6-2 (ISO/IEC 29341-6-2)

Dịch vụ van điều khiển

TCVN 10176-6-10 (ISO/IEC 29341-6-10)

Dịch vụ chế độ vận hành quạt

TCVN 10176-6-11 (ISO/IEC 29341-6-11)

...

...

...

TCVN 10176-6-12 (ISO/IEC 29341-6-12)

Dịch vụ trạng thái tòa nhà

TCVN 10176-6-13 (ISO/IEC 29341-6-13)

Dịch vụ lịch biểu điểm đặt

TCVN 10176-6-14 (ISO/IEC 29341-6-14)

Dịch vụ cảm biến nhiệt độ

TCVN 10176-6-15 (ISO/IEC 29341-6-15)

Dịch vụ điểm đặt nhiệt độ

TCVN 10176-6-16 (ISO/IEC 29341-6-16)

...

...

...

TCVN 10176-6-17 (ISO/IEC 29341-6-17)

Thiết bị chiếu sáng nhị phân

TCVN 10176-7-1 (ISO/IEC 29341-7-1)

Thiết bị chiếu sáng có thể điều chỉnh

TCVN 10176-7-2 (ISO/IEC 29341-7-2)

Dịch vụ điều chỉnh

TCVN 10176-7-10 (ISO/IEC 29341-7-10)

Dịch vụ chuyển mạch nguồn

TCVN 10176-7-11 (ISO/IEC 29341-7-11)

...

...

...

TCVN 10176-8-1 (ISO/IEC 29341-8-1)

Thiết bị mạng cục bộ

TCVN 10176-8-2 (ISO/IEC 29341-8-2)

Thiết bị mạng diện rộng

TCVN 10176-8-3 (ISO/IEC 29341-8-3)

Thiết bị kết nối mạng diện rộng

TCVN 10176-8-4 (ISO/IEC 29341-8-4)

Thiết bị điểm truy cập mạng cục bộ không dây

TCVN 10176-8-5 (ISO/IEC 29341-8-5)

...

...

...

TCVN 10176-8-10 (ISO/IEC 29341-8-10)

Dịch vụ chuyển tiếp tầng 3

TCVN 10176-8-11 (ISO/IEC 29341-8-11)

Dịch vụ xác thực liên kết

TCVN 10176-8-12 (ISO/IEC 29341-8-12)

Dịch vụ radius từ máy trạm

TCVN 10176-8-13 (ISO/IEC 29341-8-13)

Dịch vụ cấu hình liên kết cáp WAN

TCVN 10176-8-14 (ISO/IEC 29341-8-14)

...

...

...

TCVN 10176-8-15 (ISO/IEC 29341-8-15)

Dịch vụ cấu hình liên kết DSL WAN

TCVN 10176-8-16 (ISO/IEC 29341-8-16)

Dịch vụ cấu hình liên kết Ethernet WAN

TCVN 10176-8-17 (ISO/IEC 29341-8-17)

Dịch vụ kết nối IP WAN

TCVN 10176-8-18 (ISO/IEC 29341-8-18)

Dịch vụ cấu hình liên kết OTS WAN

TCVN 10176-8-19 (ISO/IEC 29341-8-19)

...

...

...

TCVN 10176-8-20 (ISO/IEC 29341-8-20)

Dịch vụ cấu hình WLAN

TCVN 10176-8-21 (ISO/IEC 29341-8-21)

Thiết bị máy in

(ISO/IEC 29341-9-1)

Thiết bị máy quét hình phiên bản 1.0

(ISO/IEC 29341-9-2)

Dịch vụ hoạt động ngoài

(ISO/IEC 29341-9-10)

...

...

...

(ISO/IEC 29341-9-11)

Dịch vụ in cơ bản

(ISO/IEC 29341-9-12)

Dịch vụ quét hình

(ISO/IEC 29341-9-13)

Kiến trúc QoS phiên bản 1.0

(ISO/IEC 29341-10-1)

Dịch vụ thiết bị QoS

(ISO/IEC 29341-10-10)

...

...

...

(ISO/IEC 29341-10-11)

Dịch vụ lưu trữ chính sách QoS

(ISO/IEC 29341-10-12)

Kiến trúc QoS mức 2

(ISO/IEC 29341-11-1)

Các lược đồ QoS

(ISO/IEC 29341-11-2)

Dịch vụ thiết bị QoS mức 2

(ISO/IEC 29341-11-10)

...

...

...

(ISO/IEC 29341-11-11)

Dịch vụ lưu trữ chính sách QoS mức 2

(ISO/IEC 29341-11-12)

Thiết bị client giao diện người sử dụng từ xa

(ISO/IEC 29341-12-1)

Thiết bị server giao diện người sử dụng từ xa

(ISO/IEC 29341-12-2)

Dịch vụ client giao diện người sử dụng từ xa

(ISO/IEC 29341-12-10)

...

...

...

(ISO/IEC 29341-12-11)

Dịch vụ an ninh cho thiết bị

(ISO/IEC 29341-13-10)

Dịch vụ điều khiển an ninh

(ISO/IEC 29341-13-11)

Mục lục

Lời nói đầu

1  Phạm vi áp dụng

...

...

...

2.1  Kiểu dịch vụ

2.2  Các biến trạng thái

2.3  Ghi thành sự kiện và kiểm duyệt

2.4  Các hoạt động

2.5  Lý thuyết vận hành

3  Mô tả thiết bị bằng XML

4  Kiểm thử

Phụ lục A (Tham khảo) Các tiêu chuẩn gốc về UPnP