AT Commands
AT Commands are used to learn or change information about Mikrodev devices. AT Commands can be queried from the Mikroterminal application or via SMS.
For more detailed information : Mikroterminal Interface.
| AT+XXX=? | ACCESS RIGHT | DESCRIPTION | |
|---|---|---|---|
| ETHERNET | LOCALIP | LOGIN REQUIRED, R/W | |
| MAC | LOGIN REQUIRED, READ ONLY | ||
| GATEWAY | LOGIN REQUIRED, R/W | ||
| NETMASK | LOGIN REQUIRED, R/W | ||
| DHCP | LOGIN REQUIRED, R/W | Enable/Disable DHCP | |
| LWIPTMO | LOGIN REQUIRED, R/W | If no packets received from PLC Ethernet port, resets the ethernet connection | |
| CONFIGPORT | LOGIN REQUIRED, R/W | ||
| GSM | GPRSAPN | LOGIN REQUIRED, R/W | |
| GPRSNAME | LOGIN REQUIRED, R/W | ||
| GPRSPSSW | LOGIN REQUIRED, R/W | ||
| CSQ | READ ONLY | available if ppp is not active | |
| IMEI | READ ONLY | available if ppp is not active | |
| GPRSIP | READ ONLY | available if ppp is not active | |
| SIM | READ ONLY | available if ppp is not active, returns true if SIMCARD communication is ok | |
| MODEM | UNPROTECTED, R/W | available if ppp is not active, sends and receives reply from modem | |
| SOCKET STATUS | SERVERTIMEOUT | LOGIN REQUIRED, R/W | Tests if sockets are ok, if not closes them (seconds) |
| CONNECTION | READ ONLY | ||
| SOCKET | UNPROTECTED, R/W | Displays the details of the clients connected on that "socket number" | |
| PLCRESET | LOGIN REQUIRED, R/W | If not received any data during that interval from ,GSM/ETH resets the device | |
| PLC STATUS | HELP | READ ONLY | |
| INCLUDE | READ ONLY | Shows the enabled features on the device | |
| MEMORY | READ ONLY | Total used memory | |
| VERSION | READ ONLY | ||
| SERIALNO | READ ONLY | ||
| PRODUCTNO | READ ONLY | Returns the product number | |
| MODEL | READ ONLY | Device model selected in bootloader level | |
| POWERCOUNT | READ ONLY | Total reset count from the time project is uploaded | |
| ERROR | READ ONLY | ||
| PLC TIME | SETTIME | LOGIN REQUIRED, R/W | |
| TIMEOFFSET | LOGIN REQUIRED, R/W | Time zone offset | |
| PLC LCD | MENULINE1 | LOGIN REQUIRED, R/W | Startup text for LCD devices, 16 characters ,first line |
| MENULINE2 | LOGIN REQUIRED, R/W | Startup text for LCD devices, 16 characters ,second line | |
| WI-FI SETTINGS | WIFIPSSW | LOGIN REQUIRED, R/W | Set/Get WiFi Password |
| WIFISSID | LOGIN REQUIRED, R/W | Set/Get WiFi SSID | |
| WIFIMAC | LOGIN REQUIRED, R/W | Get WiFi MAC | |
| WIFIIP | LOGIN REQUIRED, R/W | Set/Get WiFi IP Address | |
| WIFIGATEWAY | LOGIN REQUIRED, R/W | Set/Get WiFi Gateway Address | |
| WIFINETMASK | LOGIN REQUIRED, R/W | Set/Get WiFi Network Mask | |
| CANBUS | CANSTATUS | UNPROTECTED, R/W | Status information for extension devices |
| CANCOMMAND | LOGIN REQUIRED, R/W | Sends commands to extension devices | |
| CANTIMEOUT | LOGIN REQUIRED, R/W | Timeout value for checking extension device exists or not | |
| INTERNAL FILESYSTEM RELATED | FBD | UNPROTECTED, R/W | |
| ONLINE | UNPROTECTED, R/W | ||
| DEFAULT | LOGIN REQUIRED, R/W | ||
| PASSWORD | UNPROTECTED, R/W | Set Password | |
| LOGIN | UNPROTECTED, R/W | Login device | |
| RESET | UNPROTECTED, R/W | ||
| OTHER PLC FUNCTIONS | ADCERROR | READ ONLY | ADC error count |
| FATFS | READ ONLY | The size of the log file in the SD card |
ETHERNET
- AT+LOCALIP
Used to identify local IP to devices with Ethernet or Wi-Fi capability.
To change the local IP, type "AT + LOCALIP = IP" and click "write" command to write IP to the device.
Click on the "read" command to read the current IP value.
- AT+GATEWAY
It is used to define gateway to devices with Ethernet or Wi-Fi capability.
In a local network, the gateway is usually the IP address of the modem. AT + GATEWAY "command to read and write the gateway address.
- AT+NETMASK
It is used to define "netmask" for devices with Ethernet or Wi-Fi capability.
- AT+DHCP
AT+DHCP= Enable/Disable DHCP.
• AT+DHCP = 0 – Disable
• AT+DHCP= 1 – Enable
- AT+LWIPTMO
If no packets received from PLC Ethernet port, resets the Ethernet connection.
- AT+CONFIGPORT
The AT + CONFIGPORT command is used to identify the port number used in situations where a TCP port connection from Mikrodiagram is desired to be installed on devices with a TCP communication port (Ethernet, GSM, Wi-Fi).
It can be changed with AT + CONFIGPORT command.
AT + CONFIGPORT = ? command can be viewed with the current configport.
CONFIGPORT is disabled when a selected TCP socket block is added to the device as a server Mikrodiagram. The device's listening port is the listening port that is inserted into the TCP socket block.
The factory default ConfigPort number is 502.
- AT+MAC
It is used to define the MAC address for devices with Ethernet or Wi-Fi capability.
The current MAC address can be read with "read" command.
GSM
- AT+GPRSAPN
AT + GPRSAPN command is used to define APN for Mikrodev products with GSM TCP communication feature.
Since the APN that needs to be defined varies according to the SIM card operator used in the device,it must be supplied from the customer service of the relevant GSM operator.
The APN has to be defined if the used device is to be used as a server in the TCP communication with the GSM line (if the device will connect to another IP).
Note: The SIM card used in the APN-defined device must have a static IP.
Note: GPRSAPN Settings
- for Turkcell - mgbs
- for Vodafone - internetstatik
- for Türk Telekom - statikip
- AT+SIM
It is used for SIM card inquiry in Mikrodev products with GSM hardware.
With "AT + SIM =?" read only command. The value can not be written.
The response to the command is SIM = 0 to indicate that the SIM card is not inserted, is incorrectly installed or is defective.
If the answer to the command is SIM = 1, it indicates that the SIM card is correctly installed and is fault-free.
- AT+CSQ
It is the value of the GSM signal quality (the power of the GSM line) that the devices with GSM capability are installed. It can be between 0 and 31.
Even if the SIM card is not inserted, the value can be read while the GSM antenna is connected. (Emergency calls are used on mobile phones when the SIM card is not inserted.)
AT + CSQ is only readable command.
The pull chart is as follows.
- AT+IMEI
It is used to find out the IMEI number of the SIM Card.
- AT+GPRSIP
The data package (internet package) is the IP of the SIM card. Supplied by the GSM operator.
It can only be read by AT + GPRSIP command.
If the device is to be used as a server, a SIM card with a fixed IP address must be provided.
When a SIM card with a fixed IP is provided, APN information must also be received from the GSM operator.
Socket Status
- AT+SERVERTIMEOUT
If the connection between the device and the remote system is lost or the connection between the devices is lost, it is waited for the specified second and then used to reset the device.
- AT+SOCKET
It is used to monitor the active connections of TCP socket blocks in Mikrodiagram project.
When AT + SOCKET = <"TCP Socket Block" Block Number> command is sent to the device, the connections made from the relevant TCP socket block are displayed.
Those with status "1" indicate that the connection exists. The "status" states, which are different from "1", indicate that the link already existed, but that the link broke down before the specified time.
- AT+PLCRESET
The AT + PLCRESET command is used when TCP communication protocols require the device to be reset after a certain period of time.
If AT + PLCRESET = 0 command is sent to the device, the command is disabled.
The AT + PLCRESET command runs at a minimum 60 second (sec) scale.
To learn the current PLCRESET command programmed in the device, enter AT + PLCRESET =? command can be sent to the device.
- AT+CONNECTION
Connection status check of Mikrodev products with GSM data exchange feature is done by "AT + CONNECTION" command.
The AT + CONNECTION command has only readability.
The AT + CONNECTION command receives even-numbered values 0-8.
The AT + CONNECTION command response table is below.
PLC Status
- AT+HELP
It is the command that indicates which queries can be asked to the device.
- AT+INCLUDE
It is the command that shows which features are active or inactive on the device.
- AT+VERSION
It is the command that shows the version information on the device.
- AT+POWERCOUNT
It shows how many times the device is restarted after Mikrodiagram project is loaded. The first value is 1 since the device is restarted after the mikrordiagram project has been loaded.
Readable command.
AT + POWERCOUNT= ? , The current value is queried.
- AT+ERROR
If the device is in error mode, it is used to learn the error code.
If AT + ERROR = 0, then there is no error condition.
AT + ERROR = 61 means that the device does not have Mikrodiagram installed.
The AT + ERROR command is only a readable command.
PLC Time
- AT+SETTIME
With the AT + SETTIME command, the device real time clock can be read and written.
When the AT + SETTIME command "read" is clicked, the current time of the device readable in the console window, the date and time to be set to the command window; When set to "dd-mm-yyyy hⓂ️s" and the "summer" command is sent, the time set is displayed in the console window.
PLC LCD
- AT+MENULINE1
- AT+MENULINE2
WIFI Settings
- AT+WIFISSID
It is used to identify the WI-FI network name to be included in WI-FI enabled products.
In the "AT + WIFISSID" command window, the WI-FI name is written, the "write" command is clicked,
When you want to read the current WI-FI SSID, click "AT + WIFISSID" "read" command.
- AT+WIFIPSSW
It is used to describe the password of the WI-FI network to be included in WI-FI-enabled products.
AT + WIFIPSSW WI-FI password is written into the command window, click on the "write" command,
When the current WI-FI password is desired to be read, the AT + WIFIPSSW "read" command is clicked.
CANBUS
- AT+CANSTATUS
It is state learning command for Mikrodev Expansion Devices.
- AT+CANCOMMAND
With the AT+CANCOMMAND query, information about the expansion device can be accessed.
AT+CANCOMMAND=< BoardType >,< BoardId >,< Channel >,< Command >,< VALUE >
• BoardType:
- XIO211_DIN = 0,
- XIO211_DOUT = 1,
- XIO211_RELAY = 2,
- XIO211_AIN = 3,
- XIO211_AOUT = 4,
- XIO211_RTD = 5,
- XIO211_DI8DQ8= 6,
- XIO211_DI8= 7,
- XIO211_DQ8= 8,
- XIO211_AI4AQ4= 9,
• BoardID:
Board value set with DIP Switch.
• Channel:
The corresponding channel number in the expansion. For example, if it will calibrate the 3rd input on the analog input, 2 will be written here.
• Read Commands:
• Write Commands:
- AT+CANTIMEOUT
AT + CANTIMEOUT command Mikrodev is used to protect the position of the inputs and outputs on the expansion units for a specified period of time in case of communication failure between CPU modules and expansion units.
The CANTIMEOUT time runs in millisecond (ms) time scale.
When the communication link between the input modules and the CPU breaks, inputs up to the number of CANTIMEOUT entered into the CPU do not change position in the software.
When the communication link between the output modules and the CPU breaks, the outputs do not change positions as long as the CANTIMEOUT times entered in the output modules.
The CANTIMEOUT time input to the CPU is used for the input modules, the CANTIMEOUT time input to the output modules for the output modules is used.
For example, if AT + CANTIMEOUT = 60000 (ms) is defined for the CPU and expansion units, the incoming digital input signal position is maintained through the expansion unit until 60000 (ms) (1 minute) after communication between the digital input (DI) expansion unit and the CPU is interrupted. 60000 ms. After the CANTIMEOUT time has elapsed, the digital inputs are pulled to logic (0) if no connection to the expansion unit is still present.
Internal FS
- AT+FBD
In Mikrodiagram, it is used to read block value and write block value by using "block numbers" of door types.
If the value is to be written, "AT + FBD = BLOKNO, VALUE" is defined and clicked on the "write" command.
If the block value is to be read, "AT + FBD = BLOKNO,?" is defined and clicked on the "write" command.
The "read" command is not used in the AT + FBD command, only the "write" command is used.
- AT+ONLINE
It is used to start and stop the online viewing from the mikroterminal while online viewing is performed in Mikrodiagram.
Online monitoring is started when AT + ONLINE = 1 command is sent.
Online monitoring is stopped when AT + ONLINE = 0 command is sent.
- AT+DEFAULT
The AT+DEFAULT command is used to reset the unit to factory settings. While the device is counting 'autoboot', sending the AT+DEFAULT=1 command returns the device to its factory settings.
When the device is restored to factory settings, the settings made with the AT commands are restored to factory settings, the most recently loaded Mikrodiagram project is deleted from the device.
After the command is sent, the device drops to error ERROR =61.
The command AT+DEFAULT is only writable.
AT+PASSWORD
•Add Password
AT+PASSWORD= -1,"PASSWORD"
- AT+LOGIN
AT+LOGIN=0 --- If the device has a password defined.
AT+LOGIN=1 --- If no password is defined on the device
- AT+RESET
The AT + RESET command is used for software restart of the device.
When AT + RESET = 1 is typed and the "send" button is clicked, the device is restarted.
Other
- AT+ADCERROR
ADC (Analog to Digital Converter). With this command the count of ADC errors is learned.
Other AT Commands
- AT+GSMRESET
The AT+GSMRESET command is queried by writing it from the Custom Command Input section.
If the device can't establish a GSM connection with in the time specified with the AT+GSMRESET command, it resets.
- AT+TEMPTYPE
The AT+TEMPTYPE command is queried by writing it from the Custom Command Input section.
Adjustments are made for the RTD temperature sensor.
AT+TEMPTYPE=0 --- RTD Close AT+TEMPTYPE=2 --- RTD Open
In order to make these adjustments, the device must have an RTD temperature sensor.
- AT+PTO
It is used to activate the "pulse train output" and "axis control" blocks.
AT+PTO =1 command is activated. AT+PTO =0 disable the command.
For current status inquiry, "AT + PTO =?" Command can be sent.
- AT+PROTOCOLMAP
Queries the OBIS Codes installed on the device.
- AT+MIKRODEV
The AT+MIKRODEV command is queried by writing it from the Custom Command Input section.
With the AT+MIKRODEV command, the serial number of the device is learned.
"AT+MIKRODEV=?" format is used.
- AT+SOFTRESET
The AT+SOFTRESET command is queried by writing it from the Custom Command Input section.
With the AT+SOFTRESET command, the reason for the last reset of the device is learned.
| AT+SOFTRESET =? | DESCRIPTION |
|---|---|
| pin reset | The NRST pin has been reset by pulling low. If you have this next to other resets, don't pay attention to it |
| POR/PDR reset | Power Down Reset, the power of the device has been cut, therefore it has been reset |
| Software Reset | Caused by AT+RESET=1 or AT+PLCRESET parameter, the device has reset itself on purpose |
| Independent Watchdog reset | The software was locked, so the watchdog timer reset to recover the device |
| Window Watchdog reset | The software was locked, so the watchdog timer reset to recover the device |
| Low Power reset | The supply level of the device has fallen below the acceptable threshold. So the devices was reset |