Передмова
На фоні різкого здорожчання чипів STM32, та їх дефіциту, на часі розглянути якісь альтернативи. Звісно, тієї ж вагової категорії. Це має бути 32 розрядний MCU, та архітектури ARM. Пропоную до вашої уваги дошку розробника KIT Prototyping CY8CKIT-149 PSoC4 від компанії Cypress + Infineon. Розписувати характеристики і опис дублюючи документацію - не бачу сенсу. Можете самі перейти за наданими ланками і ознайомитись більш детально.
 |
| CY8CKIT-149 PSoC® 4100S Plus Prototyping Kit |
Мета цієї статті:
- показати як встановити засіб розробки Eclipse ModusToolBox IDE
- створення проекту "Hello, World" для ознайомлення з процесом розробки
Встановлення ModusToolbox
Перейдіть за ланкою, щоб завантажити
ModusToolbox, та оберіть вашу операційну систему. ModusToolBox доступний для Windows,
Linux, macOS. Ну звісно, це ж Eclips :)
Після завантаження, встановіть
ModusToolBox.
Встановлення без особливостей, достатньо:
- тиснути "Next"
- погодитись з ліцензійною угодою
- залишити шлях встановлення за замовчуванням, або вказати свій шлях (шлях не має містити кирилічні символи)
- обрати тип інсталяції "Default installation"
- кнопкою "Finish" завершити інсталяцію та запускаємо ModusToolBox
|
| Завершення встановлення |
Оберіть свій WorkSpaces, тека де будуть зберігатись ваші проекти, або залиште як є:
|
| Обираємо шлях workspaces |
Тиснемо кнопку "Launch" і перейдемо до створення першого проекту "Hello World" надрукуємо текстовий рядок в серіал порт та поблимаємо світлодіодами. А світлодіодів на цій платі розробника дуже багато :)
Створення нового проекту
|
| Створення нового проекту |
- На панелі швидкого доступу "Quick panel"
- Тиснемо "New Application". Запуститься утіліта "Project Creator"
- Обираємо свою дошку розробника "CY8CKIT-149" з чипом CY8C4147AZI-S475
- Тиснемо кнопку "Next"
|
| Обираємо приклад з репозиторію |
Структура проекту
Коли проект створиться, то в "Workspaces" створяться дві теки "mtb_shared" з бібліотеками, які будуть доступні всім проектам в цьому "Workspaces" та тека, власне, з самим проектом. В нашому випадку це "PSoC4_Hello_World":
|
| Структура проекту |
- mtb_shared - тека з бібліотеками, які доступні будь якому проекту в цьому workspaces
- pdl (peripheral driver library) та hal (high abstraction level) бібліотеки
- PSoC4_Hello_World - тека з проектом який ми створили
- COMPONENT_CUSTOM_DESING_MODUS - тека яка стосується утіліти Device Manager. Про це в наступних статтях.
- Файл main.c - тут і будемо дивитись/писати код
- Панель швидкого доступу. Ознайомимиось з нею нижче.
Панель швидкого доступу
Для кожного проекту в "workspaces" викликається своя панель швидкого доступу. Де можна швидко знайти всі необхідні речі для роботи над цим проектом:
|
| Панель швидкого доступу |
- Побудувати і очистити проект
- Запустити відладку або просто залити прошивку за допомоги Jlink або KitProg3
- Викликати утіліти, наприклад Library Manager, Device Configurator, тощо
-
Та швидкий доступ до документації на саму дошку розробника, всіх
бібліотек, що дуже зручно
Приклад Hello World
Подвійним кліком на файлі main.c відкриємо файл на редагування, та перш за все, пропоную побудувати проект, натиснувши в панелі швидкого доступу "Quick panel" -> "Build PSoC4_Hello_World Application". Це для того щоб переконатись що з проектом все гаразд і всі файли створились як слід, та щоб всі інклюди, змінні, функції, дефайни і таке інше проіндесувались. Як приклад зібрався без помилок, тиснемо на панелі швидкого доступу "PSoC4_Hello_World program (KitProg3_MiniProg4)". Прошивка заллється до мікроконтролеру і почне працювати. В серіал порт один раз надішлеться текстове повідомлення "Hello World", та почне блимати набортний світлодіод.
Сам файл main.c виглядає так. Він, приклад, побудований на бібліотеці PDL, більш низького рівня чим HAL бібліотека.
/****************************************************************************** * File Name: main.c * * Description: This is the source code for the PSoC 4 MCU Hello World Example * for ModusToolbox. * * Related Document: See README.md * ******************************************************************************* * (c) 2020, Cypress Semiconductor Corporation. All rights reserved. ******************************************************************************* * This software, including source code, documentation and related materials * ("Software"), is owned by Cypress Semiconductor Corporation or one of its * subsidiaries ("Cypress") and is protected by and subject to worldwide patent * protection (United States and foreign), United States copyright laws and * international treaty provisions. Therefore, you may use this Software only * as provided in the license agreement accompanying the software package from * which you obtained this Software ("EULA"). * * If no EULA applies, Cypress hereby grants you a personal, non-exclusive, * non-transferable license to copy, modify, and compile the Software source * code solely for use in connection with Cypress's integrated circuit products. * Any reproduction, modification, translation, compilation, or representation * of this Software except as specified above is prohibited without the express * written permission of Cypress. * * Disclaimer: THIS SOFTWARE IS PROVIDED AS-IS, WITH NO WARRANTY OF ANY KIND, * EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, NONINFRINGEMENT, IMPLIED * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. Cypress * reserves the right to make changes to the Software without notice. Cypress * does not assume any liability arising out of the application or use of the * Software or any product or circuit described in the Software. Cypress does * not authorize its products for use in any products where a malfunction or * failure of the Cypress product may reasonably be expected to result in * significant property damage, injury or death ("High Risk Product"). By * including Cypress's product in a High Risk Product, the manufacturer of such * system or application assumes all risk of such use and in doing so agrees to * indemnify Cypress against all liability. *******************************************************************************/ /******************************************************************************* * Include header files ******************************************************************************/ #include "cy_pdl.h" #include "cybsp.h" /******************************************************************************* * Macros *******************************************************************************/ #define LED_DELAY_MS (500u) #define CY_ASSERT_FAILED (0u) /******************************************************************************* * Function Name: main ******************************************************************************** * Summary: * System entrance point. This function performs * - initial setup of device * - configure the SCB block as UART interface * - prints out "Hello World" via UART interface * - Blinks an LED under firmware control at 1 Hz * * Parameters: * none * * Return: * int * *******************************************************************************/ int main(void) { cy_rslt_t result; cy_stc_scb_uart_context_t CYBSP_UART_context; /* Initialize the device and board peripherals */ result = cybsp_init(); /* Board init failed. Stop program execution */ if (result != CY_RSLT_SUCCESS) { CY_ASSERT(CY_ASSERT_FAILED); } /* Configure and enable the UART peripheral */ Cy_SCB_UART_Init(CYBSP_UART_HW, &CYBSP_UART_config, &CYBSP_UART_context); Cy_SCB_UART_Enable(CYBSP_UART_HW); /* Enable global interrupts */ __enable_irq(); /* Send a string over serial terminal */ Cy_SCB_UART_PutString(CYBSP_UART_HW, "Hello world\r\n"); for(;;) { /* Toggle the user LED state */ Cy_GPIO_Inv(CYBSP_USER_LED1_PORT, CYBSP_USER_LED1_PIN); /* Wait for 0.5 seconds */ Cy_SysLib_Delay(LED_DELAY_MS); } } /* [] END OF FILE */
Пропоную ознайомитись з задіяними в цьому прикладі функціями та структурами. Як побудоване налаштування пінів і периферії. Спробувати внести в приклад свої зміни. Ознайомитись з результатами, своїх внесків в код, шляхом заливки оновленої прошивки.
Ще я підготував відео в підтримку до цієї статті, де покажу як встановити "ModusToolBox", створю пустий проект, та напишу більш цікавий приклад мікроконтролерного "Hello World", за допомоги, вже, HAL бібліотек.
