doc: add info about each component, add info on some strapping pins

and3rson · Apr 15, 2024 · 15a072c · 15a072c
1 parent 7c2b139
commit 15a072c
Show file tree

Hide file tree

Showing 18 changed files with 236 additions and 1 deletion.
diff --git a/docs/assembly/components.rst b/docs/assembly/components.rst
@@ -126,7 +126,7 @@
    * - 1
      - U2
      - 280x240 1.69\" TFT
-     - 1.7\" TFT Display (ST7789)
+     - 1.7\" IPS TFT Display (ST7789)
      - `arduino.ua <https://arduino.ua/prod6568-tft-displei-1-7-spi-240x280-rgb>`__
      - 176
      -

diff --git a/docs/assembly/every_component.rst b/docs/assembly/every_component.rst
diff --git a/docs/assembly/images/buzzer.png b/docs/assembly/images/buzzer.png
diff --git a/docs/assembly/images/dac.png b/docs/assembly/images/dac.png
diff --git a/docs/assembly/images/display.png b/docs/assembly/images/display.png
diff --git a/docs/assembly/images/divider.png b/docs/assembly/images/divider.png
diff --git a/docs/assembly/images/extension.png b/docs/assembly/images/extension.png
diff --git a/docs/assembly/images/mcu.png b/docs/assembly/images/mcu.png
diff --git a/docs/assembly/images/regulator.png b/docs/assembly/images/regulator.png
diff --git a/docs/assembly/images/reset.png b/docs/assembly/images/reset.png
diff --git a/docs/assembly/images/sdcard.png b/docs/assembly/images/sdcard.png
diff --git a/docs/assembly/images/switching.png b/docs/assembly/images/switching.png
diff --git a/docs/assembly/images/usb.png b/docs/assembly/images/usb.png
diff --git a/docs/assembly/index.rst b/docs/assembly/index.rst
@@ -12,3 +12,4 @@
 
     configurations
     components
+    every_component
diff --git a/docs/faq/hardware.rst b/docs/faq/hardware.rst
@@ -30,3 +30,19 @@
 Враховуючи, що (станом на момент написання цього документу) SD-карта працює на частоті 25 МГц, читання файлу розміром 1 МБ з SD-карти за ідеальних умов займе менше однієї секунди!
 
 Тому, якщо ви пишете гру, яка завантажує текстури чи звуки з SD-карти, просто завантажте їх у пам'ять PSRAM один раз при запуску гри і надалі працюйте з ними вже з пам'яті, не взаємодіючи з SD-картою.
+
+Чому ви не вивели `GPIO35`, `GPIO36` та `GPIO37` на роз'єм розширення?
+----------------------------------------------------------------------
+
+Ці піни можна використовувати лише в деяких (менш потужних) варіантах ESP32-S3-WROOM.
+
+В ESP32-S3-WROOM-N16R8, який використовується в Лілці, ці піни використовуються для внутрішіх потреб (а точніше - для спілкування мікроконтролера ESP32-S3 з пам'яттю PSRAM).
+
+Тому використовувати їх для будь-яких інших цілей заборонено.
+
+Чому ви не вивели `GPIO45` на роз'єм розширення?
+------------------------------------------------
+
+`GPIO45` - це один з так званих "strapping" пінів, які використовуються для вибору режиму завантаження мікроконтролера та інших налаштувань.
+
+Використання цього піна небезпечне, оскільки він встановлює режим напруги SPI-шини. Тому ми вирішили не виводити його на роз'єм розширення, щоб уникнути можливих проблем та потенційних пошкоджень пристрою.
diff --git a/docs/hardware/mcu.rst b/docs/hardware/mcu.rst
@@ -1,3 +1,5 @@
+.. _mcu:
+
 Мікроконтролер
 ==============
 

diff --git a/docs/keira/sdcard.rst b/docs/keira/sdcard.rst
@@ -1,3 +1,5 @@
+.. _sdcard:
+
 Карта microSD
 =============
 

diff --git a/docs/manual/extension.rst b/docs/manual/extension.rst
@@ -1,3 +1,5 @@
+.. _extension:
+
 Роз'єм розширення
 =================