ICS：97.120

CCS：I641

團(tuán)體標(biāo)準(zhǔn)

T/XAZNXXX-XXXX

智能家用電器物模型

Thingmodelofintelligenthouseholdappliances

（征求意見(jiàn)稿）

XXXX-XX-XX發(fā)布XXXX-XX-XX實(shí)施

雄安新區(qū)智能城市創(chuàng)新聯(lián)合會(huì)發(fā)布

XX××××—××××

智能家用電器物模型

1范圍

本文件規(guī)定了智能家用電器物模型的結(jié)構(gòu)以及物模型文件的基本要求和命名規(guī)則。

本文件適用于單相器具額定電壓不超過(guò)250V、其他器具額定電壓不超過(guò)480V的智能家用電器。

2規(guī)范性引用文件

下列文件中的內(nèi)容通過(guò)文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，

僅該日期對(duì)應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本

文件。

GB12904-2008商品條碼零售商品編碼與條碼表示

GB/T38052.1-2019智能家用電器系統(tǒng)互操作第1部分：術(shù)語(yǔ)

3術(shù)語(yǔ)和定義

下列術(shù)語(yǔ)和定義適用于本文件。

3.1

智能家用電器intelligenthouseholdappliances;smarthouseholdappliances

應(yīng)用了智能化技術(shù)或具有了智能化能力/功能的家用和類(lèi)似用途電器。

注1：智能家用電器可簡(jiǎn)稱(chēng)為智能家電，也可稱(chēng)為智慧家電、人工智能家電等。

注2：改寫(xiě)GB/T28219-2018，定義3.8。

[來(lái)源：GB/T38052.1-2019，定義2.2.1]

3.2

物模型thingmodel

是對(duì)智能家電的數(shù)字化描述。

3.3

功能點(diǎn)functionpoint

是對(duì)智能家電自身能力及其參數(shù)的描述，是智能家電能力描述的最小單位。

3.4

智能家電服務(wù)平臺(tái)intelligenthouseholdappliancesserviceplatform;smarthouseholdappliances

serviceplatform

為智能家電提供服務(wù)、管理和互聯(lián)，同時(shí)，也可為智能家電與其他家電、其他行業(yè)或第三方應(yīng)用之

間提供接入服務(wù)的系統(tǒng)。

注：智能家電服務(wù)平臺(tái)簡(jiǎn)稱(chēng)為服務(wù)平臺(tái)，它包括但不限于智能家電行業(yè)服務(wù)平臺(tái)、廠商服務(wù)平臺(tái)、第三方服務(wù)平臺(tái)。

[來(lái)源：GB/T38052.1-2019，定義2.2.7]

3.5

1

T/CNLICXXXX-XXXX

控制終端controlterminal

能夠獲得智能家電信息，通過(guò)人機(jī)交互界面，實(shí)現(xiàn)智能家電應(yīng)用操作的設(shè)備。

[來(lái)源：GB/T38052.1-2019，定義2.2.3]

4物模型結(jié)構(gòu)

4.1概述

智能家電的物模型由標(biāo)識(shí)和功能點(diǎn)組成，如圖1所示。

圖1智能家電的物模型結(jié)構(gòu)

4.2標(biāo)識(shí)

智能家電物模型的標(biāo)識(shí)是用于區(qū)分不同的物模型，其內(nèi)容包括廠商代碼、產(chǎn)品類(lèi)型代碼、產(chǎn)品所屬

大類(lèi)代碼、產(chǎn)品所屬小類(lèi)代碼、標(biāo)準(zhǔn)版本代碼等，如圖2所示，在使用中以ASCII碼表示。

圖2智能家電物模型標(biāo)識(shí)示意圖

A部數(shù)值表示廠商代碼,為企業(yè)的EAN-13編碼,按GB12904-2008的規(guī)定執(zhí)行；B部數(shù)值（01）表示家電

類(lèi)；C部、D部數(shù)值分別表示智能家電所屬的產(chǎn)品大類(lèi)代碼、小類(lèi)代碼,具體分類(lèi)參見(jiàn)表1；E部數(shù)值表示

物模型標(biāo)準(zhǔn)的版本代碼，本標(biāo)準(zhǔn)為01；F部數(shù)值由廠商自行自定義，可以是廠商自定義的型號(hào)、序列號(hào)

等的組合，在廠商內(nèi)部應(yīng)保證唯一。

2

XX××××—××××

表1智能家電的分類(lèi)及代碼

產(chǎn)品大類(lèi)產(chǎn)品小類(lèi)

大類(lèi)代碼大類(lèi)名稱(chēng)小類(lèi)代碼小類(lèi)名稱(chēng)

01冷藏箱

02冷凍箱

03冷藏冷凍箱

04葡萄酒冷藏柜

01冷藏冷凍器具

05商用冷藏柜

06商用冷凍柜

07家用玻璃門(mén)冷藏柜（展示柜）

99其他

01波輪洗衣機(jī)

02滾筒洗衣機(jī)

03干衣機(jī)

04波輪洗衣干衣機(jī)

05滾筒洗衣干衣機(jī)

06洗碗機(jī)

02洗滌清潔器具07吸塵器

08脫水機(jī)

09掃地機(jī)器人

10地板擦洗機(jī)

11地板打蠟機(jī)

12洗鞋機(jī)

99其他

01家用空調(diào)

02中央空調(diào)

03新風(fēng)機(jī)

04加濕器

05空氣凈化器

03空氣調(diào)節(jié)器具

06除濕機(jī)

07電風(fēng)扇

08精油香薰機(jī)

09換氣扇

99其他

3

T/CNLICXXXX-XXXX

01烤箱

02微波爐

03電飯鍋（煲）

04壓力鍋

05油煙機(jī)

06豆?jié){機(jī)

07電磁灶

04廚電器具

08電熱灶

09多功能烹飪一體機(jī)

10打火灶

11消毒機(jī)

12食物垃圾處理機(jī)

13智能垃圾桶

99其他

01電熱水器

02燃?xì)鉄崴?/p>

03太陽(yáng)能熱水器

04熱泵熱水器

05熱水中心

05水處理器具06凈水設(shè)備

07飲水設(shè)備（電水壺、咖啡機(jī)、養(yǎng)生壺、茶吧機(jī)）

08水處理設(shè)備

09自動(dòng)灌溉系統(tǒng)

10自動(dòng)水族箱和池塘用系統(tǒng)

99其他

01電熨斗

02蒸汽電熨斗

03電熱毯（墊）

06取暖熨燙器具04家用室內(nèi)電加熱器

05浴室電加熱器

06衣物干燥機(jī)和毛巾架

99其他

07美容美發(fā)器具01電吹風(fēng)機(jī)

4

XX××××—××××

02電動(dòng)剃須刀

03電推剪

04美容儀

05電動(dòng)牙刷

06智能馬桶

07洗澡機(jī)

99其他

01按摩器具（按摩椅、按摩床、按摩墊、按摩儀等）

02抗菌/除菌器具

08保健器具03家用桑拿器具

04家用制氧器具

99其他

01閘門(mén)、卷簾門(mén)、窗驅(qū)動(dòng)裝置

02窗簾、遮陽(yáng)棚驅(qū)動(dòng)裝置

09家用驅(qū)動(dòng)裝置

03電動(dòng)晾衣架

99其他

01裝配電動(dòng)工具（電動(dòng)螺絲刀、電動(dòng)套絲機(jī)、電動(dòng)扳手）

切削電動(dòng)工具（電錘、電鋸、電刨、電鉆、手搖鉆、電剪

02

10家用電動(dòng)加工器具刀沖擊鉆）

磨拋光電動(dòng)工具（電磨、角磨機(jī)、磨光機(jī)、拋光機(jī)、砂帶

03

機(jī)、砂光機(jī)、電動(dòng)砂輪機(jī)）

99其他

01智能開(kāi)關(guān)

11開(kāi)關(guān)插座02智能插座

99其他

01寵物喂食器

12寵物和玩具類(lèi)器具02玩具

99其他

99其他00--

4.3功能點(diǎn)

4.3.1功能點(diǎn)的構(gòu)成

智能家電物模型功能點(diǎn)的參數(shù)可包括功能點(diǎn)標(biāo)識(shí)、顯示名稱(chēng)、標(biāo)識(shí)名稱(chēng)、功能點(diǎn)類(lèi)型、數(shù)據(jù)類(lèi)型、

默認(rèn)值、單位、備注等，具體如表2所示。

5

T/CNLICXXXX-XXXX

表2功能點(diǎn)參數(shù)列表

字段名稱(chēng)參數(shù)說(shuō)明

功能點(diǎn)標(biāo)識(shí)ID功能點(diǎn)的序號(hào)

顯示名稱(chēng)Display_Name功能點(diǎn)的顯示名稱(chēng)

標(biāo)識(shí)名稱(chēng)Name功能點(diǎn)的標(biāo)識(shí)名稱(chēng)

功能點(diǎn)類(lèi)型Type功能點(diǎn)的類(lèi)型：查詢(xún)Query、控制Control、報(bào)警Alert、故障Fault

功能點(diǎn)的數(shù)據(jù)類(lèi)型（布爾型Bool、枚舉型Enum、數(shù)值型Uint、字

數(shù)據(jù)類(lèi)型Data_Type

符串型String）

最大值Max僅用于數(shù)值型參數(shù)，參數(shù)的最大值

最小值Min僅用于數(shù)值型參數(shù)，參數(shù)的最小值

分辨率Ratio僅用于數(shù)值型參數(shù)，參數(shù)的步進(jìn)值

增量Addition僅用于數(shù)值型參數(shù)，參數(shù)的偏移量

枚舉項(xiàng)Enum僅用于枚舉型參數(shù)，枚舉值列表

數(shù)據(jù)長(zhǎng)度Length僅用于字符串型參數(shù)，字符串的最大字節(jié)數(shù)

默認(rèn)值Default參數(shù)的默認(rèn)值

單位Unit數(shù)據(jù)值的單位

備注Desc功能點(diǎn)的描述或說(shuō)明

4.3.2功能點(diǎn)標(biāo)識(shí)

功能點(diǎn)標(biāo)識(shí)是物模型文件中功能點(diǎn)的順序值，起始值為0，增量為1。

4.3.3顯示名稱(chēng)

功能點(diǎn)的顯示名稱(chēng)，如：開(kāi)關(guān)、溫度等。

僅支持中文、英文大小寫(xiě)、數(shù)字、部分經(jīng)常使用符號(hào)（下劃線(xiàn)，減號(hào)，括弧，空格），必須以中文、

英文或數(shù)字開(kāi)頭，長(zhǎng)度不超過(guò)40個(gè)字符。

4.3.4標(biāo)識(shí)名稱(chēng)

功能點(diǎn)的標(biāo)識(shí)名稱(chēng)，用于應(yīng)用層傳輸、控制終端或服務(wù)平臺(tái)開(kāi)發(fā)時(shí)使用。

命名規(guī)則遵循標(biāo)準(zhǔn)的開(kāi)發(fā)語(yǔ)言變量名命名規(guī)范，支持大小寫(xiě)字母、數(shù)字和下劃線(xiàn)，以字母開(kāi)頭，長(zhǎng)

度不超過(guò)50個(gè)字符。

4.3.5功能點(diǎn)類(lèi)型

功能點(diǎn)的類(lèi)型可分為4類(lèi)：

a)查詢(xún)（Query）：表示該功能點(diǎn)不可控制或修改，數(shù)據(jù)只能由智能家電上報(bào)，如環(huán)境溫度、濕度

等；

b)控制（Control）：表示該功能點(diǎn)可控制，服務(wù)平臺(tái)或控制終端可遠(yuǎn)程控制或修改功能點(diǎn)，智能

家電同時(shí)也會(huì)上報(bào)該功能點(diǎn)的當(dāng)前值，如開(kāi)關(guān)、馬達(dá)轉(zhuǎn)速等；

6

XX××××—××××

c)報(bào)警（Alert）：表示該功能點(diǎn)不可控制或修改，只能由智能家電上報(bào)，有警示作用，如溫度過(guò)

高、門(mén)未關(guān)好等；

d)故障（Fault）：表示該功能點(diǎn)不可控制或修改，只能由智能家電上報(bào)，提示出現(xiàn)的硬件或軟件

故障，如馬達(dá)損壞、溫度傳感器損壞等。

4.3.6數(shù)據(jù)類(lèi)型

功能點(diǎn)的數(shù)據(jù)類(lèi)型有以下4類(lèi)，每一個(gè)功能點(diǎn)可以指定其中一種數(shù)據(jù)類(lèi)型：

a)布爾型（Bool）：非真即假的二值型變量（0或1），如開(kāi)關(guān)狀態(tài)的數(shù)據(jù)類(lèi)型可使用布爾型；

b)枚舉型（Enum）：自定義的有限集合值，適用于有固定的若干個(gè)值的功能點(diǎn)，如LED燈的顏色有

黃色、紫色、粉色，該功能點(diǎn)的數(shù)據(jù)類(lèi)型適宜用枚舉型定義；

c)數(shù)值型（Uint）：數(shù)值可為正數(shù)、負(fù)數(shù)或小數(shù)，使用時(shí)一般都轉(zhuǎn)換為無(wú)符號(hào)整數(shù)，具體用法參見(jiàn)

附錄A，根據(jù)占用空間可分為Uint8（1Byte）、Uint16（2Byte）、Uint32（4Byte）、Uint64（8Byte）；

d)字符串型（String）：自定義的一個(gè)或多個(gè)字符的集合，如位置信息、報(bào)警信息等。

4.3.7最大值

最大值僅用于數(shù)值型參數(shù)，是參數(shù)數(shù)據(jù)值的最大值。

4.3.8最小值

最小值僅用于數(shù)值型參數(shù)，是參數(shù)數(shù)據(jù)值的最小值。

4.3.9分辨率

分辨率僅用于數(shù)值型參數(shù)，表示參數(shù)遞增或遞減的步進(jìn)值。

4.3.10增量

增量?jī)H用于數(shù)值型參數(shù)，表示數(shù)據(jù)的偏移量，默認(rèn)為參數(shù)的最小值。

4.3.11枚舉項(xiàng)

枚舉項(xiàng)僅用于枚舉型參數(shù)，是枚舉值列表。

4.3.12數(shù)據(jù)長(zhǎng)度

數(shù)據(jù)長(zhǎng)度僅用于字符串型參數(shù)，表示字符串的最大字節(jié)數(shù)，可自定義，數(shù)值范圍：1-2048。

4.3.13默認(rèn)值

默認(rèn)值為可選項(xiàng)，是功能點(diǎn)參數(shù)的默認(rèn)數(shù)據(jù)值。

4.3.14單位

單位為可選項(xiàng)，是數(shù)據(jù)數(shù)值單位的文字顯示，可與功能點(diǎn)數(shù)據(jù)值單位一致，也可不一致，如不一致

需提供相應(yīng)的單位轉(zhuǎn)換算法。常用的單位如表3所示。

表3常用單位

序號(hào)單位名稱(chēng)單位符號(hào)

01攝氏度℃

02百分比%

03千克kg

04伏特V

05安培A

7

T/CNLICXXXX-XXXX

06赫茲Hz

07千瓦kW

08千瓦時(shí)kW·h

09小時(shí)h

10分鐘min

11秒s

12微克每立方米μg/m3

13毫克每立方米mg/m3

14千米每小時(shí)km/h

15米m

16毫米mm

17華氏度℉

18度°

4.3.15備注

備注為可選項(xiàng)，是用一段文本描述當(dāng)前功能點(diǎn)的定義方法或功能說(shuō)明，用于提高功能點(diǎn)的易讀性，

對(duì)字符格式不做限制，長(zhǎng)度不超過(guò)200個(gè)字符。

5物模型文件

5.1基本要求

智能家電均應(yīng)具有描述自身屬性、功能的能力，該能力可通過(guò)物模型文件的內(nèi)容得以體現(xiàn)。

物模型文件格式可以為ASCII格式、XML格式或JSON格式。

物模型文件可在智能家電功能升級(jí)過(guò)程中實(shí)現(xiàn)版本升級(jí)。

智能家電物模型文件實(shí)例可參見(jiàn)附錄B。

5.2命名規(guī)則

物模型文件命名規(guī)則：物模型標(biāo)識(shí)+物模型文件版本號(hào)+物模型文件格式代碼+編寫(xiě)日期，如表4所示。

表4物模型文件命名規(guī)則

Ⅰ部分Ⅱ部分Ⅲ部分Ⅳ部分

物模型文件物模型文件

物模型標(biāo)識(shí)編寫(xiě)日期

版本號(hào)格式代碼

表4中Ⅰ部分的物模型標(biāo)識(shí)參見(jiàn)4.2。

表4中Ⅱ部分的物模型文件版本號(hào)由7位十進(jìn)制數(shù)字和“-”組成，格式為“XX-XX-XXX”，如“01-00-013”。

表4中Ⅲ部分的物模型文件格式代碼由2位十進(jìn)制數(shù)字組成，格式為“XX”，其中ASCII格式為01、

XML格式為02、JSON格式為03。

8

XX××××—××××

表4中Ⅳ部分的編寫(xiě)日期由8位十進(jìn)制數(shù)字組成，格式為“XXXXXXXX”，例如“20220402”。

5.3屬性

智能家電物模型文件的屬性信息如表5所示。

表5物模型文件屬性

字段名稱(chēng)參數(shù)可選/必選說(shuō)明

物模型文件版本TMF_Version必選由企業(yè)自定義，格式為“XX-XX-XXX”

ASCII格式為01、XML格式為02、JSON格式

物模型文件格式TMF_Encode必選

為03

物模型文件URL地址長(zhǎng)度TMF_URL_Lenth可選URL連接地址的長(zhǎng)度

物模型文件URL地址TMF_URL可選物模型文件URL鏈接地址

物模型文件大小TMF_Size可選物模型文件的字節(jié)數(shù)（Byte）

保證物模型文件在傳輸過(guò)程中的數(shù)據(jù)完整

校驗(yàn)方式Verification可選

性，宜使用SHA3及以上算法

9

T/CNLICXXXX-XXXX

附錄A

（規(guī)范性）

數(shù)值型數(shù)據(jù)應(yīng)用說(shuō)明

A.1負(fù)數(shù)和小數(shù)的處理

在嵌入式開(kāi)發(fā)時(shí)，智能家電內(nèi)部硬件一般不支持小數(shù)、負(fù)數(shù)等非無(wú)符號(hào)整型的數(shù)值，因此需要對(duì)

小數(shù)和負(fù)數(shù)作數(shù)值轉(zhuǎn)換?？筛鶕?jù)算法，將用戶(hù)輸入的數(shù)值轉(zhuǎn)換成智能家電能夠識(shí)別的數(shù)據(jù)類(lèi)型，算法公

式如公式（1）所示。

Y=kX+m…………....（1）

式中：

Y——顯示值，即用戶(hù)可見(jiàn)的智能家電顯示數(shù)值，可以是正數(shù)、負(fù)數(shù)或小數(shù)；

X——傳輸值，功能點(diǎn)定義時(shí)的參數(shù)，是實(shí)際指令間傳輸使用的數(shù)值，也是服務(wù)平臺(tái)或控制終端接

收到的值，數(shù)據(jù)類(lèi)型為無(wú)符號(hào)整型；

k——分辨率，即用戶(hù)輸入的分辨率值，確定了每個(gè)取值的步進(jìn)；

m——增量，算法通過(guò)m值將Y值偏移到滿(mǎn)足X值的無(wú)符號(hào)整型格式要求，m的默認(rèn)值為Ymin。

以電子溫度計(jì)取值范圍轉(zhuǎn)換為例，電子溫度計(jì)取值范圍是：-30.0℃～50.0℃，即Ymin=-30.0、

Ymax=50.0；另外，分辨率k=0.1，m=Ymin=-30.0。根據(jù)公式（1）:

Xmin=(-30.0+30.0)/0.1=0；

Xmax=(50.0+30.0)/0.1=800。

A.2時(shí)間型數(shù)據(jù)的處理

智能家電內(nèi)部硬件一般不支持時(shí)間型數(shù)據(jù)，如“1998-01-2208:56:16”，可將其轉(zhuǎn)換為一串無(wú)符號(hào)

整型的數(shù)據(jù)使用，即秒數(shù)值。轉(zhuǎn)換算法是計(jì)算從格林威治時(shí)間1970年1月1日0時(shí)0分0秒（北京時(shí)

間1970年1月1日8時(shí)0分0秒）開(kāi)始至指定時(shí)間所經(jīng)過(guò)的秒數(shù)，不考慮閏秒。

10

XX××××—××××

附錄B

（資料性）

物模型文件實(shí)例

某型號(hào)空氣凈化器的物模型文件實(shí)例如下。

"TM_ID":"XXXXXXXXXXXXX01030501ad5ba741a1dc",

"Attributes":{

"TMF_Version":"01-00-000"，

"TMF_Encode":"03"

},

"Functions":[

{

"ID":0,

"Display_Name":"開(kāi)關(guān)",

"Name":"Switch",

"Type":"Control",

"Data_Type":"Bool",

"Desc":"1為開(kāi)，0為關(guān)"

},

{

"ID":1,

"Display_Name":"等離子開(kāi)關(guān)",

"Name":"Switch_Plasma",

"Type":"Control",

"Data_Type":"Bool",

"Desc":"1為開(kāi)，0為關(guān)"

},

{

"ID":2,

"Display_Name":"空氣質(zhì)量指示燈",

"Name":"LED_Air_Quality",

"Type":"Control",

"Data_Type":"Bool",

"Desc":"1為開(kāi)，0為關(guān)"

},

{

"ID":3,

"Display_Name":"兒童安全鎖",

"Name":"Child_Security_Lock",

"Type":"Control",

11

T/CNLICXXXX-XXXX

"Data_Type":"Bool",

"Desc":"1為開(kāi)，0為關(guān)"

},

{

"ID":4,

"Display_Name":"風(fēng)速",

"Desc":"Wind_Velocity",

"Type":"Control",

"Data_Type":"Enum",

"Enum":[

"強(qiáng)力",

"標(biāo)準(zhǔn)",

"睡眠",

"智能"

],

“Desc”:"4種模式選擇"

},

{

"ID":5,

"Display_Name":"空氣檢測(cè)靈敏度",

"Name":"Air_Sensitivity",

"Type":"Control",

"Data_Type":"Enum",

"Enum":[

"0",

"1",

"2",

"3",

"4"

],

"Desc":"0-4檔"

},

{

"ID":6,

"Display_Name":"濾網(wǎng)壽命",

"Name":"Filter_Life",

"Type":"Control",

"Data_Type":"Uint8",

"Uint_Spec":{

"Addition":0,

"Max":100,

"Ratio":1,

"Min":0

12

XX××××—××××

},

"Desc":"濾網(wǎng)累計(jì)使用時(shí)間（小時(shí)）,最大為100，最小為0"

},

{

"ID":7,

"Display_Name":"按周重復(fù)",

"Name":"Week_Repeat",

"Type":"Control",

"Data_Type":"Uint8",

"Uint_Spec":{

"Addition":0,

"Max":255,

"Ratio":1,

"Min":0

},

"Desc":"設(shè)置重復(fù)周期"

},

{

"ID":8,

"Display_Name":"倒計(jì)時(shí)開(kāi)機(jī)",

"Name":"CountDown_On_min",

"Type":"Control",

"Data_Type":"Uint16",

"Uint_Spec":{

"Addition":0,

"Max":1440,

"Ratio":1,

"Min":0

},

"Desc":"倒計(jì)時(shí)開(kāi)機(jī)時(shí)間（分鐘）"

},

{

"ID":9,

"Display_Name":"倒計(jì)時(shí)關(guān)機(jī)",

"Name":"CountDown_Off_min",

"Type":"Control",

"Data_Type":"Uint16",

"Uint_Spec":{

"Addition":0,

"Max":1440,

"Ratio":1,

"Min":0

},

13

T/CNLICXXXX-XXXX

"Desc":"倒計(jì)時(shí)關(guān)機(jī)時(shí)間（分鐘）"

},

{

"ID":10,

"Display_Name":"定時(shí)開(kāi)機(jī)",

"Name":"TiMing_On",

"Type":"Control",

"Data_Type":"Uint16",

"Uint_Spec":{

"Addition":0,

"Max":1440,

"Ratio":1,