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