Revision as of 20:03, 24 July 2018

mDesigner in Arduino mode.

The primary methods of using Microduino modules with mDesigner is with Live and Arduino mode. Each mode as it own pros and cons. Determining the right mode is up to the user per use case. Although, it is recommended to start with "Live" mode for testing then switching to "Arduino" mode later.

Live mode is regular Scratch, but with added blocks which are designed to interact with Microduino modules. This means the user has access to the stage and actor blocks. Projects (hardware) need to be connected to the computer running mDesigner. mDesigner communicates with the project (hardware), namely the Core module, in "real time" over the USB connection by sending commands for the Core module to perform. This means that "Live" mode requires a constant connection with the computer running mDesigner.

Arduino mode acts as a "visual" drag and drop coding editor. The script (code) is converted to "Arduino" code and then compile and uploaded to the attached Core module. This means that code can run even when detached from the computer. The stage and actor are disabled in this mode since the code runs independent of mDesigner.

Overview

Arduino is a special mode which can be enabled in mDesigner. It acts as a drag and drop editor for programming. The Stage and Actor is disabled and many Block Categories cannot be used.
The main advantage of using Arduino Mode is that code is gennerated, compile, and uploaded. This means that the user can disconnect the project (hardware) from a computer and it can still work.

Programming Overview

The programming of a script (program) is outlined below.

Computer: Computer running mDesigner (in Arduino mode) compiles the script(program) and sends the compiled code to mBattery/mCenter+.	mBattery/mCenter+: mBattery/mCenter+ contains a programmer which programs the Core/Core+ module with the compiled code.	Core/Core+: The compiled code is programmed/flashed onto the Core/Core+ module. The compiled code can run independent of mDesigner. The project (hardware) can be disconnected from the computer.

		Core/Core+: Compiled script (program) is programmed directly onto the Core/Core+ module and can run independently of a computer and mDesigner.

Preparation

Hardware Preparation

• Ensure drivers are properly installed by following the mDesigner getting started guides.
• Connect to the computer with a USB cable with either a:
  • mBattery with a stacked Core / Core+ module.
  • mCenter+
• Ensure that mBattery / mCenter+ is powered on.

Software Preparation

In order to use Arduino mode it must be switched to in mDesigner.

1. With mDesigner open. Click on the Arduino icon.
   :
   
   
2. mDesigner will now switch to Arduino mode.
   :
   
   
3. Select the COM port that mBattery/mCenter+ is connected to.
   :
   
   
4. Ready or Connected should display.
   :
   

Usage

To compile your script (program) and upload it to your Core/Core+ module. Follow the steps below.

1. Once your script (code) is assembled and ready. Click on the "Flash firmware" button on the top right of the mDesigner window.
   :
   
   
2. mDesigner will compile and start uploading the compiled script.
   :
   
   
3. If there is no errors, then the uploading will complete and a "Done" message will appear.
   :
   
   

Uploading Errors

Limitations

=Incompatible Blocks

Due to the nature of how Arduino mode works. The Actor and Stage features are not accessible in Arduino mode.
Therefore, blocks related to the actor and stage cannot be used in Arduino mode. Other additional blocks may not be usable in Arduino mode. Some block categories will be missing or contain different blocks.