Difference between revisions of "Getting started: Microduino IDE for Windows"

From Microduino Wiki
Jump to: navigation, search
(Created page with "{{Language|Microduino Getting started}} {| style="width: 800px;" |- | 360px|right|thumb Getting started: Windows Getting sta...")
 
 
(93 intermediate revisions by 4 users not shown)
Line 1: Line 1:
−
{{Language|Microduino Getting started}}
+
{| style="width: 80%;"
−
{| style="width: 800px;"
 
 
|-
 
|-
 
|
 
|
−
[[File:microduinoGettingStartHeader.jpg|360px|right|thumb]]
+
The guide below is a software setup guide for Windows aimed for general use of Microduino products.
  
 +
For kit specific getting started guides please follow the appropriate links in the [[#Kit_Specific_Software_Setup_Guides]] section:
  
−
[[Getting started: Windows]]
+
=Kit Specific Software Setup Guides=
 +
{{Clickable_headed_image_table_box_small|header=Itty Bitty City|link=Getting_Started_with_Itty_Bitty_City_(Windows)|image=File:IBC.png|image_size=140px|table_width=175px|table_height=150px}}
 +
{{Clickable_headed_image_table_box_small|header=mCookie 101 Basic|link=Getting_Started_with_101_Basic_Kit_(Windows)|image=File:mCookie_Basic_Kit.png|image_size=140px|table_width=175px|table_height=150px}}
 +
{{Clickable_headed_image_table_box_small|header=mCookie 201 Advanced|link=Getting_Started_with_201_Advanced_Kit_(Windows)|image=File:mCookie_Advanced_Kit.png|image_size=140px|table_width=175px|table_height=150px}}
 +
{{Clickable_headed_image_table_box_small|header=mCookie 301 Expert|link=Getting_Started_with_301_Expert_Kit_(Windows)|image=File:mCookie_Expert_Kit.png|image_size=140px|table_width=175px|table_height=150px}}
 +
{{Clickable_headed_image_table_box_small|header=mCookie 102 Basic|link=Getting_Started_with_102_Basic_Kit_(Windows)|image=File:mCookie_102_Basic_Kit.png|image_size=140px|table_width=175px|table_height=150px}}
 +
{{Clickable_headed_image_table_box_small|header=mCookie 202 Advanced|link=Getting_Started_with_202_Advanced_Kit_(Windows)|image=File:mCookie_202_Advanced_Kit.png|image_size=140px|table_width=175px|table_height=150px}}
 +
{{Clickable_headed_image_table_box_small|header=mCookie 302 Expert|link=Getting_Started_with_302_Expert_Kit_(Windows)|image=File:mCookie_302_Expert_Kit.png|image_size=140px|table_width=175px|table_height=150px}}
 +
{{Clickable_headed_image_table_box_clear}}
 +
<big><b>If your kit is not listed, please proceed following the general setup guide below.</b></big>
  
−
[[Getting started: Mac]]
+
=Previous Installations=
 +
{| class="wikitable" style="background-color:#FEF9E7;"
 +
|'''Note:''' If you have a previous version installed already, you must uninstall that version prior to installing a newer version.
 +
*Go to Control Panel and uninstall the '''Arduino IDE for Microduino'''.
 +
*Delete the '''C:\Program Files (x86)\Arduino IDE for Microduino''' folder as some legacy files may cause issues with a new installation.
 +
Then proceed to the next steps.
 +
|}
  
−
==Step 1: Arduino IDE下载==
+
=Download=
−
'''*Microduino完全兼容Arduino，先安装基础IDE'''
+
Download the latest Windows Microduino IDE (Version 6.0, 2020-02-27): [http://oss.microduino.cn/download/download/Arduino%20IDE%20for%20Microduino-win-1.8.4-V6.0.exe <big>HERE</big>]<br clear=all>
 +
Download the previous Windows Microduino IDE (Version 5.0, 2019-03-25): [https://microduinoinc.com/downloads/Arduino.IDE.for.Microduino-win-1.8.4-V5.0.exe <big>HERE</big>]
 +
[[File:Arduino_Download.png|link=https://microduinoinc.com/downloads/Arduino.IDE.for.Microduino-win-1.8.4-V5.0.exe|150px|left|thumb]]<br clear=all>
  
−
*先在此下载Microduino的IDE（基于Arduino1.0x版本修改）：
+
=Installation=
−
**[https://github.com/wasdpkj/Microduino-IDE-win/archive/master.zip Microduino-IDE-win]
+
1. Double click on the setup file to start the installation process. Click <b>Next</b>.
−
**[https://github.com/wasdpkj/Microduino-IDE-mac/archive/master.zip Microduino-IDE-mac]
+
[[File:WinInstallNew_01.png|500px|left|thumb]]<br clear=all>
 +
2. The next window will allow you to select which options to install. Leave all checked and click <b>Install</b>.
 +
[[File:WinInstallNew_02.png|500px|left|thumb]]<br clear=all>
 +
3. The installation process will begin for the Arduino IDE.  
 +
[[File:WinInstallNew_03.png|500px|left|thumb]]<br clear=all>
 +
4. Wait until it is complete.
 +
[[File:WinInstallNew_04.png|500px|left|thumb]]<br clear=all>
 +
5. After the Arduino IDE has been installed, a window for driver installation will appear. Click <b>Next</b>.
 +
[[File:WinInstallNew_05.png|500px|left|thumb]]<br clear=all>
 +
6. Click on "<b>I accept this agreement</b>" and click <b>Next</b> to start the drivers installation.
 +
[[File:WinInstallNew_06.png|500px|left|thumb]]<br clear=all>
 +
7. After the drivers are installed, click <b>Finish</b>.
 +
[[File:WinInstallNew_07.png|500px|left|thumb]]<br clear=all>
 +
8.Installation is now complete! Click on <b>Finish</b>.
 +
[[File:WinInstallNew_08.png|500px|left|thumb]]<br clear=all>
 +
9.If you left the run option checked, the software will start to launch. Otherwise locate the program shortcut on your desktop or start menu and launch it.
 +
[[File:WinInstallNew_09.png|500px|left|thumb]]<br clear=all>
 +
10. The software is now ready to be used!
 +
[[File:WinInstallNew_10.png|500px|left|thumb]]<br clear=all>
  
 +
=Confirm Drivers Installed Successfully=
 +
Confirm that the drivers are installed successfully based on your hardware.
  
−
*我们已经将'''Microduino兼容'''的'''硬件支持包'''和'''程序库'''集成在了IDE中，下一步将验证他们的有效性
+
Refer to the table below for which programmer each kit uses:
−
 
+
{| class="wikitable"
−
==Step 2: 验证IDE==
+
|-
−
 
+
! Programmer
−
{| style="width: 800px;"
+
! Contained in Kit
 +
! Programmable Boards
 
|-
 
|-
−
|  
+
| USBTTL
−
'''*验证硬件支持包'''
+
| 102 Basic Kit
−
 
+
| Core, Core+, CoreRF
−
 
+
|-
−
*为适配Microduino的多种核心，IDE已集成了Microduino硬件支持包；
+
| mBattery
−
**该支持包让Arduino IDE在板卡内显示Microduino硬件
+
| Itty Bitty City, 202 Advanced Kit, 302 Expert Kit
−
**并和Arduino官方硬件一样能在线下载及重新烧写bootloader
+
| Core, Core+, CoreRF
−
 
 
−
 
 
−
*启动Arduino IDE,单击"Tools"菜单
 
−
*您将会在"Board"菜单下看到Microduino系列.
 
−
||  
 
−
[[File:microduinoGettingStart1.jpg|289px|right|thumb]]
 
−
|}
 
−
 
 
−
 
 
−
{| style="width: 800px;"
 
 
|-
 
|-
−
|  
+
| (CoreUSB)*
−
'''*验证程序库'''
+
| X01 Series Kits: 101 Basic Kit; 201 Advanced Kit; 301 Expert Kit
−
 
+
| CoreUSB
−
 
 
−
*Microduino针对数十种不同的功能模块，整理出了兼容的程序库支持包；
 
−
**这里面包含Arduino官方原版的部分支持包
 
−
**我们只是对其文件夹改名，便于整理分类
 
−
 
 
−
 
 
−
*启动Arduino IDE,单击"File"菜单
 
−
*您将会在"Examples"菜单下找到程序示例.
 
−
*'''注意：1.6.3版本的IDE要先在"Board"菜单下选择好板卡才能找到示例程序'''
 
−
||  
 
−
[[File:microduinoGettingStart2.jpg|289px|right|thumb]]
 
 
|}
 
|}
 +
*NOTE: CoreUSB is a core module with an integrated programmer.
  
−
==Step 3: 驱动程序==
+
==USBTTL==
 +
*Connect [[Microduino-USBTTL]] to your computer. Verify that there are available Port options under Tools.
 +
[[File:microduinoGettingStart-USBTTL.jpg|500px|center|thumb]]
 +
==CoreUSB==
 +
*Connect [[Microduino-CoreUSB]] or [[mCookie-CoreUSB]] to your computer. Verify that there are available Port options under Tools.
 +
[[File:microduinoGettingStart-CoreUSB.jpg|500px|center|thumb]]
 +
==mBattery==
 +
*Connect [[mCookie-Battery]] to your computer.
 +
[[File:MBattery-t.jpg|400px|center|thumb]]
 +
<blockquote>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. mBattery must be "ON" in order to program the modules.</blockquote>
 +
*Verify that there are available Port options under Tools.
 +
[[File:microduinoGettingStart-USBTTL.jpg|500px|center|thumb]]
  
−
'''*开发环境配置好之后，开始安装驱动程序'''
+
=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.
−
*先在此下载对应系统的驱动：
 
−
**[https://github.com/wasdpkj/Microduino-Drivers/archive/master.zip Microduino-Drivers]
 
−
**[http://www.ftdichip.com/Drivers/VCP.htm FTDI]
 
  
−
'''*安装驱动'''
+
Example usage would be for the Core module in Itty Bitty City. Board is '''Microduino/mCookie-Core (328p)''' and Processor is '''Atmega328P@16M,5V'''.
 +
{| class="wikitable"
 +
|-
 +
! Name
 +
! Board
 +
! Processor
 +
! Contained in Kit
 +
|-
 +
| rowspan="2" | Core (168pa)
 +
| rowspan="2" | Microduino/mCookie-Core (168pa)
 +
| Atmega168pa@8M,3.3V
 +
|-
 +
| Atmega168pa@16M,5V
 +
|-
 +
| rowspan="2" | Core (328p)
 +
| rowspan="2" | Microduino/mCookie-Core (328p)
 +
| Atmega328P@8M,3.3V
  
−
 
−
{| style="width: 800px;"
 
 
|-
 
|-
−
|  
+
| Atmega328P@16M,5V
−
'''*Windows'''
+
| [[Itty_Bitty_City|Itty Bitty City Kit]], '''X02 Series Kits''': [[MCookie_Basic_Kit|102 Basic Kit]]; [[MCookie_Advanced_Kit|202 Advanced Kit]]; [[MCookie_Expert_Kit|302 Expert Kit]]
−
*自动安装
+
|-
−
**解压获得"\Windows\Automatic"文件夹内容
+
| rowspan="2" | Core+ (644pa)
−
**运行其中"CDM X.X WHQL Certified.exe"
+
| rowspan="2" | Microduino/mCookie-Core+ (644pa)
−
***（win7运行需管理员权限，如右图）
+
| Atmega644pa@16M,3.3V
−
**按提示完成安装即可​
+
|-
−
*手动安装
+
| Atmega644pa@16M,5V
−
**如果你不怕麻烦，也可以选择手动安装：
+
| [[MCookie_Expert_Kit|302 Expert Kit]]
−
***'''[[windows手动安装Microduino驱动程序]]'''
+
|-
−
||  
+
| rowspan="2" | Core+ (1284pa)
−
[[File:microduinoGettingStart3.jpg|289px|right|thumb]]
+
| rowspan="2" | Microduino/mCookie-Core+ (1284pa)
−
|}
+
| Atmega1284pa@8M,3.3V
−
 
+
|-
−
 
+
| Atmega1284pa@16M,5V
−
{| style="width: 800px;"
 
 
|-
 
|-
−
|  
+
| CoreUSB
−
'''*Mac OS'''
+
| Microduino/mCookie-Core USB (32u4)
−
*解压获得"\Mac.os"文件夹内容
+
| USB
−
*运行其中"FTDIUSBSerialDriver_X_X"
+
| '''X01 Series Kits''': [[MCookie_Basic_Kit|101 Basic Kit]]; [[MCookie_Advanced_Kit|201 Advanced Kit]]; [[MCookie_Expert_Kit|301 Expert Kit]]
−
*按提示完成安装即可
 
−
||  
 
−
[[File:microduinoGettingStart4.jpg|289px|right|thumb]]
 
−
|}
 
−
 
 
−
 
 
−
    '''注意：'''
 
−
    '''windows8若出现文件损坏或缺少签名等提示，无法正常安装驱动时，则需要禁用系统数字签名安装。'''
 
−
    '
 
−
    1.Turn off the check.
 
−
    2.Hold the shift key while clicking on Restart
 
−
    3.Select Troubleshoot > Advanced Options > Startup Settings > Restart
 
−
    4.After Restart select option 7.
 
−
    '
 
−
    by: [[http://answers.microsoft.com/en-us/windows/forum/windows_8-hardware/how-to-install-a-driver-that-does-not-contain/7c3f299b-3483-4c96-8c44-87c7451af222 microsoft answers]]
 
−
 
 
−
==Step 4: 连接硬件==
 
−
 
 
−
 
 
−
*用Micro-USB 线连接Microduino-USBTTL到您的PC/Mac上;
 
−
 
 
−
 
 
−
{| style="width: 800px;"
 
 
|-
 
|-
−
|  
+
| CoreRF
−
'''*Windows'''
+
| Microduino/mCookie RF (128rfa1)
−
*打开IDE，在菜单"Tools"里的"Serial Port"
 
−
*你将看到"COMXX"
 
−
||
 
−
[[File:microduinoGettingStart5.jpg|289px|right|thumb]]
 
 
|}
 
|}
  
 +
==Determining Processor Variant==
 +
===Core===
 +
<center>
 +
[[File:microduinoGettingStart-Core3V3.jpg|250px]]
 +
[[File:microduinoGettingStart-Core+3V3.jpg|250px]]
 +
</center>
 +
===Core+===
 +
<center>
 +
[[File:microduinoGettingStart-Core5V.jpg|250px]]
 +
[[File:microduinoGettingStart-Core+5V.jpg|250px]]
 +
</center>
  
−
{| style="width: 800px;"
+
=Arduino IDE Basics=
−
|-
+
===Interface===
−
|
+
[[File:Interface.png|400px|center|thumb]]
−
'''*Mac OS'''
+
*'''[Verify]''': Checks for errors in the code.
−
*打开IDE，在菜单"Tools"里的"Serial Port"
 
−
*你将看到"dev/tty.usbserial-XX"
 
−
||
 
−
[[File:microduinoGettingStart6.jpg|289px|right|thumb]]
 
−
|}
 
  
 +
*'''[Upload]''': Uploads the program to a MCU.
  
 +
*'''[Serial Monitor]''': Useful in debugging programs.
  
 +
===Tools===
 +
[[File:Tools.JPG|400px|center|thumb]]
 +
*'''[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===
 +
#Select board type and processor.
 +
#Select the port.
 +
#Click upload.
  
−
*'''[[安装Arduino IDE Microduino硬件支持包]]'''
 
−
*'''[[安装Arduino IDE Microduino程序库支持包]]'''
 
  
−
|}
+
*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.
 +
[[File:MBattery-t.jpg|300px]]

Latest revision as of 23:59, 27 February 2020

The guide below is a software setup guide for Windows aimed for general use of Microduino products.

For kit specific getting started guides please follow the appropriate links in the #Kit_Specific_Software_Setup_Guides section:

Kit Specific Software Setup Guides

If your kit is not listed, please proceed following the general setup guide below.

Previous Installations

Note: If you have a previous version installed already, you must uninstall that version prior to installing a newer version.
  • Go to Control Panel and uninstall the Arduino IDE for Microduino.
  • Delete the C:\Program Files (x86)\Arduino IDE for Microduino folder as some legacy files may cause issues with a new installation.

Then proceed to the next steps.

Download

Download the latest Windows Microduino IDE (Version 6.0, 2020-02-27): HERE
Download the previous Windows Microduino IDE (Version 5.0, 2019-03-25): HERE

Arduino Download.png

Installation

1. Double click on the setup file to start the installation process. Click Next.

WinInstallNew 01.png

2. The next window will allow you to select which options to install. Leave all checked and click Install.

WinInstallNew 02.png

3. The installation process will begin for the Arduino IDE.

WinInstallNew 03.png

4. Wait until it is complete.

WinInstallNew 04.png

5. After the Arduino IDE has been installed, a window for driver installation will appear. Click Next.

WinInstallNew 05.png

6. Click on "I accept this agreement" and click Next to start the drivers installation.

WinInstallNew 06.png

7. After the drivers are installed, click Finish.

WinInstallNew 07.png

8.Installation is now complete! Click on Finish.

WinInstallNew 08.png

9.If you left the run option checked, the software will start to launch. Otherwise locate the program shortcut on your desktop or start menu and launch it.

WinInstallNew 09.png

10. The software is now ready to be used!

WinInstallNew 10.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.jpg

CoreUSB

MicroduinoGettingStart-CoreUSB.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. mBattery must be "ON" in order to program the modules.
  • Verify that there are available Port options under Tools.
MicroduinoGettingStart-USBTTL.jpg

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

Interface.png
  • [Verify]: Checks for errors in the code.
  • [Upload]: Uploads the program to a MCU.
  • [Serial Monitor]: Useful in debugging programs.

Tools

Tools.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

Retrieved from "https://wiki.microduinoinc.com/index.php?title=Getting_started:_Microduino_IDE_for_Windows&oldid=23632"