BigClown Firmware Windows Toolchain

For Microsoft Windows 7, 8, 10 (32bit and 64bit).

Toolchain is based on BusyBox environment, Git, GNU C, GNU Make.

Scripts/binaries for toolchain executables:

• Daily use - for documentation have a look at BigClown Documentation

  • BigClown Toolchain scripts
    • script\bct.cmd - Entry into BigClown Toolchain - adds Git, GCC, DFU paths at the beginning of %Path%. You can pass directory as first parametr to change to working directory.
    • script\bcf.cmd - Executes BigClown Firmware Tool (implemented in Python and packed by PyInstaller)
    • script\bb.cmd - Executes BusyBox shell (for users who likes Linux shell environment)
  • BigClown Sandbox in ConEmu script\bcsb.cmd
    • MQTT broker
    • MQTT cli client bch
    • BigClown Gateway bcg
    • MQTT Wall web application
  • Git
    • git\cmd\git.exe - Git executable
  • GNU Make
    • make\make.exe - GNU Make executable
  • USB DFU
    • dfu\dfu-util.exe - USB DFU flasher

• Installation or check purposes

  • dfu\dfu-driver-install.cmd - installs USB DFU drivers. Has to be used before connecting STM32 MCU in DFU mode to PC (BigClown Firmware Windows Toolchain has to be installed before connecting STM32 MCU in DFU mode). Uses zadic.exe
  • dfu\zadig.exe - check/fix USB HID drivers (in case STM32 MCU in DFU mode was connected to PC before installation - non-functional ST USB DFU drivers are installed by Plug & PLay system)

Toolchain can be started in different ways:

• Pick BigClown Toolchain in Start menu or double-click icon in Desktop
• Start cmd and then bct (script\bct.cmd is used for that)
• Right click on directory and choose Open with BigClown Toolchain (defined in HKLM)

Sandbox can be started: in different ways:

• Pick BigClown Sandbox in Start menu or double-click icon in Desktop
• Start cmd and then bcsb (script\bcsb.cmd is used for that)

Serial port for Gateway in Sandbox can be customized by setting environment variable PORT. If PORT environment variable it is not set, Sandbox uses last COM port reported by bcg devices.

Installation directory

Default install destination directory is %ProgramFiles(x86)% on 64bit OS or into %ProgramFiles% on 32bit OS (can be changed by user during installation). Defines HKLM environment variable %BigClownToolchain% pointing to top level directory of installation.

During first installation adds %BigClownToolchain%\script at the end of %Path% (can be deselected during installation) on HKLM level by default. That allows to use tools (bcf, bch, bcg, etc) from anywhere and start Toolchain by bct.

If you like to use different version of Git, GNU C or other tools, just use your favourite direcotry before BigClown installation in %Path% (e.g. change paths in bct.cmd or just copy bct.cmd, modify paths and use that modified script to define another paths).

Usage example

Start cmd.

bct
bcf create bctest
cd bctest
make
make dfu

Components

32bit versions, drivers 32bit & 64bit:

• BigClown Firmware Tool v1.4.1
  • tools\bcf.exe - Python script packed with PyInstaller
• BigClown Gateway v1.16.2
  • tools\bcg.exe - Python script packed with PyInstaller
• BigClown Control Tool v0.2.0
  • tools\bch.exe - Python script packed with PyInstaller
• MQTT broker hbmqtt v0.9.5
  • tools\hbmqtt.exe - Python script packed with PyInstaller
• MQTT Wall v0.4 Simple web page showing subscribed topics from MQTT server.
  • mqtt-wall\* - web application
• Git for Windows MinGit-busybox 2.23.0
  • git\cmd
  • git\etc
  • git\mingw32
  • git\usr
• GNU ARM Embedded Toolchain 8-2019-q3-update
  • gcc\arm-none-eabi
  • gcc\bin
  • gcc\lib
  • gcc\share
• GNU MCU Eclipse Windows Build Tools 2.12-20190422, GNU make version 4.2.1
  • make\make.exe - GNU Make, Makefile dependencies by BusyBox:
    • make\sh.exe
    • make\echo.exe
    • make\mkdir.exe
    • make\cp.exe
    • make\rm.exe
• Clink v0.4.9
• ConEmu 180626
• FTDI Virtual COM Port Drivers 2.12.28
• dfu-util-static v0.8
• libwdi v1.2.5 WinUSB drivers for STM32 DFU
• Zadig v2.4 USB driver check&fix for STM32 DFU
• STM32 Virtual COM Port Driver v1.4.0

Build prerequisites

• Microsoft Windows 10 version 1803 (cmd shell)
• Scoop package manager https://github.com/lukesampson/scoop/wiki/Quick-Start
• Scoop buckets
  • scoop bucket add extras
  • scoop bucket add nonportable
  • scoop bucket add versions
• Required Scoop packages scoop install
  • 7zip 7-Zip
  • git Git for Windows
  • python36 --arch 32bit Python 3.6.8 32bit
  • innosetup-np Inno Setup v5.6.1
• Windows 10 SDK signtool Windows SDK Signing Tools for Desktop Apps ~10MB
  • Signing Installers You Create with Inno Setup
    • "C:\Program Files (x86)\Windows Kits\10\bin\10.0.17763.0\x64\signtool.exe" sign /f "...cert.p12" /t http://timestamp.comodoca.com/authenticode /p MY_PASSWORD $f
• Recommended Scoop packages:
  • busybox
  • concfg
  • clink
  • hack-font
  • vscode

How to build

• install prerequisites
• clone repository from GitHub (or unzip from release repository archive)
• change to bch-toolchain-windows directory
• download
• build

---

Made with ❤  by HARDWARIO a.s. in the heart of Europe.