From f10999fb6349251712aae9035ce240337a117523 Mon Sep 17 00:00:00 2001
From: klassents <klassen@elron.tech>
Date: Tue, 28 Jan 2025 07:27:36 +0300
Subject: [PATCH] =?UTF-8?q?=D0=9E=D0=B1=D0=BD=D0=BE=D0=B2=D0=B8=D1=82?=
 =?UTF-8?q?=D1=8C=20docs/elsomik=5Fdescription.md?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/elsomik_description.md | 67 ++++++++++++++++++++++++++++++++++++-
 1 file changed, 66 insertions(+), 1 deletion(-)

diff --git a/docs/elsomik_description.md b/docs/elsomik_description.md
index d72fbd1..9db6333 100644
--- a/docs/elsomik_description.md
+++ b/docs/elsomik_description.md
@@ -1 +1,66 @@
-бу
\ No newline at end of file
+# Elsomik
+Особенности работы с платой Elsomik в среде программирования ArduinoIDE.
+### Функциональное назначение выводов  
+Ниже представлен вид платы снизу:
+![elsomik_pinout.png](elsomik_pinout.png)
+
+### Загрузка скетчей
+!!!!!
+
+### Цифровые выводы
+Выводы на плате Elsomik пронумерованы в соответствии с их принадлежностью к определенному GPIO-порту и конкретному пину внутри порта. Чтобы использовать цифровой вывод, необходимо передать в функцию номер порта и номер пина в формате `P0_1`, где "0" — это номер порта, а "1" — номер пина внутри порта. Например, для инициализации вывода 5 порта 1 на выход необходимо вызвать функцию `pinMode(P1_5, OUTPUT)`.  
+Для использования доступны следующие выводы: `P0_0 ... P0_15, P1_0 ... P1_15, P2_6, P2_7`. Выводы `P0_11 ... P0_15` на плате обозначены иначе, ниже представлена таблица соответствия:  
+|Обозначение на плате|Номер вывода|
+|---------|---------|
+|TDI|P0_11|
+|TCK|P0_12|
+|TMS|P0_13|
+|TRST|P0_14|
+|TDO|P0_15|
+
+### АЦП
+На плате доступно 8 выводов, которые можно использовать в качестве каналов АЦП. Для работы с ними в функцию `analogRead()` необходимо передать номер канала или номер соответствующего цифрового вывода. Доступные каналы и их соответствие номерам выводов платы:  
+  
+|Цифровой вывод|Номер канала АЦП|
+|---------|---------|
+|P1_5|A0|
+|P1_7|A1|
+|P0_2|A2|
+|P0_4|A3|
+|P0_7|A4|
+|P0_9|A5|
+|P0_11|A6|
+|P0_13|A7|  
+#### ШИМ  
+На плате Elsomik в ArduinoIDE доступно 8 выводов для формирования ШИМ-сигнала. Генерация сигнала осуществляется с помощью 32-битного таймера. Выводы, подключенные к одному и тому же таймеру, выдают ШИМ-сигнал одинаковой частоты.  
+Доступные выводы:  
+  
+|Цифровой вывод|Используемый таймер|
+|---------|---------|
+|P0_0|таймер 1|
+|P0_1|таймер 1|
+|P0_2|таймер 1|
+|P0_3|таймер 1|
+|P1_0|таймер 2|
+|P1_1|таймер 2|
+|P1_2|таймер 2|
+|P1_3|таймер 2|  
+  
+При использовании SPI формирование ШИМ сигнала на выводах P1_0 ... P1_3 недоступно.  
+### Прерывания  
+На плате Elsomik доступно 8 прерываний, настраиваемых функцией `void attachInterrupt(uint8_t interruptNum, void (*userFunc)(void), int mode)`:  
+  
+|Цифровой вывод|Номер прерывания|
+|---------|---------|
+|P0_4|0|
+|P0_9|1|
+|P0_10|2|
+|P0_15|3|
+|P1_6|4|
+|P1_9|5|
+|P1_12|6|
+|P1_15|7|  
+
+### Serial
+Интерфейс UART0 доступен на выводах P0_5, P0_6, для работы с ним используется экземпляр класса под названием `Serial`.  
+Интерфейс UART1 доступен на выводах P1_8, P1_9, используемый экземпляр класса - `Serial1`.  
\ No newline at end of file