Technology category

1. Can the IoT card of Telecom or Unicom be connected to the OneNET platform?

A: Yes. All IoT cards can be used, except the Telecom’s NB card that can only be connected to the OC platform.

2. Can the trigger mailbox be modified?

A: The trigger mailbox is bound only during registration. If you want to change the mailbox, click Security Settings > Rebind Email.

. Can the data stream of the platform be deleted? How to delete?**

A: The data stream can be deleted at present. Click Developer Center > Data Stream Template > Operation > Delete.

4. Can platform data be exported, deleted, modified and analyzed? How to process it?

A: Currently the platform is equipped with APIs for data/device management.

5. How to check whether the command is sent successfully by the platform?

A: If the API command is called successfully by the application, the OneNET platform will return the execution result.

6. Can the data streams of multiple devices be kept in the same application?

A: Standalone applications are applicable. One standalone application may involve a variety of application components corresponding to different device data streams.

7. Can the device in the platform be recovered after it is deleted? How to recover?

A: The platform device cannot be recovered after it is deleted.

8. Can the device ID be set by the user? Or, is it automatically generated by OneNET?

A: The device ID is automatically generated by the platform.

9. When OneNET pushes messages to a third-party platform, there is always a prompt that the data push set by you has failed multiple times to almost the upper limit of the platform and the link will be connected. Why does this occur?

A: This may be caused by disconnection of the application from the OneNET platform. If the application confirmation is not received, OneNET will continuously push data. It will not stop pushing until 2,000 pieces of data have been pushed.

1. Can only one access protocol be specified when a product is created?

A: Users can choose one protocol according to the application scenario. A device interacts with the platform according to one protocol only.

11. How many devices can be created under a product?

A: Multiple devices can be created under a product. There are restrictions corresponding to the types of real name authentication. For details, see Account Authentication.

12. How many data streams can be added under a device?

A: Multiple data streams can be created under a device. At present, the number of data streams is not limited in the platform.

1. How long can OneNET data be stored? What about the capacity?

A: The data of the OneNET platform is stored for one year. There are no restrictions over the capacity.

1. Is one data stream capable of transmitting two or more types of data?

A: No. It is recommended to create two different data streams.

15. Why is the data uploaded to OneNET an image or data point sometimes?

A: The data is uploaded in the data point form to the platform. The platform does not support image display.

16. The standalone applications are different from template application. How to use the template application?

A:

Standalone application: The data information contained in the standalone application can be collected from multiple devices. This application is unique, which cannot be reused in other devices.

Template application: The data information contained in the template application is collected from a single device. The template applies to all devices. When the template application is enabled through a device, the data displayed in the template application is collected from the device. The device using this template must contain all data streams required in the template.

17. How to convert a template application into standalone application?

A: The template application cannot be converted into a standalone application.

18. Can devices be added/deleted in batches in OneNET?

A: The platform has APIs which can be used to add and delete devices in batches. Please call APIs correctly to add and delete devices in batches.

19. How does OneNET send data to devices?

A: The platform has different modes to send data to devices according to the protocols. For details, see the application protocol access file.

20. Can OneNET use http to transmit videos?

A: This is not supported at present.

21. How does OneNET judge whether the device is online?

A: If the indicator in front of the device name in the product page is green, it means that the device is online. If the indicator is gray, it means that the device is offline.

22. Can the device be added if the deleted IMEI number under the NB product is duplicated in the display?

A: The IMEI number in the module can only be bound to a unique device of the platform. The platform does not support adding a device repeatedly. In this case, it is recommended to first delete the existing device. If the user does not add the device by himself, contact the module provider to delete the device or replace the module.

23. After the successful authentication of the third-party platform, how to receive the data pushed by the server?

A: The server pushes data to the url that is set in third-party application configuration.

24. If the third-party platform data is not pushed successfully, can OneNET be manually triggered to push the data?

A: Yes.

25. Is OneNET connected to a third-party platform through http only?

A: It supports http or https.

26. How to change the bound number if the mobile phone is lost?

A: Change the bound number in security settings. If the previous mobile number is canceled or unavailable, the bound number cannot be changed.

27. How to use OneNET_config_v1.2.exe?

A: OneNET_config_v1.2.exe is a registration code generation tool. Enter the tool path in cmd, fill in all parameters as required, and start running.

28. If the trigger reaches the set value, it will send a message to the mailbox continuously. How to set sending the message once?

A: If the trigger condition is set to “inout” during trigger creation, the trigger will respond once when the data stream enters or exits the interval for the first time and not respond continuously if the data stream is within the interval. For the data points in different trigger modes, see the trigger api section of the application access file.

29. What are the features of the personal account and corporate account of the OneNET platform? What are their differences?

A: At present, user authentication is available online. The features of the personal account and corporate account are partially different. The corporate account has more permissions. Personal authentication can be upgraded further for enterprise authentication. See the Account Authentication for details.

30. What is the corporate account application process (enterprise authentication process)?

A: After the authentication function is launched, the registration entry for corporate accounts has been cancelled. If you want to complete corporate registration, click User Registration > Login > Personal Data > Enterprise Authentication in the platform.

31. How to change the displayed image in the application editor according to the data stream?

A: Upload the image, and fill in the corresponding data stream value below the image. When there is a corresponding data value, the corresponding image will be opened.

32. Can the communication protocol be modified after the product is created?

A: It cannot be modified. If it is modified, the device authentication information and mode under the product will change, resulting in confusion.

33. After a device is created or added in the OneNET platform, the device should be online, but the platform shows that “the device does not support resource identification”. Why does this occur?

A: For login to the OneNET platform according to the LWM2M protocol, subscribe the Object group and Resource parameters first. Refer to the AT command steps of the used module to complete the configuration before login.

34. How to log in again for OneNET offline devices?

A: When the device is offline, the steps to log in again are the same as those for the first login. To prevent the device from being offline, please send the heartbeat packet in time. The device using the LWM2M protocol will send AT+MIPLUPDAT commands promptly.

35. Why is the server set to be disabled automatically?

A: There are two reasons for the third-party server to disable the push service. (1) Failure in pushing occurs continuously within 24h. (2) Failure in pushing one message results in 2,000 consecutive failures.

36. There is no device in the FOTA device list. How to add a device?

A: When the module model is selected for the new group in FOTA, it must be consistent with that of your device. Thus, the device will be added in the FOTA device list. The device is displayed based on the module model and then added.

37. What is the difference between device registration and device addition?

A: Devices are added through the Api-key of the product, and device registration is based on the official environment registration code Register-code of the device. Both operations are to add new devices.

38. Does a map show multiple device locations in the application?

A: No. It is not supported to display multiple coordinates. Only one data stream can be selected in the map control, i.e. the coordinates of one point.

39. Is there a limit to the number of subscription topics? How many topics can be posted under a product? How many topics can be subscribed by a device?

A: It is limited. One MQTT product supports 100 custom topics at most, and 50 topics or less can be subscribed by a device.

40. How to set the timeout of offline commands?

A: Set the timeout parameter, i.e. validity period of commands, 0 by default. 0: Online command. If the device is online, the command will be issued to the device. If the device is offline, the command will be discarded directly. >0: Offline command. If the device is online, the command will be issued to the device. If the device is offline, the command will be valid for the current time plus timeout period, and issued to the online device within the validity period. Unit: second. Valid range: 0-2678400.

41. Is it allowed to slide in the application management page of OneNET to view the historical data curve?

A: No. The data curve only shows the values of the latest data point at present.

42. How to use the official environment registration code used in device management?

A: The registration code is used when the api is called for device registration.

43. How to query historical data of the device through TCP transparent transmission?

A: The historical data of the device can be obtained through the API interface for query of device history.

44. How to use the map of OneNET?

A: Get the parameters from the base station, and report information to the specified data stream of the platform. See the location service.

45. What needs to be returned after the data pushed by the platform is received?

A: It is necessary to send the success status code of http request to OneNET within 5 seconds.

46. Why is the pushed service always stopped?

A: The service will be pushed repeatedly first. When the cumulative number of pushes reaches 2,000 or there are repeated messages in 24 consecutive hours, the push function will be disabled.

47. Can the created product or device be recovered if it is deleted unintentionally?

A: No.

48. If the device is offline, how long does it take for OneNET to detect this?

A: OneNET will not detect that the device is offline until the lifetime expires.

49. How does device A transmit data to Device B in the transparent transmission mode?

A: It is recommended to apply the mqtt protocol during communication in front of the device. The topic is published by device A and subscribed by device B.

50. There is no prompt of parameter error when commands are issued. Why is there a prompt “execution status: request parameter error” when the cache command is read?

A: The error is usually caused by the inconsistency between the resource type and the type in the parameter. It is judged only in the execution process.

51. If there is no reply from the application, will the data be pushed continuously?

A: The data will be pushed repeatedly first. However, when the data is pushed repeatedly for 2,000 consecutive times or 24 consecutive hours, the push function will be disabled.

52. Are there any requirements for custom resid?

A: The normal process is applicable. The difference is that the IDs of the custom object, instance and resource should not be the same as those defined by OMA.

53. How to deal with the repeated failure in token check during URL configuration of the third-party development platform?

A: The nonce, msg, and signature are transmitted by the “get” method during submission for verification. If there is no correct msg value in the returned result, such as other symbols in the msg value, verification will fail.

54. How to divide the commands issued by the OneNET platform?

A: Block transmission. The maximum size of the commands issued by the API is 2kb, and the maximum block size is 512 bytes.

55. Is there a way to obtain the product ID based on MasterKey in the API?

A: At present, there is no API related to the product ID. For other APIs, see the application development section of the development file.

56. How many cache commands are there for each device in OneNET?

A: There are at most 10 cache commands for NB devices at present, and no restrictions over other devices.

57. What will happen if the registered lifetime expires?

A: The device will be offline from the OneNET platform.

58. Is there any difference between device resource writing and command issuing?

A: Both writing and execution are command operations of the device. Execution supports string issuing only, while writing supports more.

59. What is the difference between the immediate command and cache command?

A: The immediate command will not be issued to the device until the device is online and the downlink port is free of ageing. The cache command can be issued when the device is offline and is sent to the device when there is uplink data.

60. Data can be sent to OneNET but the platform shows that the device is offline. Why does this occur?

A: This occurs to the platform connected by the http protocol. Since the http protocol is for short connection, the online status of the device will not be displayed, but data can be posted in the OneNET platform.

61. Does the current NB module support GPS positioning?

A: The module itself does not support it. This can be performed via an external GPS sensor.

62. Can OneNet be connected directly to its own DTU-modbus through a 2G IoT card?

A: Yes

63. What is the meaning of the error 5106 returned by OneNET?

A: TIME_OUT means that the platform does not receive a response from the device within the timeout period (25 seconds). There are several possible reasons.

1) The network connection session is reclaimed by the core network, and the NB-IOT device is connected to the platform through the core network. If the device has no uplink or downlink activity within some time (varying in different places, usually a few minutes), the connection will be reclaimed by the core network, and the messages from the platform will not be transmitted to the device.

2) Network problem: The NB-IOT network is unstable. Although CoAP has a retransmission mechanism, the entire process of request response from the platform to device may still fail within 25 seconds.

64. What is the Remaing length in the Fixed header?

A: Remaining total length in bytes.

65. How to resolve garbled Chinese codes in the decompressed code file?

A: Change the font, preferably UTF-8.

66. There is an auth_info parameter error when the device is created.

OneNET request error: url = https://api.onenet.hk.chinamobile.com/devices params = {protocol=LWM2M, psk=P123123123123123123, auth_info= {123123123123123123=123123123123123123}, title=test-pan} error = invalid parameter: auth_info

A: The apikey is required for the header.

67. Where can the set wifi and password be changed in the official routine program?

A: WIFI_info.

68. What is the platform address for devices to report data?

A: The IPs and ports of protocols vary from each other. Refer to the platform address.

69. Is the mqtt data protocol applicable to a wired network? Is lwip required?

A: Yes. Connect the socket interface in lwipIP to OneNET.

70. Are only 10 offline caches commands or less allowed for NB device?

A: Yes.

71. Is there any permission for database building in OneNET? Can it only be connected to the third-party server?

A: Yes.

72. Is there a limit to the devices associated in a group? Is there a limit to the number of groups under an account?

A: None.

73. The AP mode is set for WiFi. Can it be connected by filling in the designated WiFi account password?

A: The password should not be filled in directly through the serial port. Refer to the 8266AT command set.

74. How long is the lifetime of the mobile platform device? Which parameters are related to this?

A: The platform supports the 31st power of 2 minus 1 second. This parameter is usually changed by AT+MIPLOPEN or AT+MIPLUPDATE.

75. Is there an API for mass sending of commands to all devices on the application side?

A: At present, this function can be performed by MQTT protocol in other ways. MQTT devices under a product can subscribe to the same topic. Once a topic is published, it will be received by all devices subscribing it.

76. How does AT+MIPLNOTIFY transmit multiple integers at a time?

A: At present, this function can be performed by MQTT protocol in other ways. MQTT devices under a product can subscribe to the same topic. Once a topic is published, it will be received by all devices subscribing it.

77. I send a “close” command on the server, and the client is closed after receiving this command. However, the client still receives the “CLOSE” command after restart. Why does this occur? mqtt svrpublish $creq/c457c6f7-7c14-5314-9148-3294abe48687 nil close

A: This is related to qos. 0: send the command at most once, regardless of device response. 1: Send the command at least once. If the device does not respond after receiving the command, the command within the validity period (see the timeout parameter) will be sent again in the next login.

78. What is the difference between registration and new addition in the OneNET development file?

A: Newly added devices are verified by the masterkey that has high permission. If you don’t want to provide the masterkey, you can just give the registration code, which is used for registration only and has lower permission. This function applies to multiple device suppliers under a product. Just give the registration code to device suppliers, instead of the masterkey.

79. How fast can the OneNET platform be tested? Is it possible in 1s?

A: Yes, once a second. However, the NB communication protocol does not support such a high frequency, usually at intervals of more than 5s.

80. What is AUTH_INFO?

A: Authentication information, customized during device creation. It is not required under normal circumstances. This field is still not configured in the module.

81. Can I use js or ajax to access OneNET?

A: Both can be used. The back-end nodejs SDK is also compatible with c# of ajax.

82. When an intermediate command is sent to the device, there is a timeout feedback from the platform. Why does this occur?

A: Device response is required. In case of no device response, the feedback is timeout.

83. Which protocol should be selected for data upload and cloud control?

A: MQTT, EDP.

84. Which protocol should be used when the device is online?

A: MQTT, EDP, LwM2M, TCP.

85. Does the OneNET platform support private network channels?

A: Not supported.

86. When the EDP protocol is used, data can be uploaded normally, but the device is not online.

A: Just log in with debugger.

87. Is it necessary to send heartbeat packets regularly to the platform when the LwM2M protocol is used in the Onenet platform?

A: No. Notifications can be sent to report data at any time within the lifetime.

88. The data uploaded by MQTT protocol is not displayed on the platform, but there is a prompt of successful upload.

A: Only the data sent to the data stream with a $dp topic can be displayed by OneNET in the form of data stream. See the MQTT protocol file.

89. How to configure and verify the URL of http push?

A: There are details in the development document on the official website. The third-party server must return msg. After the user completes the configuration in the page and clicks “Submit”, the OneNET platform will send an HTTP GET request to the URL address for URL verification. The request example is as follows: http://url?msg=xxx&nonce=xxx&signature=xxx. Where, url is the URL filled in by the user in page configuration, and nonce, msg and signature are used for URL and token verification. The token verification process is as follows: Calculate MD5 with the token in page configuration and values of nonce and msg. Compare the URL Decode calculation result of the Base64 string value in the previous step with the value of the request parameter signature. If the two values are equal to each other, it means that the token has been verified successfully. If you do not want to verify the token, you can choose to skip the MD5 calculation. The msg value will be returned directly.

90. How does NB-IoT report GPS data?

A: In the NB light application map (NB resource supporting the reporting of GPS data), the following two resources (choose one) to upload the latitude and longitude: 1. The object id is 6, and the resource id is 0 (latitude) or 1 (longitude). 2. The object id is 3336, and the resource id is 5513 (latitude) or 5514 (longitude). Select the “location” data stream in the corresponding device in the map. Example of uploading the latitude and longitude with the module M5310-A and resource 3336:

AT+MIPLADDOBJ=0, 3336, 1, “1”, 0, 1

AT+MIPLDISCOVERRSP=0,3336,1,9,“5513;5514”

AT+MIPLNOTIFY=0,0,3336,0,5513,1,13,“100.6474940698”,0,1,21

AT+MIPLNOTIFY=0,0,3336,0,5514,1,14,“20.5371754772”,0,0,22.

91. The development board cannot be connected to wifi after the code is uploaded successfully.

A: Call the API interface for inspection and testing on the device side.

92. Are there any restrictions over the device type during SOTA upgrade?

A: No. The SOTA can be upgraded during communication with OneNET.

93. After NB-IoT is connected to OneNET, is it always connected? Or, are heartbeat packets sent at intervals? Is device authentication necessary every time?

A: NB devices have lifecycle settings. The device is online during the lifecycle. The device lifecycle needs to be updated. A long lifecycle can be set, more than one day. Authentication is not necessary every time.

94. Are there remaining messages in MQTT?

A: Yes.

95. Has anyone used the track control in the application? How to display the GPS track in the application?

A: The latitude and longitude data stream is temporarily not supported. Base station positioning is required in the module, so there must be base station positioning information in the device.

96. Two thresholds are required under the trigger condition inout. How to transmit the parameters?

A: When the type is inout, the threshold is set to {“lolmt”:40, “uplmt”:52}, meaning that the data stream is triggered when entering or exiting the closed interval [40, 52] for the first time.

97. Does OneNET support MQTT protocol access in websocket mode?

A: Yes.

98. Can a client of MQTT subscribe multiple topics at the same time?

A: Yes.

99. After the NB module receives the cache message, what will be sent by OneNET to the application server?

A: The device response is dependent on the module used. Refer to the module at command module or seek technical support from the module manufacturer.

100. Is M5310 just a channel or integrated with the LwM2M protocol? Is the coap protocol or LwM2MoverCoap used in the M5310 module and OneNET platform?

A: M5310 is integrated with the protocol LwM2MoverCoap.

101. When the first packet of data is published by the OneNET platform according to the MQTT protocol, will the socket be disconnected actively?

A: MQTT involves long connection. As long as the legal data is sent, the socket will not be disconnected.

102. Many properties (especially the string type) of OneNET objects are not identified, and the opaque type is displayed. The “string” type is identified by 5750 and 5751 only.

A: Follow the ipso file. Otherwise, OneNET will store and display data in the opaque form.

103. Does the OneNET platform support file issuing at present?

A: Yes. There is a file issuing interface according to the device-side access protocol.

104. What is the lifetime?

A: Refer to the time of connection without sending heartbeat packets.

105. Why does this occur during online debugging? “Msg”:“Data analysis of the internal server failed. Try again later”.

A: It is recommended to use postman. This may be caused by online debugging tools.

106. The platform shows that the device is online, but the number of objects in the device list is 0. Is it normal?

A: No resources are found. Perform subscription and identification again.

107. How to receive character data during TCP transparent transmission?

A: Change the lua script.

108. How to obtain IMEI and IMSI?

A: Get imsi:at+cimi, and imei:at+cgsn=1.

109. Does NB-IoT support active control commands of the server?

A: Yes. The downlink writing and reading of the API interface are all consistent with the commands of the active control of the server.

110. Is it normal that the device is offline? (http protocol)

A: Due to short connection of the http protocol, it is normal that the device is offline but the data is reported normally. Use the TCP or MQTT protocol to display the online status.

111. What is the difference between the immediate command and cache command?

A: Intermediate command: The command sent by a three-party platform to OneNET will be immediately issued by OneNET to devices. Cache command: The command issued by a third-party platform to OneNET will be saved by OneNET first and issued to devices when the set trigger downlink conditions are met. When the two commands are sent, responses should be made to the platform. The results will be immediately forwarded by the platform to the third-party platform.

112. What is the role of the new APIKEY function in the platform?

A: It is a brand new distribution function. If you only want a client to access the data or control a specific device, please provide the device-level apikey to prevent unauthorized control over other devices.

113. What is the data stream format of the MQTT standard?

A: MQTT involves 7 data stream formats. Refer to the MQTT development file for details.

114. How to delete data points in OneNET?

A: The data points have been uploaded and saved in the OneNET database. They cannot be deleted without permission.

115. Can M5310A change the baud rate?

A: The baud rate can be changed. The baud rate of 9,600 will be maintained for some time after restart and before change to the set baud rate.

116. What should be done in the presence of HardFault_Handler?

A: Add while(1); in HardFault_Handler and make a breakpoint to see where you can enter the platform.

117. How to display the image uploaded to OneNET on the APP?

A: Images are in the binary file format. After the file is extracted by the API, change its format.

118. Why is “auth failed” always returned when the API is called?

A: See the device number (this is caused by inconsistency between the imei of LWM2M protocol and apikey, or inconsistency between the devid of other protocols and apikey).

119. Which language is used in the application development environment?

A: typescript.

120. How to add devices in batches? Are devices added by the backend or device developer?

A: The imei can be imported in batches into modules of NB devices. In the EDP or MQTT protocol, the API for device registration on the device side can be called.

121. Can fota be upgraded by serial command?

A: Yes.

122. Why does the “else” interface appear instead of the packet program?

A: The memory allocation failed.

123. What is the reason for subscription failure? How to deal with it?

A: 1. The ADDOBJ command is not sent; 2. There is no response to +MIPLOBSERVE issued by the platform.

124. Will the device be disconnected when the EDP protocol is used? Are there any steps to prevent the device from disconnection?

A: The EDP protocol is based on TCP. Messages need to be sent to maintain connection. You can send data or heartbeat packets.

125. If the device is forcibly disconnected after the expiration of the lifetime of OneNET, how to report data? Re-initiate the registration or take other measures?

A: Re-initiate the registration. Update is usually required before the expiration of lifetime.

126. Does the NB device of the OneNET platform send string data?

A: Yes. Use the “execute” interface to issue strings.

127. Are there restrictions over the quantity of free data in HTTP push of OneNET?

A: The HTTP push is free of charge and there is no limit to the quantity of data.

128. The device is offline and not activated in the device list. How to understand “not activated”?

A: The device is not activated if it does not log in after being created. Indeed, the device will be activated once it is connected.

129. How much data does OneNET support in one frame?

A: Max. 800K for the upload of binary files.

130. Is there a limit on the number of API calls of OneNET?

A: There is no limit to the total number of API calls, but the call frequency per second is limited to 300 times per second.

131. Is there a limit on the number of email reminders per day in the trigger?

A: Yes, 20 times.

132. HeartBeat TimeOut: 0 What does the serial port output mean?

A: The sent heartbeat is not detected.

133. The platform shows that the device is online, and the serial port successfully sends AT+MIPLNOTIFY=0,3303,0,5700,“29.2”,1. However, the number of objects in the device list is 0, and the sent data cannot be seen. Why does this occur?

A: No resources are found. Perform subscription and identification again.