1、sinr 2、datacall apn/password/username len 2、atcmd

Author: Mia1234567890

en-us/api/QuecPythonClasslib.md

@@ -66,9 +66,9 @@ Call this API to activating the PDP Context.
 | ---------- | ------ | ------------------------------------------------------------ |
 | profileIdx | int    | PDP context index. Range: 1 - 8 [volte version with the largest default PID is used to register IMS, please do not repeat the operation]. It is generally set to 1, if set as 2 - 8, the private APN and password may be required. |
 | ipType     | int    | IP type. 0-IPV4, 1-IPV6, 2-IPV4 and IPV6.                    |
-| apn        | string | Optional. APN name. The maximum length is 63 bytes.          |
-| username   | string | Optional. APN user name.  The maximum length is 15 bytes.    |
-| password   | string | Optional. APN password. The maximum length is 15 bytes.      |
+| apn        | string | Optional. APN name. The maximum length is 63 bytes. (The maximum length is 64 bytes in EC200U/EC200A) |
+| username   | string | Optional. APN user name.  The maximum length is 15 bytes.(The maximum length is 64 bytes in EC200U/EC200A) |
+| password   | string | Optional. APN password. The maximum length is 15 bytes.(The maximum length is 64 bytes in EC200U/EC200A) |
 | authType   | int    | Authentication type. 0-No authentication, 1-PAP, 2-CHAP.     |
 
 * Return Value
@@ -344,9 +344,9 @@ After calling this interface, the user_apn.json will be created in the user part
 | ---------- | ------ | ------------------------------------------------------------ |
 | profileIdx | int    | PDP context index. Range: 1-8. It is generally set to 1, if set as 2-8, the private APN and password may be required. |
 | ipType     | int    | IP type. 0-IPV4, 1-IPV6, 2-IPV4 and IPV6.                    |
-| apn        | string | Optional. APN name. The maximum length is 63 bytes.          |
-| username   | string | Optional. APN user name.  The maximum length is 15 bytes.    |
-| password   | string | Optional. APN password. The maximum length is 15 bytes.      |
+| apn        | string | Optional. APN name. The maximum length is 63 bytes.(The maximum length is 64 bytes in EC200U/EC200A) |
+| username   | string | Optional. APN user name.  The maximum length is 15 bytes.(The maximum length is 64 bytes in EC200U/EC200A) |
+| password   | string | Optional. APN password. The maximum length is 15 bytes.(The maximum length is 64 bytes in EC200U/EC200A) |
 | authType   | int    | Authentication type. 0-No authentication, 1-PAP, 2-CHAP.     |
 | flag       | int    | This parameter is optional. The default value is 0, indicating that only a user_apn.json file is created to save user APN information. If the value is 1, the user_apn.json file is created to save user APN information, and the APN information is used for PDP context activation immediately. |
 
@@ -701,6 +701,59 @@ Obtain Coordinate Information.
 
 
 
+#### atcmd - AT
+
+Function：send AT cmd.
+
+Note：This module only supports 1803S/EC200U/CATM platform.
+
+#### send AT cmd
+
+> **atcmd.sendSync(atcmd,resp,include_str,timeout)
+
+* Parameter
+
+| Parameter | Type   | Description                                       |
+|  ----   | -------- | --------------------------------------------- |
+| atcmd   |  string  | AT cmd，must contain‘\r\n’              |
+| resp    |  string  | output param       |
+| include_str | string | include str                                      |
+| timeout | int      | Timeout period, senconds                            |
+
+* Return value
+
+Return 0, or return [errorlist] if failed：
+
+typedef enum HELIOS_AT_RESP_STATUS_ENUM{
+	HELIOS_AT_RESP_OK = 0,
+	HELIOS_AT_RESP_ERROR,
+	HELIOS_AT_RESP_CME_ERROR,
+	HELIOS_AT_RESP_CMS_ERROR,
+	HELIOS_AT_RESP_INVALID_PARAM,
+	HELIOS_AT_RESP_TIME_OUT,
+	HELIOS_AT_RESP_SYS_ERROR,
+}HELIOS_AT_RESP_STATUS_E;
+
+* Example
+
+```python
+>>> import atcmd
+>>> resp=bytearray(50)
+>>> atcmd.sendSync('at+cpin?\r\n',resp,'',20)
+0
+>>> print(resp)
+bytearray(b'\r\n+CPIN: READY\r\n\n\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00
+\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00')
+
+atcmd.sendSync('at+cpin\r\n',resp,'',20)
+1
+>>> print(resp)
+bytearray(b'\r\nERROR\r\n\n
+\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00\x00')
+```
+
+
+
 #### sim - SIM Card
 
 Function: Provides SIM operations related APIs, such as querying SIM card status, ICCID, IMSI.
@@ -2159,6 +2212,14 @@ This function obtains CSQ.
 
 This function obtains the information of Cell information.
 
+Note：This interface is a variable parameter function in BC25 platform, the number of parameters:[0/1]
+case with one Parameter:
+	parameter:sinr_enable，
+	type:int
+	range:0/1
+		0，disable to get sinr
+		1，enable to get sinr
+
 * Parameter
 
   * None
@@ -2208,12 +2269,21 @@ This function obtains the information of Cell information.
 | tac       | Tracing area code,  range : 0 ~ 65535                        |
 | earfcn    | Extended Absolute Radio Frequency Channel Number, range : 0-65535. |
 | rssi      | Received Signal Strength Indication. In LTE network, denotes RSRP quality (negative value), which is converted according to RSRP measurement report value, and the conversion relationship is as follows<br>RSRP quality = RSRP measurement report value - 140, unit : dBm, range : -140 ~ -44 dBm |
+| sinr      | Signal to Noise Ratio(supported in BC25，range : -30 ~ 30)   |
 
 * Example
 
 ```python
 >>> net.getCellInfo()
 ([], [], [(0, 14071232, 1120, 0, 123, 21771, 1300, -69), (3, 0, 0, 0, 65535, 0, 40936, -140), (3, 0, 0, 0, 65535, 0, 3590, -140), (3, 0, 0, 0, 63, 0, 40936, -112)])
+
+//bc25
+>>> net.getCellInfo(1)
+([], [], [(0, 17104243, 460, 4, 169, 19472, 3688, -56, -108, -3)])
+>>> net.getCellInfo(0)
+([], [], [(0, 17104243, 460, 4, 169, 19472, 3688, -75, -102)])
+>>> net.getCellInfo()
+([], [], [(0, 17104243, 460, 4, 121, 19472, 3688, -76, -105)])
 ```
 
 
@@ -2342,6 +2412,14 @@ This function obtains the network mode.
 
 This function obtains the signal strength.
 
+Note：This interface is a variable parameter function in 1803s/qualcomm/unisoc platform, the number of parameters:[0/1]
+case with one Parameter:
+	parameter:sinr_enable，
+	type:int
+	range:0/1
+		0，disable to get sinr
+		1，enable to get sinr
+
 * Parameter
 
   * None
@@ -2369,12 +2447,17 @@ This function obtains the signal strength.
       `rsrp` : Reference Signal Receiving Power, range : -141 ~ -44 dBm, 99 indicates unknown or undetected signal <br/>
       `rsrq` : Reference Signal Receiving Quality, range : -20 ~ -3 dBm, A larger value indicates better signal reception quality <br/>
       `cqi` : Channel Quality
-
+	  `sinr`: Signal to Noise Ratio(supported in 1803s/qualcomm/unisoc，range : -30 ~ 30)
 * Example
 
 ```python
 >>>net.getSignal()
 ([99, 99, 255, 255], [-51, -76, -5, 255])
+
+>>>net.getSignal(0)
+([99, 99, 255, 255], [-51, -76, -5, 255])
+>>>net.getSignal(1)
+([99, 99, 255, 255], [-51, -76, -5, 255, 18])
 ```
 
 

en-us/api/QuecPythonThirdlib.md

@@ -1646,6 +1646,29 @@ Set interactive protect. After setting to enable interactive protect, all extern
 | Parameter | Type | Description                       |
 | --------- | ---- | --------------------------------- |
 | flag      | int  | 0 : Disable（default)；1 ：Enable |
+| kw_args   | str  | password，it can be NULL          |
+
+* Return Value
+
+  * Return 0 if the execution is successful.
+  * if the parameter of flag is 2, return values means current repl states:
+     -1：failed
+      1：repl enable
+	  2：repl enable but The password has already been set
+      3：repl refuse
+      4：repl-protection by password
+
+
+
+> ​	**system.replChangPswd(old_password,new_password)**
+
+change repl-protetion password
+
+* 参数
+
+|   Parameter  | Type | Description                       |
+| old_password | str  | old password len:6-12byte         |
+| new_password | str  | new password len:6-12byte         |
 
 * Return Value
 
@@ -1654,9 +1677,64 @@ Set interactive protect. After setting to enable interactive protect, all extern
 **Example**
 
 ```python
-import system
-
-system.replSetEnable(1)  # Enable interactive protection.
+>>>import system
+
+>>> system.replSetEnable(1,password='miamia123')
+0
+>>> 
+Please enter password:
+>>> ******
+Incorrect password, please try again:
+>>> ********
+Incorrect password, please try again:
+>>> *********
+REPL enable
+>>> system.replSetEnable(2)
+2
+>>>
+
+
+>>> system.replSetEnable(1,password='miamia')
+Incorrect password!
+-1
+>>> system.replSetEnable(1,password='miamia123')
+0
+>>> 
+Please enter password:
+>>> miamia123
+*********
+REPL enable
+>>> system.replSetEnable(2)
+2
+
+
+
+>>> system.replChangPswd(old_password='miamia123',new_password='123456') //change password
+0
+>>> system.replSetEnable(1,password='miamia123')
+Incorrect password!
+-1
+>>> system.replSetEnable(1,password='123456')
+0
+>>> 
+Please enter password:
+>>> ******
+REPL enable
+
+
+
+>>> system.replSetEnable(0,password='123456')
+
+0
+>>> 
+>>> system.replSetEnable(2)
+1
+>>> system.replSetEnable(0)
+0
+>>>system.replSetEnable(1)
+>>>
+REPL refuse
+>>>
 ```