update docs

Signed-off-by: NAnnie_wang <annie.wangli@huawei.com>

en/application-dev/reference/apis/js-apis-cardEmulation.md

@@ -17,16 +17,15 @@ import cardEmulation from '@ohos.nfc.cardEmulation';
 Enumerates the NFC card emulation types.
 
 > **NOTE**
->
 > This parameter is supported since API version 6 and deprecated since API version 9. You are advised to use [hasHceCapability](#hashcecapability9).
 
 **System capability**: SystemCapability.Communication.NFC.CardEmulation
 
-| Name| Value| Description|
-| -------- | -------- | -------- |
-| HCE | 0 | HCE.|
-| UICC | 1 | Subscriber identity module (SIM) card emulation.|
-| ESE | 2 | embedded Secure Element (eSE) emulation.|
+| Name  | Value   | Description      |
+| ---- | ---- | -------- |
+| HCE  | 0    | HCE.|
+| UICC | 1    | Subscriber identity module (SIM) card emulation.|
+| ESE  | 2    | embedded Secure Element (eSE) emulation. |
 
 ## CardType<sup>9+</sup>
 
@@ -34,10 +33,10 @@ Enumerates the types of services used by the card emulation application.
 
 **System capability**: SystemCapability.Communication.NFC.CardEmulation
 
-| Name| Value| Description|
-| -------- | -------- | -------- |
+| Name     | Value        | Description               |
+| ------- | --------- | ----------------- |
 | PAYMENT | "payment" | Payment type.|
-| OTHER | "other" | Other types.|
+| OTHER   | "other"   | Other types.|
 
 ## isSupported
 
@@ -46,21 +45,20 @@ isSupported(feature: number): boolean
 Checks whether a certain type of card emulation is supported.
 
 > **NOTE**
-> 
 > This parameter is supported since API version 6 and deprecated since API version 9. You are advised to use [hasHceCapability](#hashcecapability9).
 
 **System capability**: SystemCapability.Communication.NFC.CardEmulation
 
 **Parameters**
 
-| Name | Type    | Mandatory| Description                   |
-| ------- | -------- | ---- | ----------------------- |
-| feature | number | Yes  | Card emulation type. For details, see [FeatureType](#featuretype).|
+| Name    | Type    | Mandatory  | Description                                      |
+| ------- | ------ | ---- | ---------------------------------------- |
+| feature | number | Yes   | Card emulation type. For details, see [FeatureType](#featuretype).|
 
 **Return value**
 
-| **Type**| **Description**|
-| -------- | -------- |
+| **Type** | **Description**                                |
+| ------- | -------------------------------------- |
 | boolean | Returns **true** if the card emulation type is supported; returns **false** otherwise.|
 
 ## hasHceCapability<sup>9+</sup>
@@ -75,8 +73,8 @@ Checks whether HCE is supported.
 
 **Return value**
 
-| **Type**| **Description**|
-| -------- | -------- |
+| **Type** | **Description**                          |
+| ------- | -------------------------------- |
 | boolean | Returns **true** if HCE is supported; returns **false** otherwise.|
 
 ## isDefaultService<sup>9+</sup>
@@ -91,15 +89,15 @@ Checks whether an application is the default application of the specified servic
 
 **Parameters**
 
-| Name | Type    | Mandatory| Description                   |
-| ------- | -------- | ---- | ----------------------- |
-| elementName | [ElementName](js-apis-bundleManager-elementName.md#elementname) | Yes| Application description, which consists of the bundle name and component name.|
-| type | [CardType](#cardtype9) | Yes| Card emulation service type.|
+| Name        | Type                                      | Mandatory  | Description                     |
+| ----------- | ---------------------------------------- | ---- | ----------------------- |
+| elementName | [ElementName](js-apis-bundleManager-elementName.md#elementname) | Yes   | Application description, which consists of the bundle name and component name.|
+| type        | [CardType](#cardtype9)                   | Yes   | Card emulation service type.               |
 
 **Return value**
 
-| **Type**| **Description**|
-| -------- | -------- |
+| **Type** | **Description**                              |
+| ------- | ------------------------------------ |
 | boolean | Returns **true** if the application is the default payment application; returns **false** otherwise.|
 
 **Example**
@@ -110,13 +108,11 @@ import cardEmulation from '@ohos.nfc.cardEmulation';
 var isHceSupported = cardEmulation.isSupported(cardEmulation.FeatureType.HCE);
 if (!isHceSupported) {
     console.log('this device is not supported for HCE, ignore it.');
-    return;
 }
 
 var hasHceCap = cardEmulation.hasHceCapability();
 if (!hasHceCap) {
     console.log('this device hasHceCapability false, ignore it.');
-    return;
 }
 
 var elementName = {

en/application-dev/reference/apis/js-apis-connectedTag.md

@@ -28,6 +28,23 @@ Initializes the active tag chip.
 | -------- | -------- |
 | boolean | Returns **true** if the operation is successful; returns **false** otherwise.|
 
+## connectedTag.initialize<sup>9+</sup>
+
+initialize(): void
+
+Initializes the active tag chip.
+
+**Required permissions**: ohos.permission.NFC_TAG
+
+**System capability**: SystemCapability.Communication.ConnectedTag
+
+**Error codes**
+For details about the error codes, see [NFC Error Codes](../errorcodes/errorcode-nfc.md).
+
+| ID| Error Message|
+| -------- | -------- |
+| 3200101 | Connected NFC tag running state is abnormal in service. |
+
 ## connectedTag.uninit
 
 uninit(): boolean
@@ -44,6 +61,23 @@ Uninitializes the active tag resources.
 | -------- | -------- |
 | boolean | Returns **true** if the operation is successful; returns **false** otherwise.|
 
+## connectedTag.uninitialize<sup>9+</sup>
+
+uninitialize(): void
+
+Uninitializes the active tag resources.
+
+**Required permissions**: ohos.permission.NFC_TAG
+
+**System capability**: SystemCapability.Communication.ConnectedTag
+
+**Error codes**
+For details about the error codes, see [NFC Error Codes](../errorcodes/errorcode-nfc.md).
+
+| ID| Error Message|
+| -------- | -------- |
+| 3200101 | Connected NFC tag running state is abnormal in service. |
+
 ## connectedTag.readNdefTag
 
 readNdefTag(): Promise&lt;string&gt;
@@ -72,6 +106,41 @@ connectedTag.readNdefTag().then((data) => {
 });
 ```
 
+## connectedTag.read<sup>9+</sup>
+
+read(): Promise&lt;number[]&gt;
+
+Reads the content of this active tag. This API uses a promise to return the result.
+
+**Required permissions**: ohos.permission.NFC_TAG
+
+**System capability**: SystemCapability.Communication.ConnectedTag
+
+**Return value**
+
+| **Type**| **Description**|
+| -------- | -------- |
+| Promise&lt;number[]&gt; | Promise used to return the content of the active tag.|
+
+**Error codes**
+For details about the error codes, see [NFC Error Codes](../errorcodes/errorcode-nfc.md).
+
+| ID| Error Message|
+| -------- | -------- |
+| 3200101 | Connected NFC tag running state is abnormal in service. |
+
+**Example**
+
+```js
+import connectedTag from '@ohos.connectedTag';
+
+connectedTag.read().then((data) => {
+    console.log("connectedTag read Promise data = " + data);
+}).catch((err)=> {
+    console.log("connectedTag read Promise err: " + err);
+});
+```
+
 ## connectedTag.readNdefTag
 
 readNdefTag(callback: AsyncCallback&lt;string&gt;): void
@@ -102,6 +171,43 @@ connectedTag.readNdefTag((err, data)=> {
 });
 ```
 
+## connectedTag.read<sup>9+</sup>
+
+read(callback: AsyncCallback&lt;number[]&gt;): void
+
+Reads the content of this active tag. This API uses an asynchronous callback to return the result.
+
+**Required permissions**: ohos.permission.NFC_TAG
+
+**System capability**: SystemCapability.Communication.ConnectedTag
+
+**Parameters**
+
+| **Name**| **Type**| **Mandatory**| **Description**|
+| -------- | -------- | -------- | -------- |
+| callback | AsyncCallback&lt;number[]&gt; | Yes| Callback invoked to return the active tag content obtained.|
+
+**Error codes**
+For details about the error codes, see [NFC Error Codes](../errorcodes/errorcode-nfc.md).
+
+| ID| Error Message|
+| -------- | -------- |
+| 3200101 | Connected NFC tag running state is abnormal in service. |
+
+**Example**
+
+```js
+import connectedTag from '@ohos.connectedTag';
+
+connectedTag.read((err, data)=> {
+    if (err) {
+        console.log("connectedTag read AsyncCallback err: " + err);
+    } else {
+        console.log("connectedTag read AsyncCallback data: " + data);
+    }
+});
+```
+
 ## connectedTag.writeNdefTag
 
 writeNdefTag(data: string): Promise&lt;void&gt;
@@ -137,6 +243,48 @@ connectedTag.writeNdefTag(rawData).then(() => {
 });
 ```
 
+## connectedTag.write<sup>9+</sup>
+
+write(data: number[]): Promise&lt;void&gt;
+
+Writes data to this active tag. This API uses a promise to return the result.
+
+**Required permissions**: ohos.permission.NFC_TAG
+
+**System capability**: SystemCapability.Communication.ConnectedTag
+
+**Parameters**
+
+| **Name**| **Type**| **Mandatory**| **Description**|
+| -------- | -------- | -------- | -------- |
+| data | number[] | Yes| Data to be written to the active tag. The value is a hexadecimal number ranging from 0x00 to 0xFF.|
+
+**Return value**
+
+| **Type**| **Description**|
+| -------- | -------- |
+| Promise&lt;void&gt; | Promise that returns no value.|
+
+**Error codes**
+For details about the error codes, see [NFC Error Codes](../errorcodes/errorcode-nfc.md).
+
+| ID| Error Message|
+| -------- | -------- |
+| 3200101 | Connected NFC tag running state is abnormal in service. |
+
+**Example**
+
+```js
+import connectedTag from '@ohos.connectedTag';
+
+var rawData = [0x01, 0x02, 0x03]; // change it tobe correct.
+connectedTag.write(rawData).then(() => {
+    console.log("connectedTag write NdefTag Promise success.");
+}).catch((err)=> {
+    console.log("connectedTag write NdefTag Promise err: " + err);
+});
+```
+
 ## connectedTag.writeNdefTag
 
 writeNdefTag(data: string, callback: AsyncCallback&lt;void&gt;): void
@@ -169,6 +317,45 @@ connectedTag.writeNdefTag(rawData, (err)=> {
 });
 ```
 
+## connectedTag.write<sup>9+</sup>
+
+write(data: number[], callback: AsyncCallback&lt;void&gt;): void
+
+Writes data to this active tag. This API uses an asynchronous callback to return the result.
+
+**Required permissions**: ohos.permission.NFC_TAG
+
+**System capability**: SystemCapability.Communication.ConnectedTag
+
+**Parameters**
+
+| **Name**| **Type**| **Mandatory**| **Description**|
+| -------- | -------- | -------- | -------- |
+| data | number[] | Yes| Data to be written to the active tag. The value is a hexadecimal number ranging from 0x00 to 0xFF.|
+| callback | AsyncCallback&lt;void&gt; | Yes| Callback invoked to return the active tag content obtained.|
+
+**Error codes**
+For details about the error codes, see [NFC Error Codes](../errorcodes/errorcode-nfc.md).
+
+| ID| Error Message|
+| -------- | -------- |
+| 3200101 | Connected NFC tag running state is abnormal in service. |
+
+**Example**
+
+```js
+import connectedTag from '@ohos.connectedTag';
+
+var rawData = [0x01, 0x02, 0x03]; // change it tobe correct.
+connectedTag.write(rawData, (err)=> {
+    if (err) {
+        console.log("connectedTag write NdefTag AsyncCallback err: " + err);
+    } else {
+        console.log("connectedTag write NdefTag AsyncCallback success.");
+    }
+});
+```
+
 ## connectedTag.on('notify')
 
 on(type: "notify", callback: Callback&lt;number&gt;): void

en/application-dev/reference/apis/js-apis-nfcController.md

@@ -176,7 +176,7 @@ Unsubscribes from the NFC state changes. The subscriber will not receive NFC sta
 | **Name**| **Type**| **Mandatory**| **Description**|
 | -------- | -------- | -------- | -------- |
   | type | string | Yes| Event type to unsubscribe from. The value is **nfcStateChange**.|
-| callback | Callback<[NfcState](#nfcstate)> | No| Callback for the NFC state changes. This parameter can be left blank.|
+| callback | Callback<[NfcState](#nfcstate)> | No| Callback for the NFC state changes. This parameter can be left blank. If this parameter is not specified, all callbacks associated with the specified event will be unregistered.|
   
 **Example**
 

en/application-dev/reference/errorcodes/errorcode-nfc.md

@@ -47,3 +47,21 @@ An error occurs when the NFC service executes the tag service logic.
 3. Connect to the tag and then perform the read and write operations.
 4. Touch and read the card again.
 5. Exit the app and read the card again.
+
+## 3200101
+
+**Error Message**
+
+Connected NFC tag running state is abnormal in service.
+
+**Description**
+
+An error occurs when the service logic of the active NFC tag is executed.
+
+**Possible Causes**
+1. The parameter values of the active NFC tag does not match the API called.
+2. The active NFC tag chip does not respond within the specified time or returns an error state.
+
+**Solution**
+1. Check that the active NFC tag parameters match the API called.
+2. Touch and read the card again.