Skip to content

Latest commit

 

History

History
140 lines (82 loc) · 6.89 KB

README.md

File metadata and controls

140 lines (82 loc) · 6.89 KB
Raw

enter image description here 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 ([email protected]) 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 [email protected] & Fred Lin [email protected]

  • 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 Build Status

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!) :