IoT Card Management

Overview

IoT Card Management is used to maintain SIM card information, ICCID, carrier platform, device binding, traffic usage, and card status. It is commonly used when devices report through cellular networks.

Operation Flow

Key Concepts

Item	Description
ICCID	Unique identifier of the SIM card. Keep it consistent with device-reported data.
Card platform	Carrier or third-party card platform used for status and usage query.
Bound device	Device associated with the SIM card.
Usage status	Traffic, activation, suspension, expiration, and package information.
Device report	Device can report ICCID and platform identifier together with device info.

Reference Commands And Configuration

The following snippets are preserved from the source guide because commands, configuration keys, and protocol examples should remain exact.

   # 描述：1.设备上电后发布设备信息； 2.设备接收到设备信息指令后发布设备信息
   # iccid            可选，物联网卡的ICCID号，设备使用物联网卡时上传
   # cardPlatformId   可选，对应物联网卡管理-卡平台编号，设备上传ICCID号时上传，如果不上传则默认遍历所有卡平台查询

   {
	    "rssi": -43,
	    "firmwareVersion": 1.2,
	    "status": 3,
	    "userId": 2, 
	    "longitude": 0,
	    "latitude": 0,
	    "iccid": 898604293620C0000970,
	    "cardPlatformId": 0,
	    "summary": {
		    "name": "FastBee",
		    "chip": "ESP8266",
		    "author": "kerwincui",
		    "deliveryTime": "2023-06-06",
		    "activeTime": "2022-10-01"
	    }
    }

Shared Screenshots

The English documentation reuses the screenshots from the Chinese source page. UI labels in screenshots may remain Chinese.

Acceptance Checklist

Item	Expected Result
Card import	ICCID is unique and basic card information is complete.
Device binding	Device detail can display the associated card information.
Device reporting	Reported ICCID can match an existing card.
Usage query	Card status and traffic usage can be refreshed when platform API is configured.
Abnormal handling	Suspended, expired, or over-limit cards can be identified quickly.

Development Entry

Type	Path Or API	Description
Frontend page	vue3/src/views/iot/card or card-related view directory	Card list and detail operations.
Backend API	/card/*	Card management and query APIs.
Device info payload	Device information report topic	ICCID and card platform fields are reported by device.