Konfigurasi external tools configurations pada SW4STM32 untuk st-flash

Catatan ini dalah bagian terakhir dari rangkaian catatan pengenalan dan tutorial mengenai penggunaan STM32CubeMX dan SW4STM32 untuk pemrograman mikrokontroler STM32. Sebagai contoh, dalam rangkaian tulisan ini dipergunakan papan sistem mikrokotroler STM32F103C8T6. Di bagian pertama dari rangkaian tutorial adalah pengenalan terhadap program STM32CubeMX. Bagian kedua memaparkan bagaimana melakukan konfigurasi pada STM32CubeMX sehingga hasilnya sesuai untuk keperluan debugging. Kemudian pada bagian ketiga diungkapkan cara instalasi dan inisiasi program SW4STM32. Bagian keempat memaparkan tahap-tahap yang perlu dilakukan untuk proses debugging.

Di bagian akhir ini akan saya coba ungkapkan catatan mengenai cara melakukan konfigurasi sehingga pengguna dalam melakukan flashing mikrokontroler dapat melakukannya “dari dalam” SW4STM32.

znap01Gambar 1.

znap02Gambar 2.

Pada Gambar 1 dan Gambar 2 terdapat pilihan berupa st-flash write dan st-flash erase. Keduanya harus dibuat sendiri oleh pengguna melalui fasilitas External Tools Configurations, seperti pada Gambar 2. Pilih New pada bagian yang saya tandai dengan kotak berwarna merah. Di sampingnya terdapat beberapa pilihan yang mungkin suatu saat akan diperlukan, silakan diperiksa sendiri. Pada {1} adalah tab Main dan didalamnya diisikan parameter yang sesuai. Misalnya pada {2}, isikan path ke arah letak program st-flash di dalam sistem komputer penguna. Lalu pada {3} arahkan target yang sesuai, biasanya yang dipakai untuk memprogram mikrokontroler adalah yang berasal dari ./Release, yang merupakan versi final. Tetapi dapat juga berasal dari hasil kompilasi pada direktori Debug seperti contoh saya pada Gambar 3.

znap03Gambar 3.

znap04Gambar 4.

znap06Gambar 5.

znap07Gambar 6.

Setelah tahap ini, pengguna dapat memilih mode operasi seperti terlihat pada Gambar 1 atau Gambar 2. Pengguna bisa memilih untuk menghapus atau melakukan pemrograman ke mikrokontroler anggota keluarga STM32. Jika operasi erase atau pemrograman ulang gagal dilakukan, bisa dicoba dengan melakukan erase dan reset pada posisi jumper seperti pada Gambar 7.

wp-1472127176031.jpegGambar 7.

Mengembalikan jumper ke posisi semula untuk mode operasi (running) dan pemrograman normal seperti Gambar 8.

wp-1472023019498.jpegGambar 8.

Debugging STM32F103C8T6 menggunakan SW4STM32 + OpenOCD + STLINK

Ini adalah bagian keempat mengenai penggunaan SW4STM32. Bagian sebelumnya telah disebutkan di tulisan ini. Setelah sebelumnya berhasil melakukan instalasi SW4STM32, di sini akan diungkapkan catatan mengenai bagaimana mempergunakannya untuk proses debugging.

Untuk kelancaran proses berikutnya; lakukan terlebih dahulu instalasi ST-Link V2 dan OpenOCD. Instalasi perangkat lunak untuk ST-LinkV2 sudah dibahas di tulisan sebelumnya [link].  Untuk OpenOCD pun proses instalasinya umumnya tidak terlalu sulit, terutama untuk sistem berbasis Microsoft Windows. Untuk sistem GNU/Linux setelah mengunduh file instalasinya di link ini, maka lakukan proses berikut:

cd ~/openocd-0.9.0
sudo ./configure
sudo make
sudo make install

Kembali ke SW4STM32:

OCDdebug001Gambar 1. Awal pengaturan untuk debugging.

OCDdebug002Gambar 2.

Jika cara seperti pada Gambar 1 dan Gambar 2 menghasilkan pesan keesalahan, maka cobalah cara seperti Gambar 3.

OCDdebug003Gambar 3.

OCDdebug004Gambar 4. Pada proses debugging untuk pertama kali, diperlukan pengaturan seperti ini.

OCDdebug005Gambar 5.

OCDdebug006Gambar 6.

OCDdebug007Gambar 7. Scroll ke bawah hingga seperti pada Gambar 8.

OCDdebug008Gambar 8.

OCDdebug009Gambar 9.

Selain mempergunakan konfigurasi Ac6, pengguna bisa juga mempergunakan cara debugging lain seperti pada Gambar 10.

OCDdebug010Gambar 10.

OCDdebug011Gambar 11.

OCDdebug012Gambar 12.

OCDdebug013Gambar 13.

OCDdebug014Gambar 14.

OCDdebug015Gambar 15.

Nah sekarang pengguna sudah memilki dua konfigurasi debugging yang siap dipergunakan. Tetapi sebelum melakukan mencoba upaya debugging dengan bantuan OpenOCD + STLINK, perlu dilakukan perubahan kode uji. Gambahkan di bagian endless loop dengan kode uji coba blinking led:

  while (1)
    {
//      HAL_GPIO_TogglePin (LedMerah_GPIO_Port, LedMerah_Pin);
      HAL_GPIO_TogglePin(GPIOC,GPIO_PIN_13);
      HAL_Delay (100);
      /* USER CODE END WHILE */
      /* USER CODE BEGIN 3 */
    }

Hubungkan dongle ST-LINK V2 ke port USB di komputer.

wp-1472023019498.jpegGambar 16.

Lalu aktifkan OpenOCD dengan baris perintah berikut (sesuaikan letak file dengan konfigurasi di komputer pengguna):

$ reset; openocd -f ~/openocd-0.9.0/tcl/interface/stlink-v2.cfg -f ~/openocd-0.9.0/tcl/target/stm32f1x.cfg

Saat aktif OpenOCD pada terminal seperti pada Gambar 17.

OCDdebug016Gambar 17. OpenOCD menunggu koneksi.

Jika nanti dengan konfigurasi standard yang diatur oleh SW4STM32 gagal berfungsi dengan baik, salah satu upaya solusi adalah dengan membuat file konfigurasi baru yang akan diacu oleh setting dalam SW4STM32. Konfigurasi dalam file STM32F103SW.cfg yang perlu diganti (di dalam file lain) adalah: reset_config srst_nogate.

# This is an STM32F103SW board with a single STM32F103C8Tx chip.
# Generated by System Workbench for STM32

source [find interface/stlink-v2.cfg]

set WORKAREASIZE 0x5000
transport select "hla_swd"


source [find target/stm32f1x_stlink.cfg]

# use hardware reset, connect under reset
#reset_config srst_only srst_nogate
reset_config srst_nogate

Jika papan mikrokontroler STM32F103C8T6 tidak dapat diprogram atau di-debug, salah satu cara adalah dengan melakukan erase. Ubah posisi jumper seperti pada Gambar 18.

wp-1472127176031.jpegGambar 18.

Lalu seperti pada Gambar 19 perintah erase dapat dilakukan setelah tombol reset pada papan ditekan dalam keadaan konfigurasi jumper seperti pada Gambar 18.

OCDdebug017Gambar 19. st-flash erase

Ok, sekarang kembali ke Gambar 16, diasumsikan semua kondisi normal dan posisi jumper sudah kembali ke posisi seperti pada gambar. Dilanjutkan pada posisi monitoring seperti pada Gambar 17. Maka proses debugging siap dilakukan dari dalam SW4STM32.

OCDdebug018Gambar 20.

Pada pilihan konfigurasi seperti pada Gambar 20, debugging terkadang dapat saya lakukan tanpa perlu melakukan aktifasi OpenOCD eksternal. Tetapi untuk amannya maka tetap pergunakan OpenOCD eksternal.

OCDdebug019Gambar 21. [Klik gambar untuk memperbesar tampilan]

Hal  yang sama juga diperoleh jika mempergunakan konfigurasi GDB Hardware Debugging.

Berikut adalah video singkat proses uji debugging.

[intense_video video_type=”youtube” video_url=”https://www.youtube.com/watch?v=6MtAfxhhEsE”]

Mempersiapkan program STM32F103C8T6 dengan mempergunakan STM32CubeMX

ztm32N01image credit: http://www.st.com/resource/en/data_brief/stm32cubemx.pdf

Sebagaimana telah diperkenalkan pada artikel yang lalu, STM32CubeMX memang terbukti benar-benar mempermudah pekerjaan para professional embedded developer maupun upaya belajar bagi yang baru memulai. Ada beberapa pengaturan yang diperlukan yang akan ditemui sepanjang proses belajar untuk memaksimalkan penggunaan STM32CubeMX. Salah satu contohnya adalah pengaruh konfigurasi yang dihasilkan (generated) oleh STM32CubeMX pada proses debugging dengan menggunakan OpenOCD. Secara default STM32CubeMX akan mematikan (disable) kemampuan debugging pada mikrokontroler STM32F103C8T6 yang sedanga dikonfigurasi. Jika ini tidak diubah maka proses debugging  mikrokontroler STM32F103C8T6 dengan OpenOCD melalui ST-Link V2 (clone) akan terganggu dan menimbulkan kesalahan.

ztm32N03Gambar 1.

Gambar 1 menampilkan konfigurasi awal dan tanda panah merah menunjukkan peripheral SYS  yang perlu diatur ulang dari nilai asalnya. Nilai yang perlu diubah ditampilkan pada Gambar 2.

ztm32N04Gambar 2.

ztm32N05Gambar 3.

Agar proses debugging mikrokontroler STM32F103C8T6 dengan OpenOCD dan ST-Link V2 dapat berjalan lancar, pengguna bisa memilih mode debug Serial Wire pada peripheral SYS, sebagaimana pada {1} di Gambar 3.

ztm32N06Gambar 4.

Setelah melakukan konfigurasi untuk proses debug pada seperti pada Gambar 3, proses dapat dilanjutkan dengan melakkan konfigurasi pada semua bagian lain yang diperlukan. Misalnya dalam mempelajari STM32 menggunakan papan μC STM32F103C8T6 yang murah meriah, pengguna perlu melakukan konfigurasi ulang pada pin PC13. Pin tersebut terhubung dengan satu led berwarna merah yang sangat mudah dijadikan bahan awal belajar maupun sebagai salah satu penanda proses (termasuk untuk debugging). Hasilnya seperti yang terlihat di Gambar 4, sedangkan untuk proses pengerjaannya dapat dibaca pada post sebelumnya di sini.

wp-1472023019498.jpegGambar 5. Papan sistem μC STM32F103C8T6 yang relatif murah sebagai sarana belajar.

Hasil konfigurasi STM32CubeMX yang berhubungan dengan debugging  yang telah diungkapkan dapat dilihat di dalam file stm32f1xx_hal_msp.c seperti yang terlihat di Gambar 6.

ztm32N07Gambar 6.

Baris kode yang benar yang memungkinkan dilakukannya proses debugging yang telah diatur dengan STM32CubeMX, yang teradapat di file stm32f1xx_hal_msp.c adalah:

__HAL_AFIO_REMAP_SWJ_NOJTAG();

Atau seperti bisa dilihat pada Gambar 7 pada baris ke 75. Baris ke 73 adalah kode yang dihasilkan secara default oleh CubeMX, kode ini akan menghasilkan kesalahan dalam proses debugging dengan menggunakan OpenOCD+ST-Link V2(+GDB). Kode pada baris ke 74 adalah untuk konfigurasi dengan JTAG 4 pin.

ztm32N08Gambar 7.

//  __HAL_AFIO_REMAP_SWJ_DISABLE(); //Kalau JTAG disabled pada STM32CubeMX akan error
//  __HAL_AFIO_REMAP_SWJ_NONJTRST(); //JTAG 4
  __HAL_AFIO_REMAP_SWJ_NOJTAG(); // Serial Wire debug

ztm32N09Gambar 8. [Klik pada gambar untuk memperbesar tampilan]

Gambar 8 menampilkan proses debugging yang benar dengan mempergunakan konfigurasi seperti yang terlihat pada Gambar 7 (debug enabled). Sedangkan pada Gambar 9, terlihat kesalahan yang terjadi jika masih menggunakan kode default: __HAL_AFIO_REMAP_SWJ_DISABLE. Pesan kesalahan dari OpenOCD:

Error: jtag status contains invalid mode value - communication failure
Polling target stm32f1x.cpu failed, trying to reexamine
Examination failed, GDB will be halted. Polling again in 100ms
Info : Previous state query failed, trying to reconnect

ztm32N10Gambar 9. Bukti tampilan kesalahan debugging STM32F103C8 sebagai akibat dari salah konfigurasi pada STM32CubeMX

Video singkat cuplikan contoh stepping pada proses debugging.

[intense_video video_type=”youtube” video_url=”https://www.youtube.com/watch?v=6MtAfxhhEsE”]

Mengenal STM32CubeMX untuk mempelajari ARM Cortex

stm32cubemx027

Dalam mempelajari penggunaan dan pemanfaatan mikrokontroler dengan inti ARM Cortex, sejauh ini, saya setuju dengan pendapat yang menyatakan bahwa arsitektur ini complex. Bila dibandingkan dengan keluarga MCS51 (8051) seperti Atmel AT89C/AT89S, keluarga AVR (ATmega*/ATtiny*), keluarga TI MSP430 atau bahkan keluarga STM8. Perbandingan bisa dilakukan dari berbagai sisi, dan mungkin akan saya coba di lain waktu jika ada kesempatan.

Untuk saat ini saya akan mengusahakan untuk dapat menuliskan catatan mengenai STM32CubeMX yang merupakan aplikasi yang dikeluarkan oleh STMicroelectronics. Aplikasi ini sangat membantu upaya untuk mempelajari penggunaan mikrokontroler ARM Cortex seperti STM32F103C8T6 (STM32). Berbeda dengan arsitektur 8-bit dan 16-bit yang sebelumnya populer, arsitektur 32-bit dari ARM ini memerlukan usaha lebih untuk dikonfigurasi. Tantangan untuk menghemat sumberdaya energi dan waktu bagi para profesional ini sepertinya dipahami oleh STMicroelectronics. Efek baiknya (kemudahan melakukan konfigurasi) juga dapat dirasakan oleh mereka yang baru belajar, seperti saya. Menurut STMicroelectronics sendiri sebagai berikut:

STM32CubeMX is part of STMicroelectronics
STMCube™ original initiative to ease developers
life by reducing development efforts, time and
cost. STM32Cube covers STM32 portfolio.

STM32Cube includes the STM32CubeMX which
is a graphical software configuration tool that
allows generating C initialization code using
graphical wizards.

It also embeds a comprehensive software
platform, delivered per series (such as
STM32CubeF4 for STM32F4 series). This
platform includes the STM32Cube HAL (an
STM32 abstraction layer embedded software,
ensuring maximized portability across STM32
portfolio), plus a consistent set of middleware
components (RTOS, USB, TCP/IP and graphics).

Singkatnya, dengan aplikasi/program komputer STM32CubeMX ini pengguna yang baru belajar dimungkinkan untuk segera memulai tahapan belajarnya dengan lebih mudah. Misalnya waktu untuk mendapatkan kerangka yang lengkap dari program “led berkedip” menjadi jauh lebih singkat. Berbagai kerumitan konfigurasi dapat kemudian dipelajari secara bertahap. Keluarga mikrokontroler STM32 (32-bit) yang berbasis pada ARM Cortex ini cukup dikenal sebagai keluarga mikrokontroler yang kurva belajarnya curam, alias perlu usaha extra (steep learning curve).

Untuk keperluan belajar maka tidak seluruh kemampuan STM32CubeMX perlu diungkap di sini. Hanya yang benar-benar dipergunakan untuk menghasilkan kode program yang sederhana saja yang akan dituliskan.

DOWNLOAD

Pertama kali program STM32CubeMX dapat diunduh di sini: link atau di sini. Yang pernah saya lakukan, hasilnya berupa file en.stm32cubemx.zip. Kemudian file  ini kemudian perlu di ekstrak oleh pengguna ke direktori yang nanti akan menjadi direktori tetap (buka instalasi) dari program ini, seperti terlihat di Gambar 1.

stm32cubemx001Gambar 1.

PENGGUNAAN

Pengguna bisa membuatkan icon di desktop seperti pada Gambar 2.

stm32cubemx002Gambar 2.

Untuk menghasilkan icon ke aplikasi STM32CubeMX dapat menggunakan konfigurasi berikut:

[Desktop Entry]
Encoding=UTF-8
Name=STM32CubeMX
Comment=
Exec=/home/rumahku/STM32CubeMX/STM32CubeMX
Icon=/usr/share/icons/hicolor/48x48/apps/display.im6.png
Categories=Application;Development;Java
Version=1.0
Type=Application
Terminal=0
Name[en_US.UTF-8]=STM32CubeMX

Dengan konfigurasi ini, untuk memanggil aplikasi pengguna cukup melakukan doble-click pada icon STM32CubeMX.

Gambar-gambar berikut dapat diperbesar dengan melakukan klik pada gambar.

stm32cubemx003Gambar 3.

stm32cubemx004Gambar 4

Pengguna bisa memilih berdasarkan MCU [1] atau memilih berdasarkan papan sirkuit [2], seperti Gambar 4.

stm32cubemx005Gambar 5. Memilih berdasarkan tipe papan sirkuit (sistem).

Misalkan pengguna sudah memiliki board produksi ST, maka sebagaimana terlihat pada Gambar 5 yang perlu dilakukan adalah membatasi jumlah tampilan dengan memilih “Type of Board”. Ini terutama bermanfaat jika item yang muncul berjumlah banyak. Jika masih sedikit, bisa langsung dipilih dari daftar dan kemudian melakukan klik pada tombol OK.

stm32cubemx006Gambar 6.

Pada Gambar 6, pada [1] pengguna dapat memilih salah satu (atau bergantian) konfigurasi yang akan dilakukan pada mikrokontroler yang dipilih (kali ini berdasarkan jenis papan).

Seperti yang sebelumnya dapat dilihat di Gambar 4, pemilihan bisa juga dilakukan berdasarkan jenis spesifik mikrokontroler. Untuk ini dalam Gambar 4, pengguna memilih [1] lalu [3].

stm32cubemx007Gambar 7.

Misalkan pengguna ingin melakukan konfigurasi untuk mikrokontroler STM32F103C8T6, maka pada Gambar 7 pengguna dapat melakukan penapisan (filtering) pada bagian yang saya beri tanda kotak merah [1]. Untuk mengurangi jumlah tampilan komponen yang banyak, di pilihan Series gunakan STM32F1. Lalu lebih spesifik dipersempit dengan memilih Line STM32F103. Mikrokontroler yang dituju akan ada dalam daftar yang tampil.

Sebagai tambahan pengetahuan menarik untuk melihat cara penamaan keluarga mikrokontroler STM32 oleh ST (STM32 microcontrollers naming conventions).

stm32cubemx008stm32cubemx009stm32cubemx010Gambar 8.

Page 216 - 1Gambar 9.

Untuk mikrokontroler ARM Cortex-M3 STM32F103C8T6, berdasarkan (screenshot) Gambar 8 dan Gambar 9 dapat diketahui:

Device family STM32
Product type General purpose
Device subfamily 103
Pin count 48 pins
Flash memory size 64 KBytes
Package LQFP
Temperature range -40 ~ 85 °C

stm32cubemx011Gambar 10. Cuplikan tampilan dari STM32CubeMX
[lagi, klik gambar untuk memperbesar tampilan]

stm32cubemx012stm32cubemx013stm32cubemx014Gambar 11. Posisi STM32F103C8 di peta produk STM32 [sumber].

Kembali ke tampilan STM32CubeMX, setelah memilih mikrokontroler yang memang akan dikonfigurasikan (STM32F103C8T6 / STM32F103C8) dan menekan tombol OK, tampilan program akan seperti pada Gambar 12.stm32cubemx015Gambar 12.

stm32cubemx016Gambar 13. Memilih pin PC13 dengan salah satu dari dua cara.

Pada Gambar 13, pengguna yang perlu mengatur pin pengendali led pada papan sirkuit (pin PC13) dengan salah satu dari dua cara.

stm32cubemx017Gambar 14.

Pada Gambar 14, lakukan left-click pada pin sampai agar pilihan menu terlihat.

stm32cubemx018Gambar 15. Tampilan setelah PC13 diatur sebagai pin keluaran (GPIO_Output).

stm32cubemx019Gambar 16. Pada tab configuration pilih GPIO.

stm32cubemx020

Gambar 17.

Jika dikehendaki/diperlukan, pengguna bisa memberi label pada pin. Pilih baris [1] lalu isi nama (User Label) [2], kemudian klik OK.

Gambar 18.

Gambar 19. Sejumlah tab untuk perintah “Generate Code”

Pada Gambar 19, diperlihatkan bahwa untuk toolchain / IDE saya memilih SW4STM32 (System Workbench for STM32), yang secara legal gratis dan dapat beroperasi di sistem GNU/Linux maupun MS Windows.

stm32cubemx023Gambar 20. Pilih salah satu cara  penyalinan pustaka yang dikehendaki.

stm32cubemx024Gambar 21. Ada kemungkinan STM32CubeMX akan meminta pengguna mengizinkan program mengunduh beberapa program tambahan.

Gambar 22.

stm32cubemx026Gambar 23. [klik gambar untuk memperbesar]

Gambar 23 adalah gambar hasil screenshot terhadap tampilan SW4STM32 (System Workbench for STM32) yang telah berhasil melakukan kompilasi kode yang dihasilkan oleh STM32CubeMX. Tentu saja user’s code masih dalam keadaan kosong. Hal ini disengaja agar percobaan dapat fokus melihat kondisi awal dari kode program yang dihasilkan oleh STM32CubeMX.  Catatan lebih panjang akan diunggah lain waktu jika ada kelapangan.

UPDATE

Hasil konfigurasi dalam catatan ini, berfungsi baik untuk sebagai kode dasar untuk memprogram mikrokontroler tetapi tidak cocok untuk jika perlu dilakukan proses debugging dengan OpenOCD dan ST-Link V2. Untuk menghasilkan konfigurasi dan kode dasar yang sesuai silakan membaca catatan di sini [link].

Berikut video singkat pembuktian bahwa cara ini (menggunakan STM32CubeMX) berhasil dengan baik:

[youtube =”https://youtu.be/R0JG7l672nA”]

 

Sumber belajar tentang STM32CubeMX:

  • STM32CubeMX
    STM32 configuration and initialization C code generation.
  • UM1718, User manual
    STM32CubeMX for ST M32 configuration  and initialization C code generation.

Mbed, kompilasi online program STM32F103C8T6

Pada post yang lalu, telah saya sampaikan catatan untuk melakukan pengujian cepat papan mikrokontroler STM32F103C8T6 (arsitektur ARM Cortex-M3 32-bit RISC) murah produksi China. Dalam post ini saya masih akan menyampaikan cara memprogram STM32F103C8T6 tetapi dengan menggunakan aplikasi online dari mbed. Sebagaimana cara lainnya, cara ini tentu saja memiliki keunggulan dan juga kekurangan. Mungkin perlu semacam studi kecil-kecilan untuk hal ini.

Beberapa keunggulan yang ditawarkan oleh sarana pemrograman online seperti mbed antara lain adalah mempersingkat waktu untuk konfigurasi. Sekalipun sepintas melakukan instalasi dan konfigurasi toolchain secara offline di komputer lokal itu mudah, tetapi kenyataannya sering tidak seperti itu. Beberapa ketidaksesuaian dan kekurangan dalam konfigurasi sangat mungkin terjadi. Seperti yang juga pernah saya alami dan sudah saya catatkan di tinker.sunupradana.info ini. Selain itu jika compiler dan IDE (singkatnya toolchain) diatur dan dipelihara terus menerus oleh pihak yang lebih profesional maka akan lebih terjamin jika ada kondisi error atau terdapat bug,menjadi  akan lebih mungkin dan lebih mudah diperbaiki oleh pengelola. Selain itu dengan jumlah pengguna yang besar, tiap permasalahan akan sangat mungkin dialami oleh banyak orang pada kurun waktu yang sama. Sehingga deteksi kesalahan lebih cepat terjadi. Faktor dimungkinkannya kolaborasi ini juga menjadi salah satu nilai plus platform seperti ini. Kode dari seorang pengguna bisa dimanfaatkan oleh orang lain, bahkan banyak orang lain seperti contoh yang akan dipakai dalam catatan ini.

Sedangkan beberapa kekurangan dari pilihan pemrograman secara online antara lain, bahwa programmer pengguna perlu memiliki akses Internet. Bagi pengguna yang tidak setiap saat diperlukan dapat terhubung dengan Internet secara lancar, maka akan menjadi masalah. Juga selain itu umumnya perlu semacam bootloader pada sistem target agar program yang dikompilasi secara online dapat langsung dipindahkan ke target dan dijalankan hanya dengan koneksi fisik berupa kabel USB. Ini mirip pada sistem Texas Instrument MSP432 yang sudah saya ungkap sebelumnya. Untuk produk dari ST seperti Nucleo-F446RE hal ini tidak menjadi masalah karena sistem tersebut sudah dapat diprogram langsung dari mbed melalui web browser.

Pada catatan kali ini saya mencoba ikut mengamalkan cara memprogram papan STM32F103C8T6 (STM32F103) dengan mempergunakan mbed. Berbeda dengan sistem Nucleo yang saya sebut di paragraf sebelum ini, papan STM32 yang murah ini tidak memiliki bootloader untuk mbed. Dengan kata lain ini bukan papan yang sebenarnya mbed enabled. Untungnya sebagaimana banyak hal lain dalam teknologi elektronika, seseorang telah mencoba memberikan solusi untuk masalah ini. Dan selama kita masih memiliki rasa ingin tahu, kemauan untuk bekerja keras dan kemauan untuk belajar, kita pun akan bisa menikmati solusi itu.

Pada dasarnya solusi diperoleh dengan cara mempergunakan konfigurasi dasar dari NUCLEO-F103RB yang tentu saja juga berintikan mikrokontroler seri STM32F103, tetapi STM32F103RBT6 dan bukan STM32F103C8T6 seperti yang akan dipakai di sini. Untungnya Zoltan Hudak menemukan cara untuk konfigurasi sistem Nucleo itu untuk papan yang harganya lebih murah, papan STM32F103C8T6.

Program yang diuat oleh Zoltan Hudak dapat dipergunakan oleh banyak orang yang telah memilki akun di mbed, nama programnya adalah STM32F103C8T6_Hello. Program ini bisa langsung diimpor oleh pengguna lain ke workspace-nya sendiri. Tetapi sebelum menunjukkan cara penggunaan mbed untuk uji coba kali ini, saya perlu menyampaikan cara menanggulangi satu kekurangan mbed dalam memprogram papan murah yang berintikan μC STM32F103C8T6. Kekurangan itu adalah bahwa compiler mbed tidak bisa melanjutkan memprogram papan μC STM32F103C8T6 secara langsung. Melainkan file bin hasil kompilasilah yang akan diberikan kepada pengguna (downloaded) untuk kemudian diunggah (uploaded) sendiri secara manual oleh pengguna ke μC STM32F103C8T6.

Untuk mengatasi kekurangan itu diperlukan suatu uploader (boleh juga disebut flasher) untuk memuat file hasil kompilasi ke μC. Saya memilih sistem yang gratis dan dapat dioperasikan juga di sistem GNU/Linux seperti Ubuntu atau Mint. Sistem tersebut adalah stlink, yang dapat dengan mudah diunduh gratis di sini. Panduan instalasinya pun mudai diikuti di halaman wiki di sini. Untuk keperluan ini yang paling diperlukan adalah program st-flash. Tetapi karena tujuan saya bukan hanya untuk melakukan uji coba, melainkan juga membangun platform yang bisa dipakai untuk pemrograman selanjutnya maka kerja konfigurasi saya lanjutkan. Agar dalam satu kurun waktu, satu rangkaian pekerjaan selesai. Karena itu saya melakukan copy agar program-program dari stlink dapat dipakai, dipanggil dari banyak tempat (direktori/folder).

Cara pertama yang bisa ditempuh adalah dengan menggunakan cara soft link;

ln -s /home/rumahku/stlink/build/st-flash ~/bin/st-flash
ln -s /home/rumahku/stlink/build/st-util ~/bin/st-util
ln -s /home/rumahku/stlink/build/st-info ~/bin/st-info
ln -s /home/rumahku/stlink/build/st-term ~/bin/st-term

Tetapi menurut saya dengan cara ini tidak menjadi mudah untuk mempergunakan st-link gui atau stlink-gui-local. Karena itu saya memilih cara kedua yaitu melakukan copy ke direktori yang kemudian berada dalam $PATH. Kebetulan saya telah memilikinya /home/rumahku/bin. Tetapi kalau belum memiki direktori seperti itu, cukup dibuat dengan cara yang mudah;

~ $ mkdir ./bin

Kemudian pertama kali copy file stlink-gui.ui dari /home/rumahku/stlink/src/tools/gui/stlink-gui.ui . Lalu copy file program dari /home/rumahku/stlink/build/  sehingga menjadi seperti pada Gambar 1.

Gambar 1.

Abaikan program FoxitReader, karena itu adalah program lain (pembaca file pdf).

Untuk memastikan bahwa semua program dalam direktori /home/rumahku/bin/ akan dapat dipanggil dari direktori lain maka direktori itu perlu ada di dalam PATH di file .profile. File .profile adalah file yang tersembunyi yang terdapat di /home/rumahku/ . Tanda titik di depan nama file menandakan bahwa file tersebut tersembunyi. Jika menggunakan “explorer” (file manager) seperti Thunar, maka pengguna perlu memberikan perintah dari keyboard berupa ctrl+h agar file yang tadinya tersembunyi di sistem GNU/Linux dapat terlihat. File itu kemudian bisa dibuka dengan gedit (text editor). Semua rangkaian cara ini relatif mudah daripada menggunakan terminal, bagi yang belum terbiasa. Lalu pastikan /home/rumahku/bin/ tercantum dalam isi file .profile.

PATH=/home/rumahku/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games

Setelah itu agar perubahan (jika ada) bisa langsung dimanfaatkan berikan perintah berikut;

~ $ source .profile

Untuk menguji apakah sistem sudah berhasil diperbaharui, panggil salah satu program dari direktori (acak) selain direktori stlink. Misalnya sekedar untuk mencoba;

~/Documents $ st-flash

Program st-flash inilah yang akan dipakai untuk melakukan upload file hasil kompilasi mbed ke papan μC.

mbed002Gambar 2. Percobaan pemanggilan berhasil

Setelah berhasil melakukan setup stlink yang tidak hanya akan dipakai untuk pemrograman cara ini tapi juga untuk banyak keperluan lain, sekarang kita bisa beralih ke tahapan selanjutnya. Tahapan utama adalah tahapan pemanfaatan mbed. Pertama kali pengguna perlu membuat akun di situs mbed, di link ini.

Gambar 3.

Gambar 4.

Setelah berhasil signup lalu login, berikutnya untuk percobaan ini, pengguna bisa langsung menuju STM32F103C8T6_Hello.

Gambar 5.

Tekan-tahan tanda “panah ke bawah” lalu pilih Import into Compiler atau Import with mbed CLI. Untuk cepatnya saya hanya melakukan klik cepat dan otomatis akan memiih pilihan defaultImport into Compiler.

mbed006Gambar 6.

mbed007Gambar 7. Setelah berhasil melakukan impor

Jika papan Nucleo-F103RB belum terdapat dalam daftar registered platform, bisa ditambahkan sendiri dengan melakukan klik pada Add Platform seperti pada Gambar 8.

mbed008Gambar 8.

mbed009Gambar 9.

mbed010Gambar 10.

Pertama, untuk uji coba ini ubah kode sesuai keperluan. Kedua pastikan platform yang sedang aktif adalah NUCLEO-F103RB, lalu klik perintah untuk Compile.

#include "stm32f103c8t6.h"
#include "mbed.h"
 
Serial      pc(PA_2, PA_3);
DigitalOut  myled(LED1);
 
int main() {
    while(1) {
        // The on-board LED is connected, via a resistor, to +3.3V (not to GND). 
        // So to turn the LED on or off we have to set it to 0 or 1 respectively
        myled = 0;      // turn the LED on
        wait(0.2);      // 200 ms
        myled = 1;      // turn the LED off
        wait(1.0);      // 1 sec
        pc.printf("Blinkrn");
    }
}

 

mbed011Gambar 11. Proses kompilasi sedang berlangsung.

mbed012Gambar 12. Download hasil kompilasi.

mbed013Gambar 13. Melihat detail hasil komplasi

mbed014Gambar 14. Informasi detail besar file hasil kompilasi.

Penting untuk mengamati bahwa batas besar program untuk μC STM32F103C8T6 adalah 64 kB, jangan sampai besar program melebihi batas itu. Zoltan Hudak sudah memberi peringatan yang jelas mengenai besar program ini.

mbed016Gambar 15. [image credit: Zoltan Hudak]

/media/uploads/hudakz/stm32f103c8t6_pinout03.png

Gambar 16. [image credit: Zoltan Hudak].

https://developer.mbed.org/media/uploads/hudakz/stm32f103c8t6_schematic.png

Gambar 17. [image credit: Zoltan Hudak].

mbed015Gambar 18. Proses upload ke mikrokontroler berhasil.

Demikianlah catatan saya kali ini mengenai contoh pemrograman salah satu mikrokontroler ARM Cortex-M3 dengan mbed, sekalipun tidak termasuk dalam golongan papan (board) yang sudah mbed enabled.