diff --git a/boards/beaglev/fire/demos-and-tutorials/gateware/comms-cape-gateware-usage.rst b/boards/beaglev/fire/demos-and-tutorials/gateware/comms-cape-gateware-usage.rst index 0dd4a6da6df67fbff75692846ff2fc6451d949af..f727f5d61dd928f7720b26eb96c29bacd85aebd4 100644 --- a/boards/beaglev/fire/demos-and-tutorials/gateware/comms-cape-gateware-usage.rst +++ b/boards/beaglev/fire/demos-and-tutorials/gateware/comms-cape-gateware-usage.rst @@ -13,10 +13,16 @@ The comms cape provides an array of communication protocols including Cape schematics, layout, and mechanicals **************************************** -For the schematics, layout, and mechanicals of the cape, please refer to the `Comms Cape <https://openbeagle.org/beagleboard/capes/-/tree/master/beaglebone/Comms>`_ repository. +For the schematics, layout, and mechanicals of the cape, please refer to :ref:`industrial-comms-cape`. -Usage in Linux -************** +Usage +***** + +Firstly, the comms cape gateware must be compiled and updated on the beagleV-Fire. This can be done by using the `build-bitstream.py` script in the gateware repository with the `cape_comms.yaml` build option file. + +.. code-block:: + + python3 build-bitstream.py build-options/cape_comms.yaml CAN === diff --git a/boards/capes/comms.rst b/boards/capes/comms.rst new file mode 100644 index 0000000000000000000000000000000000000000..4e980045e4ed485081b9a02f285133914be23002 --- /dev/null +++ b/boards/capes/comms.rst @@ -0,0 +1,97 @@ +.. _industrial-comms-cape: + +Beaglebone Industrial Comms Cape +################################ + +For industrial communication applications. Provides an array of communication protocols including one RS485, one CAN, +two analog 4–20 mA current loops, and two 3A 50V interfaces allowing the control of high current loads. + +.. figure:: images/BeagleBoneCommsCapeA2-400x279.png + :align: center + :alt: BeagleBone Comms Cape + +* `Order page <https://beagleboard.org/capes#comms>`_ +* `Schematic <https://openbeagle.org/beagleboard/capes/-/tree/master/beaglebone/comms>`_ + +.. note:: + This cape also boasts compatiblity with the :ref:`beaglev-fire-home`. Documentation for it's setup can be found + at :ref:`beaglev-fire-comms-cape-gateware-usage`. + +Electrical Specifications +************************** + +- **RS485**: `MAX13487E/MAX13488E datasheet <https://datasheets.maximintegrated.com/en/ds/MAX13487E-MAX13488E.pdf>`_ +- **CAN**: `SN65HVD230 datasheet <https://www.ti.com/product/SN65HVD230>`_ +- **2x 4-20mA current loop inputs** +- **2x 3A 50V sinks for high-current loads** + +Mechanical Specifications +************************* + +.. list-table:: + :header-rows: 1 + + * - Feature + - Specification + * - Layers + - 2 + * - PCB Thickness + - 0.062" + * - RoHS Compliant + - Yes + +Documentation +************* + +.. list-table:: + :header-rows: 1 + + * - Feature + - Availability + * - Open Source + - Yes + * - System Reference Manual + - Not yet + * - Schematics + - PDF, EAGLE + * - PCB Files + - PDF, EAGLE + * - Gerber Files + - Not yet + * - Bills of Materials + - Not yet + + +Test Code +********* + +.. code-block:: bash + + # For the RS485, you just need + config-pin p9.11 uart + config-pin p9.13 uart + # and then use /dev/ttyS4 + + # For the CAN, you just need + config-pin p9.24 can + config-pin p9.26 can + # and then you can use something like + # https://openbeagle.org/-/snippets/15 , + # but replace can0 with can1 + + # For the 4-20mA loop, the ADC overlay should already be loaded and you can + cat /sys/bus/iio/devices/iio:device0/in_voltage5_raw + cat /sys/bus/iio/devices/iio:device0/in_voltage6_raw + # but you'll need to do the voltage to data conversion + + # For the sink drivers, you can do: + # Sink A + config-pin p9.15 gpio + echo out > /sys/class/gpio/gpio48/direction + echo 1 > /sys/class/gpio/gpio48/value + # Sink B + config-pin p9.23 gpio + echo out > /sys/class/gpio/gpio49/direction + echo 1 > /sys/class/gpio/gpio49/value + # and that should turn them on. + diff --git a/boards/capes/index.rst b/boards/capes/index.rst index 48eb1c52f43d05de872c75c4a8846983ee063092..5f3c39483d7044714c37d74e130c8e4ba147da21 100644 --- a/boards/capes/index.rst +++ b/boards/capes/index.rst @@ -43,6 +43,7 @@ across the corresponding Boards without changing any code at all. Find the instructions below on using each cape: * :ref:`bone-cape-relay` +* :ref:`industrial-comms-cape` .. toctree:: :maxdepth: 2 @@ -50,4 +51,5 @@ Find the instructions below on using each cape: /boards/capes/cape-interface-spec /boards/capes/relay + /boards/capes/comms