Wunderbar v2 23-10-17 Wunderbar upgrade to Conrad Connect firmware and onboarding manual Conrad Electronic SE © 2017 23-10-17 Page 1 of 28
Wunderbar v2 23-10-17 Contents 1 Outline 3 2 Firmware upgrade 2.1 Windows . . . . . . . . . 2.1.1 Upgrade procedure 2.2 Linux and macOS . . . . 2.2.1 Upgrade procedure 3 Firmware update 3.1 Update procedure . . . . 4 4 4 14 14 . . . . . . . . . . . . . . . . . . . . . . . . 18 18 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 Onboarding 20 4.1 Prerequisites . . . . . . . . .
Wunderbar v2 1 23-10-17 Outline This document contains instructions on upgrading existing Wunderbar firmware to V2 version, describes onboarding procedure for this new firmware and explains buttons functionality and led indications.
Wunderbar v2 2 23-10-17 Firmware upgrade Wunderbar can connect to Conrad Connect once the firmware is upgraded to V2 version. This process needs to be performed only once. 2.1 Windows Two programs are required during firmware upgrade procedure: 1. Zadig [link] Automated Driver Installer GUI application which helps installing correct USB drivers for Wunderbar 2. dfu-util [link] which is used to update firmware on Wunderbar 2.1.1 Upgrade procedure 1.
Wunderbar v2 23-10-17 Figure 2: Folder with dfu-util and firmware upgrade package 3. Connect Li-Ion Battery to Wunderbar board. Note! Battery is crucial for proper Wunderbar operation and is required even when Wunderbar is connected to USB port! 4. Connect Wunderbar to computer with USB Micro cable. If Windows starts automatic driver installation it can be safely ignored.
Wunderbar v2 23-10-17 Figure 3: Windows 10 automatic driver installation pop-up Note! Please use USB cable bundled with Wunderbar. Not all USB cables are wired correctly and Wunderbar might not be correctly recognized by your computer. 5. Put Wunderbar into firmware update mode: (a) press and hold User button (figure 4) (b) press and release Reset button (figure 4) (c) release User button Power led and User led should be on.
Wunderbar v2 23-10-17 6. Download Zadig [link] and unpack it to same folder as dfu-util. Figure 5: Folder with dfu-util, firmware upgrade package and Zadig 7. Start Zadig application.
Wunderbar v2 23-10-17 Wunderbar should now be selectable from drop down list 8. Before clicking on ‘Install Driver‘ (or ‘Replace Driver‘) button make sure that WinUSB driver is selected: 9.
Wunderbar v2 23-10-17 10. Unplug Wunderbar from USB port and plug it again to force Windows to use new drivers. 11. Put Wunderbar into firmware update mode: (a) Press and hold User button (figure 4) (b) Press and release Reset button (figure 4) (c) release User button 12. Click on Windows start button and type ‘Device Manager‘ (in German Windows version please type ‘Geräte-Manager‘) 13.
Wunderbar v2 23-10-17 14. Click on Windows start button and type ‘cmd‘ to start Command Prompt 15.
Wunderbar v2 23-10-17 16. Verify that Wunderbar is visible by dfu-util by typing: dfu-util.exe -l Output will look similar to this: 17. Now, upgrade Wunderbar with Bluetooth upgrader: dfu-util.exe -d 15a2:1000 -a 0 -D wunderbar_ble_updater.
Wunderbar v2 23-10-17 18. Restart Wunderbar with Reset button 19. A new removable drive, named WUNDERBAR, should appear on your computer after a few seconds. There will be two files on this drive: 20. Copy wunderbar master ble.hex to this new drive (drag & drop works!) 21. The drive will disappear after the file is completely copied. Warning about improperly ejected drive can be ignored. 22.
Wunderbar v2 23-10-17 Any other file will mean that update failed. You can open FAIL.TXT or ASSERT.TXT to check exact error message. 23. Put Wunderbar into firmware update again (like in step 5) 24. Verify again that Wunderbar is in firmware update mode and available to dfu-util (like in step 16) 25. Upgrade Wunderbar with latest firmware: dfu-util.exe -d 15a2:1000 -a 0 -D wunderbar_v2.bin Output will look similar to this: 26. Finally restart Wunderbar with Reset button.
Wunderbar v2 2.2 23-10-17 Linux and macOS Original Wunderbar firmware contains a bootloader that can be used to program Wunderbar with new software. A program called dfu-util is required for this procedure. Latest dfu-util version can be installed on: • Ubuntu Linux $ apt-get install dfu-util • macOS $ brew install dfu-util 2.2.1 Upgrade procedure 1. Download firmware upgrade package from Conrad [link] and unpack it 2. Connect Li-Ion Battery to Wunderbar board.
Wunderbar v2 23-10-17 Note! Please use USB cable bundled with Wunderbar. Not all USB cables are wired correctly and Wunderbar might not be properly recognized by your computer. 4. Put Wunderbar into firmware update mode: (a) press and hold User button (figure 6) (b) press and release Reset button (figure 6) (c) release User button Power led and User led on master module should be on. Reset button User button WiFi led User led Power led Figure 6: Wunderbar master module buttons and leds 5.
Wunderbar v2 23-10-17 Output should be similar (dfu-util version and serial number might differ) to this: dfu-util 0.9 Copyright 2005-2009 Weston Schmidt, Harald Welte and OpenMoko Inc. Copyright 2010-2016 Tormod Volden and Stefan Schmidt This program is Free Software and has ABSOLUTELY NO WARRANTY Please report bugs to http://sourceforge.net/p/dfu-util/tickets/ Found DFU: [15a2:1000] ver=0000, devnum=22, cfg=1, intf=0, path="20-2.1.4.4", alt=0, name="UNKNOWN", serial="ffffffff4e45299790180014" 6.
Wunderbar v2 23-10-17 (a) CONRAD.HTM (b) DETAILS.TXT 9. Copy wunderbar master ble.hex to this new drive 10. The drive will disappear after few seconds. Warning about improperly ejected drive can be ignored. 11. After few more seconds the same drive will appear again and should contain only following 2 files: (a) CONRAD.HTM (b) DETAILS.TXT Any other file will mean that update failed. You can open FAIL.TXT or ASSERT.TXT to check exact error message. 12.
Wunderbar v2 3 23-10-17 Firmware update Wunderbar firmware can be updated or replaced with custom one via DFU bootloader. It is recommended to update V2 firmware to the latest revision available. You can get the version of firmware running on your Wunderbar and check if it is the latest available, by logging in to Conrad Connect dashboard [link] and navigating to your Wunderbar. 3.1 Update procedure To start an update simply put Wunderbar into DFU mode: 1. press and hold User button (figure 11) 2.
Wunderbar v2 23-10-17 Note! It is recommended to re-onboard Wunderbar after Wunderbar V2 firmware update! Warning! Custom firmware only! Custom firmware must be linked properly - application has to start at address 0x00018000, otherwise bootloader can get corrupted! Page 19 of 28
Wunderbar v2 4 23-10-17 Onboarding 4.1 Prerequisites Wunderbar V2 firmware provides an onboarding method through USB. Communication with Wunderbar is done over virtual com port, so a terminal application is required. CoolTerm [link] is a free tool, recommended on all operating systems and the following instruction will assume that this app is used. Note! CoolTerm does not handle backspace key by default, so it is highly recommended to enable this support in ‘Options’->’Terminal’ before onboarding.
Wunderbar v2 23-10-17 3. Connect Wunderbar to computer with USB Micro cable. Note! Please use USB cable bundled with Wunderbar. Not all USB cables are wired correctly and Wunderbar might not be correctly recognized by your computer. 4. On Windows, COM port number needed for next step can be found in ‘Device Manager‘.
Wunderbar v2 23-10-17 (b) Wunderbar will be visible as ‘WUNDERBAR V2 CDCVCOM‘ or ‘USB Serial Device (COMX)‘ device under ‘Ports (COM & LPT)‘ Number after ‘COM‘ in brackets indicate port number and this name should be used in CoolTerm when selecting port. 5. Open CoolTerm app and configure serial port and baudrate as shown on figure 8. Baudrate should be set 115200, name of serial port will differ on each computer and system.
Wunderbar v2 23-10-17 Figure 8: Serial port settings 6. Once configuration is accepted you can click on Connect button. Figure 9 7. Following text should appear in the console: Welcome to WunderBar V2 onboarding wizard! This app will guide you through the process of onboarding your device. Press ENTER to continue.
Wunderbar v2 23-10-17 (a) WiFi SSID (b) Security type (open network, WEP, WPA, WPA2) (c) WiFi password (d) ConradConnect login name (e) Short token generated in step 1 on ConradConnect [link] (f) Device name generated in step 1 on ConradConnect [link] During onboarding you will also be asked to put all sensors into onboarding mode, by clicking on the button on sensor boards (10). Figure 10 8. Depending on your WiFi network and internet connection onboarding process might take a minute or two.
Wunderbar v2 23-10-17 Wunderbar configuration, like WiFi SSID, password or Conrad Connect credentials, can be changed by running onboarding process again. In order to enter onboarding mode long press (over 5 seconds, till User led is blinking rapidly) User button when Wunderbar is running.
Wunderbar v2 5 23-10-17 Buttons & led indications Reset button User button WiFi led User led Power led Figure 11: Wunderbar master module buttons and leds 5.1 Reset button This button has single functionality to force reset Wunderbar at any time. Press and release of Reset button alone will always result in Wunderbar restarting in application mode, as length of this button press is not monitored.
Wunderbar v2 23-10-17 1. Long press (over 5 seconds): this will clear onboarding data from Wunderbar. Once this button is pressed for 5 seconds User led will start blinking rapidly and onboarding data will be cleared when button is released. This is required if Wunderbar configuration (WiFi or Conrad Connect credentials) needs to be changed.
Wunderbar v2 23-10-17 • Fast blinking (every 0.13 second) indicates that Wunderbar is initiating communication with Conrad Connect. • Rapid blinking (every 30 millisecond) indicates that Wunderbar is primed for clearing onboarding data; this patter will appear only after holding User button pressed for more than 5 seconds. • Repeated 5 short and 5 longer blinks indicates that Wunderbar experienced a fatal error and has to be restarted with Reset button.
