HOWTO gblc
gblc - the (G)ude (B)oot-(L)oader (C)lient
You can use the gblc utility to search GBL devices (e.g. Expert Power Control NET, EMC Professional NET, etc...] within your network, to modify their network settings, or to update the firmware. All GBL devices are listening to port 50123 UDP, which is used for all communication described below.
gblc was developed as command line tool for linux as equivalent to GBL_Conf.exe for Windows, but is also available as gblc.exe compiled with cygwin gcc.
Download
- Source tarball: Gblc-0.7.11.tar.gz
- Win32 cygwin binary: Datei:Gblc.zip
Compiling gblc
tar -xzvf Gblc-0.7.6.tar.gz cd gblc-0.5.1 ./configure make make install
Testing gblc installation
# which gblc /usr/local/bin/gblc
Usage: gblc command [HOST] [OPTIONS] commands search [HOST] search GBL devices by broadcast ping HOST send GPL-ping fabdefaults HOST reset device to fab defaults gofirmware HOST leave bootloader start firmware gobootldr HOST leave firmware start bootload if devices allows update HOST load firmware update to flash --firmware=epc.bin netconf HOST change devices' network settings --[ip,nm,gw]=v.w.x.y --dhcp=[0,1] --httpport=80 --httpauth=[0,1] --indexauth=[0,1] --ipacl=[0,1] --phy=[auto,10,100,10_100,10fd,100fd,10_100fd] --replyping=[0,1] --gbldebug=[0,1] --gbldr=[0,1] hostname HOST change devices' hostname --name=myhost [OPTIONS] -d, --debug enabled debug info -s, --silent dont show progress infos -u, --unicast send UNICAST dgrams when possible -b, --bootldr just search device in bootloader mode --version show version info
Searching GBL devices - gblc search
# gblc search
'EMC Professional NET' v1.2 BootLdr: v2.0 MAC-addr: 00:19:32:00:00:38 Phy conf: manual probe: 10 100 Mpbs half-duplex Phy state: 10 Mbps half-duplex IP addr: 192.168.1.250 Netmask: 255.255.255.0 Gateway: 192.168.1.3 DHCP: enabled HTTP port: 80 HTTP auth: disabled 'ExpertPowerControl 8x' v2.1 BootLdr: v2.2 (*ACTIVE*) MAC-addr: 00:19:32:00:00:AB Phy conf: manual probe: 10 100 Mpbs half-duplex Phy state: 10 Mbps half-duplex IP addr: 192.168.1.241 Netmask: 255.255.255.0 Gateway: 192.168.1.3 DHCP: enabled HTTP port: 80 HTTP auth: disabled 2 devices found
As you can see, we found one EMC Professional NET and one ExpertPowerControl 8x within our network. The search is performed by a UDP broadcast. The ExpertPowerControl 8x has been started in BootLoader Mode (BootLdr: v2.2 (*ACTIVE*)), so you will be able to perform the commands netconf, fabdefaults, , fwupdate, etc...
Changing GBL devices' net settings - gblc netconf
# gblc netconf 192.168.1.241 --ip=192.168.1.242 --nm=255.255.0.0 --gw=0.0.0.0 --dhcp=0 --httpauth=0 --httpport=81 --ipacl=0
saving net conf, wait approx. 1 seconds GBL-Save NetConf 2 replied in 0.041230 seconds command status: SUCCESFUL
check if all settings are stored by your device with
# gblc search 192.168.1.241
searching GBL device... 'ExpertPowerControl 8x' v2.1 BootLdr: v2.2 (*ACTIVE*) MAC-addr: 00:19:32:00:00:AB Phy conf: manual probe: 10 100 Mpbs half-duplex Phy state: 10 Mbps half-duplex IP addr: 192.168.1.242 Netmask: 255.255.0.0 Gateway: 0.0.0.0 DHCP: disabled HTTP port: 81 HTTP auth: disabled 1 devices found
netconf options in detail
set target devices's IP address --[ip,nm,gw]=v.w.x.y enable/disable dhcp at target device --dhcp=[0,1] set target devices' http port --httpport=80 enable/disable http passwort protection --httpauth=[0,1] make even startpage require http password if password protection is enabled --indexauth=[0,1] enable/disable IP ACL (ip filter) --ipacl=[0,1] modify ethernet physical link behavior --phy=[auto,10,100,10_100,10fd,100fd,10_100fd] enable/disable target devices' support for ICMP ping reply --replyping=[0,1] enable/disable target devices' serial debug output (115200 baud 8N1) --gbldebug=[0,1] enable/disable target device is allowed to enter bootloader by GBL command (ATTENTION: without IP-ACL this is a serious security hole! --gbldr=[0,1]
Reset GBL devices to fabrique defaults - gblc fabdefaults
gblc fabdefaults 192.168.1.242 sending GBL-Restore FabSettings, please wait approx. 6 secons... GBL-Restore FabSettings 5 replied in 5.173012 seconds command status: SUCCESFUL
now reboot your GBL device to make it operate with fab default settings.
Uploading Firmware - gblc update
# gblc update 192.168.1.153 --firmware=epc.bin
127716 bytes, 250 pages, xor sum: 0x3f sending GBL-Prepare Firmware Update, please wait approx. 1 second... - replied in 0.000445 seconds command status: SUCCESFUL 1/250 - replied in 0.002158 seconds 2/250 - replied in 0.002188 seconds 3/250 - replied in 0.002172 seconds [...] 250/250 - replied in 0.002172 seconds Firmware Update complete