Gotting HG G-76343 Скачать руководство пользователя страница 87

Страница: 87 / 114

Device Description HG G

76343/4/5 | English, Revision 05 | Date: 23.02.2022

REST-API – Chapter 11

11.1 Functions and Command Lines

Starting with firmware 2.12p it is possible to perform the following functions via
HTTP(S) with GET and POST:

Download of the active config file

Download of the default config file

Upload of a config file

Upload of a firmware file

Status request

Certificate upload

Download of a list of available WLAN+LAN recordings ((W)LAN dump files)

Download of single WLAN+LAN recordings

Download of the systemlog file

With the command line tool

curl

you can execute the functions of the REST-API via

script automatically or via command line.

curl

also processes the transfer of any

user/password information. This is how the command lines for the various functions
would look like:

REST-API

Table 60

REST-API: Functions and Parameters

Function

URL

Method Result

Download the active
config file

http(s)://<radio_modem_IP>/API/Cfg/GetRunning

GET

Text

Download the
default config file

http(s)://<radio_modem_IP>/API/Cfg/GetDefault

Get

Text

Upload of a config
file

http(s)://<radio_modem_IP>/API/Cfg/Set

POST

Upload of a firm

ware file

http(s)://<radio_modem_IP>/API/Firmware/Upgrade

POST

Status request

http(s)://<radio_modem_IP>/API/Status

GET

JSON

Upload a certificate http(s)://<

radio_modem_IP

>/API/Cfg/ImportCertificate

POST

Download the file
list of the existing
WLAN+LAN record

ings

http(s)://<

radio_modem_IP

>/API/Debug/CaptureFiles

GET

JSON

Download a file

http(s)://<

radio_modem_IP

>/API/Debug/CaptureFile/

GET

Binary

Download the sys

temlog file

http(s)://<

radio_modem_IP

>/API/Debug/Get/SystemLog

GET

JSON

Содержание HG G-76343

Страница 1: ...Rail or Flange Casing Variants HG G 76343 A HG G 76344 A including version for 4G LTE 5G HG G 76345 A English Revision 05 Date 23 02 2022 Dev by TC Author s RAD Device Description HG G 76343 4 5 Data...

Страница 2: ...authentication via 802 1x SCEP Simple Certificate Enrollment Protocol Fast Roaming 802 11r 2x antenna connectors for diversity 1 4x Gigabit LAN interfaces 1x serial interface not in HG G 76345 RS232 R...

Страница 3: ...g Type ZA with Flange Casing 15 3 2 Initial Startup via LAN 15 3 3 The MC Config Program 15 3 4 Reset to Factory Settings 16 4 MC Config Program 17 4 1 Functional Description 17 4 2 Initial Startup 17...

Страница 4: ...of the relay 48 5 3 7 Realtime Clock 48 5 3 8 Input optional 49 5 3 8 1 Input Parameters 49 5 3 8 2 Input query in UDP mode 50 5 3 9 Logging Debug 50 5 4 Statistics 50 5 4 1 Statistics System Log 50 5...

Страница 5: ...a default reset 85 10 2 Application for the Config USB Stick 85 10 2 1 Initializing a Config USB Stick 85 11 REST API 87 11 1 Functions and Command Lines 87 11 2 Outputs for the Status Function 89 12...

Страница 6: ...43 4 5 English Revision 05 Date 23 02 2022 6 Table of Contents 17 List of Tables 107 18 Index 109 19 Copyright and Terms of Liability 112 19 1 Copyright 112 19 2 Exclusion of Liability 112 19 3 Trade...

Страница 7: ...f the danger The paragraph kind or source of the danger names the kind or source of the danger The paragraph consequences describes the consequences of not observing the warning notice The paragraphs...

Страница 8: ...required etter eys are indicated as such for any programs of G tting KG small and capital letters are equally working 1 2 Declaration of Conformity This product complies with the relevant harmonizati...

Страница 9: ...5 connects all devices that are connected to its LAN interface to a network reachable via WLAN Via a serial interface the HG G 76343 4 5 can receive and transmit data that is sent or received by a co...

Страница 10: ...connector LAN port 1 has a PoE function IEEE 802 3af so that the HG G 76343 4 5 can be powered by this port The serial port is connected by a 9 pin D SUB plug The assignment is selected in a way that...

Страница 11: ...connector for the power supply and the relay switching contact 2 3 2 Connectors HG G 76344 A Figure 4 Connectors HG G 76344ZA The photo shows the HG G 76344 A with default configuration with 1 serial...

Страница 12: ...ng contact 2 4 Pin Assignments 2 4 1 5 pin M12 Socket Power Relay Figure 6 Pin assignment 5 pin M12 socket power relay 2 4 2 9 pin Sub D Socket Serial Table 3 Pin assignment 9 pin Sub D socket RS 232...

Страница 13: ...e APs or is cur rently authenticating green WLAN connection working OK short orange blinking Shows activity on the interface sending or receiving of data LAN off No device connected to the LAN Port gr...

Страница 14: ...e and one version with a flange casing Below you can find casing pictures showing the dimensions of the different variants 3 1 1 Casing Type XA with Top Hat Rail Mounting on narrow Side all Vari ants...

Страница 15: ...t only the ON LED lights up green which soon starts blinking orange red green and green This indicates the boot process After about 15 seconds the appli cation is ready and the LEDs indicate the modes...

Страница 16: ...different sequences that are visualized by all four LEDs lighting up in the same color The LED sequences start with lighting up in white then blue red green re starting with white Holding the Reset bu...

Страница 17: ...ere is no wireless network with a matching SSID Figure 11 MC Config Program Setup for the initial operation of a WLAN client The HG G 76343 4 5 is connected to a computer that has an Ethernet port The...

Страница 18: ...nt By double clicking this field all messages saved so far are opened in a text editor 4 3 1 Operating Elements Figure 13 MC Config Program Operating elements Table 5 MC Config Program Operating eleme...

Страница 19: ...restart of the device is carried out 8 Close Closes the MC Config program 9 User Pass word This information must be entered if the configuration of a WLAN client is pro tected by the definition of Us...

Страница 20: ...t is connected to a WLAN the Mac address of the con nected access point is displayed here Some access points send out a device name that the WLAN client then shows here instead of the MAC address 9 Si...

Страница 21: ...36 165 are in the 5 GHz band 13 Status Information on the transfer state of data between the MC Config program and the WLAN client This also includes the status of the logging function for recording t...

Страница 22: ...isplay changes and shows the messages of the selected WLAN client 2 Log Datei The messages of the MC Config program are written to the file given here 3 ERROR INFO DEBUG TRACE Selection of how detaile...

Страница 23: ...s on off Static flag If you want to keep all existing devices in the table in an application even if they are not currently avail able you can set the entries to static This means that the entries are...

Страница 24: ...y Deletes the selected entry from the list Abort Transfer With this function a running transfer e g firmware upload can be aborted Set RTC to Device This transfers the system time of the PC to the rad...

Страница 25: ...editor this information can be further processed Autosize col umns This function sets the width of all visible columns automatically to a certain measure so that all information is visible This actio...

Страница 26: ...time of the PC is continuously transmitted to the WLAN clients This makes sense if no time server is available in the network Device Polling This parameter sets how often the current status of the de...

Страница 27: ...the configure menu part 3 of 3 Menu item Function Table 14 MC Config Program Pretest Option Function Disabled Pretest not active Enabled Need user acknowl edge The new Config must be confirmed by the...

Страница 28: ...ect all list items Ctrl A Delete Delete selected list items from the table Ctrl Entf Abort transfer Abort all currently running data transfers Ctrl Alt A Debug logging Activate or deactivate the loggi...

Страница 29: ...cture items with a search match are highlighted in blue Possible settings for the selected segment are displayed in the parameter field 5 The user can apply changes Changed parameters are shown in bol...

Страница 30: ...nts are connected via a WLAN infrastructure that does not for ward the broadcast queries of the MC Config program In order to reach these WLAN clients you can define IP ranges that are scanned with th...

Страница 31: ...item in 5 can be re moved After leaving the dialog with Close the defined and activated ranges are scanned 4 8 Logging Debug Messages The WLAN clients allow to store events and error situations that o...

Страница 32: ...save all sent and received data packets into a file This file can then be ana lyzed with the program Wireshark 5 The same function as 4 but for the LAN interface 6 Here the intensity of the debug mess...

Страница 33: ...at file and displayed in area 2 By repeating this for other devices it is possible to log debug messages for several WLAN clients at once A double click on area 2 opens the logged messages in the defa...

Страница 34: ...rameter Setting via the Web Interface Table 17 Web interface System Information part 1 of 2 Entry Note Device Name This information can be edited under Admin section 5 2 on page 42 and is being displa...

Страница 35: ...duct contains software whose right holders license it under the terms of the GNU General Public License ver sion 2 GPLv2 version 3 GPLv3 and or other open source software licenses For more information...

Страница 36: ...ormation part 2 of 3 Entry Note Table 19 Web interface Possible messages connection state State Meaning Idle no connection active Disconnected previously existing connection was interrupted EAP Succes...

Страница 37: ...dBm Table 22 Web interface Wired LAN Status Information Entry Note LAN link state Link Down no LAN cable with an active Ethernet cli ent connected Up LAN cable with an active Ethernet client connecte...

Страница 38: ...mxc0 If a compatible USB serial adapter is connected the following declarations like dev ttyUSB0 1 are also possible Network Connection The configured port mode is shown here followed by the current s...

Страница 39: ...active TCP UDP The relay function opens a TCP UDP Socket and listens on the configured port Internal The relay is controlled by the digital input Serial Trigger The relay turns on when data is being r...

Страница 40: ...ently connected AP is highlighted in gray and is al ways displayed in the first position This is followed by the APs with the appropriate SSID which can also be used for a connection These are display...

Страница 41: ...ory stick is plugged in the status of this memory is displayed at the bot tom of the home page Before removing the memory stick the user should disconnect the memory from the system using the Unmount...

Страница 42: ...Configuration Manage ment In this menu item you can transfer firmware files to the HG G 76343 4 5 or save and restore the currently configured parameters in a file 5 2 1 Firmware With this dialog a fi...

Страница 43: ...to a file Running configuration means the configuration that is currently active on the WLAN client without the changes made temporarily within the actual configura tion session Download new con figu...

Страница 44: ...rotocol SNMP is a network protocol for moni toring and controlling network elements from a central sta tion The MIB file which pro vides a device description can be downloaded from the radio modem via...

Страница 45: ...please contact the service Webserver certificate With this function it is possible to upload a certificate for the web server of the radio modem This certificate replaces the device internal self gen...

Страница 46: ...es within a local network can be resolved to IP addresses without the need for a DNS server All DNS requests for the local domain are sent via UDP to the mDNS multicast address 224 0 0 251 UDP port 53...

Страница 47: ...de for vehicles running on battery power The following parameters set the function of the relay 5 3 6 1 Relay Parameter Table 30 Web interface Onboard Relay part 1 of 2 Parameter Function Enable This...

Страница 48: ...fered by a bat tery Therefore once the time has been set it is lost after the supply voltage has been switched off After switching on the voltage the HG G 76343 4 5 starts the RTC with the date 01 01...

Страница 49: ...re is not present Table 33 Web interface AUX Input Parameters part 1 of 2 Parameter Function Enable Enables the input Mode Operating Modes Remote Port Remote IP IP address and Port of the communicatio...

Страница 50: ...the messages are shown that are stored on the HG G 76343 4 5 Which mes sages are logged depends on the settings in Configuration Logging ab s chapter 9 on page 77 There you can adjust the logging inte...

Страница 51: ...left to right 5 4 2 Statistics Network This sub menu shows statistics of the network interfaces The section Network In terface eth0 shows them for the LAN interface the section Network Interface wlan0...

Страница 52: ...with each other even with the cloned device However these other devices cannot communicate via WLAN Bridge Modes Table 35 Bridge Modes Bridge Mode LAN clients IP s in WLAN Transparency Note LAN Clien...

Страница 53: ...the WLAN interface of the radio modem Thus the WLAN client and the LAN client can be reached via WLAN with this IP ad dress Figure 43 Bridge Modes LAN Client Cloning parameters 2 DNS1 2 If the radio m...

Страница 54: ...ly one IP address Disadvantage of the LAN Client Cloning mode 1 Only one LAN client can be connected to the HG G 76343 4 5 6 2 NAT and Single Client NAT Mode In NAT mode the HG G 76343 4 5 works with...

Страница 55: ...network to the DNS server of the WLAN page This elimi nates the need to configure a special DNS server on the LAN clients In this case only the local IP of the HG G 76343 4 5 must be entered MAC Authe...

Страница 56: ...ort number changes Single ports Client IP You can create up to 30 of these rules In a rule definition both port ranges and multiple port redirections can be defined by specifying them separated by com...

Страница 57: ...Modes Static DHCP server entries To ensure that LAN clients are always assigned the same IP address after switching on the HG G 76343 4 5 or the entire system you can reserve IP ad dresses from the I...

Страница 58: ...section 5 4 2 on page 51 6 3 Level 2 Pseudo Bridge Mode In Level 2 pseudo bridge mode all LAN clients communicate with their own IP ad dresses via the WLAN For this purpose the MAC address of the WLA...

Страница 59: ...HCP Relay Agent If the LAN clients on the radio modem obtain their IP ad dress via DHCP this option can support this by the HG G 76343 4 5 manipulating the DHCP requests of the LAN client so that the...

Страница 60: ...assign ment and transparency especially in applications with multiple LAN clients are solved In this mode all data packets received from the LAN clients are tunneled by the HG G 76343 4 5 Slave to ano...

Страница 61: ...the stationary network side 6 4 1 MWLC Master Figure 53 Bridge Modes MWLC Master The MWLC Master works with WLAN interface switched off High Priority This means that the data from and to the MWLC slav...

Страница 62: ...side becomes visible as soon as the Bridge active option is deactivated Figure 55 Bridge Modes Bridge not active Routing Priority If WLAN and LAN are active a gateway is usually also defined for both...

Страница 63: ...er country setting antenna configuration SSID Profile 1 Here you define the WLAN network name to which the HG G 76343 4 5 should connect This includes settings for the encryption used and the possibil...

Страница 64: ...he energy consumption of the HG G 76343 4 5 to be reduced to a limited extent Activating this function only makes sense for appli cations that have to work as energy efficiently as possible 802 11bg b...

Страница 65: ...cast address can also be specified here so that all devices connected to the LAN can po tentially receive this information Destination port The UDP port on which the receiving device expects data Form...

Страница 66: ...ne when the SSID profile is changed Table 38 Wireless WLAN Interface SSID profile parameters Parameter Value Function SSID 1 32 char This is the network name of the WLAN This is specified by the AP WL...

Страница 67: ...ccess Point Table 40 Wireless WLAN Interface SSID connect action Parameter Value Function DHCP No action Renew This setting determines what the DHCP client function of the radio modem should do when a...

Страница 68: ...igit hex value An example If the WEP key consists of the ABCDE characters the correct input is 4142434445 for WPA The pass phrase is specified here This string must be at least 8 and can be a maximum...

Страница 69: ...erent EAP methods that can be selected here Depending on the EAP method a password has to be specified and if necessary certificates must also be installed 1 The server certificate does not have to ex...

Страница 70: ...ongoing data transmission Therefore parameters are provided which make this scan procedure and the criteria for the change to another AP adjustable so that the data connection can be kept as stable a...

Страница 71: ...kes various parameters into account The parame ters that are available also depend on the existing WLAN infrastructure The most important value is the signal strength SNR Starting from the SNR value i...

Страница 72: ...llowing options can be selected 7 5 3 Connection Watchdog This is an option to monitor the WLAN connection This is intended to detect a ter mination of the WLAN connection by registering the received...

Страница 73: ...lways moves along a fixed course and in an environment with many APs Then it may be advantageous if only certain APs should be used to run this course with as few roamings as possible The Avoid mode c...

Страница 74: ...rolled via the network Further explanations are given in the section 8 2 on page 75 Keep alive parameter Parameters for the TCP server or TCP client mode to monitor the TCP connection See section 8 3...

Страница 75: ...port The UDP mode should be used in cases where e g a separation of the communication partners occurs more frequently How ever it must be noted that the UDP protocol does not ensure the correct deliv...

Страница 76: ...is done via a separate socket port For this reason the user has to make further configura tions depending on the network mode set The states of the signal lines are described as character strings Cert...

Страница 77: ...can be solved In normal operation all settings described here should be reset to the default values Likewise the log files that are still present on the device should be deleted by the func tion Stat...

Страница 78: ...own or a reset the fol lowing messages are written to the end of an already existing debug file The maximum size of the file is 16 MB USB External USB FLASH memory In this mode a new numbered debug fi...

Страница 79: ...has to be defined for this 0 0 0 0 means that this function is not active 4 Thread Name or ID of the process that issues this message 5 Source file name a Name of the program file and b number of the...

Страница 80: ...location for the WLAN recordings Internal Flash Internal flash memory approx 400 MByte USB External USB Memory depending on capacity of the memory stick Dump Control With Dump Control you can specify...

Страница 81: ...mp Ethernet Dump file list Additional information is given as to how many bytes and data packets are stored in the current dump Also there is information about the number of data packets that have bee...

Страница 82: ...n depending on the settings made under Logging This file is filled up to a length of 16 MByte When this size is reached it is renamed Com pleteOldDebugLog txt An existing CompleteOldDebugLog txt file...

Страница 83: ...dual debugging levels can be set for the following program sections Figure 68 Debug Logging Syslog Server Table 57 Debug Logging Debug Levels Level Function ERROR Occurrence of an error that prevents...

Страница 84: ...etwork Bridge Messages generated by the bridge module NOTICE Reduced System Performance The Maximum level may generate such a large number of debug messages that the performance of the primary applica...

Страница 85: ...are for the radio modem The goal is to be able to quickly replace a defective HG G 76343 4 5 with a different HG G 76343 4 5 by simply plugging the USB Config Stick from the defective radio modem into...

Страница 86: ...ange of the configuration takes place in the Config Stick as well as a change of the HG G 76343 4 5 firmware is also stored on the USB stick Thus another HG G 76343 4 5 that is started with this Confi...

Страница 87: ...r of any user password information This is how the command lines for the various functions would look like REST API Table 60 REST API Functions and Parameters Function URL Method Result Download the a...

Страница 88: ...https radio_modem_IP API Cfg GetDefault Cfg Set curl N u user password k X POST F image config file https radio_modem_IP API Cfg Set Firmware Upgrade curl N u user password k X POST F image firmware...

Страница 89: ...Time UTC Firmware Version 2 12s Firmware version KernelVersion Linux version 4 9 229 Kernel version Table 63 REST API Return calues API Status Serial API Status Serial 1 2 3 4 Value Example Descriptio...

Страница 90: ...2 Port 55925 Table 65 REST API Return values API Status Wireless part 1 of 2 API Status Wireless 1 2 3 Value Example Accesspoints 0 BSSID 68 86 A7 13 81 1F SNR 35 Noise 95 RSSI 60 APName AP_001 SSID T...

Страница 91: ...43 4 5 English Revision 05 Date 23 02 2022 91 REST API Chapter 11 Channel Frequency 2412 Channel 1 Noise 95 LastScanned 64 Table 65 REST API Return values API Status Wireless part 2 of 2 API Status Wi...

Страница 92: ...the logging of system messages on USB memory media or for the connection of other inter faces with USB adapters Relay 1 x switch over max 1A 24 V max 125 VAC Signal Input Aux 1 x galv separated 10 60...

Страница 93: ...EP 64 128bit TKIP AES Security 802 11i WPA 2 3 PSK 802 1x EAP PEAP TLS TTLS LEAP Channels 802 11b g n ETSI 1 13 USA Canada 1 11 802 11a n ETSI 19 USA Canada 12 U NII 1 UNII 2A U NII 2C U NII 3 Data ra...

Страница 94: ...apter de scribes the differences Figure 70 Application example HG G 76344 A LTE 13 1 Variants HG G 76344 A LTE HG G 76344XA ZA 4G LTE 5G Table 68 Variants of the radio modem with mobile radio interfac...

Страница 95: ...ot usually be reached from outside such a function can very well be used in a private campus network For this reason the mobile device usually initiates a connection to the server The mobile radio mod...

Страница 96: ...SIM card slot in the picture HG G 76344ZA LTE 5G Inserting the SIM card Remove the protective cover of the SIM card slot Carefully insert the SIM card completely into the slot on the front The orienta...

Страница 97: ...sful data dial up User Password APN Short green blue changes The PIN is being transferred to the SIM card Permanent green blue change PIN incorrect White red change PIN attempts are exhausted The PUK...

Страница 98: ...ICCID SIM card identification number IMSI Mobile radio subscriber identification Base Station Area Code Information about the rough location of the mobile subscriber Base Station Cell ID Information...

Страница 99: ...terface right Table 72 LTE Network Information in the web interface Info Meaning Interface Mobile IPv4 IP address net mask and GW of the mobile interface Interface LAN IPv4 IP address net mask and GW...

Страница 100: ...r formed via DNS lookup if required The cycle time can be entered in seconds in the Connection Timeout field and only becomes active if no data is transferred within this period The system uses this f...

Страница 101: ...terface Mobile radio interface LTE LTE P Technology LTE Cat 4 3GPP Release 11 Antennas 1x SMA LTE 2x SMA LTE P thereof optionally 1x GNSS Speed Downlink up to 150 Mbps Uplink up to 50 Mbps GNSS GPS GL...

Страница 102: ...us a written request by mail email or fax to the following addresses G tting KG Celler Str 5 D 31275 Lehrte Germany Fax 49 0 5136 8096 80 E Mail opensource goetting agv com detailing the name of the...

Страница 103: ...odule FCC ID RYK WPEA 121N Contains Transmitter Module IC 6158A WPEA121NW Any similar wording that expresses the same meaning may be used Additionally the following two part statement must be fixed on...

Страница 104: ...ation This equipment generates uses and can radiate radio frequency energy and if not installed and used in accordance with the instructions may cause harmful interfer ence to radio communications How...

Страница 105: ...igure 19 MC Config Program Configure Menu 25 Figure 20 MC Config Program Device Menu 28 Figure 21 MC Config Program Config dialog 29 Figure 22 MC Config Program IP Ranges 30 Figure 23 MC Config Progra...

Страница 106: ...s 64 Figure 57 Wireless WLAN Interface Wireless Status Information Service 65 Figure 58 Wireless WLAN Interface Enable Ping 72 Figure 59 Wireless WLAN Interface Preferred avoided access points 73 Figu...

Страница 107: ...nterface Wireless Status Information 35 Table 19 Web interface Possible messages connection state 36 Table 20 Web interface Display for active encryption 36 Table 21 Web interface SNR Quality of the r...

Страница 108: ...ic Dump Configuration 80 Table 56 Debug Logging Structure of the file names of the downloaded dump files 82 Table 57 Debug Logging Debug Levels 83 Table 58 Debug Logging Individual Debug Levels 83 Tab...

Страница 109: ...p 81 File Destination 78 MC Config Program 81 Wireless Dump 81 Declaration of Conformity 8 default reset 85 E EAP 69 EU Declaration of Conformity 8 Exclusion of Liability 112 EXT4 42 F Factory Setting...

Страница 110: ...e 93 trade marks 112 U UDP IP Mode 75 USB Memory Stick 85 Config USB Stick 85 EXT4 42 format 42 V Variants 10 Versions 10 W Warning Notices 7 Web Interface 34 Access Point Information 40 Admin Menu 44...

Страница 111: ...ice Description HG G 76343 4 5 English Revision 05 Date 23 02 2022 111 Index Chapter 18 Wireless Roaming 70 Wireless SSID Profile 66 Wireless Status Information Service 65 WPA 68 WPA2 68 WPA3 68 WPA3...

Страница 112: ...o the description This instruction manual has been drawn up to the best of our knowledge Installa tion setup and operation of the device will be on the customer s own risk Liability for consequential...

Страница 113: ...Device Description HG G 76343 4 5 English Revision 05 Date 23 02 2022 113 Copyright and Terms of Liability Chapter 19...

Страница 114: ...Innovation through Guidance G tting KG Celler Str 5 D 31275 Lehrte Tel 49 0 5136 8096 0 Fax 49 0 5136 8096 80 info goetting agv com www goetting agv com www goetting agv com...

Результаты поиска

Содержание HG G-76343

Отзывы:

Похожие инструкции для HG G-76343

Бренды по названию

Популярные бренды

Gotting HG G-76343, Руководство пользователя

Результаты поиска

Содержание HG G-76343

Отзывы:

Похожие инструкции для HG G-76343

Бренды по названию

Популярные бренды