test for lab1 action

Author: DmtkD

.github/workflows/Lab_01_CI.yml

@@ -1,29 +1,37 @@
-name: Lab_01
+name: Cheking of compile Arduino sketch for AVR/AtMega and ESP8266
 
-on: [push, pull_request]
+on:
+  push:
+    branches: [ main, master ]
+  pull_request:
+    branches: [ main, master ]
 
 jobs:
   test-matrix:
     strategy:
       matrix:
-        arduino-platform: ["arduino:samd", "arduino:avr"]
+        arduino-platform:
+          - "arduino:avr"
+          - "esp8266:esp8266"
         include:
           - arduino-platform: "arduino:avr"
-            fqbn: "arduino:avr:unowifi"
+            fqbn: "arduino:avr:mega"
+          - arduino-platform: "esp8266:esp8266"
+            fqbn: "esp8266:esp8266:generic"
 
     runs-on: ubuntu-22.04
 
     steps:
-      - name: Checkout
+      - name: Checkout code
         uses: actions/checkout@v4
 
-      - name: Setup Arduino CLI
-        uses: arduino/setup-arduino-cli@v1
+      - name: Set up Arduino CLI
+        uses: arduino/setup-arduino-cli@v2
 
       - name: Install platform
         run: |
           arduino-cli core update-index
           arduino-cli core install ${{ matrix.arduino-platform }}
 
       - name: Compile Sketch
-        run: arduino-cli compile --fqbn ${{ matrix.fqbn }} ./mc_labs/mc_lab_01/mc_lab_01.ino
+        run: arduino-cli compile --fqbn ${{ matrix.fqbn }} ./mc_labs/mc_lab_01/*.ino

README.md

@@ -1,17 +1,84 @@
-Introduction to Embedded Systems: Using ANSI C and the Arduino Development Environment. 
 
-Slack: https://app.slack.com/huddle/T277SDD26/C9P6S41DH
+# 🛠️ Мікроконтролери частина 1 (Інструкція для студентів)
 
-Proteus IoT lib:
-https://github.com/LPNU-IoT/proteus-wemosd1-lib
+## 📚 Про предмет
 
-Recomended material:
+**Мікроконтролери частина 1** — це курс, на якому студенти вивчають основи роботи з мікроконтролерами (MCU), їх переваги, особливості та подальші напрямки розвитку в Embedded Systems, System Engineering та інших сферах. Курс забезпечує базові знання для просування в галузі.
 
-https://www.jimfiore.org/Books.html
-https://docs.arduino.cc/
-https://www.arduino.cc/reference/en/
-https://docs.arduino.cc/hardware/mega-2560/
-https://arduino.github.io/arduino-cli/0.35/
+## 📁 Структура репозиторія
 
-Simulation example:
-https://wokwi.com/projects/391005481372432385
+Цей репозиторій має наступну структуру:  
+├── `REPOSITORY_OF_COURSE`  
+   ├── **.github/workflows** — папка з GitHub Actions, що автоматично перевіряє ваш код. 🚀  
+   ├── **labs** — папка з лабораторними роботами, в якій містяться всі необхідні. 🔬  
+   ├── **lectures** — папка з лекціями. 📘  
+   └── **README.md** — дана інструкція. 📄
+
+> **🚨 УВАГА!**  
+> Папку `.github/workflows` категорично заборонено змінювати.  
+> Будь-які зміни в цій папці можуть призвести до автоматичного зниження балу за лабораторну роботу. ⚠️
+
+## 🛠️ Як працювати з репозиторієм
+
+1. **Створення гілки**: Для виконання кожної нової лабораторної роботи створіть окрему гілку від основної гілки `main` або `master` за наступним принципом:
+   ```bash
+   git clone ${this_repository}
+   git branch --list
+   >>> main (active branch)
+   git checkout -b ${student_surname_name}/labX  
+     
+   `X` — номер лабораторної роботи.  
+   `student_surname_name` — Прізвища та ім'я студента  
+   ``` 
+
+  
+2. **Робота з лабораторними роботами**: Помістіть вашу лабораторну роботу в відповідну папку у вашій гілці, яка буде називатися `labX`, де `X` знову номер лабораторної.
+
+3. **Пул-реквест**: Щоб відправити вашу лабораторну роботу на перевірку, створіть пул-реквест на основну гілку (`main` або `master`) та чекайте, поки GitHub Actions виконає перевірку. 🔄
+
+## ✅ Критерії перевірки
+
+Ваш код буде перевірятися за наступними критеріями:
+
+1. **Компільованість**: Код має успішно компілюватися. 💻
+2. **Стиль коду**: Код має відповідати заданому стилю написання. ✍️
+3. **Чистота коду**: Код не має містити зайвого сміття, яке не використовується. 🧹
+
+> Якщо під час перевірки буде виявлено помилки за цими критеріями, вам потрібно їх виправити і знову запушити зміни у вашу гілку. Лабораторні роботи, які не пройшли перевірку, не будуть прийняті до перевірки. ❌
+
+## 📝 Додаткові зауваження
+
+- Будь ласка, уважно дотримуйтеся всіх інструкцій і не змінюйте конфігурацію GitHub Actions.
+- Переконайтеся, що ви уважно прочитали всі інструкції в лабораторних роботах та дотримуєтеся їх.
+- Всі лабораторні роботи повинні бути виконані та подані в межах термінів, визначених у плані курсу. ⏳
+
+## ❓ Часті питання (FAQ)
+
+- **Що робити, якщо я отримав помилку у перевірці?**  
+  Виправте помилки відповідно до повідомлень в GitHub Actions і знову запуште зміни. 🔧
+
+- **Як створити пул-реквест?**  
+  Ви можете знайти детальні інструкції у [документації GitHub](https://docs.github.com/en/pull-requests). 📚
+
+- **Куди звертатися за допомогою?**  
+  Якщо у вас є питання або проблеми, звертайтеся до викладача або на форум курсу. 🗣️
+
+### Бажаємо успіхів у навчанні! 🚀
+
+
+> Introduction to Embedded Systems: Using ANSI C and the Arduino Development Environment. 
+> 
+> Slack: https://app.slack.com/huddle/T277SDD26/C9P6S41DH
+>
+> Proteus IoT lib:
+> https://github.com/LPNU-IoT/proteus-wemosd1-lib
+> 
+> **Recomended material:**
+> 1. https://www.jimfiore.org/Books.html
+> 2. https://docs.arduino.cc/
+> 3. https://www.arduino.cc/reference/en/
+> 4. https://docs.arduino.cc/hardware/mega-2560/
+> 5. https://arduino.github.io/arduino-cli/0.35/
+> 
+> Simulation example:
+> https://wokwi.com/projects/391005481372432385