{"id":7180,"date":"2018-01-15T17:11:28","date_gmt":"2018-01-15T17:11:28","guid":{"rendered":"https:\/\/blog.jetbrains.com\/pycharm\/?p=5326"},"modified":"2024-01-17T15:40:56","modified_gmt":"2024-01-17T14:40:56","slug":"micropython-plugin-for-pycharm","status":"publish","type":"pycharm","link":"https:\/\/blog.jetbrains.com\/pt-br\/pycharm\/2018\/01\/micropython-plugin-for-pycharm","title":{"rendered":"Announcing the MicroPython Plugin for PyCharm"},"content":{"rendered":"

Today we\u2019ve released the <\/span>MicroPython plugin<\/span><\/a> 1.0 for PyCharm. This plugin lets you edit your MicroPython code and interact with your MicroPython-powered microcontrollers using PyCharm. It supports ESP8266, Pyboard, and BBC Micro:bit devices. The plugin is being developed as a <\/span>team project<\/span><\/a> by the PyCharm Community lead Andrey Vlasovskikh. The source code for the project can be found on <\/span>GitHub<\/span><\/a>.<\/span><\/p>\n

MicroPython is a relatively new member of the Python interpreters family. It\u2019s basically a Python 3.5 implementation designed for microcontrollers \u2014 small computing devices that are used everywhere from smart watches to cars. People usually program microcontrollers in C or an assembly language due to low performance and memory limits. Thanks to clever optimization techniques implemented in MicroPython you can now use (almost) standard Python for microcontrollers. For example, you can create your own Internet of Things device and program it in MicroPython.<\/span><\/p>\n

The MicroPython plugin is compatible with both PyCharm Community and Professional editions. We’re going to make it available for IntelliJ IDEA soon as well. Let me walk you through the setup process and the features of the plugin using PyCharm:<\/span><\/p>\n

We\u2019ll be using an ESP8266-based device called <\/span>WEMOS D1 mini<\/span><\/a>. Basically, it\u2019s a Wi-Fi chip with a couple of digital and analog I\/O pins to connect external sensors and actuators. But for our simple demo, we won\u2019t need anything besides the LED light that is already located on the device and is connected to the digital output pin 2.<\/span><\/p>\n

This is our demo program which toggles the LED every second:<\/span><\/p>\n

import utime\r\nfrom machine import Pin\r\n\r\n\r\ndef main():\r\n    led = Pin(2, Pin.OUT)\r\n    enabled = False\r\n    while True:\r\n        if enabled:\r\n            led.off()\r\n        else:\r\n            led.on()\r\n        utime.sleep_ms(1000)\r\n        enabled = not enabled\r\n\r\n\r\nif __name__ == '__main__':\r\n    main()\r\n<\/pre>\n
Let\u2019s get started setting up our device!<\/span><\/p>\n
First of all, make sure your OS can see your device via USB. This step is device-dependent. For WEMOS D1 mini on Windows and macOS you\u2019ll need a serial port driver <\/span>provided by the device vendor<\/span><\/a>.<\/span><\/p>\n
Next, we\u2019ll setup PyCharm to work with your device. First, you need to install the MicroPython plugin in PyCharm <\/span>\u201cFile | Settings | Plugins\u201d<\/span><\/i>. Then you need to create a new Python project in <\/span>\u201cFile | New Project\u2026\u201d<\/span><\/i>. In PyCharm 2017.3 the new project dialog with the correct settings will look like this:<\/span><\/p>\n
\"image6\"<\/p>\n
Make sure you\u2019ve configured a Python 3.5 or a newer interpreter for it (preferably a virtual environment), since the MicroPython plugin will later ask you to install a few Python packages to communicate with your device. <\/span><\/p>\n
After that add a new file to your new project with the contents of our program above. Finally, enable MicroPython support for your project in <\/span>\u201cFile | Settings | Languages & Frameworks | MicroPython\u201d<\/span><\/i> and specify your device there:<\/span><\/p>\n
\"MicroPython<\/a><\/p>\n
Now let\u2019s see what the plugin has to offer.<\/span><\/p>\n
Code Completion and Documentation<\/h2>\n
The MicroPython plugin provides code completion and documentation for MicroPython-specific modules:<\/span><\/p>\n
\"MicroPython<\/a><\/p>\n
Notice that code completion is context-aware. On this screenshot PyCharm shows you only the members of the <\/span>utime<\/span> module.<\/span><\/p>\n
The quick documentation window contains the docs for the selected name. Use Ctrl+Q (F1 on macOS) to show this pop-up window. You can also dock it and enable <\/span>\u201cAuto-update from Source\u201d<\/span><\/i> to keep it permanently.<\/span><\/p>\n
Syntax Checking and Type Checking<\/span><\/p>\n
The plugin searches syntax errors and other problems in your code like potential AttributeError<\/code> or ImportError<\/code> using static code analysis. It comes with Python stub files for device-specific binary modules. These stubs contain Python type hints that make it possible to check types in your MicroPython code:<\/p>\n
\"MicroPython<\/a><\/p>\n
On the screenshot above you can see several Python syntax errors when the user tries to write some C code in the middle of their Python file. There is also a type error in\u00a0<\/span>utime.sleep_ms(3.14)<\/code>, since this function only accepts integers.<\/p>\n
Flash Files to Devices<\/h2>\n
The MicroPython plugin helps you to upload your files to your MicroPython device via USB. Use <\/span>\u201cMicroPython\u201d<\/span><\/i> run configurations to flash files or folders to your device in <\/span>\u201cRun | Edit Configurations\u2026\u201d<\/span><\/i> menu. To quickly upload a single file you can select <\/span>\u201cRun \u2018Flash <your-file-name>.py’\u201d<\/span><\/i> from the context menu of your Python file:<\/span><\/p>\n
\"MicroPython<\/a><\/p>\n
MicroPython REPL<\/h2>\n
Interactive experiments play an important role in Python development, but they are even more important with microcontrollers which usually don\u2019t have any screens to show possible errors. The MicroPython plugin allows you to quickly run an interactive Python REPL console. Use <\/span>\u201cTools | MicroPython | MicroPython REPL\u201d<\/span><\/i> menu to run a MicroPython shell on your device.<\/span><\/p>\n
\"MicroPython<\/a><\/p>\n
I hope you enjoy this plugin. I\u2019ll be glad to hear your feedback and how you\u2019re using it. Tell me about your experience with it in the comments below, or on twitter: <\/span>@vlasovskikh<\/span><\/a> or <\/span>@pycharm<\/span><\/a>. Star or fork the <\/span>intellij-micropython<\/span><\/a> repository on GitHub, send your issues and pull requests!<\/span><\/p>\n","protected":false},"author":1152,"featured_media":0,"comment_status":"open","ping_status":"closed","template":"","categories":[808,1065,2347],"tags":[91],"cross-post-tag":[],"acf":[],"_links":{"self":[{"href":"https:\/\/blog.jetbrains.com\/pt-br\/wp-json\/wp\/v2\/pycharm\/7180"}],"collection":[{"href":"https:\/\/blog.jetbrains.com\/pt-br\/wp-json\/wp\/v2\/pycharm"}],"about":[{"href":"https:\/\/blog.jetbrains.com\/pt-br\/wp-json\/wp\/v2\/types\/pycharm"}],"author":[{"embeddable":true,"href":"https:\/\/blog.jetbrains.com\/pt-br\/wp-json\/wp\/v2\/users\/1152"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.jetbrains.com\/pt-br\/wp-json\/wp\/v2\/comments?post=7180"}],"version-history":[{"count":1,"href":"https:\/\/blog.jetbrains.com\/pt-br\/wp-json\/wp\/v2\/pycharm\/7180\/revisions"}],"predecessor-version":[{"id":435026,"href":"https:\/\/blog.jetbrains.com\/pt-br\/wp-json\/wp\/v2\/pycharm\/7180\/revisions\/435026"}],"wp:attachment":[{"href":"https:\/\/blog.jetbrains.com\/pt-br\/wp-json\/wp\/v2\/media?parent=7180"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.jetbrains.com\/pt-br\/wp-json\/wp\/v2\/categories?post=7180"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.jetbrains.com\/pt-br\/wp-json\/wp\/v2\/tags?post=7180"},{"taxonomy":"cross-post-tag","embeddable":true,"href":"https:\/\/blog.jetbrains.com\/pt-br\/wp-json\/wp\/v2\/cross-post-tag?post=7180"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}