Welcome to the KookaBlockly Reference Guide!

KookaBlockly is a powerful standalone visual editor designed for creating program scripts for Kookaberry and related microprocessors. This editor operates on a drag-and-drop interface, making it beginner-friendly and highly intuitive.

This document describes how to use to the KookaBlockly visual scripting tool.

KookaBlockly is part of the KookaSuite script editing toolset which was commissioned by the AustSTEM Foundation and created by Damien George for the Kookaberry.

This guide is for KookaBlockly v1.10.0.

The document is in TWO parts:

1. Working with KookaBlockly - relates to KookaBlockly set-up, basic screen displays and usage.

2. A Reference Document for the visual functional blocks in KookaBlockly.

Contents

• Part 1 - Working With KookaBlockly
  • Introduction to KookaBlockly
    • KookaBlockly: Visual Programming Editor for Kookaberry Microprocessor Boards
    • Key Features
    • Programming With KookaBlockly
    • AustSTEM Learning Hub
  • Installing KookaBlockly
    • Downloading KookaSuite
    • Installing KookaSuite on Microsoft Windows
    • Installing KookaSuite on MacOS
    • Installing KookaSuite on Raspberry Pi
    • Script Folders
    • KookaBlockly Updates
    • Editing KookaBlockly Scripts Using KookaIDE
  • Using the KookaBlockly Application
    • Version
    • Resize / Exit
    • Workspace
    • Blocks Palette
    • Script Controls
    • Inspection Buttons
    • Connection
    • Script Selection
    • Scroll Bars, Centre, Zoom and Trash
  • KookaBlockly Conventions
    • Block Shapes
    • Block Configuration
    • Right-clicking
    • Text Delimiters
    • Deleting Blocks
• Part 2 - KookaBlockly Function Blocks Reference
  • Control
    • On Start
    • Scheduled Loop
    • Every Loop
    • Exit Program
    • Sleep
    • Time (s)
    • Time (ms)
  • Clock
    • Internal Clock
      • Get Clock – Simple Time
      • Get Clock - Extended Time
      • Set Clock from Character String
    • External Clock
      • External Clock’s Pins Connections
      • Get External Clock - Simple Time
      • Get External Clock – Extended Time
    • Set Internal Clock from External Clock
    • Set External Clock from Internal Clock
    • Set External Clock from Character String
  • Display
    • Kookaberry Display
    • Text coordinates
    • Display Clear
    • Display Show
    • Display Set Font
    • Display Print
    • Display Print-and
    • Display Pixel
    • Display Line
    • Display Rectangle
    • Display Text
    • Display Image
  • Buttons
    • When Button Was Pressed
    • When Button Is Pressed
    • Button was pressed
    • Button is pressed
    • Button to Exit Program
  • LEDs
    • Turn ON LED
    • Turn OFF LED
    • Toggle LED
    • Set NeoPixel
  • Pins
    • Pin Turn ON
    • Pin Turn OFF
    • Pin Toggle
    • Set Pin to Digital Value
    • Get Pin Digital Value
    • Get Pin Voltage
    • Get Pin Voltage as Percentage of Maximum
    • Set Pin to Voltage
    • Set Pin to Percentage of Maximum
    • Pin – Pulse Width Modulation (PWM)
  • Sensors
    • Internal Sensors
      • Get Accelerometer (raw)
      • Get Accelerometer (scaled)
      • Get Compass
    • External Sensors
      • Sensors’ Pins Connections
      • Get Temperature from DS18x20
      • Get Temperature from NTC
      • Get Temperature or Humidity from DHT11 or DHT22
      • Get Temperature / Humidity / Pressure from BME280
        • About The BME280 Sensor
      • Get Acceleration / Compass Strength from LSM303
        • About the LSM303 Sensor
      • Get LUX from VEML7700
        • About the VEML7700 Sensor
      • Get Power / Voltage / Current from INA219
        • About the INA219 Sensor
      • Get Soil Moisture
        • About Soil Moisture Sensors
    • More Sensor Learning Resources
  • Actuators
    • Actuators’ Pins Connections
    • Set Servo to Angle
    • Set Servo to Angle Taking Seconds
    • Set Servo to Speed
    • Set Servo to Speed Taking Seconds
    • More Actuator Learning Resources
  • Radio
    • Internal Radio
      • When Radio Receive
      • Radio Read
      • Radio Send
      • Set Radio channel
      • Set Radio Parameter
    • External Radio
      • When HC-12 Receive
      • HC-12 Read
      • HC-12 Send
      • HC-12 Send and
      • HC-12 Set Channel
  • Logging
    • Clear File
    • Log To File
  • Boolean
    • Comparison
    • Boolean And / Or
    • Not
    • True / False
    • Null
    • Test If
  • If–Else
    • If-Do
    • If-Do-Else-Do
    • If-Do-Else If-Do-Else-Do
    • If-Do Configuration
  • Loops
    • Loop Repeat
    • Loop Repeat While / Until
    • Count With Variable From-To-By
      • Count With Variable Example
    • For Each Item In List
    • Break / Continue Loop
  • Strings
    • Text
    • Format as Integer
    • Format as Floating Point
    • Convert to Integer
    • Convert to Float
  • Lists
    • Create List
      • Create List Example
    • Create List With Item Repeated No. of Times
    • Length Of List
    • Is Empty
    • In List Find First / Last Occurrence of Item
      • In List Find Example
    • In List Get / Remove Item
      • In List Get / Remove Examples
    • In List Set / Insert Item
      • In List Set / Insert Example
    • In List Get Sub-List
      • Get Sub-List Example
    • Make List / Text With Delimiter
      • Make List / Text Examples
    • Sort List
      • Sort List Example
  • Math
    • Number
      • Number Example
    • Arithmetic
      • Arithmetic Example
    • Multiply and Add
    • Scale Function
      • Scale Example
    • Math Function
    • Trigonometric Function
    • Special Constants
    • Number Property Test
    • Round Number
    • List Operations
      • List Operations Example
    • Remainder
    • Constrain
    • Random Integer
    • Random Fraction
    • Atan2 of X
  • Variables
    • Create Variable
    • Set Variable
    • Change Variable
    • Variable Value
  • Functions
    • Define Function
      • Define Inputs
      • Function Name
      • Function Description
    • Define Function with Return Value
    • If Condition Return
  • Advanced
    • Python Value
    • Python Action
    • Advanced Example
• Glossary of Terms

Example Scripts:

All the scripts used in this guide are available for downloading from Github and following the instructions on the README page:

Errata:

If errors or issues are found in the KookaBlockly Reference Guide please post an issue on GitHub.

Copyright:

Blockly is a library from Google for building beginner-friendly block-based programming languages.

Kookaberry and Kooka are trademarks of Kookaberry Pty Ltd, Australia.

The Kooka Firmware release v1.10.0 and KookaSuite were created by Damien George (George Electronics Pty Ltd – MicroPython) in collaboration with Kookaberry Pty Ltd and the AustSTEM Foundation Ltd.