Skip to content

Commit

Permalink
Add agent docs page
Browse files Browse the repository at this point in the history
  • Loading branch information
BrianJKoopman committed May 8, 2024
1 parent 2f4e3e1 commit a544c38
Show file tree
Hide file tree
Showing 2 changed files with 63 additions and 0 deletions.
62 changes: 62 additions & 0 deletions docs/agents/wiregrid_tiltsensor.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,62 @@
.. highlight:: rst

.. _wiregrid_tiltsensor:

==========================
Wiregrid Tilt Sensor Agent
==========================

# Enter a brief description here.

.. argparse::
:filename: ../socs/agents/wiregrid_tiltsensor/agent.py
:func: make_parser
:prog: python3 agent.py

Dependencies
------------

# List if any, else remove section.

Configuration File Examples
---------------------------

Below are configuration examples for the ocs config file and for running the
Agent in a docker container.

OCS Site Config
````````````````

An example site-config-file block::

{'agent-class': 'WiregridTiltSensorAgent',
'instance-id': 'wg-tilt-sensor',
'arguments': ['--ip-address', '10.10.10.73']},

Docker Compose
``````````````

An example docker-compose configuration::

ocs-wg-tilt-sensor:
image: simonsobs/socs:latest
hostname: ocs-docker
network_mode: "host"
environment:
- INSTANCE_ID=wg-tilt-sensor
volumes:
- ${OCS_CONFIG_DIR}:/config:ro

- Since the agent within the container needs to communicate with hardware on the
host network you must use ``network_mode: "host"`` in your compose file.

Description
-----------

# Longer description here if needed.

Agent API
---------

.. autoclass:: socs.agents.wiregrid_tiltsensor.agent.WiregridTiltsensorAgent
:members:
1 change: 1 addition & 0 deletions docs/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -81,6 +81,7 @@ API Reference Full API documentation for core parts of the SOCS library.
agents/wiregrid_actuator
agents/wiregrid_encoder
agents/wiregrid_kikusui
agents/wiregrid_tiltsensor

.. toctree::
:caption: Simulator Reference
Expand Down

0 comments on commit a544c38

Please sign in to comment.