KookaManager for the Mac (Beta Version)

AustSTEM is developing a Kookaberry management tool (KookaManager) for both Windows and Mac operating systems. It is currently in its Beta stage of development.

KookaManager’s purpose is to provide a dashboard for the management of the Kookaberry.  Functions include:

  • Launching KookaSuite apps, but only when a Kookaberry is connected
  • Examining and managing the files on the Kookaberry
  • Downloading the latest firmware files to the Kookaberry
  • Downloading a library of pre-built Kookaberry apps and packages, any of which can then be loaded onto the Kookaberry. A tagged catalogue of apps is provided to enable relevant apps to be found.
  • Transferring the users apps (Python or KookaBlockly) onto the Kookaberry for stand-alone use via the Kookaberry’s built-in menu
  • Opening relevant web pages that provide instructions / information on the Kookaberry and its apps and tools.

Installing KookaManager for the Mac

The Mac download can be found at this location: https://www.dropbox.com/s/9pgdo920c9padyn/KookaManager.dmg?dl=0

The current version is a Beta 0.8. Click to download, open the file in Finder, and transfer to the Applications folder



Mac Security Protocol – KookaManager

Double-click the KookaManager file to run it, and navigate through the Mac Privacy and Security protocols as follows. This file is completely safe to open.

When you first try to run KookaManager the following prompt appears. Click Cancel and go to Settings in your bottom menu bar. Click on the Security & Privacy icon and then on Open Anyway in the next screen


The following prompt will appear with a final warning before you can open the file. Click Open and, in the case of this KookaManager file, another prompt will appear advising that KookaSuite files have not been detected. This because they have not been downloaded yet! This is the next activity…… Click OK to continue to KookaManager


Installing KookaSuite

The next step is to install KookaSuite from the Maintain Menu by clicking on Download Latest KookaSuite… in the Maintain dropdown menu.


This will take you to GitHub where you will select (double click on file) the latest version for the Mac and download it.


When it has finished downloading, open it in Finder and change the name of folder from Kookaberry-1.7 to KookaSuite




Mac Security Protocol – KookaSuite

Double-click each of the KookaSuite folders in turn to run them through the MacOS security protocols. This is the same procedure used for  the KookaManager file. These files are completely safe to open.


When you have finished verifying all the files, transfer the KookaSuite folder to Applications and add KookaManager to the bottom menu bar



The software editors (KookaBlockly and KookaIDE) both have script (MicroPython files/programmes) drop-down menus where demo programmes and programmes created by yourself that can be selected and brought into the editors’s canvas.

Accessing saved scripts requires the downloading of this zipped KookaberryScripts folder. It contains sample and demo programmes.

Unzip and move the folder to the same disk location as the KookaSuite folder. [NOTE: A KookaLibrary folder is added to the KookaScripts folder when any one of the KookaSuite files are executed for the first time. When the Get More Apps function is selected from the Apps menu in KookaManager for the first time a prompt will ask you to update the Library and catalogue contents.

KookaManager Functions


Once you have downloaded KookaSuite and KookaberryScripts, the KookaManager application will be fully functional

Connected Kookaberry

Connect a Kookaberry to your Mac using the USB A to USB B battery lead. The contents of its USB memory will display in the canvas of the KookaManager window. If, for some reason, the Kookaberry does not show up in the KM window, click on the Connect icon in the top right hand corner.

You can see all the apps preloaded into the USB memory by opening the app folder.

The MicroPython code in each app can be inspected by clicking on the Inspect File button in the bottom right hand corner.

All the files are locked by default. If you wish to delete one; select it and unlock it. Don’t forget toe lock the files again after you have finsished

Tip; It is easier to operate on the files from the Finder window……

Apps Menu

The Apps menu contains many options, but the main one is the Get More Apps menu which allows a user to investigate and download all of the AustSTEM approved applications in its library and catalogue. If the list of apps does not appear, click on Update Library. Clicking on the name of an app will show a description of the app.

If you want to download an app to your Kookaberry that is not already in its menu; select the app and click Load

Software Editors

A single click on one of the KookaBlockly or KookaIDE icons down the right hand side of the KookaManager window will launch the respective editor in a separate window.

Twin Window

A single click on the KookaTW icon will launch the Twin Window application which mirrors the Kookaberry’s screen on your PC in a separate window. If the window on your PC is is initially blank, disconnect the Kookaberry and then reconnect.

Updating Firmware

Firmware is the suite of software programmes that collaborates with all the various microcontroller chips and components on the board to enable the Kookaberry to work. There are just three files for the three microcontrollers which, once downloaded and run, are invisible to the user.

Microcontroller Chips

These are the three microcontroller integrated circuits on the Kookaberry board

  • Front End Processor (FEP): The FEP is an STM32F103 ARM Cortex-M0 microcontroller with 128 Kb of flash memory and 20 Kb static ram. The FEP runs a preloaded program to interface between the USB computer interface and the other two on board microcontrollers. It also controls the download of applications into and out of the 32 Mbit serial memory.
  • Main Processor (MP): The MP is an STM32F091 ARM-Cortex M0 microcontroller having 256 Kb of flash memory and 32 Kb static ram. This processor is the primary processor to run applications. It also provides general purpose inputs and outputs (GPIO) that may be used by the applications together with the interfacing to the other on-board peripherals – being the accelerometer / e- compass, BLE, 32 Mb flash ram (via an API to the FEP), and the OLED display.
  • Bluetooth Low Energy (BLE): The BLE microcontroller is the Nordic nRF52822 ARM-Cortex M0 microcontroller with 256 Kb flash memory and 16 Kb static ram. It has a 2.4 GHz transceiver specifically for BLE communication.


Firmware Version

You can find out the version of firmware that your Kookaberry is using by connecting it to KookaIDE and observing the date in the connection data at the top of the left hand window. The current latest version (as at February 2022) is shown in the screen shot below. If the connection data in your Kookaberry is not the same, then you will need to update the firmware.

Downloading latest version of firmware

Click on the Maintain menu and click on Update Firmware… A warning will appear which relates to issues unlikely to be present on your Kookaberry. Press Proceed


The KM will not respond for a number of seconds – be patient. The firmware will then load quickly and a prompt will appear as follows. You can leave the Kookaberry connected to the Mac. No other software will be impacted. If the connect data is not showing in the KookIDE LH pane, then click Connect at the top RH corner of the KookaManager.

When download is complete, follow the instructions in the prompt