diff --git a/common/source/docs/common-ethernet-adapters.rst b/common/source/docs/common-ethernet-adapters.rst index c3cf842c8d..7da65d962d 100644 --- a/common/source/docs/common-ethernet-adapters.rst +++ b/common/source/docs/common-ethernet-adapters.rst @@ -4,23 +4,33 @@ Ethernet Adapters ================= -Ardupilot has the ability to use Ethernet peripherals and networking (see :ref:`common-network`), but most H7 based autopilots do not include the Ethernet controller. Ethernet networking capability can be added using an Ethernet Adapter which provides connectivity to the autopilot using PPP protocol over a serial port of the autopilot. +Ardupilot has the ability to use Ethernet peripherals and networking (see :ref:`common-network`). This page includes various switches and adapters known to work .. image:: ../../../images/Net_Adapter.png :target: ../_images/Net_Adapter.png -Requirements -============ +Most H7 based autopilots do not include native ethernet support but ethernet networking capability can be added using an Ethernet Adapter (see `BotBlox DroneNet `__ and `CubeLAN 8-Port Switch `__ below) which provide connectivity using PPP protocol over the autopilot's serial port -- PPP capability is not included by default on standard H7 autopilot firmware, so the `Custom Firmware Build Server `__ must be used to include it. +Hardware +======== + +- `BotBlox SwitchBlox for Ardupilot `__ : ethernet switch to allow connecting multiple devices together +- `BotBlox DroneNet for Ardupilot `__ : ethernet switch with CAN, USART, RS485, and GPIO/PWM adapters allowing non-ethernet devices including autopilots to work over ethernet +- `BotBlox SwitchBlox Cable Adapter for Ardupilot `__ : adapter to ease the ethernet port differences across different device manufacturers +- `CubeNode ETH `__ : serial to ethernet adapter to allow non-ethernet autopilots to work over ethernet +- `CubeLAN 8-Port Switch `__ : ethernet switch using the CubePilot preferred 5-pin connector + +PPP Setup +========= + +- PPP capability is not included by default on standard H7 autopilot firmware, so the `Custom Firmware Build Server `__ must be used to build an firmware that includes it .. image:: ../../../images/build-server-ppp.jpg :target: ../_images/build-server-ppp.jpg .. note:: if using a local build environment (:ref:`building-the-code`), you can include PPP capability by using the ``--enable-ppp`` waf configuration option when building the code for an autopilot locally. -- H7 based autopilot with an unused, flow controlled (for optimum transfer speeds) SERIAL port. (SERIAL2 used in the following setup examples) -- Ethernet to PPP adapter (see below) +- Connect one of the H7 based autopilot's serial ports to the ethernet switch's or Ethernet-to-PPP-adapter's USART port. For optimum performance a serial port with flow control should be used (e.g. normally SERIAL1 or SERIAL2). In the following instructions SERIAL2 is used Autopilot Setup =============== @@ -44,6 +54,7 @@ Adapters .. image:: ../../../images/BotBlox_DroneNet.jpg :target: ../_images/BotBlox_DroneNet.jpg + :width: 450px Video ===== diff --git a/images/Net_Adapter.png b/images/Net_Adapter.png index 4da7dc23d0..2e14b2004d 100644 Binary files a/images/Net_Adapter.png and b/images/Net_Adapter.png differ