Tiêu chuẩn quốc gia TCVN 10176-8-15:2018 Công nghệ thông tin - Kiến trúc thiết bị UPnP

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ố.

Bộ tiêu chuẩn TCVN 10176-8 Công nghệ thông tin - Kiến trúc thiết bị UPnP gồm các tiêu chuẩn sau:

- 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-14:2018 (ISO/IEC 29341-8-14:2008), Phần 8-14: Giao thức điều khiển thiết bị internet gateway - Dịch vụ cấu hình liên kết cáp mạng diện rộng

- 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

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

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

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

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

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

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

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.

2.2.2  Layer1UpstreamMaxBitRate

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.

Chú ý rằng giá trị của biến này có thể phụ thuộc vào các khả năng của phần mềm và phần cứng của giao diện WAN cụ thể (mô hình hóa bởi WANDevice) cũng như chức năng của kiểu kết nối đã hỗ trợ. Ví dụ, một modem nhất định có thể hỗ trợ trên 5 kết nối được nối cầu cùng lúc nhưng chỉ có 3 kết nối PPTP cùng lúc. Giá trị này không thể là 0.

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.

2.2.10  TotalBytesSent

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.

Các biến NumberOfActiveConnections, ActiveConnectionDeviceContainer, ActiveConnectionServiceID có liên quan với nhau, khi nhà cung quyết định cài đặt tính năng này thì phải cài đặt tất cả 3 biển trên.

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

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

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

2.4.1  SetEnabledForInternet

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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.

2.4.10.4  Các lỗi

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

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.

SetEnabledForInternet                                                 Thành công = 200

GetEnabledForInternet                                                 Thành công = 200

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)

Mục lục

Lời nói đầu

1  Phạm vi áp dụng

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

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