Szablon: Textcommands: Różnice pomiędzy wersjami

Z Elproma Wiki Knowledge Base
Skocz do: nawigacja, szukaj
 
(Nie pokazano 10 pośrednich wersji utworzonych przez tego samego użytkownika)
Linia 1: Linia 1:
This page contains the list of text commands supported by {{{model}}} {{{type}}} and its description.
This page contains the list of text commands supported by {{{model}}} {{{type}}} and its description.


All below commands are available from 3.0.x modem firmware version. They can be send over USB, SMS or Teleorigin Manager.
All below commands are available from 3.0.x modem firmware version. They can be send over USB, SMS or Smart Manager.


Special characters:<br>
Special characters:<br>
Linia 8: Linia 8:
<LF> - Line Feed 0x0A character
<LF> - Line Feed 0x0A character


'''NOTE:''' <CR><LF> characters can be omitted when the command is sent via SMS and Teleorigin Manager („Console” tab).
'''NOTE:''' <CR><LF> characters can be omitted when the command is sent via SMS and Smart Manager („Console” tab).


==Device commands==
==Device commands==
Linia 168: Linia 168:
   | Response
   | Response
   | Phone allow list is empty
   | Phone allow list is empty
or
or<br>
xxxxxxxxx +xxxxxxxxxxxx xxxxxxxxxxxxxx<CR><LF>
xxxxxxxxx +xxxxxxxxxxxx xxxxxxxxxxxxxx<CR><LF>
|-
|-
   | Response example
   | Response example
   | Phone allow list is empty
   | Phone allow list is empty
or
or<br>
123456789 +0012123456789<CR><LF>
123456789 +0012123456789<CR><LF>
|-
|-
Linia 237: Linia 237:
   | Response examples
   | Response examples
   | internet <CR><LF>
   | internet <CR><LF>
or
or<br>
internet username password<CR><LF>
internet username password<CR><LF><br>
Where:<br>
Where:<br>
internet is <apn>
internet is <apn><br>
username is <username>
username is <username><br>
password is <password>
password is <password>
|-
|-
Linia 247: Linia 247:
   | Sets TCP ports (data and config)
   | Sets TCP ports (data and config)
Where:<br>
Where:<br>
<data_port> - TCP data port (range from 0 to 65535)
<data_port> - TCP data port (range from 0 to 65535)<br>
<config_port> - TCP port for remote configuration (range from 0 to 65535)
<config_port> - TCP port for remote configuration (range from 0 to 65535)
|-
|-
Linia 314: Linia 314:
<time> - restart time in hours (from 0 to 8760). When it is set to 0, the device will not perform periodic reboot<br>
<time> - restart time in hours (from 0 to 8760). When it is set to 0, the device will not perform periodic reboot<br>
<start_time> - Unix time* - optional. If it is ommited, <start_time> equals device startup time<br>
<start_time> - Unix time* - optional. If it is ommited, <start_time> equals device startup time<br>
* - there will be added also the HH:MM format option (under development)
<nowiki>*</nowiki> - there will be added also the HH:MM format option (under development)
|-
|-
   | Response
   | Response
Linia 327: Linia 327:
   | Response
   | Response
   | x xxxxxxxxxx<CR><LF>*
   | x xxxxxxxxxx<CR><LF>*
* - there will be added also x xx:xx format option (under development)
<nowiki>*</nowiki> - there will be added also x xx:xx format option (under development)
|-
|-
   | Response example
   | Response example
Linia 334: Linia 334:
1 is <time><br>
1 is <time><br>
1619515560 is <start_time><br>
1619515560 is <start_time><br>
* - there will be added also 1 10:30 format option (under development)
<nowiki>*</nowiki> - there will be added also 1 10:30 format option (under development)
|-
|-
   | <b>CONFIG SET UART <configuration><CR><LF></b>
   | <b>CONFIG SET UART <configuration><CR><LF></b>
Linia 386: Linia 386:
<source> - clock source, options:<br>
<source> - clock source, options:<br>
<b>GSM</b> (time from GSM network)<br>
<b>GSM</b> (time from GSM network)<br>
<b>NTP ntp_addr ntp_port</b><br>
<b>NTP ntp_addr ntp_port</b> (time from NTP server, ntp_addr – string with NTP server address, ntp_port – NTP port (range from 0 to 65535), optional, usually 123)
(time from NTP server, ntp_addr – string with NTP server address, ntp_port – NTP port (range from 0 to 65535), optional, usually 123)
|-
|-
   | Response
   | Response
Linia 403: Linia 402:
   | Response examples
   | Response examples
   | GSM<CR><LF>
   | GSM<CR><LF>
or
or<br>
NTP ntp.elproma.com.pl 123<CR><LF>
NTP ntp.elproma.com.pl 123<CR><LF>
|-
|-
Linia 434: Linia 433:
   | Response example
   | Response example
   | As above
   | As above
|-
  | <b>CONFIG SAVE PERMANENT<CR><LF></b>
  | Saves configuration to device memory permanently
|-
  | Response
  | OK<CR><LF>SAVED BACKUP<CR><LF>
|-
  | Response example
  | As above
|-
  | <b>CONFIG GET SAVE PERMANENT<CR><LF></b>
  | Get status of permanent configuration
|-
  | Response
  | SAVE PERMANENT <option><CR><LF>
Where:<br>
<option> - TRUE or FALSE
|-
  | Response example
  | SAVE PERMANENT TRUE<CR><LF>
|-
|-
   | <b>CONFIG SET SERIAL TYPE <type><CR><LF></b>
   | <b>CONFIG SET SERIAL TYPE <type><CR><LF></b>
Linia 479: Linia 499:
   | <b>CONFIG RESET<CR><LF></b>
   | <b>CONFIG RESET<CR><LF></b>
   | Resets configuration
   | Resets configuration
*requires CONFIG SAVE and reset of the device (RB900SG RESET) to apply
<nowiki>*</nowiki> requires CONFIG SAVE and reset of the device (RB900SG RESET) to apply
|-
|-
   | Response
   | Response
Linia 507: Linia 527:
   | Response example
   | Response example
   | ENABLE<CR><LF>
   | ENABLE<CR><LF>
or
or<br>
DISABLE<CR><LF>
|-
  | <b>CONFIG GET SIM SELECTED<CR><LF></b>
  | Returns status of selected SIM
|-
  | Response
  | xxxxxxxx<CR><LF>
|-
  | Response example
  | EXTERNAL<CR><LF>
or<br>
INTERNAL<CR><LF>
|-
  | <b>CONFIG SET SIM SELECTED <option><CR><LF></b>
  | Selects SIM, where:
<option> is EXTERNAL or INTERNAL
|-
  | Response
  | OK<CR><LF>
|-
  | Response example
  | As above
|-
  | <b>CONFIG SET SERIAL PORT AT COMMANDS <option><CR><LF></b>
  | Enable or disable AT commands mode, where:
<option> is ENABLE or DISABLE
|-
  | Response
  | OK<CR><LF>
|-
  | Response example
  | As above
|-
  | <b>CONFIG GET SERIAL PORT AT COMMANDS<CR><LF></b>
  | Returns the status of AT commands mode
|-
  | Response
  | OK<CR><LF>
|-
  | Response example
  | ENABLE<CR><LF>
or<br>
DISABLE<CR><LF>
DISABLE<CR><LF>
|-
  | <b>CONFIG GET JSON<CR><LF></b>
  | Returns the configuration
|-
  | Response
  | CONFIG: {<configuration_in_json_format>}<CR><LF>
|}
|}



Aktualna wersja na dzień 15:41, 29 lut 2024

This page contains the list of text commands supported by {{{model}}} {{{type}}} and its description.

All below commands are available from 3.0.x modem firmware version. They can be send over USB, SMS or Smart Manager.

Special characters:
<EXT> - End of Text 0x03 character
<CR> - Carriege Return 0x0D character
<LF> - Line Feed 0x0A character

NOTE: <CR><LF> characters can be omitted when the command is sent via SMS and Smart Manager („Console” tab).

Device commands

RB900SG Commands
Available since firmware version: 3.0.0
RB900SG GET FW VERSION<CR><LF> Downloads the firmware version number of the microcontroller
Response x.x.x<CR><LF>

where x – version number

Response example 3.0.0<CR><LF>
RB900SG GET IP<CR><LF> Retrieves the IP address of the device
Response x.x.x.x<CR><LF>
Response example 10.43.210.2<CR><LF>
RB900SG GET RTCTIME<CR><LF> Gets device time in Unix time or unless the clock is out of sync then rtc time is equal uptime
Response xxxx<CR><LF>
Response example 868<CR><LF>
RB900SG GET UPTIME<CR><LF> Gets the number of seconds since the device startup
Response xxxx<CR><LF>
Response example 868<CR><LF>
RB900SG RESET<CR><LF> Resets the device
Response -
Response example -
RB900SG TIME<CR><LF> Returns the current time in human-readable version
Response Time: xxxxxxxxxx, mm-dd-yyyy hh:mm:ss<CR><LF>
Response example Time: 1619618224, 11-30-2021 13:57:04 <LF><CR><LF>
RB900SG LOG PRINT<CR><LF> Sends all entries from the event log
Response ------------------------------------------------------

Sep 12:30:05 - x.x.x<CR><LF>
Sep 12:30:08 - SIM ready<CR><LF>
Sep 12:30:09 - Cfg port opened<CR><LF>
Sep 12:30:11 - PDP activated<CR><LF>

Response example ------------------------------------------------------

Sep 12:30:05 - x.x.x<CR><LF>
Sep 12:30:08 - SIM ready<CR><LF>
Sep 12:30:09 - Cfg port opened<CR><LF>
Sep 12:30:11 - PDP activated<CR><LF>
Sep 12:30:12 - IP: 46.77.88.87
Sep 12:30:14 - Sync to NTP

RB900SG LOG FORMAT<CR><LF> Removes all entries from the event log
Response OK<CR><LF>
Response example As above
RB900SG GET HW VERSION<CR><LF> Downloads the hardware version number of the device
Response x.x.x<CR><LF>

where x – version number

Response example 2.3.1<CR><LF>
RB900SG BATTERY VOLTAGE<CR><LF> Downloads battery voltage in volts
Response X.XX<CR><LF>
Response example 4.08<CR><LF>
RB900SG GET TEMPERATURE<CR><LF> Downloads temperature of the device
Response XX.X *C<CR><LF>
Response example 30.5 *C<CR><LF>

Allowlist commands

PHONE ALLOWLIST Commands
Available since firmware version: 3.0.0
PHONE ALLOWLIST ENABLE<CR><LF><CR><LF> Turns allowlist on
Response OK<CR><LF>
Response example As above
PHONE ALLOWLIST DISABLE<CR><LF> Turns allowlist off
Response OK<CR><LF>
Response example As above
PHONE ALLOWLIST STATUS<CR><LF> Returns information whether allowlist is on or off
Response xxxxxxx<CR><LF>
Response example DISABLE<CR><LF>
PHONE ALLOWLIST LIST<CR><LF> Returns a list of numbers added to an allowlist
Response Phone allow list is empty

or
xxxxxxxxx +xxxxxxxxxxxx xxxxxxxxxxxxxx<CR><LF>

Response example Phone allow list is empty

or
123456789 +0012123456789<CR><LF>

PHONE ALLOWLIST ADD <phone_number><CR><LF> Adds a <phone_number> to the allowlist

Where:
<phone_number> - phone numer in national or international format
NOTE: it is recomended to add the numer in national and international format separately (without and with the area code)

Response OK<CR><LF>
Response example As above
PHONE ALLOWLIST REMOVE <phone_number><CR><LF> Removes the given <phone_number> from the allowlist

Where:
<phone_number> - phone numer in national or international format

Response OK<CR><LF>
Response example As above
PHONE ALLOWLIST CLEAR<CR><LF> Removes all phone numbers from allowlist
Response OK<CR><LF>
Response example As above

Config commands

CONFIG Commands
Available since firmware version: 3.0.0
CONFIG SET APN <apn> <username> <password><CR><LF> Sets <apn>

Where:
<apn> - string with Access Point Name
<username> - apn username (optional)
<password> - apn password (optional)

Response OK<CR><LF>
Response example As above
CONFIG GET APN<CR><LF> Returns apn and username (optional) and password (optional)
Response Xxxxxxxxx xxxxxxxx xxxxxxxx<CR><LF>
Response examples internet <CR><LF>

or
internet username password<CR><LF>
Where:
internet is <apn>
username is <username>
password is <password>

CONFIG SET TCP PORTS <data_port> <config_port><CR><LF> Sets TCP ports (data and config)

Where:
<data_port> - TCP data port (range from 0 to 65535)
<config_port> - TCP port for remote configuration (range from 0 to 65535)

Response OK<CR><LF>
Response example As above
CONFIG GET TCP PORTS<CR><LF> Returns TCP <data_port> and <config_port> ports
Response xxx xxx<CR><LF>
Response example 703 704<CR><LF>

Where:
703 is <data_port> and 704 is <config_port>

CONFIG SET SIM PIN <pin><CR><LF> Sets the PIN code of the SIM card

Where:
<pin> - PIN code of the SIM card (range from 0000 to 9999)

Response OK<CR><LF>
Response example As above
CONFIG GET SIM PIN<CR><LF> Returns the PIN code of the SIM card
Response xxxx<CR><LF>
Response example 1111<CR><LF>
CONFIG SET ANTENNA <type><CR><LF> Sets the antenna to external or internal <type>

Where:
<type> - type of antenna, options:
EXTERNAL
INTERNAL

Response OK<CR><LF>
Response example As above
CONFIG GET ANTENNA<CR><LF> Returns the antenna type
Response xxxxxxxxx<CR><LF>
Response example EXTERNAL<CR><LF>
CONFIG SET PERIODIC REBOOT Sets the periodic restart time

Where:

Response OK<CR><LF>
Response example As above
CONFIG GET PERIODIC REBOOT<CR><LF> Returns periodic restart time and start time in hours
Response x xxxxxxxxxx<CR><LF>*

* - there will be added also x xx:xx format option (under development)

Response example 1 1619515560<CR><LF>*

Where:
1 is

CONFIG SET UART <configuration><CR><LF> Configures UART

Where:
<configuration> - configuration string in the format xxxx abc where xxxx = baudrate, a = start bits, b = parity, c = stop bits

Response OK<CR><LF>
Response example As above
CONFIG GET UART<CR><LF> Returns UART configuration
Response xxxx xxx<CR><LF>
Response example 9600 8N1<CR><LF>

Where:
9600 is baudrate
8 is start bits
N is parity
1 is stop bits

CONFIG SET TEXT INFO 1 <CR><LF> Sets text information

Where:
- string with additional comment (up to 128 characters)

Response OK<CR><LF>
Response example As above
CONFIG GET TEXT INFO 1<CR><LF> Returns text information
Response Xxxxxx<CR><LF>
Response example Test comment<CR><LF>
CONFIG SET RTC SOURCE <source><CR><LF> Sets the internal clock sync source

Where:
<source> - clock source, options:
GSM (time from GSM network)
NTP ntp_addr ntp_port (time from NTP server, ntp_addr – string with NTP server address, ntp_port – NTP port (range from 0 to 65535), optional, usually 123)

Response OK<CR><LF>
Response example As above
CONFIG GET RTC SOURCE<CR><LF> Returns the internal clock synchronization source
Response xxx<CR><LF>
Response examples GSM<CR><LF>

or
NTP ntp.elproma.com.pl 123<CR><LF>

CONFIG SET NETWORK SEARCH MODE <mode><CR><LF> Sets the network search mode

Where:
<mode> - AUTO or 2G or 3G or 4G sets the search mode to auto, 2G (GSM) only, 3G (WCDMA) only or 4G (LTE) only

Response OK<CR><LF>
Response example As above
CONFIG GET NETWORK SEARCH MODE<CR><LF> Returns the network search mode
Response xx<CR><LF>
Response example 2G<CR><LF>
CONFIG SAVE<CR><LF> Saves configuration to device memory
Response OK<CR><LF>
Response example As above
CONFIG SAVE PERMANENT<CR><LF> Saves configuration to device memory permanently
Response OK<CR><LF>SAVED BACKUP<CR><LF>
Response example As above
CONFIG GET SAVE PERMANENT<CR><LF> Get status of permanent configuration
Response SAVE PERMANENT <option><CR><LF>

Where:
<option> - TRUE or FALSE

Response example SAVE PERMANENT TRUE<CR><LF>
CONFIG SET SERIAL TYPE <type><CR><LF> Sets serial port hardware layer type where:

<type> - 232 or 422 or 485

Response OK<CR><LF>
Response example As above
CONFIG GET SERIAL TYPE<CR><LF> Returns serial port hardware layer type
Response XXX<CR><LF>
Response example 232<CR><LF>
CONFIG SET WATCHDOG PING SERVER <en> <addr> <timeout> <ping_num><CR><LF> Sets options for pinging external server, where:

<en> - enable (0 or 1), <addr> - address (max. 32 chars), <timeout> - timeout in seconds 1-255 (optional), <ping_num> - number of ping repetitions 1-10 (optional)

Response OK<CR><LF>
Response example As above
CONFIG GET WATCHDOG PING SERVER<CR><LF> Returns options for pinging external server
Response xxxxxxx<CR><LF>

or
<domain or IP> <timeout> <ping_num>

Response example DISABLE<CR><LF>

or
domain.com 20 4

CONFIG RESET<CR><LF> Resets configuration

* requires CONFIG SAVE and reset of the device (RB900SG RESET) to apply

Response OK<CR><LF>
Response example As above
Available since firmware version: 3.0.3
CONFIG SET VPN <option><CR><LF> Sets VPN on or off where:

<option> - ENABLE or DISABLE

Response OK<CR><LF>
Response example As above
CONFIG GET VPN<CR><LF> Returns VPN status
Response xxxxxxx<CR><LF>
Response example ENABLE<CR><LF>

or
DISABLE<CR><LF>

CONFIG GET SIM SELECTED<CR><LF> Returns status of selected SIM
Response xxxxxxxx<CR><LF>
Response example EXTERNAL<CR><LF>

or
INTERNAL<CR><LF>

CONFIG SET SIM SELECTED <option><CR><LF> Selects SIM, where:

<option> is EXTERNAL or INTERNAL

Response OK<CR><LF>
Response example As above
CONFIG SET SERIAL PORT AT COMMANDS <option><CR><LF> Enable or disable AT commands mode, where:

<option> is ENABLE or DISABLE

Response OK<CR><LF>
Response example As above
CONFIG GET SERIAL PORT AT COMMANDS<CR><LF> Returns the status of AT commands mode
Response OK<CR><LF>
Response example ENABLE<CR><LF>

or
DISABLE<CR><LF>

CONFIG GET JSON<CR><LF> Returns the configuration
Response CONFIG: {<configuration_in_json_format>}<CR><LF>

NOTE: To save new configuration use CONFIG SAVE command and reboot the device using RB900SG RESET or manually reset the device by disconnecting the power supply.

[[Category:{{{model}}} User Manual]]