BlocklyDuino-v2 (Custom Version)

This is a fork of the original BlocklyDuino-v2.

Modifications

I have modified this repository to be compatible with the Citera Board and added several features including a bitmap editor and typed variables.

Main UI Changes (index.html)

• Lines 16-47: Added mandatory style definitions for the bitmap editor.
• Line 332: Added <option value="citera_board">citera_board</option> to the boardMenu.
• Line 543: Added <option value="citera_board">citera_board</option> to the boardDescriptionSelector.
• Lines 609-610: Removed unused toolbox definitions.
• Line 614: Inserted citeraboard as the active toolbox.
• Lines 624-706: Inserted scripts required for the bitmap field.

Configuration & Defaults

• tools/blockFactory/codeFactory.js
• @blockly/demos/code/code.js
  • Changed the default initial language to Japanese (ja).

New Board Support: Citera Board

• blocklyduino/arduino/board/citera.js
• blocklyduino/blocks/board/citera.js
  • Added citera.js, created based on board_base.js.
  • Added and adjusted blocks specifically for the Citera board.
• blocklyduino/js/boards.json
• js/buttons_functions.js
  • Registered citera_board (a custom board based on CH32V203).
• blocklyduino/media/boards/citera_board.jpg
  • Added an image for the custom board.
• blocklyduino/msg/blocks_ja.js
  • Added Japanese translations for Citera board blocks.

Toolbox & New Features

• blocklyduino/toolbox/toolbox_citera.json
  • Added a new toolbox definition for the Citera board.
• js/toolbox.js
  • Added toolbox_citera. This is used as an alternative to toolbox_arduino and contains custom blocks for the Citera Board in addition to standard blocks.
• js/field-bitmap/
  • Added the field-bitmap directory and field-bitmap.js to support bitmap editing features.
• blocklyduino/arduino/typed_variable.js
• blocklyduino/blocks/typed_variable.js
• js/typed_variable.js
  • Added vars_setup for int and float variable blocks.

Welcome to BlocklyDuino2

BlocklyDuino is a web-based program for editing and visual block programming editor for Arduino electronic boards.

BlocklyDuino is based on Blockly, the web-based graphical programming editor.

This new v2 version is also based on the work done on STudio4Education, a similar project for STmicroelectronics boards, and inspired by all fork of BlocklyDuino's original Gasolin's work.

It provides static type language blocks and code generators for simple Arduino programming.

BlocklyDuino also supports some Grove blocks to easily get started with microcontroller-based experimentation and learning.

BlocklyDuino's Demo

BlocklyDuino2 is a simple webware, you can give it a try here.

You can download it here and launch index.html.

Features

• Programming Arduino with visually drag and drop code blocks
• Generate fully compatible Arduino source code
• Multiple Arduino boards choice for automatic selection of pin functions
• Interact Arduino board with dozen of sensor blocks
• Load different on-site examples with url parameters
• Keyboard navigation and accessibility helpers
• Theme choice
• Block render choice
• Multi language
• Keyboard navigation

Accessibility

You can enter accessibility mode by hitting Shift + Ctrl + k.

Official documentation: https://developers.google.com/blockly/guides/configure/web/keyboard-nav

Key mapping is customizable by activating 'open key mappings' option.

Some basic commands for moving around are below.

Workspace Navigation

• W: Previous block/field/input at the same level.
• A: Up one level (Field (or input) -> Block -> Input (or field) -> Block -> Stack -> Workspace).
• S: Next block/field/input at the same level.
• D: Down one level (Workspace -> Stack -> Block -> Input (or field) -> Block -> Field (or input)).
• T: Will open the toolbox. Once in there you can moving around using the WASD keys. And insert a block by hitting Enter.
• X: While on a connection hit X to disconnect the block after the cursor.

Cursor

The cursor controls how the user navigates the blocks, inputs, fields and connections on a workspace. Two different cursors:

• Default Cursor: Allow the user to go to the previous, next, in or out location.
• Basic Cursor: Using the pre order traversal allows the user to go to the next and previous location.

Run locally on your web browser

If you want to install it locally, get code from github and open index.html in your browser.

The prefered way is to put the BlocklyDuino/web folder into a web server and open the url like localhost/index.html for use.

Usage

1. Open BlocklyDuino and select your Arduino board, your language, your favorite theme + renderer.
2. Drag and drop blocks to make an Arduino program.
3. Copy all of the source code into an existing or new project in the Arduino IDE.
4. Configure your Arduino IDE with the rght board and communication port.
5. Press the 'Upload' button in the Arduino IDE to burn the code into a connected Arduino board.

Integrated Arduino upload

You can try an Electron version with arduino-cli embbeded for an off-line version: https://github.com/BlocklyDuino/BlocklyDuino2Electron

ChangeLog

Check changelog here

Tools used

Ace editor

Authors and Contributors

Sébastien CANET (scanet@libreduc.cc) for this reboot and Electron version.

Fred Lin (@gasolin) for original BlocklyDuino.

Thanks Neil Fraser, Q.Neutron from Blockly https://developers.google.com/blockly/

Thanks Arduino and Seeeduino guys for Arduino and Grove blocks.

The BlocklyDuino project is also inspired by ardublock and modkit

This BlocklyDuino2 project is also inspired by Blockly@rduino, ardublockly, Blocklino and STudio4Education.

License

Copyright (C) 2020 Sébastien CANET scanet@libreduc.cc & Fred Lin gasolin@gmail.com

• Licensed under the GNU General Public License v3.0 (the "License").
• You may not use this project or any file except in compliance with the License.
• You may obtain a copy of the License at https://www.gnu.org/licenses/#GPL.

Code from Blockly is licensed under the Apache 2.0 license. Code from STudio4Education is licensed under the BSD 3-Clause license.

Blockly

Google's Blockly is a web-based, visual programming editor. Users can drag blocks together to build programs. All code is free and open source.

The project page is https://developers.google.com/blockly/

Blockly has an active developer forum. Please drop by and say hello. Show us your prototypes early; collectively we have a lot of experience and can offer hints which will save you time.

Help us focus our development efforts by telling us what you are doing with Blockly. The questionnaire only takes a few minutes and will help us better support the Blockly community.

Want to contribute? Great! First, read our guidelines for contributors.

Links and thanks

Tools without which nothing would have been possible (and millions of thanks to their creators!) :

• Blockly
• BlocklyDuino
• Blockly@rduino
• Blocklino
• STudio4Education
• Font Awesome