.. include:: /include/include.rst
.. include:: /include/include-l0.rst
.. include:: /include/include-description.rst

|donate-button|

************************
DCC-EX Model Railroading 
************************

.. grid::  1 1 1 2
  :gutter: 2
  :margin: 0
  :padding: 1

  .. grid-item-card:: 
    :columns: 12 12 12 8
    :class-card: sd-shadow-md sd-rounded-3 sd-width-auto

    |DCC-EX| is a team of dedicated enthusiasts producing open source **DCC** and **DC solutions** to run your entire model railroad layout. 
    
    Our easy to use, **ready-to-run** and **do-it-yourself** products use *either* our own custom hardware *or* off-the-shelf Arduino and similar technology. 
    
    Our **free and open source** :doc:`EX-CommandStation software </ex-commandstation/index>` is supported by numerous third party hardware and apps like |JMRI|, |Engine Driver|, |WiThrottle|, Rocrail and more. 
    
    **Our mission** is to provide free and open source software and hardware designs to make model railroading accessible and affordable to everyone. Read more about our entire "EX"-osystem of offerings in the following pages.

  .. grid-item-card:: 
    :columns: 12 12 12 4
    :class-card: sd-shadow-md sd-rounded-3 sd-width-auto sd-text-center

    EX-CommandStation Releases
    ^^^
    
    .. rst-class:: dcclink

      :dcc-ex-text-size-60pct:`Automated:` :ref:`EX-Installer <download/ex-commandstation:EX-Installer>` 
      
      :dcc-ex-text-size-60pct:`Manual:` :ref:`Prod <download/ex-commandstation:latest ex-commandstation official release>` , :ref:`Devel <download/ex-commandstation:latest ex-commandstation unreleased development version>`

  .. grid-item-card:: 
    :columns: 12 12 12 7
    :class-card: sd-shadow-md sd-rounded-3 sd-width-auto

    If you are just starting with |DCC-EX| then the sections will help you understand how our products might suit your needs:

    - :ref:`begin/what-to-know:What is EX-CommandStation?`
    - :doc:`/begin/comparison`
    - :ref:`begin/what-to-know:what is dcc?`
    - :ref:`I just want to run DCC trains <begin/what-to-know:i just want to run my trains>`
    - :ref:`begin/what-to-know:We do DC as well!`
    - :ref:`I'm interested in DCC but have a limited budget <begin/what-to-know:i'm interested in dcc but have a limited budget>`
    - :ref:`I want to operate my turnout/points & run DCC trains <begin/what-to-know:i want to operate my turnouts/points and run trains>`
    - :ref:`I want to control accessories & run DCC trains <begin/what-to-know:i want to control all my accessories and run trains>`
    - :ref:`begin/what-to-know:i want some extra automated/animated realism`
    - :ref:`begin/what-to-know:i want a fully automated exhibition layout for my club`

    If these haven't helped, or you've read them and you are still unsure, then feel free to contact us, preferably through our :ref:`Discord server <support/index:preferred option - discord>` where you can chat directly with our team members. Details of this and other contact methods on our :doc:`/support/contact-us` page. 

  .. grid-item-card:: 
    :columns: 12 12 12 5
    :class-card: sd-shadow-md sd-rounded-3 sd-width-auto
    :img-top: /_static/images/logos/product-logo-news-cropped.png 
    
    .. postlist:: 2
      :format: {date} - {title}
      :date: %d %b %Y
      :list-style: none
      :excerpts:
      :expand: Continue reading...

    Read the full DCC-EX News feed `here <news.html>`_. :dcc-ex-text-size-80pct:`RSS/Atom feed - Subscribe with "https://dcc-ex.com/news/atom.xml"`.

  .. grid-item-card:: 
    :columns: 12
    :class-card: sd-shadow-md sd-rounded-3 sd-width-auto

    Where to next?
    ^^^
    
    It is important to understand that our different |DCC-EX| products, and options within those products, are targeted to different levels of users. From those who don't know anything about electronics or software, through to those with more extensive knowledge and experience. 
    
    We have tagged the pages of this website with helpful icons to help you understand who they are aimed at.  The :doc:`/begin/levels` page explains those levels. Keep an eye out on our pages to see at which level of experience each section of our documentation is aimed towards.

.. toctree::
   :hidden:
   :maxdepth: 4

   begin/what-to-know
   begin/levels

.. toctree::
   :hidden:
   :maxdepth: 4
   :caption: Products

   ex-commandstation/index
   ex-installer/index
   ex-webthrottle/index
   EX-CSB1 Express <ex-csb1/index>
   EX-MotorShield8874 <reference/hardware/motorboards/ex-motor-shield-8874>
   EX-WiFiShield-8266 <reference/hardware/wifi-boards/ex-wifi-shield-8266>
   ex-dccinspector/index
   ex-toolbox/index

.. toctree::
   :hidden:
   :maxdepth: 4
   :caption: EX-CommandStation Add-Ons

   exrail/index
   trackmanager/index
   ex-turntable/index
   ex-ioexpander/index
   ex-fastclock/index

.. toctree::
   :hidden:
   :maxdepth: 4
   :caption: Support & Info

   support/index
   throttles/index
   big-picture/index

.. toctree::
   :hidden:
   :maxdepth: 4
   :caption: Downloads

   download/index

.. toctree::
   :hidden:
   :maxdepth: 4
   :caption: Purchasing & Merchandise

   purchasing/dealers
   reference/accessories/index
   merchandise/index

.. toctree::
   :hidden:
   :maxdepth: 4
   :caption: Detailed Information

   reference/index
   under-development/index
   projects/index

.. toctree::
   :hidden:
   :maxdepth: 4
   :caption: External References

   external-references/index
   external-references/standards
   reference/accessories/index

.. toctree::
   :hidden:
   :maxdepth: 4
   :caption: The DCC-EX Project

   About Us and the Project<about/index>
   about/index-contributing