Getting started: Microduino IDE for Mac

From Microduino Wiki
Revision as of 15:33, 11 August 2017 by Sonny (talk | contribs) (Microduino / mCookie Setup)
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

This section is for Microduino CoreUSB or mCookie CoreUSB ONLY. Otherwise, skip to the next section. Expand to view contents.

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

Confirm that the drivers are installed successfully based on your hardware.

Refer to the table below for which programmer each kit uses:

Programmer Contained in Kit Programmable Boards
USBTTL 102 Basic Kit Core, Core+, CoreRF
mBattery Itty Bitty City, 202 Advanced Kit, 302 Expert Kit Core, Core+, CoreRF
(CoreUSB)* X01 Series Kits: 101 Basic Kit; 201 Advanced Kit; 301 Expert Kit CoreUSB
  • NOTE: CoreUSB is a core module with an integrated programmer.

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.

Uploading Code

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


  • Note: If using mBattery to upload to a core module. Ensure that mBattery is "ON" and supplying power to the modules. There will be a red LED on.

MBattery-t.jpg