axon-mini: add initial documentation and homepage

source/_static/js/clarity.js

@@ -0,0 +1,5 @@
+(function(c,l,a,r,i,t,y){
+    c[a]=c[a]||function(){(c[a].q=c[a].q||[]).push(arguments)};
+    t=l.createElement(r);t.async=1;t.src="https://www.clarity.ms/tag/"+i;
+    y=l.getElementsByTagName(r)[0];y.parentNode.insertBefore(t,y);
+})(window, document, "clarity", "script", "xtw38brdfp");

source/conf.py

@@ -98,7 +98,7 @@ def bgcolor_role(name, rawtext, text, lineno, inliner, options={}, content=[]):
 
 # Set templates and exclude patterns
 templates_path = ["_templates"]
-exclude_patterns = ["_build"]
+exclude_patterns = ["_build", "vicharak_sbcs/axon-lite/axon-lite-linux/linux-development-guide", "vicharak_sbcs/axon-lite/axon-lite-linux/linux-configuration-guide", "vicharak_sbcs/axon-lite/axon-lite-accessories/fan.rst"]
 
 # HTML settings
 html_theme = "sphinxawesome_theme"
@@ -109,6 +109,10 @@ def bgcolor_role(name, rawtext, text, lineno, inliner, options={}, content=[]):
     "css/fonts.css",
     "css/custom.css",
 ]
+# JS files to include
+html_js_files = [
+    "js/clarity.js",
+]
 # Theme options
 html_theme_options = {
     # sphinxawesome_theme options
@@ -136,4 +140,4 @@ def bgcolor_role(name, rawtext, text, lineno, inliner, options={}, content=[]):
 #    "images/favicon.ico",
 #    "images/mstile-150x150.png",
 #    "images/safari-pinned-tab.svg",
-#]
+#]

source/index.rst

@@ -12,18 +12,24 @@
 Welcome to Vicharak's documentation!
 ####################################
 
-Vicharak brings to you the powerful rk3399 based Vaaman and the highly advanced rk3588 based Axon single-board computers (SBCs).
-Designed for both hobbyists and professionals, these SBCs offer unparalleled performance and versatility for a wide range of
-applications including IoT, AI and multimedia processing.
+Vicharak offers a comprehensive range of single-board computers (SBCs) across the Vaaman and Axon families, powered by leading processors including the RK3399, RK3588, RK3576, and QCS6490. Designed for both hobbyists and professionals, our SBCs deliver exceptional performance and versatility for applications spanning IoT, AI/ML, embedded systems, and multimedia processing.
 
 .. |vaaman_top| image:: _static/images/rk3399-vaaman/Vaaman-top.webp
-   :width: 100%
+   :width: 80%
    :alt: vaaman top
 
 .. |axon_top| image:: _static/images/rk3588-axon/axon-top.webp
-   :width: 100%
+   :width: 80%
    :alt: axon top
 
+.. |axon_lite_top| image:: _static/images/rk3576-axon-lite/axon-lite-top.webp
+   :width: 80%
+   :alt: axon lite top
+
+.. |axon_mini_top| image:: _static/images/qcs6490-axon-mini/axon-mini-back.webp
+   :width: 80%
+   :alt: axon mini top
+
 .. grid:: 1 1 2 2
 
     .. grid-item-card:: Vaaman SBC
@@ -40,6 +46,20 @@ applications including IoT, AI and multimedia processing.
 
        |axon_top|
 
+    .. grid-item-card:: Axon Lite SBC
+       :link: vicharak_sbcs/axon-lite/axon-lite-home
+       :link-type: doc
+       :shadow: md
+
+       |axon_lite_top|
+
+    .. grid-item-card:: Axon Mini SBC
+       :link: vicharak_sbcs/axon-mini/axon-mini-home
+       :link-type: doc
+       :shadow: md
+
+       |axon_mini_top|
+
 .. toctree::
    :glob:
    :caption: Contents
@@ -48,6 +68,8 @@ applications including IoT, AI and multimedia processing.
 
    Vaaman SBC <vicharak_sbcs/vaaman/vaaman-home>
    Axon SBC <vicharak_sbcs/axon/axon-home>
+   Axon Lite SBC <vicharak_sbcs/axon-lite/axon-lite-home>
+   Axon Mini SBC <vicharak_sbcs/axon-mini/axon-mini-home>
 
 .. toctree::
    :glob:
@@ -56,6 +78,8 @@ applications including IoT, AI and multimedia processing.
 
    Vaaman Downloads <vicharak_sbcs/vaaman/vaaman-downloads>
    Axon Downloads <vicharak_sbcs/axon/axon-downloads>
+   Axon Lite Downloads <vicharak_sbcs/axon-lite/axon-lite-downloads>
+   Axon Mini Downloads <vicharak_sbcs/axon-mini/axon-mini-downloads>
 
 .. toctree::
    :glob:
@@ -64,6 +88,8 @@ applications including IoT, AI and multimedia processing.
 
    Vaaman Accessories <vicharak_sbcs/vaaman/vaaman-accessories> 
    Axon Accessories <vicharak_sbcs/axon/axon-accessories>
+   Axon Lite Accessories <vicharak_sbcs/axon-lite/axon-lite-accessories>
+   Axon Mini Accessories <vicharak_sbcs/axon-mini/axon-mini-accessories>
 
 .. toctree::
    :glob:

source/vicharak_sbcs/axon-lite/audio/analog.rst

@@ -0,0 +1,276 @@
+#################
+Analog MIC
+#################
+
+.. image:: /_static/images/rk3576-axon-lite/axon-lite-audio-connectors.webp
+   :width: 70%
+
+The Analog MIC input on the Axon Lite board provides a flexible interface for acoustic sensing using a broad class of analog microphone technologies. Axon Lite provides support for mics of different types and companies, preserving dynamic range while minimizing noise.
+
+Wiring and connectors
+----------------------
+
+- Connector Type : (Wire To board) JST
+- MPN : WAFER-125L-2A
+- Pin : 2 Pin
+- Pitch : 1.25mm
+- Current rating (max): 1A each pin
+
+Axon Lite supports an **Analog differential mic**.
+
+.. note::
+   If you want to use an analog single-ended microphone, connect the positive point to the positive pin of the mic connector and the negative point to ground.
+
+For Single ended mic: `Reference Mic To Buy <https://robu.in/product/microphone-97mm-pack-of-3/>`_
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+* Mic output → ANALOG_MIC pin (+)
+* Mic ground → GND (GPIO GND) on `Axon Lite Header <https://docs.vicharak.in/vicharak_sbcs/axon-lite/axon-lite-gpio-description>`_
+
+For Differential mic:
+^^^^^^^^^^^^^^^^^^^^^^
+* Mic output → ANALOG_MIC pin (+)
+* Mic ground → ANALOG_MIC pin (-)
+
+How to Setup
+------------
+
+Follow these steps to connect and use an analog microphone with the Axon Lite board.
+
+1. Connect the microphone
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Connect your microphone to the Axon Lite board:
+
+* If you are using single interface mic, just connect MIC_OUT to ANALOG_MIC PIN (+) and Microphone ground → Axon Lite GND (Connect to GPIO GND)
+* Otherwise if you are using differential mic, connect MIC_OUT to ANALOG_MIC PIN (+) and MIC_GND to ANALOG_MIC PIN (-)
+
+Refer to the Axon Lite pinout documentation for exact pin locations `Axon Lite Pinouts <https://docs.vicharak.in/vicharak_sbcs/axon-lite/axon-lite-gpio-description>`_
+
+2. Detect the microphone
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+Boot the Axon Lite board and open a terminal.
+
+Run:
+
+.. code-block:: bash
+
+   arecord -l
+
+This will list available recording devices.
+
+Example output:
+
+.. code-block:: text
+
+      vicharak@vicharak:~$ aplay -l
+    **** List of PLAYBACK Hardware Devices ****
+    card 0: rockchipes8388 [rockchip-es8388], device 0: dailink-multicodecs ES8323 HiFi-0 [dailink-multicodecs ES8323 HiFi-0]
+      Subdevices: 1/1
+      Subdevice #0: subdevice #0
+
+* Look for rockchipes8388, it contains **ES8388** which is an analog audio codec chip, which handles: audio. 
+* Note down the device and card number to be used in below commands
+
+* In this example: ``card 0, device 0 → plughw:0,0`` is used 
+
+3. Record Audio from Microphone
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Prerequisites
+"""""""""""""
+
+Ensure:
+
+* Microphone is properly connected to the SBC
+* ALSA utilities are installed
+
+Install if needed:
+
+.. code-block:: bash
+
+   sudo apt install alsa-utils
+
+Step 1: Record Audio
+""""""""""""""""""""
+
+Record audio using:
+
+.. code-block:: bash
+
+   arecord -D plughw:0,0 -f S16_LE -r 16000 -c 1 test.wav
+
+Parameter Explanation
+,,,,,,,,,,,,,,,,,,,,,
+
+.. list-table::
+   :header-rows: 1
+   :widths: 20 60
+
+   * - Parameter
+     - Meaning
+   * - ``-D plughw:0,0``
+     - Select microphone device
+   * - ``-f S16_LE``
+     - 16-bit signed little-endian format
+   * - ``-r 16000``
+     - Sampling rate (16 kHz)
+   * - ``-c 1``
+     - Mono recording
+   * - ``test.wav``
+     - Output file
+
+Step 2: Stop Recording
+""""""""""""""""""""""
+
+Press:
+
+.. code-block:: text
+
+   Ctrl + C
+
+The audio will be saved as ``test.wav``
+
+Step 3: Playback Recorded Audio
+"""""""""""""""""""""""""""""""
+
+Verify recording:
+
+.. code-block:: bash
+
+   aplay test.wav
+
+Recommended Settings for Speech Applications
+"""""""""""""""""""""""""""""""""""""""""""""
+
+Use:
+
+.. code-block:: bash
+
+   arecord -D plughw:0,0 -f S16_LE -r 16000 -c 1 speech.wav
+
+This configuration is ideal for:
+
+* Speech recognition
+* Voice assistants
+* Embedded AI applications
+
+
+Notes
+,,,,,
+
+* Use ``plughw`` instead of ``hw`` to allow automatic format conversion
+* 16 kHz mono is sufficient for most voice applications
+* Higher sample rates (e.g., 44100 Hz) may be used for higher quality audio
+
+Example:
+
+.. code-block:: bash
+
+   arecord -D plughw:0,0 -f S16_LE -r 44100 -c 2 audio.wav
+
+
+Troubleshooting
+---------------
+
+Quick Diagnostic Commands
+^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+List supported hardware parameters:
+
+.. code-block:: bash
+
+   arecord -D hw:0,0 --dump-hw-params
+
+Check microphone levels:
+
+.. code-block:: bash
+
+   alsamixer
+
+Press ``F4`` → Capture devices
+
+Increase capture volume if needed.
+
+---
+
+No audio detected
+^^^^^^^^^^^^^^^^^
+
+Check the following:
+
+* Microphone is connected correctly
+* Ground connection is secure
+* Microphone output is connected to MIC input
+* Device is visible using:
+
+  .. code-block:: bash
+
+     arecord -l
+
+* Capture volume is not muted:
+
+  .. code-block:: bash
+
+     alsamixer
+
+  Press F4 and increase Capture volume.
+
+---
+
+Low audio volume
+^^^^^^^^^^^^^^^^
+
+Possible solutions:
+
+* Increase microphone gain using:
+
+  .. code-block:: bash
+
+     alsamixer
+
+* Use a microphone module with built-in amplifier
+* Move closer to the microphone
+
+---
+
+Excessive noise or interference
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Check the following:
+
+* Ensure proper grounding
+* Keep microphone wires short
+* Avoid routing microphone wires near power or digital signal lines
+* Use shielded cables if necessary
+
+---
+
+Hum or buzzing sound
+^^^^^^^^^^^^^^^^^^^^
+
+Possible causes:
+
+* Ground loop issues
+* Poor shielding
+* Electrical interference from nearby components
+
+Solutions:
+
+* Ensure common ground between microphone and Axon Lite
+* Use shielded microphone cable
+* Keep microphone away from power sources and high-frequency components
+
+---
+
+Verification Checklist
+----------------------
+
+Ensure the following:
+
+* Microphone is securely connected
+* Microphone appears in ``arecord -l``
+* Audio recording works using ``arecord``
+* Audio playback works using ``aplay``
+* Capture volume is properly set using ``alsamixer``