MicroPython - Memprogram ESP32/ESP8266 menggunakan VS Code dan Pymakr

Pada artikel ini, Arduino Indonesia akan membahas tentang cara memprogram papan ESP32 dan ESP8266 dengan MicroPython menggunakan Editor VS Code (Visual Studio Code) dengan ekstensi Pymakr. Jika Anda terbiasa memprogram papan ESP32 dan ESP8266 menggunakan VS Code dengan PlatformIO IDE (Arduino core), dan juga ingin memprogramnya dengan MicroPython, menggunakan ekstensi Pymakr bisa menjadi alternatif yang baik. 

Menginstal VS Code di Windows (Visual Studio Code)

1. Kunjungi https://code.visualstudio.com/ dan unduh versi stabil (stable build) untuk sistem operasi Windows.

2. Jalankan file installer yang telah diunduh.

3. Ikuti instruksi di layar untuk menyelesaikan instalasi. Anda dapat menggunakan pengaturan default yang disarankan.

Klik pada installation wizard untuk memulai instalasi dan ikuti semua langkah hingga selesai. Terima perjanjian lisensi dan tekan tombol Next.

Pilih opsi-opsi berikut dan klik Next.

Tekan tombol Install.

Terakhir, klik Finish untuk menyelesaikan instalasi.

Buka VS Code dan Anda akan disambut oleh tab Welcome yang berisi catatan rilis (release notes) versi terbaru.

Selesai. Visual Studio Code telah berhasil diinstal.

Menginstal VS Code pada Mac OS X (Visual Studio Code)

1. Kunjungi https://code.visualstudio.com/ dan unduh versi stabil (stable build) untuk sistem operasi Mac OS X.

2. Buka file `.zip` yang telah diunduh.

3. Salin (drag) aplikasi Visual Studio Code ke folder *Applications.

4. Buka VS Code dari Launchpad atau Spotlight Search.

Setelah mengunduh file aplikasi Visual Studio Code, Anda akan mendapatkan pesan berikut. Tekan tombol "Open" untuk membukanya.

 

Atau, buka folder Downloads Anda dan jalankan Visual Studio Code dari sana.

Setelah itu, Anda akan disambut oleh tab Welcome yang berisi catatan rilis (release notes) versi terbaru.

Selesai. Visual Studio Code telah berhasil diinstal.

Menginstal VS Code pada Linux Ubuntu (Visual Studio Code)

1.  Kunjungi https://code.visualstudio.com/ dan unduh versi stabil (stable build) untuk sistem operasi Linux Ubuntu (misalnya file `.deb`).

 

2.  Buka terminal dan navigasikan ke folder tempat file diunduh (misalnya Downloads).

3.  Instal VS Code menggunakan perintah berikut (sesuaikan dengan nama file yang diunduh):

  

  ```bash

    sudo dpkg -i code_<version>.deb

    ```

 

    atau gunakan manajer paket:

 

    ```bash

    sudo apt install ./code_<version>.deb

    ```

 

4.  Jika ada ketergantungan (dependencies) yang belum terpenuhi, instal dengan:

 

    ```bash

    sudo apt-get install -f

    ```

 

5.  Luncurkan VS Code dari menu aplikasi atau dengan mengetik `code` di terminal.

Simpan file instalasinya:

 

Untuk menginstalnya, buka jendela Terminal, arahkan ke folder Downloads Anda dan jalankan perintah berikut untuk menginstal VS Code.

 

$ cd Downloads

~/Downloads $ sudo apt install ./code_1.49.1-1600299189_amd64.deb

 

Setelah instalasi selesai, VS Code akan tersedia di menu aplikasi Anda.

 

Buka VS Code dan Anda akan disambut oleh tab Welcome yang berisi catatan rilis (release notes) versi terbaru.

Selesai. Visual Studio Code telah berhasil diinstal.

Menginstal Ekstensi Pymakr di VS Code

Di bagian ini, kami akan menginstal ekstensi Pymakr di VS Code. Ekstensi ini memungkinkan Anda berkomunikasi dengan perangkat MicroPython menggunakan REPL (command-line) bawaan. Ia menyediakan antarmuka dengan tombol untuk menjalankan satu file ke papan, menyinkronkan seluruh proyek, atau langsung mengetik dan mengeksekusi perintah. Untuk menggunakan ekstensi Pymakr di VS Code, Anda perlu menginstal node.js di komputer Anda.

Kunjungi situs web node.js di halaman Home atau Downloads dan instal node.js sesuai sistem operasi Anda.

Menginstal Plugin Pymakr

1. Buka VS Code.

2. Klik ikon Extensions (atau tekan Ctrl+Shift+X) untuk menuju ke halaman ekstensi.

3. Cari Pymakr dan instal ekstensi tersebut.

Ekstensi Pymakr kini telah terinstal di VS Code. Pymakr Console akan terbuka, dan Anda akan melihat perintah-perintah baru di bilah bawah.

Berikut adalah perintah-perintah baru yang tersedia:

- Pymakr Console: Menampilkan/sembunyikan koneksi ke papan - terhubung/putuskan sambungan.

- Run: Menjalankan file yang sedang terbuka di papan.

- Upload: Mengunggah seluruh proyek ke papan Anda.

- Download: Mengunduh proyek dari papan ke komputer.

- All commands: Menampilkan daftar semua perintah Pymakr yang tersedia.

- Select All commands: Memilih dari daftar semua perintah.

Menu berikut akan terbuka:

Menghubungkan Perangkat MicroPython ke Pymakr

Bersamaan dengan itu, Pymakr akan secara otomatis membuka file `pymakr.json`. Anda perlu mengedit file tersebut untuk menghubungkan perangkat MicroPython (misalnya: ESP32 atau ESP8266 Anda yang telah di-flash dengan firmware MicroPython).

Catatan: Jika file `pymakr.json` tidak terbuka otomatis, buka All Commands (di bilah bawah) lalu pilih Pymakr > Global Settings.

Ini akan membuka file `pymakr.json`.

Pymakr memiliki daftar perangkat USB yang akan dicoba untuk dihubungi. Anda perlu memastikan perangkat Anda ada dalam daftar di file konfigurasi `pymakr.json`. Anda harus menambahkan USB Manufacturer (pembuat USB) yang digunakan perangkat untuk terhubung ke PC. Dalam kasus kami, baik ESP32 maupun ESP8266 menggunakan driver USB Silicon Labs.

 

Untuk mengetahui driver mana yang digunakan papan Anda, buka Device Manager di komputer (dengan papan terhubung) dan cari perangkat USB yang terhubung.

Di Device Manager, Anda juga dapat memeriksa port COM mana yang digunakan oleh perangkat. Dalam kasus kami, itu adalah COM3.

 

Sekarang, edit file `pymakr.json` untuk menambahkan manufacturer Silicon Labs (atau yang lain sesuai perangkat Anda) ke bagian `autoconnect_comport_manufacturers`. Kemudian, simpan file tersebut.

 

"autoconnect_comport_manufacturers": [

  "Pycom",

  "Pycom Ltd.",

  "FTDI",

  "Microsoft",

  "Microchip Technology, Inc.",

  "Silicon Labs"

]

 

Memilih Port COM

Setelah menyimpan file dengan pengaturan sebelumnya, Anda juga perlu mengatur port COM tempat papan Anda terhubung. Pymakr memiliki kemampuan untuk menemukan port COM Anda secara otomatis (mungkin tidak bekerja untuk sebagian pengguna).

 

Untuk koneksi otomatis, biarkan pengaturan `address` kosong, dan atur `auto_connect` ke `true`.

 

"address": "",

"auto_connect": true,

 

Dalam kasus saya, Pymakr berhasil mendeteksi port COM secara otomatis (tanda ✓ muncul di sebelah tombol Pymakr Console).

 

Jika papan Anda tidak terhubung secara otomatis, Anda perlu mengubah bagian `address` dengan port COM papan Anda. Contohnya:

 

"address": "COM3",

 

Untuk menemukan port COM papan, Anda dapat klik All Commands dan pilih Pymakr > Extra > List Serial Ports.

Untuk menggunakan port COM yang telah ditentukan, Anda juga perlu mengatur parameter `auto_connect` ke `false`:

 

"auto_connect": false,

 

Simpan file konfigurasi `pymakr.json` (CTRL+S).

 

Setelah menyimpan file, Pymakr akan secara otomatis mendeteksi papan Anda (tanda ✓ akan muncul di sebelah tombol Pymakr Console). Jika ini tidak terjadi, tekan tombol Pymakr Console untuk mencoba menghubungkan secara manual. Jika masih belum berhasil, kami sarankan untuk me-restart VS Code.

Ketik `help()` pada jendela Terminal setelah tanda prompt (`>>>`) dan lihat respons dari papan Anda:

 

help()

 

Selesai! Pymakr telah berhasil diinstal di VS Code dan Anda berhasil menghubungkan perangkat MicroPython. Ikuti bagian selanjutnya untuk mempelajari cara membuat, menyimpan, dan mengunggah proyek ke papan Anda.

Membuat Proyek MicroPython di VS Code + Pymakr untuk ESP32/ESP8266

Ikuti bagian ini untuk mempelajari cara membuat Proyek MicroPython di VS Code menggunakan Pymakr untuk memprogram papan ESP32 dan ESP8266. Sebagai contoh, kami akan mengunggah kode untuk membuat LED on-board (GPIO 2) berkedip (blink).

1. Pertama, hubungkan papan ESP32 atau ESP8266 yang telah di-flash firmware MicroPython ke komputer Anda.

2. Buat sebuah folder untuk proyek Anda. Contoh: `blink`.

3. Buka VS Code. Pymakr akan otomatis mencoba terhubung ke papan Anda. Jika tidak, buka menu Extensions dan aktifkan ekstensi Pymakr. Selain itu, pastikan Anda telah mengedit file `pymakr.json` dengan konfigurasi yang tepat untuk terhubung ke papan Anda. Lihat kembali bagian Menghubungkan Perangkat MicroPython ke Pymakr.

4. Kemudian, buka File > Open Folder dan pilih folder yang baru Anda buat. Setiap proyek MicroPython sebaiknya memiliki dua file: `main.py` dan `boot.py`. Buat file-file tersebut di dalam folder proyek:

- boot.py: Dijalankan saat perangkat dinyalakan dan mengatur beberapa opsi konfigurasi.

- main.py: Ini adalah skrip utama yang berisi kode Anda. Dieksekusi segera setelah `boot.py`.

Pada bagian ini, kami akan mengunggah kode sederhana untuk membuat LED on-board berkedip. Oleh karena itu, Anda tidak perlu menyalin apa pun ke file `boot.py`.

 

Salin kode berikut ke file `main.py`. Kode ini membuat LED on-board berkedip setiap setengah detik.

 

from machine import Pin

from time import sleep

led = Pin(2, Pin.OUT)

while True:

  led.value(not led.value())

  sleep(0.5)

 

Simpan file tersebut (CTRL+S).

Kemudian, klik tombol Upload.

Proses ini akan mengunggah kode ke papan dan secara otomatis me-*restart* papan untuk mulai menjalankan kode.

LED on-board pada ESP32 atau ESP8266 seharusnya mulai berkedip.

Penting: Perintah Run hanya menjalankan kode tanpa mengunggahnya ke papan. Artinya, kode hanya akan berjalan selama papan terhubung ke komputer. Untuk mengunggah kode ke papan, pilih opsi Upload.

Untuk melakukan perubahan lebih lanjut (mengunggah kode baru), tekan CTRL+C untuk menghentikan kode yang sedang berjalan. Anda tidak akan dapat mengunggah kode baru jika ESP sedang menjalankan kode lain.

 

Anda juga tidak dapat menjalankan perintah lain saat papan sedang mengeksekusi kode. Jika prompt (`>>>`) tidak ditampilkan, itu berarti papan sedang menjalankan kode. Tekan CTRL+C untuk menghentikan kode, dan prompt (`>>>`) akan muncul. Setelah itu, Anda dapat menjalankan perintah lain.

Menonaktifkan/Menyembunyikan Ekstensi Pymakr

Saat Anda tidak menggunakan Pymakr, Anda dapat menonaktifkan atau menyembunyikan perintah-perintah Pymakr di bilah bawah. Hal ini terutama berguna jika Anda memprogram papan ESP menggunakan ekstensi PlatformIO. Mengaktifkan kedua ekstensi secara bersamaan dapat menyebabkan masalah saat mengunggah kode dan menghubungkan ke papan.

 

Untuk menyembunyikan perintah Pymakr, buka Extensions dan cari ekstensi Pymakr di daftar ekstensi yang terinstal. Kemudian, klik Disable. 

Mulai ulang VS Code agar perubahan berlaku. Saat Anda ingin menggunakan ekstensi Pymakr lagi, Anda perlu mengaktifkan ekstensi tersebut kembali.

 

 

 

Siap Belajar & Bangun Proyek IoT?

KLIK GAMBAR DI BAWAH INI UNTUK BELI TRAINER KIT ESP32

 

Klik gambar untuk pembelian

Dalam praktik, hasil dan kendala yang ditemui bisa berbeda tergantung perangkat, konfigurasi, versi library, dan sistem yang digunakan.

• Diskusi umum dan tanya jawab praktik: https://t.me/edukasielektronika
• Kendala spesifik dan kasus tertentu: http://bit.ly/Chatarduino