FetchMessages Method
Receive currently buffered messages and return to sleep.
Syntax
mqttsn.fetchMessages([callback])
Callback
The 'callback' parameter specifies a function which will be called when the operation completes (or an error is encountered). If the 'callback' parameter is not specified, then the method will block and will not return until the operation completes (or an error is encountered).
The callback for this method is defined as:
function(err){ }
'err' is the error that occurred. If there was no error, then 'err' is 'null'.
'err' has 2 properties which hold detailed information:
err.code err.message
Remarks
Request any messages currently being buffered by the server for the current sleep period and return to sleep after they have been received.
Any available buffered messages will be sent to the client by the MQTTSN Gateway and the sleep interval will be reset.
This method sends a PINGREQ method with the ClientId, requesting buffered messages which will be sent if available (see MessageIn). When the server has sent all messages, it will sent a PINGRESP message, causing the client to re-enter sleep mode. Once the PINGRESP is received, the duration the client may sleep restarts.