Getting started: Microduino IDE for Mac

From Microduino Wiki
Revision as of 21:25, 27 March 2017 by Sonny (talk) (mBattery)
Jump to: navigation, search
Language: English  • 中文

Download

Installation

  • Change your settings to allow identified developers by going to: (Apple Logo) >>> System Preferences...
  • Then go to Security & Privacy.

MacTutorial Settings 2.png

  • Click on then Lock icon and enter your credentials to be able to change settings.
  • Under Allow apps download from: select App Store and identified developers
  • Click the Lock icon again to lock and save changes.

MacTutorial Settings 3.png

  • Open the downloaded file. A folder will open containing the Microduino IDE and drivers for the hardware.

MacTutorial 1 OpenDmg.png

  • Open the Drivers folder. Drivers are needed to communicate with the Microduino hardware.

MacTutorial 2 DmgContents.png

  • Install ONE of the driver packages:
    • Driver_OS10.3.mpkg if you have Mac OS 10.3 or below.
    • Driver_OS10.4-10.8.mpkg if you have Mac OS 10.4 to Mac OS 10.8.
    • Driver_OS10.9-Newer.mpkg if you have Mac OS 10.9 or newer.
  • Follow the on-screen instructions to install the driver.

MacTutorial 3 InstallDriver1.png

  • Once completed. Open the USBTTL-C Install folder. This is another driver that needs to be installed.
  • (Note: The Mac OS X 10.6 or older package does not contain this. Therefore, you can skip this step.)

MacTutorial 4 DriverFolder.png

  • Open CH34x_Install.pkg. Follow the on-screen instructions to install the driver.

MacTutorial 5 InstallDriver2.png

  • Drag the Arduino for Microduino.app application to your Applications folder to install the IDE.



MacTutorial 6 DragApp.png]

  • The software is now installed and ready to use. Double-click the application to launch it!

MacTutorial 7 InstalledApp.png MacTutorial 8 LaunchApp.png

Microduino / mCookie Setup

MCookie GettingStart 1 EN.png
  • Your Mac is trying to recognize the new device. Briefly press the key to the right of your shift key.
MCookie GettingStart 2 EN.png
  • A popup will appear saying that your keyboard cannot be recognized. Click "Skip".
MCookie GettingStart 3 EN.png
  • Select the keyboard layout for your region (ANSI for most users). Click done.
MCookie GettingStart 4 EN.png

Confirm Drivers Installed Successfully

USBTTL

  • Connect Microduino-USBTTL to your computer. Verify that there are available Port options under Tools.
MicroduinoGettingStart-USBTTL mac1.jpg

CoreUSB

MicroduinoGettingStart-CoreUSB mac1.jpg

mBattery

MBattery-t.jpg
IMPORTANT: Ensure that mBattery is "ON" by pressing and holding the button. A red LED should be on, which indicates that power is being supplied to the modules.
  • Verify that there are available Port options under Tools.
MacTutorial CH340 Port.png

Selecting Board Type and Processor

Selecting the Board Type and Processor is required to compile the correct code for the core module.

Configuring the software is done under Tools > Board and Tools > Processor.

Below is the table which lists all the core modules with corresponding Board and Processor. The table also lists kits that contain specific core modules.

Example usage would be for the Core module in Itty Bitty City. Board is Microduino/mCookie-Core (328p) and Processor is Atmega328P@16M,5V.

Name Board Processor Contained in Kit
Core (168pa) Microduino/mCookie-Core (168pa) Atmega168pa@8M,3.3V
Atmega168pa@16M,5V
Core (328p) Microduino/mCookie-Core (328p) Atmega328P@8M,3.3V
Atmega328P@16M,5V Itty Bitty City Kit, X02 Series Kits: 102 Basic Kit; 202 Advanced Kit; 302 Expert Kit
Core+ (644pa) Microduino/mCookie-Core+ (644pa) Atmega644pa@16M,3.3V
Atmega644pa@16M,5V 302 Expert Kit
Core+ (1284pa) Microduino/mCookie-Core+ (1284pa) Atmega1284pa@8M,3.3V
Atmega1284pa@16M,5V
CoreUSB Microduino/mCookie-Core USB (32u4) USB X01 Series Kits: 101 Basic Kit; 201 Advanced Kit; 301 Expert Kit
CoreRF Microduino/mCookie RF (128rfa1)

Determining Processor Variant

Core

MicroduinoGettingStart-Core3V3.jpg MicroduinoGettingStart-Core+3V3.jpg

Core+

MicroduinoGettingStart-Core5V.jpg MicroduinoGettingStart-Core+5V.jpg

Arduino IDE Basics

Interface

MicroduinoGettingStart-IDE1.jpg
  • [Verify]: Checks for errors in the code.
  • [Upload]: Uploads the program to a MCU.
  • [Serial Monitor]: Useful in debugging programs.

Tools

MicroduinoGettingStart-Tools1.jpg
  • [Board]: Select the corresponding core module to which the program is being uploaded.
  • [Processor]: Select the corresponding processor.
  • [Port]: Select the common USB port.

The Board Types

When using Microduino-Core, select the proper processor for your board:


MicroduinoGettingStart-Core3V3.jpg


MicroduinoGettingStart-Core+3V3.jpg



When using Microduino-Core+, select the proper processor for your board:


MicroduinoGettingStart-Core5V.jpg


MicroduinoGettingStart-Core+5V.jpg



When using Microduino-CoreUSB or mCookie-CoreUSB, select Microduino-CoreUSB:


Microduino-core32U4-rect.jpg


MCookie-CoreUSB-F.JPG



Uploading Code

  1. Select board type and processor.
  2. Select the port.
  3. Click upload.