diff --git a/docs/reference/_index.md b/docs/reference/_index.md new file mode 100644 index 0000000000..8d0258ed21 --- /dev/null +++ b/docs/reference/_index.md @@ -0,0 +1,11 @@ +--- +linkTitle: "Reference" +title: "Reference" +weight: 600 +layout: "docs" +type: "docs" +no_list: true +noedit: true +open_on_desktop: true +description: "Technical reference documentation for the Viam platform: APIs, SDKs, components, services, architecture, and more." +--- diff --git a/docs/reference/account/_index.md b/docs/reference/account/_index.md new file mode 100644 index 0000000000..aec166ad8f --- /dev/null +++ b/docs/reference/account/_index.md @@ -0,0 +1,8 @@ +--- +title: "Account" +linkTitle: "Account" +weight: 80 +type: "docs" +no_list: true +description: "Reference documentation for Viam accounts, billing, and organization management." +--- diff --git a/docs/reference/account/accounts.md b/docs/reference/account/accounts.md new file mode 100644 index 0000000000..e2b5735a27 --- /dev/null +++ b/docs/reference/account/accounts.md @@ -0,0 +1,9 @@ +--- +linkTitle: "Account management" +title: "Account management" +weight: 900 +layout: "docs" +type: "docs" +no_list: true +description: "Log in and out of your Viam account." +--- diff --git a/docs/reference/account/billing.md b/docs/reference/account/billing.md new file mode 100644 index 0000000000..5ef9a3c47d --- /dev/null +++ b/docs/reference/account/billing.md @@ -0,0 +1,11 @@ +--- +title: "Payment and billing" +linkTitle: "Billing" +weight: 50 +type: "docs" +description: "An overview of the Payments & Billing page." +tags: ["fleet management", "cloud", "app"] +date: "2024-03-13" +no_list: true +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/account/organize.md b/docs/reference/account/organize.md new file mode 100644 index 0000000000..91ebee439a --- /dev/null +++ b/docs/reference/account/organize.md @@ -0,0 +1,9 @@ +--- +linkTitle: "Organize your machines" +title: "Organize your machines" +weight: 60 +layout: "docs" +type: "docs" +no_list: true +description: "Organize and manage access to your fleet by grouping machines into organizations and locations." +--- diff --git a/docs/reference/advanced-modules/_index.md b/docs/reference/advanced-modules/_index.md new file mode 100644 index 0000000000..6b68ce5b4b --- /dev/null +++ b/docs/reference/advanced-modules/_index.md @@ -0,0 +1,19 @@ +--- +title: "Advanced modular resources" +linkTitle: "Advanced modular resources" +weight: 70 +type: docs +tags: + [ + "server", + "rdk", + "extending viam", + "modular resources", + "components", + "services", + ] +description: "Some usage may require you to define new APIs or deploy custom components in non-standard ways." +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +toc_hide: true +--- diff --git a/docs/reference/advanced-modules/create-subtype.md b/docs/reference/advanced-modules/create-subtype.md new file mode 100644 index 0000000000..150589caab --- /dev/null +++ b/docs/reference/advanced-modules/create-subtype.md @@ -0,0 +1,11 @@ +--- +title: "Define a new resource API" +linkTitle: "Custom API" +weight: 30 +type: "docs" +tags: ["rdk", "extending viam", "modular resources", "API"] +description: "Define a custom API for a resource that does not fit into existing component or service APIs." +no_list: true +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/advanced-modules/custom-components-remotes.md b/docs/reference/advanced-modules/custom-components-remotes.md new file mode 100644 index 0000000000..7980cee529 --- /dev/null +++ b/docs/reference/advanced-modules/custom-components-remotes.md @@ -0,0 +1,10 @@ +--- +title: "Add custom components as remote parts" +linkTitle: "Custom components as remote parts" +weight: 99 +type: "docs" +tags: ["server", "sdk"] +description: "If you are unable to use modular resources, you can implement custom components and register them on a server configured as a remote of your machine." +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/advanced-modules/docker-modules.md b/docs/reference/advanced-modules/docker-modules.md new file mode 100644 index 0000000000..270bca4546 --- /dev/null +++ b/docs/reference/advanced-modules/docker-modules.md @@ -0,0 +1,11 @@ +--- +title: "Deploy a module using Docker" +linkTitle: "Docker Modules" +weight: 300 +type: "docs" +tags: ["extending viam", "modular resources"] +description: "Deploy a module using Docker." +no_list: true +date: "2025-04-10" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/apis/_index.md b/docs/reference/apis/_index.md new file mode 100644 index 0000000000..959781a42a --- /dev/null +++ b/docs/reference/apis/_index.md @@ -0,0 +1,12 @@ +--- +title: "Viam's Client APIs" +linkTitle: "APIs" +weight: 10 +type: "docs" +description: "Access and control your machine or fleet with the SDKs' client libraries for the resource and robot APIs." +images: ["/general/code.png"] +tags: ["client", "sdk", "viam-server", "networking", "apis", "robot api"] +no_list: true +date: "2024-10-01" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/apis/billing-client.md b/docs/reference/apis/billing-client.md new file mode 100644 index 0000000000..55fe65632e --- /dev/null +++ b/docs/reference/apis/billing-client.md @@ -0,0 +1,10 @@ +--- +title: "Retrieve billing information with Viam's billing client API" +linkTitle: "Billing client" +weight: 90 +type: "docs" +description: "Use the billing client API to retrieve billing information from Viam." +tags: ["cloud", "sdk", "viam-server", "networking", "apis", "robot api"] +date: "2024-09-14" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/apis/components/_index.md b/docs/reference/apis/components/_index.md new file mode 100644 index 0000000000..38181fdfcf --- /dev/null +++ b/docs/reference/apis/components/_index.md @@ -0,0 +1,10 @@ +--- +linkTitle: "Component APIs" +title: "Component APIs" +weight: 5 +empty_node: true +layout: "empty" +canonical: "/reference/apis/" +type: "docs" +description: "Component APIs." +--- diff --git a/docs/reference/apis/components/arm.md b/docs/reference/apis/components/arm.md new file mode 100644 index 0000000000..846b3eb915 --- /dev/null +++ b/docs/reference/apis/components/arm.md @@ -0,0 +1,11 @@ +--- +title: "Arm API" +linkTitle: "Arm" +weight: 5 +type: "docs" +description: "Give commands to your arm components for linear motion planning." +icon: true +images: ["/icons/components/arm.svg"] +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/apis/components/audio-in.md b/docs/reference/apis/components/audio-in.md new file mode 100644 index 0000000000..fc70fb8e77 --- /dev/null +++ b/docs/reference/apis/components/audio-in.md @@ -0,0 +1,11 @@ +--- +title: "Audio in API" +linkTitle: "Audio in" +weight: 10 +type: "docs" +description: "Give commands to your audio in components." +icon: true +# images: ["/icons/components/resource.svg"] +date: "2025-11-12" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/apis/components/audio-out.md b/docs/reference/apis/components/audio-out.md new file mode 100644 index 0000000000..6828a96906 --- /dev/null +++ b/docs/reference/apis/components/audio-out.md @@ -0,0 +1,11 @@ +--- +title: "Audio out API" +linkTitle: "Audio out" +weight: 10 +type: "docs" +description: "Give commands to your audio out components." +icon: true +# images: ["/icons/components/resource.svg"] +date: "2025-11-12" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/apis/components/base.md b/docs/reference/apis/components/base.md new file mode 100644 index 0000000000..91a47cc87b --- /dev/null +++ b/docs/reference/apis/components/base.md @@ -0,0 +1,11 @@ +--- +title: "Base API" +linkTitle: "Base" +weight: 20 +type: "docs" +description: "Give commands for moving all configured components attached to a mobile platform as a whole without needing to send commands to individual components." +icon: true +images: ["/icons/components/base.svg"] +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/apis/components/board.md b/docs/reference/apis/components/board.md new file mode 100644 index 0000000000..0dfd9c4b2f --- /dev/null +++ b/docs/reference/apis/components/board.md @@ -0,0 +1,11 @@ +--- +title: "Board API" +linkTitle: "Board" +weight: 30 +type: "docs" +description: "Give commands for setting GPIO pins to high or low, setting PWM, and working with analog and digital interrupts." +icon: true +images: ["/icons/components/board.svg"] +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/apis/components/button.md b/docs/reference/apis/components/button.md new file mode 100644 index 0000000000..89d3993df7 --- /dev/null +++ b/docs/reference/apis/components/button.md @@ -0,0 +1,11 @@ +--- +title: "Button API" +linkTitle: "Button" +weight: 35 +type: "docs" +description: "Give commands for getting presses from a physical button." +icon: true +images: ["/icons/components/button.svg"] +date: "2025-02-20" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/apis/components/camera.md b/docs/reference/apis/components/camera.md new file mode 100644 index 0000000000..d3552131e0 --- /dev/null +++ b/docs/reference/apis/components/camera.md @@ -0,0 +1,11 @@ +--- +title: "Camera API" +linkTitle: "Camera" +weight: 40 +type: "docs" +description: "Give commands for getting images or point clouds." +icon: true +images: ["/icons/components/camera.svg"] +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/apis/components/encoder.md b/docs/reference/apis/components/encoder.md new file mode 100644 index 0000000000..74336ad245 --- /dev/null +++ b/docs/reference/apis/components/encoder.md @@ -0,0 +1,11 @@ +--- +title: "Encoder API" +linkTitle: "Encoder" +weight: 50 +type: "docs" +description: "Give commands for getting the position of a motor or a joint in ticks or degrees." +icon: true +images: ["/icons/components/encoder.svg"] +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/apis/components/gantry.md b/docs/reference/apis/components/gantry.md new file mode 100644 index 0000000000..e7ad051f52 --- /dev/null +++ b/docs/reference/apis/components/gantry.md @@ -0,0 +1,11 @@ +--- +title: "Gantry API" +linkTitle: "Gantry" +weight: 60 +type: "docs" +description: "Give commands for coordinated control of one or more linear actuators." +icon: true +images: ["/icons/components/gantry.svg"] +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/apis/components/generic.md b/docs/reference/apis/components/generic.md new file mode 100644 index 0000000000..ca8252867a --- /dev/null +++ b/docs/reference/apis/components/generic.md @@ -0,0 +1,11 @@ +--- +title: "Control your generic component with the generic API" +linkTitle: "Generic" +weight: 70 +type: "docs" +description: "Give commands for running custom model-specific commands using DoCommand on your generic components." +icon: true +images: ["/icons/components/generic.svg"] +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/apis/components/gripper.md b/docs/reference/apis/components/gripper.md new file mode 100644 index 0000000000..f4fa07987b --- /dev/null +++ b/docs/reference/apis/components/gripper.md @@ -0,0 +1,11 @@ +--- +title: "Control your gripper with the gripper API" +linkTitle: "Gripper" +weight: 80 +type: "docs" +description: "Give commands for opening and closing a gripper device." +icon: true +images: ["/icons/components/gripper.svg"] +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/apis/components/input-controller.md b/docs/reference/apis/components/input-controller.md new file mode 100644 index 0000000000..74dbef6e06 --- /dev/null +++ b/docs/reference/apis/components/input-controller.md @@ -0,0 +1,12 @@ +--- +title: "Input controller API" +linkTitle: "Input controller" +titleMustBeLong: true +weight: 90 +type: "docs" +description: "Give commands to register callbacks for events, allowing you to use input devices to control your machines." +icon: true +images: ["/icons/components/controller.svg"] +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/apis/components/motor.md b/docs/reference/apis/components/motor.md new file mode 100644 index 0000000000..a3dca30592 --- /dev/null +++ b/docs/reference/apis/components/motor.md @@ -0,0 +1,11 @@ +--- +title: "Motor API" +linkTitle: "Motor" +weight: 100 +type: "docs" +description: "Give commands to operate a motor or get its current status." +icon: true +images: ["/icons/components/motor.svg"] +date: "2024-10-10" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/apis/components/movement-sensor.md b/docs/reference/apis/components/movement-sensor.md new file mode 100644 index 0000000000..644d6c376a --- /dev/null +++ b/docs/reference/apis/components/movement-sensor.md @@ -0,0 +1,11 @@ +--- +title: "Movement sensor API" +linkTitle: "Movement sensor" +weight: 110 +type: "docs" +description: "Give commands for getting the current GPS location, linear velocity and acceleration, angular velocity and acceleration and heading." +icon: true +images: ["/icons/components/imu.svg"] +date: "2022-10-10" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/apis/components/power-sensor.md b/docs/reference/apis/components/power-sensor.md new file mode 100644 index 0000000000..97231f0ca9 --- /dev/null +++ b/docs/reference/apis/components/power-sensor.md @@ -0,0 +1,11 @@ +--- +title: "Power sensor API" +linkTitle: "Power sensor" +weight: 120 +type: "docs" +description: "Commands for getting measurements of voltage, current, and power consumption." +icon: true +images: ["/icons/components/power-sensor.svg"] +date: "2022-10-10" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/apis/components/sensor.md b/docs/reference/apis/components/sensor.md new file mode 100644 index 0000000000..636c4d4e57 --- /dev/null +++ b/docs/reference/apis/components/sensor.md @@ -0,0 +1,11 @@ +--- +title: "Sensor API" +linkTitle: "Sensor" +weight: 130 +type: "docs" +description: "Give commands for getting sensor readings." +icon: true +images: ["/icons/components/sensor.svg"] +date: "2022-10-10" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/apis/components/servo.md b/docs/reference/apis/components/servo.md new file mode 100644 index 0000000000..1a3152873e --- /dev/null +++ b/docs/reference/apis/components/servo.md @@ -0,0 +1,11 @@ +--- +title: "Servo API" +linkTitle: "Servo" +weight: 140 +type: "docs" +description: "Give commands for controlling the angular position of a servo precisely or getting its current status." +icon: true +images: ["/icons/components/servo.svg"] +date: "2022-10-10" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/apis/components/switch.md b/docs/reference/apis/components/switch.md new file mode 100644 index 0000000000..b959428616 --- /dev/null +++ b/docs/reference/apis/components/switch.md @@ -0,0 +1,11 @@ +--- +title: "Switch API" +linkTitle: "Switch" +weight: 200 +type: "docs" +description: "Give commands for getting the state of a physical switch that has two or more discrete positions." +icon: true +images: ["/icons/components/switch.svg"] +date: "2025-02-20" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/apis/data-client.md b/docs/reference/apis/data-client.md new file mode 100644 index 0000000000..3a11b9a9e5 --- /dev/null +++ b/docs/reference/apis/data-client.md @@ -0,0 +1,23 @@ +--- +title: "Upload and retrieve data with Viam's data client API" +linkTitle: "Data client" +weight: 10 +type: "docs" +description: "Use the data client API to upload and retrieve data directly." +icon: true +images: ["/services/icons/sdk.svg"] +tags: + [ + "cloud", + "sdk", + "viam-server", + "networking", + "apis", + "robot api", + "data management", + "data", + ] + +date: "2024-09-19" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/apis/fleet.md b/docs/reference/apis/fleet.md new file mode 100644 index 0000000000..bb876846e0 --- /dev/null +++ b/docs/reference/apis/fleet.md @@ -0,0 +1,20 @@ +--- +title: "Manage your fleet with Viam's fleet management API" +linkTitle: "Fleet management" +weight: 20 +type: "docs" +description: "Use the fleet management API with Viam's client SDKs to manage your machine fleet with code." +tags: + [ + "cloud", + "sdk", + "viam-server", + "networking", + "apis", + "robot api", + "cloud management", + "fleet management", + ] +date: "2024-09-20" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/apis/ml-training-client.md b/docs/reference/apis/ml-training-client.md new file mode 100644 index 0000000000..e8c48d4191 --- /dev/null +++ b/docs/reference/apis/ml-training-client.md @@ -0,0 +1,10 @@ +--- +title: "Work with ML training jobs with Viam's ML training API" +linkTitle: "ML training client" +weight: 10 +type: "docs" +description: "Use the ML training client API to manage ML training jobs taking place in Viam's cloud app." +tags: ["cloud", "sdk", "viam-server", "networking", "apis", "ml model", "ml"] +date: "2024-09-16" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/apis/robot.md b/docs/reference/apis/robot.md new file mode 100644 index 0000000000..2a46b6b835 --- /dev/null +++ b/docs/reference/apis/robot.md @@ -0,0 +1,10 @@ +--- +title: "Manage machines with Viam's machine management API" +linkTitle: "Machine management" +weight: 20 +type: "docs" +description: "How to use the machine API to monitor and manage your machines." +tags: ["robot state", "sdk", "apis", "robot api"] +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/apis/services/SLAM.md b/docs/reference/apis/services/SLAM.md new file mode 100644 index 0000000000..6d91d8bbb1 --- /dev/null +++ b/docs/reference/apis/services/SLAM.md @@ -0,0 +1,12 @@ +--- +title: "SLAM service API" +linkTitle: "SLAM" +weight: 60 +type: "docs" +tags: ["slam", "services"] +description: "Give commands to get a machine's position within a map." +icon: true +images: ["/services/icons/slam.svg"] +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/apis/services/_index.md b/docs/reference/apis/services/_index.md new file mode 100644 index 0000000000..752c30f21f --- /dev/null +++ b/docs/reference/apis/services/_index.md @@ -0,0 +1,10 @@ +--- +linkTitle: "Service APIs" +title: "Service APIs" +weight: 5 +empty_node: true +layout: "empty" +canonical: "/reference/apis/" +type: "docs" +description: "Service APIs." +--- diff --git a/docs/reference/apis/services/base-rc.md b/docs/reference/apis/services/base-rc.md new file mode 100644 index 0000000000..f07adac404 --- /dev/null +++ b/docs/reference/apis/services/base-rc.md @@ -0,0 +1,12 @@ +--- +title: "Base remote control service API" +linkTitle: "Base remote control" +weight: 70 +type: "docs" +tags: ["base", "services", "rover", "input controller", "remote control"] +description: "Give commands to get a list of inputs from the controller that are being monitored for that control mode." +icon: true +images: ["/services/icons/base-rc.svg"] +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/apis/services/data.md b/docs/reference/apis/services/data.md new file mode 100644 index 0000000000..52cfc9f1b0 --- /dev/null +++ b/docs/reference/apis/services/data.md @@ -0,0 +1,11 @@ +--- +title: "Data management service API" +linkTitle: "Data management" +weight: 10 +type: "docs" +description: "Give commands to your data management service to sync data stored on the machine it is deployed on to the cloud." +icon: true +images: ["/icons/components/arm.svg"] +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/apis/services/discovery.md b/docs/reference/apis/services/discovery.md new file mode 100644 index 0000000000..46939ec7cc --- /dev/null +++ b/docs/reference/apis/services/discovery.md @@ -0,0 +1,10 @@ +--- +title: "Discovery service API" +linkTitle: "Discovery" +weight: 80 +type: "docs" +tags: ["navigation", "services", "resources", "components"] +description: "Reveal which resources are available to configure on a machine based on the hardware that is physically present." +date: "2025-02-18" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/apis/services/generic.md b/docs/reference/apis/services/generic.md new file mode 100644 index 0000000000..08f43a6c73 --- /dev/null +++ b/docs/reference/apis/services/generic.md @@ -0,0 +1,12 @@ +--- +title: "Generic service API" +linkTitle: "Generic" +weight: 60 +type: "docs" +tags: ["generic", "services"] +description: "Give commands to your generic components for running model-specific commands using DoCommand." +icon: true +images: ["/icons/components/generic.svg"] +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/apis/services/ml.md b/docs/reference/apis/services/ml.md new file mode 100644 index 0000000000..e11462f9d6 --- /dev/null +++ b/docs/reference/apis/services/ml.md @@ -0,0 +1,12 @@ +--- +title: "ML model service API" +linkTitle: "ML model" +weight: 30 +type: "docs" +tags: ["data management", "ml", "model training"] +description: "Give commands to your ML model service to make inferences based on a provided ML model." +icon: true +images: ["/services/icons/ml.svg"] +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/apis/services/motion.md b/docs/reference/apis/services/motion.md new file mode 100644 index 0000000000..f01ca9dfc1 --- /dev/null +++ b/docs/reference/apis/services/motion.md @@ -0,0 +1,11 @@ +--- +title: "Motion service API" +linkTitle: "Motion" +weight: 40 +type: "docs" +description: "Give commands to move a machine's components from one location or pose to another." +icon: true +images: ["/icons/components/arm.svg"] +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/apis/services/navigation.md b/docs/reference/apis/services/navigation.md new file mode 100644 index 0000000000..2892b7d18c --- /dev/null +++ b/docs/reference/apis/services/navigation.md @@ -0,0 +1,12 @@ +--- +title: "Navigation service API" +linkTitle: "Navigation" +weight: 50 +type: "docs" +tags: ["navigation", "services", "base", "rover"] +description: "Give commands to define waypoints and move your machine along those waypoints while avoiding obstacles." +icon: true +images: ["/services/icons/navigation.svg"] +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/apis/services/vision.md b/docs/reference/apis/services/vision.md new file mode 100644 index 0000000000..c5c684e80a --- /dev/null +++ b/docs/reference/apis/services/vision.md @@ -0,0 +1,12 @@ +--- +title: "Vision service API" +linkTitle: "Vision" +weight: 20 +type: "docs" +description: "Give commands to get detections, classifications, or point cloud objects, depending on the ML model the vision service is using." +icon: true +images: ["/services/icons/vision.svg"] +tags: ["vision", "computer vision", "CV", "services"] +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/apis/services/world-state-store.md b/docs/reference/apis/services/world-state-store.md new file mode 100644 index 0000000000..48568e8b22 --- /dev/null +++ b/docs/reference/apis/services/world-state-store.md @@ -0,0 +1,12 @@ +--- +title: "World state store API" +linkTitle: "World state store" +weight: 70 +type: "docs" +tags: ["world_state_store", "services"] +description: "Retrieve a list of world objects." +icon: true +images: ["/icons/components/generic.svg"] +date: "2025-09-12" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/apis/sessions.md b/docs/reference/apis/sessions.md new file mode 100644 index 0000000000..54868d798b --- /dev/null +++ b/docs/reference/apis/sessions.md @@ -0,0 +1,21 @@ +--- +title: "Session management with Viam's client SDKs" +linkTitle: "Session management" +weight: 20 +type: "docs" +description: "Manage sessions between your machine and clients connected through Viam's SDKs." +tags: + [ + "client", + "sdk", + "viam-server", + "networking", + "apis", + "robot api", + "session", + "sessions", + "session management", + ] +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/architecture/_index.md b/docs/reference/architecture/_index.md new file mode 100644 index 0000000000..0b5d48c4a2 --- /dev/null +++ b/docs/reference/architecture/_index.md @@ -0,0 +1,12 @@ +--- +title: "Viam architecture" +linkTitle: "Viam architecture" +weight: 10 +type: "docs" +description: "How a machine running on Viam is structured, from on-device to cloud communications." +imageAlt: "Viam architecture" +images: ["/viam/machine-components.png"] +tags: ["components", "services", "communication"] +date: "2024-08-13" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/architecture/machine-to-machine-comms.md b/docs/reference/architecture/machine-to-machine-comms.md new file mode 100644 index 0000000000..e91d7baf77 --- /dev/null +++ b/docs/reference/architecture/machine-to-machine-comms.md @@ -0,0 +1,8 @@ +--- +title: "Machine-to-Machine Communication: End-to-End Flow" +linkTitle: "Machine-to-Machine Communication" +weight: 60 +type: "docs" +description: "Explanation of how a machine and its parts interact at the communication layer." +toc_hide: true +--- diff --git a/docs/reference/architecture/parts.md b/docs/reference/architecture/parts.md new file mode 100644 index 0000000000..17f662772e --- /dev/null +++ b/docs/reference/architecture/parts.md @@ -0,0 +1,10 @@ +--- +title: "Machine architecture: Parts" +linkTitle: "Parts, sub-parts, remotes" +weight: 40 +type: "docs" +description: "Connect multiple machine parts to each other as sub-parts or remotes." +tags: ["server", "components", "services"] +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/changelog.md b/docs/reference/changelog.md new file mode 100644 index 0000000000..60154021c2 --- /dev/null +++ b/docs/reference/changelog.md @@ -0,0 +1,14 @@ +--- +title: "Changelog" +linkTitle: "Changelog" +weight: 20 +draft: false +type: "docs" +description: "A log of added features, improvements, and changes over time." +layout: "changelog" +outputs: + - rss + - html +date: "2024-09-18" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/components/_index.md b/docs/reference/components/_index.md new file mode 100644 index 0000000000..21d61b2615 --- /dev/null +++ b/docs/reference/components/_index.md @@ -0,0 +1,8 @@ +--- +title: "Components" +linkTitle: "Components" +weight: 20 +type: "docs" +no_list: true +description: "Components represent physical hardware on your machine, including motors, cameras, sensors, and more." +--- diff --git a/docs/reference/components/arm/_index.md b/docs/reference/components/arm/_index.md new file mode 100644 index 0000000000..b1a2c121d0 --- /dev/null +++ b/docs/reference/components/arm/_index.md @@ -0,0 +1,19 @@ +--- +title: "Arm Component" +linkTitle: "Arm" +childTitleEndOverwrite: "Arm Component" +weight: 10 +type: "docs" +description: "A robotic arm is made up of a series of links and joints, ending with a device you can position." +no_list: true +tags: ["arm", "components"] +icon: true +images: ["/icons/components/arm.svg"] +modulescript: true +hide_children: true +outputs: + - html + - typesense +date: "2024-10-21" +# SME: Peter L +--- diff --git a/docs/reference/components/arm/eva.md b/docs/reference/components/arm/eva.md new file mode 100644 index 0000000000..5f7160722f --- /dev/null +++ b/docs/reference/components/arm/eva.md @@ -0,0 +1,12 @@ +--- +title: "Configure an Eva Arm" +linkTitle: "eva" +weight: 34 +type: "docs" +draft: "true" +description: "Configure an Eva arm." +images: ["/icons/components/arm.svg"] +tags: ["arm", "components"] +toc_hide: true +# SMEs: Bucket, Motion +--- diff --git a/docs/reference/components/arm/fake.md b/docs/reference/components/arm/fake.md new file mode 100644 index 0000000000..91f3b0d438 --- /dev/null +++ b/docs/reference/components/arm/fake.md @@ -0,0 +1,12 @@ +--- +title: "Configure a Fake Arm" +linkTitle: "fake" +weight: 34 +type: "docs" +description: "Configure a fake arm to use for testing." +images: ["/icons/components/arm.svg"] +tags: ["arm", "components"] +component_description: "A model used for testing, with no physical hardware." +toc_hide: true +# SMEs: Bucket, Motion +--- diff --git a/docs/reference/components/arm/yahboom-dofbot.md b/docs/reference/components/arm/yahboom-dofbot.md new file mode 100644 index 0000000000..f36d1ca95e --- /dev/null +++ b/docs/reference/components/arm/yahboom-dofbot.md @@ -0,0 +1,11 @@ +--- +title: "Configure a Yahboom DOFBOT Arm" +linkTitle: "yahboom-dofbot" +weight: 50 +type: "docs" +draft: "true" +description: "Configure a Yahboom DOFBOT modular arm." +images: ["/icons/components/arm.svg"] +tags: ["arm", "components"] +toc_hide: true +--- diff --git a/docs/reference/components/base/_index.md b/docs/reference/components/base/_index.md new file mode 100644 index 0000000000..78d80287e9 --- /dev/null +++ b/docs/reference/components/base/_index.md @@ -0,0 +1,15 @@ +--- +title: "Base Component" +linkTitle: "Base" +weight: 14 +type: "docs" +no_list: true +description: "The base component allows you to move a mobile robot without needing to send commands to individual components like motors." +tags: ["base", "components"] +icon: true +images: ["/icons/components/base.svg"] +modulescript: true +hide_children: true +date: "2024-10-21" +# SMEs: Steve B +--- diff --git a/docs/reference/components/base/boat.md b/docs/reference/components/base/boat.md new file mode 100644 index 0000000000..780ac71ab5 --- /dev/null +++ b/docs/reference/components/base/boat.md @@ -0,0 +1,12 @@ +--- +title: "Configure a Boat Base" +linkTitle: "boat" +weight: 35 +type: "docs" +draft: "true" +description: "Configure a boat base." +images: ["/icons/components/base.svg"] +tags: ["base", "components"] +toc_hide: true +# SMEs: Eliot +--- diff --git a/docs/reference/components/base/fake.md b/docs/reference/components/base/fake.md new file mode 100644 index 0000000000..d9927e653d --- /dev/null +++ b/docs/reference/components/base/fake.md @@ -0,0 +1,12 @@ +--- +title: "Configure a Fake Base" +linkTitle: "fake" +weight: 20 +type: "docs" +description: "Configure a fake base to use for testing without physical hardware." +images: ["/icons/components/base.svg"] +tags: ["base", "components"] +component_description: "A model used for testing, with no physical hardware." +toc_hide: true +# SMEs: Steve B +--- diff --git a/docs/reference/components/base/sensor-controlled.md b/docs/reference/components/base/sensor-controlled.md new file mode 100644 index 0000000000..97bb66c333 --- /dev/null +++ b/docs/reference/components/base/sensor-controlled.md @@ -0,0 +1,12 @@ +--- +title: "Configure a Sensor-Controlled Base" +linkTitle: "sensor-controlled" +weight: 40 +type: "docs" +description: "Configure a sensor-controlled base, a robotic base with feedback control from a movement sensor." +images: ["/icons/components/base.svg"] +tags: ["base", "components"] +component_description: "Wrap other base models and add feedback control using a movement sensor." +toc_hide: true +# SMEs: Rand H., Martha J. +--- diff --git a/docs/reference/components/base/two_wheeled_base.md b/docs/reference/components/base/two_wheeled_base.md new file mode 100644 index 0000000000..a80f04e103 --- /dev/null +++ b/docs/reference/components/base/two_wheeled_base.md @@ -0,0 +1,12 @@ +--- +title: "Configure a Two-Wheeled Base (Micro-RDK)" +linkTitle: "two_wheeled_base (Micro-RDK)" +weight: 30 +type: "docs" +description: "Configure and wire a two-wheeled base with a microcontroller." +images: ["/icons/components/base.svg"] +tags: ["base", "components"] +micrordk_component: true +toc_hide: true +# SMEs: Gautham V. +--- diff --git a/docs/reference/components/base/wheeled.md b/docs/reference/components/base/wheeled.md new file mode 100644 index 0000000000..2d39346935 --- /dev/null +++ b/docs/reference/components/base/wheeled.md @@ -0,0 +1,12 @@ +--- +title: "Configure a Wheeled Base" +linkTitle: "wheeled" +weight: 30 +type: "docs" +description: "Configure and wire a wheeled base." +images: ["/icons/components/base.svg"] +tags: ["base", "components"] +component_description: "Supports mobile wheeled robotic bases with motors on both sides for differential steering." +toc_hide: true +# SMEs: Steve B +--- diff --git a/docs/reference/components/board/_index.md b/docs/reference/components/board/_index.md new file mode 100644 index 0000000000..11130ed3c8 --- /dev/null +++ b/docs/reference/components/board/_index.md @@ -0,0 +1,16 @@ +--- +title: "Board Component" +linkTitle: "Board" +childTitleEndOverwrite: "Board Component" +weight: 17 +type: "docs" +no_list: true +description: "The signal wire hub of a machine, with GPIO pins for transmitting signals between the machine's computer and its other components." +tags: ["board", "components"] +icon: true +images: ["/icons/components/board.svg"] +modulescript: true +hide_children: true +date: "2024-10-21" +# SMEs: Gautham, Rand +--- diff --git a/docs/reference/components/board/esp32.md b/docs/reference/components/board/esp32.md new file mode 100644 index 0000000000..12e8e1e402 --- /dev/null +++ b/docs/reference/components/board/esp32.md @@ -0,0 +1,13 @@ +--- +title: "Configure an ESP32 Board (Micro-RDK)" +linkTitle: "esp32 (Micro-RDK)" +weight: 20 +type: "docs" +description: "Configure an ESP32 board running viam-micro-server." +images: ["/installation/thumbnails/esp32-espressif.png"] +imageAlt: "E S P 32 - espressif" +tags: ["board", "components"] +micrordk_component: true +toc_hide: true +# SMEs: Gautham, Nico, Andrew +--- diff --git a/docs/reference/components/board/fake.md b/docs/reference/components/board/fake.md new file mode 100644 index 0000000000..bcfe8ef58e --- /dev/null +++ b/docs/reference/components/board/fake.md @@ -0,0 +1,12 @@ +--- +title: "Configure a Fake Board" +linkTitle: "fake" +weight: 20 +type: "docs" +description: "Configure a fake board." +images: ["/icons/components/board.svg"] +tags: ["board", "components"] +component_description: "A model used for testing, with no physical hardware." +toc_hide: true +# SMEs: Gautham, Rand +--- diff --git a/docs/reference/components/button/_index.md b/docs/reference/components/button/_index.md new file mode 100644 index 0000000000..810a58e8a5 --- /dev/null +++ b/docs/reference/components/button/_index.md @@ -0,0 +1,15 @@ +--- +title: "Button Component" +linkTitle: "Button" +childTitleEndOverwrite: "Button Component" +weight: 20 +type: "docs" +description: "A physical button on a machine." +tags: ["button", "components"] +icon: true # this should be used when the image is an icon, it will adjust the sizing and object-fit +images: ["/icons/components/button.svg"] +no_list: true +modulescript: true +date: "2025-02-20" +# SMEs: +--- diff --git a/docs/reference/components/camera/_index.md b/docs/reference/components/camera/_index.md new file mode 100644 index 0000000000..d13b3e800f --- /dev/null +++ b/docs/reference/components/camera/_index.md @@ -0,0 +1,15 @@ +--- +title: "Camera Component" +linkTitle: "Camera" +childTitleEndOverwrite: "Camera Component" +weight: 40 +type: "docs" +description: "A camera captures 2D or 3D images and sends them to the computer controlling the machine." +no_list: true +tags: ["camera", "components"] +icon: true +images: ["/icons/components/camera.svg"] +modulescript: true +date: "2024-10-21" +# SMEs: Bijan, vision team +--- diff --git a/docs/reference/components/camera/calibrate.md b/docs/reference/components/camera/calibrate.md new file mode 100644 index 0000000000..eff147720a --- /dev/null +++ b/docs/reference/components/camera/calibrate.md @@ -0,0 +1,12 @@ +--- +title: "Calibrate a Camera" +linkTitle: "Calibrate a Camera" +weight: 80 +type: "docs" +description: "Calibrate a camera and extract the intrinsic and distortion parameters." +images: ["/icons/components/camera.svg"] +tags: ["camera", "components"] +no_component: true +date: "2024-01-01" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/components/camera/esp32-camera.md b/docs/reference/components/camera/esp32-camera.md new file mode 100644 index 0000000000..16fa09786b --- /dev/null +++ b/docs/reference/components/camera/esp32-camera.md @@ -0,0 +1,15 @@ +--- +title: "Configure an esp32-camera (Micro-RDK)" +linkTitle: "esp32-camera (Micro-RDK)" +weight: 33 +type: "docs" +description: "Configure a camera connected to an esp32 board, initialized and configured using esp-idf." +images: ["/icons/components/camera.svg"] +tags: ["camera", "components", "Micro-RDK"] +component_description: "An `OV2640` or `OV3660` camera connected to an esp32 board." +micrordk_component: true +toc_hide: true +date: "2024-08-28" +# updated: "" # When the content was last entirely checked +# SMEs: Matt Perez, Micro-RDK team +--- diff --git a/docs/reference/components/camera/fake-micro-server.md b/docs/reference/components/camera/fake-micro-server.md new file mode 100644 index 0000000000..9c61592cfe --- /dev/null +++ b/docs/reference/components/camera/fake-micro-server.md @@ -0,0 +1,13 @@ +--- +title: "Configure a Fake Camera (Micro-RDK)" +linkTitle: "fake (Micro-RDK)" +weight: 20 +type: "docs" +description: Configure a camera to use for testing." +images: ["/icons/components/camera.svg"] +tags: ["camera", "components"] +component_description: "A camera model for testing." +micrordk_component: true +toc_hide: true +# SMEs: Matt Perez, Micro-RDK team +--- diff --git a/docs/reference/components/camera/fake.md b/docs/reference/components/camera/fake.md new file mode 100644 index 0000000000..bd07e53675 --- /dev/null +++ b/docs/reference/components/camera/fake.md @@ -0,0 +1,12 @@ +--- +title: "Configure a Fake Camera" +linkTitle: "fake" +weight: 10 +type: "docs" +description: Configure a camera to use for testing." +images: ["/icons/components/camera.svg"] +tags: ["camera", "components"] +component_description: "A camera model for testing." +toc_hide: true +# SMEs: Bijan, vision team +--- diff --git a/docs/reference/components/camera/ffmpeg.md b/docs/reference/components/camera/ffmpeg.md new file mode 100644 index 0000000000..1a5640ee9a --- /dev/null +++ b/docs/reference/components/camera/ffmpeg.md @@ -0,0 +1,12 @@ +--- +title: "Configure an ffmpeg Camera" +linkTitle: "ffmpeg" +weight: 30 +type: "docs" +description: "Uses a camera device, a video file, or a stream as a camera." +images: ["/icons/components/camera.svg"] +tags: ["camera", "components"] +component_description: "Use a camera, a video file, or a stream as a camera component." +toc_hide: true +# SMEs: Sean Yu, audio/video team +--- diff --git a/docs/reference/components/camera/image-file.md b/docs/reference/components/camera/image-file.md new file mode 100644 index 0000000000..0842e8b7d0 --- /dev/null +++ b/docs/reference/components/camera/image-file.md @@ -0,0 +1,12 @@ +--- +title: "Configure an Image File Camera" +linkTitle: "image_file" +weight: 31 +type: "docs" +description: "Configure a camera that gets color or depth images frames from a file path." +images: ["/icons/components/camera.svg"] +tags: ["camera", "components"] +component_description: "Gets color and depth image frames from a file path." +toc_hide: true +# SMEs: Bijan, vision team +--- diff --git a/docs/reference/components/camera/transform.md b/docs/reference/components/camera/transform.md new file mode 100644 index 0000000000..4c5f093631 --- /dev/null +++ b/docs/reference/components/camera/transform.md @@ -0,0 +1,12 @@ +--- +title: "Transform Camera" +linkTitle: "transform" +weight: 60 +type: "docs" +description: "Use the transform camera model to apply transformation to a camera stream. For example, crop, resize, or add overlays with info about the camera stream." +images: ["/icons/components/camera.svg"] +tags: ["camera", "components"] +component_description: "Use pipelines for applying transformations to an input image source." +toc_hide: true +# SMEs: Rand, AV team +--- diff --git a/docs/reference/components/camera/webcam.md b/docs/reference/components/camera/webcam.md new file mode 100644 index 0000000000..9feb280bf6 --- /dev/null +++ b/docs/reference/components/camera/webcam.md @@ -0,0 +1,13 @@ +--- +title: "Configure a Webcam" +linkTitle: "webcam" +weight: 33 +type: "docs" +description: "Configure a standard camera that streams camera data." +images: ["/icons/components/camera.svg"] +tags: ["camera", "components"] +component_description: "A standard USB camera or other webcam that streams camera data." +usage: 999999 +toc_hide: true +# SMEs: Bijan, vision team +--- diff --git a/docs/reference/components/component/_index.md b/docs/reference/components/component/_index.md new file mode 100644 index 0000000000..df39629a8b --- /dev/null +++ b/docs/reference/components/component/_index.md @@ -0,0 +1,15 @@ +--- +title: "Template Component" +linkTitle: "Template" +childTitleEndOverwrite: "Template Component" +weight: 10 +type: "docs" +description: "A NAME is a ... description of what the component is." +tags: ["camera", "components"] +icon: true # this should be used when the image is an icon, it will adjust the sizing and object-fit +images: ["/icons/components.png"] +draft: true +no_list: true +modulescript: true +# SMEs: +--- diff --git a/docs/reference/components/component/board1.md b/docs/reference/components/component/board1.md new file mode 100644 index 0000000000..01456624b4 --- /dev/null +++ b/docs/reference/components/component/board1.md @@ -0,0 +1,11 @@ +--- +title: "Configure a Board" +linkTitle: "" +weight: 20 +type: "docs" +description: "Configure a board." +images: ["/icons/components/board.svg"] +tags: ["board", "components"] +draft: true +# SMEs: +--- diff --git a/docs/reference/components/component/model1.md b/docs/reference/components/component/model1.md new file mode 100644 index 0000000000..4735854f51 --- /dev/null +++ b/docs/reference/components/component/model1.md @@ -0,0 +1,11 @@ +--- +title: "Configure a Model1" +linkTitle: "Model1" +weight: 12 +type: "docs" +description: "Configure a model1 arm." +images: ["/icons/components.png"] +tags: ["name", "components"] +draft: true +# SMEs: +--- diff --git a/docs/reference/components/encoder/_index.md b/docs/reference/components/encoder/_index.md new file mode 100644 index 0000000000..477f7aa630 --- /dev/null +++ b/docs/reference/components/encoder/_index.md @@ -0,0 +1,16 @@ +--- +title: "Encoder Component" +linkTitle: "Encoder" +childTitleEndOverwrite: "Encoder Component" +weight: 50 +type: "docs" +description: "A special type of sensor that measures rotation of a motor or joint." +tags: ["encoder", "components"] +icon: true +images: ["/icons/components/encoder.svg"] +no_list: true +modulescript: true +hide_children: true +date: "2024-10-21" +# SME: Rand +--- diff --git a/docs/reference/components/encoder/arduino.md b/docs/reference/components/encoder/arduino.md new file mode 100644 index 0000000000..e9fcf19cbc --- /dev/null +++ b/docs/reference/components/encoder/arduino.md @@ -0,0 +1,11 @@ +--- +title: "Configure an Arduino Encoder" +linkTitle: "arduino" +type: "docs" +description: "Configure an Arduino encoder." +images: ["/icons/components/encoder.svg"] +tags: ["encoder", "components"] +draft: true +toc_hide: true +# SMEs: Rand +--- diff --git a/docs/reference/components/encoder/fake.md b/docs/reference/components/encoder/fake.md new file mode 100644 index 0000000000..e8f931f4d4 --- /dev/null +++ b/docs/reference/components/encoder/fake.md @@ -0,0 +1,12 @@ +--- +title: "Configure a Fake Encoder" +linkTitle: "fake" +type: "docs" +description: "Configure a fake encoder." +images: ["/icons/components/encoder.svg"] +tags: ["encoder", "components"] +weight: 10 +component_description: "An encoder model for testing." +toc_hide: true +# SMEs: Rand +--- diff --git a/docs/reference/components/encoder/incremental-micro-rdk.md b/docs/reference/components/encoder/incremental-micro-rdk.md new file mode 100644 index 0000000000..daf93628e9 --- /dev/null +++ b/docs/reference/components/encoder/incremental-micro-rdk.md @@ -0,0 +1,12 @@ +--- +title: "Configure an Incremental Encoder (Micro-RDK)" +linkTitle: "incremental (Micro-RDK)" +titleMustBeLong: true +type: "docs" +description: "Configure an incremental encoder." +images: ["/icons/components/encoder.svg"] +tags: ["encoder", "components"] +micrordk_component: true +toc_hide: true +# SMEs: Rand +--- diff --git a/docs/reference/components/encoder/incremental.md b/docs/reference/components/encoder/incremental.md new file mode 100644 index 0000000000..c6eccf974b --- /dev/null +++ b/docs/reference/components/encoder/incremental.md @@ -0,0 +1,11 @@ +--- +title: "Configure an Incremental Encoder" +linkTitle: "incremental" +type: "docs" +description: "Configure an incremental encoder." +images: ["/icons/components/encoder.svg"] +tags: ["encoder", "components"] +component_description: "Supports a two phase encoder, which can measure the speed and direction of rotation in relation to a given reference point." +toc_hide: true +# SMEs: Rand +--- diff --git a/docs/reference/components/encoder/single-micro-rdk.md b/docs/reference/components/encoder/single-micro-rdk.md new file mode 100644 index 0000000000..b4b28956f8 --- /dev/null +++ b/docs/reference/components/encoder/single-micro-rdk.md @@ -0,0 +1,11 @@ +--- +title: "Configure a Single Encoder (Micro-RDK)" +linkTitle: "single (Micro-RDK)" +type: "docs" +description: "Configure a single encoder with a microcontroller." +images: ["/icons/components/encoder.svg"] +tags: ["encoder", "components"] +micrordk_component: true +toc_hide: true +# SMEs: Rand +--- diff --git a/docs/reference/components/encoder/single.md b/docs/reference/components/encoder/single.md new file mode 100644 index 0000000000..a1b2a8f6cc --- /dev/null +++ b/docs/reference/components/encoder/single.md @@ -0,0 +1,11 @@ +--- +title: "Configure a Single Encoder" +linkTitle: "single" +type: "docs" +description: "Configure a single encoder." +images: ["/icons/components/encoder.svg"] +tags: ["encoder", "components"] +component_description: "A single pin 'pulse output' encoder which returns its relative position but no direction." +toc_hide: true +# SMEs: Rand +--- diff --git a/docs/reference/components/gantry/_index.md b/docs/reference/components/gantry/_index.md new file mode 100644 index 0000000000..78b58d990e --- /dev/null +++ b/docs/reference/components/gantry/_index.md @@ -0,0 +1,16 @@ +--- +title: "Gantry Component" +linkTitle: "Gantry" +childTitleEndOverwrite: "Gantry Component" +no_list: true +weight: 50 +type: "docs" +description: "A mechanical system of linear rails that can precisely position an attached device." +tags: ["gantry", "components"] +icon: true +images: ["/icons/components/gantry.svg"] +modulescript: true +hide_children: true +date: "2024-10-21" +# SME: Rand +--- diff --git a/docs/reference/components/gantry/fake.md b/docs/reference/components/gantry/fake.md new file mode 100644 index 0000000000..cabab21e9f --- /dev/null +++ b/docs/reference/components/gantry/fake.md @@ -0,0 +1,13 @@ +--- +title: "Configure a Fake Gantry" +linkTitle: "fake" +weight: 10 +type: "docs" +description: "Configure a fake gantry." +tags: ["gantry", "components"] +icon: true +images: ["/icons/components/gantry.svg"] +component_description: "A model used for testing, with no physical hardware." +toc_hide: true +# SME: Rand +--- diff --git a/docs/reference/components/gantry/multi-axis.md b/docs/reference/components/gantry/multi-axis.md new file mode 100644 index 0000000000..1242793302 --- /dev/null +++ b/docs/reference/components/gantry/multi-axis.md @@ -0,0 +1,12 @@ +--- +title: "Configure a Multi-Axis Gantry" +linkTitle: "multi-axis" +weight: 80 +type: "docs" +description: "Configure a multi-axis gantry." +images: ["/icons/components/gantry.svg"] +tags: ["gantry", "components"] +component_description: "Supports a gantry with multiple linear rails. Composed of multiple single-axis gantries." +toc_hide: true +# SME: Rand, Martha +--- diff --git a/docs/reference/components/gantry/single-axis.md b/docs/reference/components/gantry/single-axis.md new file mode 100644 index 0000000000..6ae2f4521b --- /dev/null +++ b/docs/reference/components/gantry/single-axis.md @@ -0,0 +1,12 @@ +--- +title: "Configure a Single-Axis Gantry" +linkTitle: "single-axis" +weight: 70 +type: "docs" +description: "Configure a single-axis gantry." +images: ["/icons/components/gantry.svg"] +tags: ["gantry", "components"] +component_description: "Supports a gantry with a singular linear rail." +toc_hide: true +# SME: Rand, Martha +--- diff --git a/docs/reference/components/generic/_index.md b/docs/reference/components/generic/_index.md new file mode 100644 index 0000000000..ceec7516d2 --- /dev/null +++ b/docs/reference/components/generic/_index.md @@ -0,0 +1,16 @@ +--- +title: "Generic Component" +linkTitle: "Generic" +childTitleEndOverwrite: "Generic Component" +weight: 55 +type: "docs" +description: "A component that does not fit any of the other APIs." +tags: ["generic", "components"] +icon: true +images: ["/icons/components/generic.svg"] +no_list: true +modulescript: true +hide_children: true +date: "2024-10-21" +# SMEs: +--- diff --git a/docs/reference/components/generic/fake.md b/docs/reference/components/generic/fake.md new file mode 100644 index 0000000000..7e069767cf --- /dev/null +++ b/docs/reference/components/generic/fake.md @@ -0,0 +1,10 @@ +--- +title: "Configure a Fake Generic Component" +linkTitle: "fake" +weight: 10 +type: "docs" +description: "Configure a fake generic component." +tags: ["generic", "components"] +component_description: "A model used for testing, with no physical hardware." +toc_hide: true +--- diff --git a/docs/reference/components/gripper/_index.md b/docs/reference/components/gripper/_index.md new file mode 100644 index 0000000000..6f2f9c2488 --- /dev/null +++ b/docs/reference/components/gripper/_index.md @@ -0,0 +1,16 @@ +--- +title: "Gripper Component" +linkTitle: "Gripper" +childTitleEndOverwrite: "Gripper Component" +weight: 60 +type: "docs" +description: "A gripper is a robotic grasping device that can open and close." +tags: ["gripper", "components"] +icon: true +images: ["/icons/components/gripper.svg"] +no_list: true +modulescript: true +hide_children: true +date: "2024-10-21" +# SMEs: Bucket Team +--- diff --git a/docs/reference/components/gripper/fake.md b/docs/reference/components/gripper/fake.md new file mode 100644 index 0000000000..a19c79d335 --- /dev/null +++ b/docs/reference/components/gripper/fake.md @@ -0,0 +1,13 @@ +--- +title: "Configure a Fake Gripper" +linkTitle: "fake" +weight: 10 +type: "docs" +description: "Configure a fake gripper." +tags: ["gripper", "components"] +icon: true +images: ["/icons/components/gripper.svg"] +component_description: "A model used for testing, with no physical hardware." +toc_hide: true +# SME: Rand +--- diff --git a/docs/reference/components/input-controller/_index.md b/docs/reference/components/input-controller/_index.md new file mode 100644 index 0000000000..4738d15c42 --- /dev/null +++ b/docs/reference/components/input-controller/_index.md @@ -0,0 +1,15 @@ +--- +title: "Input Controller Component" +linkTitle: "Input Controller" +weight: 60 +type: "docs" +no_list: true +description: "An input controller, like a gamepad or joystick, is a device humans use to control a machine's actions." +tags: ["input controller", "components"] +icon: true +images: ["/icons/components/controller.svg"] +modulescript: true +hide_children: true +date: "2024-10-21" +# SME: James +--- diff --git a/docs/reference/components/input-controller/fake.md b/docs/reference/components/input-controller/fake.md new file mode 100644 index 0000000000..1f33b5a5b6 --- /dev/null +++ b/docs/reference/components/input-controller/fake.md @@ -0,0 +1,12 @@ +--- +title: "Configure a Fake Input Controller for Testing" +linkTitle: "fake" +weight: 30 +type: "docs" +description: "Configure a fake input controller for testing." +images: ["/icons/components/controller.svg"] +tags: ["input controller", "components"] +component_description: "A model for testing, with no physical hardware." +toc_hide: true +# SMEs: James +--- diff --git a/docs/reference/components/input-controller/gamepad.md b/docs/reference/components/input-controller/gamepad.md new file mode 100644 index 0000000000..6adb34da1b --- /dev/null +++ b/docs/reference/components/input-controller/gamepad.md @@ -0,0 +1,12 @@ +--- +title: "Configure a Linux-supported Gamepad" +linkTitle: "gamepad" +weight: 30 +type: "docs" +description: "Configure a linux-supported gamepad as an input controller." +images: ["/icons/components/controller.svg"] +tags: ["input controller", "components"] +component_description: "Supports X-box, Playstation, and similar controllers with Linux support." +toc_hide: true +# SMEs: James +--- diff --git a/docs/reference/components/input-controller/gpio.md b/docs/reference/components/input-controller/gpio.md new file mode 100644 index 0000000000..e3e27c94d5 --- /dev/null +++ b/docs/reference/components/input-controller/gpio.md @@ -0,0 +1,12 @@ +--- +title: "Configure a GPIO/ADC-Based Input Controller" +linkTitle: "gpio" +weight: 30 +type: "docs" +description: "Configure a GPIO- or ADC-based device as an input controller." +images: ["/icons/components/controller.svg"] +tags: ["input controller", "components"] +component_description: "Customizable GPIO/ADC based device using a board component." +toc_hide: true +# SMEs: James +--- diff --git a/docs/reference/components/input-controller/mux.md b/docs/reference/components/input-controller/mux.md new file mode 100644 index 0000000000..6d22165237 --- /dev/null +++ b/docs/reference/components/input-controller/mux.md @@ -0,0 +1,12 @@ +--- +title: "Configure a Mux Input Controller" +linkTitle: "mux" +weight: 30 +type: "docs" +description: "Configure a mux input controller to combine one or more input controllers." +images: ["/icons/components/controller.svg"] +tags: ["input controller", "components"] +component_description: "Supports multiplexed controllers, combining multiple sources of input." +toc_hide: true +# SMEs: James +--- diff --git a/docs/reference/components/input-controller/webgamepad.md b/docs/reference/components/input-controller/webgamepad.md new file mode 100644 index 0000000000..277c68ec18 --- /dev/null +++ b/docs/reference/components/input-controller/webgamepad.md @@ -0,0 +1,12 @@ +--- +title: "Configure a Web Gamepad" +linkTitle: "webgamepad" +weight: 30 +type: "docs" +description: "Configure a web-based gamepad as an input controller." +images: ["/icons/components/controller.svg"] +tags: ["input controller", "components"] +component_description: "Supports a remote, web based gamepad." +toc_hide: true +# SMEs: James +--- diff --git a/docs/reference/components/motor/_index.md b/docs/reference/components/motor/_index.md new file mode 100644 index 0000000000..811623532c --- /dev/null +++ b/docs/reference/components/motor/_index.md @@ -0,0 +1,16 @@ +--- +title: "Motor Component" +linkTitle: "Motor" +childTitleEndOverwrite: "Motor Component" +weight: 70 +type: "docs" +description: "A motor is a rotating machine that transforms electrical energy into mechanical energy." +tags: ["motor", "components"] +icon: true +images: ["/icons/components/motor.svg"] +no_list: true +modulescript: true +hide_children: true +date: "2024-10-21" +# SME: Rand +--- diff --git a/docs/reference/components/motor/dmc4000.md b/docs/reference/components/motor/dmc4000.md new file mode 100644 index 0000000000..e19cb82454 --- /dev/null +++ b/docs/reference/components/motor/dmc4000.md @@ -0,0 +1,11 @@ +--- +title: "Configure a DMC4000-Controlled Motor" +linkTitle: "DMC4000" +weight: 60 +type: "docs" +description: "Configure a stepper motor controlled by a DMC-40x0 series motion controller." +images: ["/icons/components/motor.svg"] +component_description: "Stepper motor driven by a DMC-40x0 series motion controller." +# SMEs: Rand, James +toc_hide: true +--- diff --git a/docs/reference/components/motor/encoded-motor.md b/docs/reference/components/motor/encoded-motor.md new file mode 100644 index 0000000000..b01d1eb962 --- /dev/null +++ b/docs/reference/components/motor/encoded-motor.md @@ -0,0 +1,11 @@ +--- +title: "Configure a Motor with an Encoder" +linkTitle: "Encoded Motors" +weight: 90 +type: "docs" +description: "How to configure an encoded motor." +images: ["/icons/components/motor.svg"] +component_description: "Standard brushed or brushless DC motor with an encoder." +toc_hide: true +# SMEs: Rand, James +--- diff --git a/docs/reference/components/motor/fake.md b/docs/reference/components/motor/fake.md new file mode 100644 index 0000000000..82fed87bb5 --- /dev/null +++ b/docs/reference/components/motor/fake.md @@ -0,0 +1,11 @@ +--- +title: "Configure a Fake Motor" +linkTitle: "fake" +weight: 10 +type: "docs" +description: "Configure a fake motor to test software without any hardware." +images: ["/icons/components/motor.svg"] +component_description: "A model for testing, with no physical hardware." +toc_hide: true +# SMEs: Rand, James +--- diff --git a/docs/reference/components/motor/gpio-micro-rdk.md b/docs/reference/components/motor/gpio-micro-rdk.md new file mode 100644 index 0000000000..5402c4b622 --- /dev/null +++ b/docs/reference/components/motor/gpio-micro-rdk.md @@ -0,0 +1,11 @@ +--- +title: "Configure a GPIO Motor (Micro-RDK)" +linkTitle: "gpio (Micro-RDK)" +weight: 10 +type: "docs" +description: "Configure brushed or brushless DC motors with a microcontroller." +images: ["/icons/components/motor.svg"] +micrordk_component: true +toc_hide: true +# SMEs: Rand, James +--- diff --git a/docs/reference/components/motor/gpio.md b/docs/reference/components/motor/gpio.md new file mode 100644 index 0000000000..b25b503533 --- /dev/null +++ b/docs/reference/components/motor/gpio.md @@ -0,0 +1,13 @@ +--- +title: "Configure a GPIO-Controlled Motor" +linkTitle: "gpio" +weight: 10 +type: "docs" +description: "Configure brushed or brushless DC motors." +images: ["/icons/components/motor.svg"] +no_list: true +component_description: "Supports standard brushed or brushless DC motors." +usage: 999999 +toc_hide: true +# SMEs: Rand, James +--- diff --git a/docs/reference/components/motor/gpiostepper.md b/docs/reference/components/motor/gpiostepper.md new file mode 100644 index 0000000000..d270efa70c --- /dev/null +++ b/docs/reference/components/motor/gpiostepper.md @@ -0,0 +1,12 @@ +--- +title: "Configure a GPIO-Controlled Stepper Motor" +linkTitle: "gpiostepper" +weight: 20 +type: "docs" +description: "Configure a bipolar stepper motor with current regulation and 1/32 microstepping driven by a basic driver." +images: ["/icons/components/motor.svg"] +component_description: "Supports stepper motors driven by basic GPIO-controlled stepper driver chips." +usage: 900000 +toc_hide: true +# SMEs: Rand, James +--- diff --git a/docs/reference/components/movement-sensor/_index.md b/docs/reference/components/movement-sensor/_index.md new file mode 100644 index 0000000000..99c4f496c8 --- /dev/null +++ b/docs/reference/components/movement-sensor/_index.md @@ -0,0 +1,16 @@ +--- +title: "Movement Sensor Component" +linkTitle: "Movement Sensor" +childTitleEndOverwrite: "Movement Sensor" +weight: 70 +type: "docs" +description: "A sensor that measures location, kinematic data, or both." +tags: ["movement sensor", "gps", "imu", "sensor", "components"] +icon: true +images: ["/icons/components/imu.svg"] +no_list: true +modulescript: true +hide_children: true +date: "2024-10-21" +# SME: Rand +--- diff --git a/docs/reference/components/movement-sensor/accel-adxl345-micro-rdk.md b/docs/reference/components/movement-sensor/accel-adxl345-micro-rdk.md new file mode 100644 index 0000000000..d1116f0d26 --- /dev/null +++ b/docs/reference/components/movement-sensor/accel-adxl345-micro-rdk.md @@ -0,0 +1,12 @@ +--- +title: "Configure an ADXL345 Accelerometer (Micro-RDK)" +linkTitle: "accel-adxl345 (Micro-RDK)" +titleMustBeLong: true +weight: 20 +type: "docs" +description: "Configure an ADXL345 digital accelerometer with a microcontroller." +images: ["/icons/components/imu.svg"] +micrordk_component: true +toc_hide: true +# SMEs: Rand, Kim Mishra +--- diff --git a/docs/reference/components/movement-sensor/fake.md b/docs/reference/components/movement-sensor/fake.md new file mode 100644 index 0000000000..ebb663155e --- /dev/null +++ b/docs/reference/components/movement-sensor/fake.md @@ -0,0 +1,11 @@ +--- +title: "Configure a Fake Movement Sensor" +linkTitle: "fake" +weight: 10 +type: "docs" +description: "Configure a fake movement sensor to test software without any hardware." +images: ["/icons/components/imu.svg"] +component_description: "A model for testing, with no physical hardware." +toc_hide: true +# SMEs: Rand +--- diff --git a/docs/reference/components/movement-sensor/gyro-mpu6050-micro-rdk.md b/docs/reference/components/movement-sensor/gyro-mpu6050-micro-rdk.md new file mode 100644 index 0000000000..ea52b4dd5c --- /dev/null +++ b/docs/reference/components/movement-sensor/gyro-mpu6050-micro-rdk.md @@ -0,0 +1,11 @@ +--- +title: "Configure an MPU-6050 (Micro-RDK)" +linkTitle: "gyro-mpu6050 (Micro-RDK)" +weight: 40 +type: "docs" +description: "Configure an MPU-6050 movement sensor with a microcontroller." +images: ["/icons/components/imu.svg"] +micrordk_component: true +toc_hide: true +# SMEs: Rand +--- diff --git a/docs/reference/components/movement-sensor/merged.md b/docs/reference/components/movement-sensor/merged.md new file mode 100644 index 0000000000..92598701c3 --- /dev/null +++ b/docs/reference/components/movement-sensor/merged.md @@ -0,0 +1,11 @@ +--- +title: "Configure a Merged Movement Sensor" +linkTitle: "merged" +weight: 40 +type: "docs" +description: "Configure a merged movement sensor." +images: ["/icons/components/imu.svg"] +component_description: "A model that allows you to aggregate the API methods supported by multiple sensors into a singular sensor client, effectively merging the models of the individual resources." +toc_hide: true +# SMEs: Rand +--- diff --git a/docs/reference/components/movement-sensor/set-up-base-station.md b/docs/reference/components/movement-sensor/set-up-base-station.md new file mode 100644 index 0000000000..96d48646fa --- /dev/null +++ b/docs/reference/components/movement-sensor/set-up-base-station.md @@ -0,0 +1,13 @@ +--- +title: "Set up a SparkFun RTK Reference Station" +linkTitle: "SparkFun RTK Reference Station Setup" +weight: 20 +type: "docs" +description: "Follow this guide to set up your own SparkFun RTK base station, a high-precision GPS module designed for use with the RTK satellite navigation technique." +images: ["/icons/components/imu.svg"] +no_component: true +date: "2024-01-01" +toc_hide: true +# updated: "" # When the content was last entirely checked +# SMEs: Susmita +--- diff --git a/docs/reference/components/movement-sensor/wheeled-odometry.md b/docs/reference/components/movement-sensor/wheeled-odometry.md new file mode 100644 index 0000000000..ad76754193 --- /dev/null +++ b/docs/reference/components/movement-sensor/wheeled-odometry.md @@ -0,0 +1,20 @@ +--- +title: "Configure a Wheeled Odometry Movement Sensor" +linkTitle: "wheeled-odometry" +type: "docs" +description: "Configure a wheeled odometry movement sensor." +images: ["/icons/components/imu.svg"] +tags: + [ + "movement sensor", + "components", + "encoder", + "motor", + "base", + "wheeled", + "odometry", + ] +component_description: "A model that uses encoders to get an odometry estimate from a wheeled base." +toc_hide: true +# SMEs: Rand, Martha +--- diff --git a/docs/reference/components/power-sensor/_index.md b/docs/reference/components/power-sensor/_index.md new file mode 100644 index 0000000000..9c270a3c7a --- /dev/null +++ b/docs/reference/components/power-sensor/_index.md @@ -0,0 +1,16 @@ +--- +title: "Power Sensor Component" +linkTitle: "Power Sensor" +childTitleEndOverwrite: "Power Sensor" +weight: 70 +no_list: true +type: "docs" +description: "A device that provides information about a machine's power systems, including voltage, current, and power consumption." +tags: ["sensor", "components", "power sensor", "ina219", "ina226", "renogy"] +icon: true +images: ["/icons/components/power-sensor.svg"] +modulescript: true +date: "2024-10-21" +hide_children: true +# SME: #team-bucket +--- diff --git a/docs/reference/components/power-sensor/fake.md b/docs/reference/components/power-sensor/fake.md new file mode 100644 index 0000000000..fe2ec43b9f --- /dev/null +++ b/docs/reference/components/power-sensor/fake.md @@ -0,0 +1,13 @@ +--- +title: "Configure a Fake Power Sensor" +linkTitle: "fake" +weight: 10 +type: "docs" +description: "Configure a fake power sensor to test software without the physical hardware." +tags: ["sensor", "power sensor"] +icon: true +images: ["/icons/components/sensor.svg"] +component_description: "A model for testing, with no physical hardware." +toc_hide: true +# SME: #team-bucket +--- diff --git a/docs/reference/components/sensor/_index.md b/docs/reference/components/sensor/_index.md new file mode 100644 index 0000000000..77365c9f0d --- /dev/null +++ b/docs/reference/components/sensor/_index.md @@ -0,0 +1,16 @@ +--- +title: "Sensor Component" +linkTitle: "Sensor" +childTitleEndOverwrite: "Sensor Component" +weight: 70 +no_list: true +type: "docs" +description: "A device that sends information about the outside world to the computer controlling a machine." +tags: ["sensor", "components"] +icon: true +images: ["/icons/components/sensor.svg"] +modulescript: true +date: "2024-10-21" +hide_children: true +# SME: #team-bucket +--- diff --git a/docs/reference/components/sensor/fake.md b/docs/reference/components/sensor/fake.md new file mode 100644 index 0000000000..30da57ff0a --- /dev/null +++ b/docs/reference/components/sensor/fake.md @@ -0,0 +1,13 @@ +--- +title: "Create a Fake Sensor" +linkTitle: "fake" +weight: 10 +type: "docs" +description: "Configure a fake sensor to use for testing." +tags: ["sensor", "components"] +icon: true +images: ["/icons/components/sensor.svg"] +component_description: "A model used for testing, with no physical hardware." +toc_hide: true +# SME: #team-bucket +--- diff --git a/docs/reference/components/sensor/ultrasonic-micro-rdk.md b/docs/reference/components/sensor/ultrasonic-micro-rdk.md new file mode 100644 index 0000000000..f75e34c3c8 --- /dev/null +++ b/docs/reference/components/sensor/ultrasonic-micro-rdk.md @@ -0,0 +1,13 @@ +--- +title: "Configure an Ultrasonic Sensor (Micro-RDK)" +linkTitle: "ultrasonic (Micro-RDK)" +weight: 60 +type: "docs" +description: "Configure an ultrasonic sensor with a microcontroller." +tags: ["sensor", "components", "ultrasonic"] +icon: true +images: ["/icons/components/sensor.svg"] +micrordk_component: true +toc_hide: true +# SME: Andrew Morrow +--- diff --git a/docs/reference/components/servo/_index.md b/docs/reference/components/servo/_index.md new file mode 100644 index 0000000000..db1f742141 --- /dev/null +++ b/docs/reference/components/servo/_index.md @@ -0,0 +1,16 @@ +--- +title: "Servo Component" +linkTitle: "Servo" +childTitleEndOverwrite: "Servo Component" +weight: 80 +type: "docs" +description: "A hobby servo is a special type of small motor whose position you can precisely control." +tags: ["servo", "components"] +icon: true +images: ["/icons/components/servo.svg"] +no_list: true +modulescript: true +hide_children: true +date: "2024-10-21" +# SME: #team-bucket +--- diff --git a/docs/reference/components/servo/fake.md b/docs/reference/components/servo/fake.md new file mode 100644 index 0000000000..ae3e67403f --- /dev/null +++ b/docs/reference/components/servo/fake.md @@ -0,0 +1,13 @@ +--- +title: "Configure a Fake Servo" +linkTitle: "fake" +weight: 10 +type: "docs" +description: "Configure a fake servo." +tags: ["servo", "components"] +icon: true +images: ["/icons/components/servo.svg"] +component_description: "A model used for testing, with no physical hardware." +toc_hide: true +# SME: Rand +--- diff --git a/docs/reference/components/servo/gpio-micro-rdk.md b/docs/reference/components/servo/gpio-micro-rdk.md new file mode 100644 index 0000000000..605a2b7779 --- /dev/null +++ b/docs/reference/components/servo/gpio-micro-rdk.md @@ -0,0 +1,13 @@ +--- +title: "Configure a GPIO Servo (Micro-RDK)" +linkTitle: "gpio (Micro-RDK)" +weight: 90 +type: "docs" +description: "Configure a gpio hobby servo with a microcontroller." +tags: ["servo", "components"] +icon: true +images: ["/icons/components/servo.svg"] +micrordk_component: true +toc_hide: true +# SME: Gautham +--- diff --git a/docs/reference/components/servo/gpio.md b/docs/reference/components/servo/gpio.md new file mode 100644 index 0000000000..077e0f2976 --- /dev/null +++ b/docs/reference/components/servo/gpio.md @@ -0,0 +1,13 @@ +--- +title: "Configure a GPIO-Controlled Servo" +linkTitle: "gpio" +weight: 90 +type: "docs" +description: "Configure a gpio servo." +tags: ["servo", "components"] +icon: true +images: ["/icons/components/servo.svg"] +component_description: "Supports a hobby servo wired to a board that supports PWM, for example Raspberry Pi 5, Orange Pi, Jetson, or PCAXXXX." +toc_hide: true +# SME: Rand +--- diff --git a/docs/reference/components/switch/_index.md b/docs/reference/components/switch/_index.md new file mode 100644 index 0000000000..8482ba7d26 --- /dev/null +++ b/docs/reference/components/switch/_index.md @@ -0,0 +1,16 @@ +--- +title: "Switch Component" +linkTitle: "Switch" +childTitleEndOverwrite: "Switch Component" +weight: 100 +type: "docs" +description: "A physical multi-position switch on a machine." +tags: ["switch", "components"] +icon: true # this should be used when the image is an icon, it will adjust the sizing and object-fit +images: ["/icons/components/switch.svg"] +no_list: true +modulescript: true +hide_children: true +date: "2025-02-20" +# SMEs: +--- diff --git a/docs/reference/components/switch/fake.md b/docs/reference/components/switch/fake.md new file mode 100644 index 0000000000..059abebf40 --- /dev/null +++ b/docs/reference/components/switch/fake.md @@ -0,0 +1,11 @@ +--- +title: "Configure a Fake Switch" +linkTitle: "fake" +weight: 10 +type: "docs" +description: "Configure a fake switch for testing." +images: ["/icons/components/switch.svg"] +tags: ["switch", "components"] +component_description: "A model used for testing, with no physical hardware." +toc_hide: true +--- diff --git a/docs/reference/configuration/_index.md b/docs/reference/configuration/_index.md new file mode 100644 index 0000000000..d34adc4ee6 --- /dev/null +++ b/docs/reference/configuration/_index.md @@ -0,0 +1,8 @@ +--- +title: "Configuration" +linkTitle: "Configuration" +weight: 60 +type: "docs" +no_list: true +description: "Detailed configuration reference for triggers, ML models, controls, and kinematics." +--- diff --git a/docs/reference/configuration/controls-package.md b/docs/reference/configuration/controls-package.md new file mode 100644 index 0000000000..1cbc320b86 --- /dev/null +++ b/docs/reference/configuration/controls-package.md @@ -0,0 +1,11 @@ +--- +title: "Control package" +linkTitle: "Control package" +weight: 60 +type: "docs" +description: "The Control Package implements feedback control on an endpoint." +# SME: Nicolas Menard, Rand, Martha +date: "2022-01-01" +no_list: true +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/configuration/kinematic-chain-config.md b/docs/reference/configuration/kinematic-chain-config.md new file mode 100644 index 0000000000..27663647be --- /dev/null +++ b/docs/reference/configuration/kinematic-chain-config.md @@ -0,0 +1,12 @@ +--- +title: "Configure complex kinematic chains" +linkTitle: "Complex kinematic chains" +weight: 200 +type: "docs" +description: "Define kinematic parameters to configure intermediate reference frames for components with complex kinematic chains." +tags: ["slam", "services"] +date: "2022-01-01" +updated: "2024-10-21" +no_list: true +# SMEs: Motion +--- diff --git a/docs/reference/configuration/mlmodel-design.md b/docs/reference/configuration/mlmodel-design.md new file mode 100644 index 0000000000..d783d663ff --- /dev/null +++ b/docs/reference/configuration/mlmodel-design.md @@ -0,0 +1,13 @@ +--- +title: "Design your ML models for vision" +linkTitle: "ML model service design" +weight: 60 +type: "docs" +tags: ["data management", "ml", "model training", "vision"] +description: "Design your ML Model service to work with Viam's vision services." +icon: true +images: ["/services/icons/ml.svg"] +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +# SME: Bijan Haney +--- diff --git a/docs/reference/configuration/slam-background.md b/docs/reference/configuration/slam-background.md new file mode 100644 index 0000000000..40c85a66fd --- /dev/null +++ b/docs/reference/configuration/slam-background.md @@ -0,0 +1,12 @@ +--- +title: "SLAM service background" +linkTitle: "SLAM technical" +weight: 70 +type: "docs" +draft: true +description: "Background and technical information for the Simultaneous Localization And Mapping (SLAM) service, its configuration, its functionality, and its interfaces." +tags: ["slam", "services"] +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +# SMEs: Jeremy, Kat +--- diff --git a/docs/reference/configuration/triggers.md b/docs/reference/configuration/triggers.md new file mode 100644 index 0000000000..5ef796cede --- /dev/null +++ b/docs/reference/configuration/triggers.md @@ -0,0 +1,10 @@ +--- +title: "Trigger configuration" +linkTitle: "Trigger configuration" +weight: 60 +type: "docs" +tags: ["data management", "trigger", "webhook"] +description: "Detailed information about how to configure triggers and webhooks." +date: "2025-05-05" +updated: "2025-09-18" +--- diff --git a/docs/reference/device-setup/_index.md b/docs/reference/device-setup/_index.md new file mode 100644 index 0000000000..6f99a971e1 --- /dev/null +++ b/docs/reference/device-setup/_index.md @@ -0,0 +1,8 @@ +--- +title: "Device Setup" +linkTitle: "Device Setup" +weight: 55 +type: "docs" +no_list: true +description: "Setup guides for single-board computers and other devices supported by Viam." +--- diff --git a/docs/reference/device-setup/beaglebone-setup.md b/docs/reference/device-setup/beaglebone-setup.md new file mode 100644 index 0000000000..b4054b258d --- /dev/null +++ b/docs/reference/device-setup/beaglebone-setup.md @@ -0,0 +1,13 @@ +--- +title: "BeagleBone AI-64 Setup Guide" +linkTitle: "BeagleBone Setup" +weight: 20 +type: "docs" +description: "Flash a BeagleBone AI-64 to prepare it for viam-server installation." +images: ["/installation/thumbnails/beaglebone.png"] +imageAlt: "BeagleBone A I-64" +no_list: true +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +# SMEs: Shawn and Rand +--- diff --git a/docs/reference/device-setup/board1-setup.md b/docs/reference/device-setup/board1-setup.md new file mode 100644 index 0000000000..3348da4761 --- /dev/null +++ b/docs/reference/device-setup/board1-setup.md @@ -0,0 +1,13 @@ +--- +title: " Setup Guide" +linkTitle: " Setup" +weight: 16 +type: "docs" +description: "Flash an for the to prepare it for viam-server installation." +images: ["/installation/thumbnails/prepare.png"] +imageAlt: "" +no_list: true +draft: true +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/device-setup/jetson-agx-orin-setup.md b/docs/reference/device-setup/jetson-agx-orin-setup.md new file mode 100644 index 0000000000..6f593d1074 --- /dev/null +++ b/docs/reference/device-setup/jetson-agx-orin-setup.md @@ -0,0 +1,13 @@ +--- +title: "NVIDIA Jetson AGX Orin Setup Guide" +linkTitle: "Jetson AGX Orin Setup" +weight: 20 +type: "docs" +images: ["/installation/thumbnails/jetson-agx-orin-dev-kit.png"] +imageAlt: "Jetson A G X Orin Developer Kit" +description: "Set up the Jetson AGX Orin Developer Kit to prepare your NVIDIA Jetson AGX Orin for viam-server installation." +no_list: true +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +# SMEs: Pete Garafano +--- diff --git a/docs/reference/device-setup/jetson-nano-setup.md b/docs/reference/device-setup/jetson-nano-setup.md new file mode 100644 index 0000000000..acb3f9c99a --- /dev/null +++ b/docs/reference/device-setup/jetson-nano-setup.md @@ -0,0 +1,13 @@ +--- +title: "NVIDIA Jetson Nano and Orin Nano Setup Guide" +linkTitle: "Jetson Nano and Orin Nano Setup" +weight: 20 +type: "docs" +images: ["/installation/thumbnails/jetson-nano-dev-kit.png"] +imageAlt: "Jetson Nano" +description: "Prepare your Jetson Nano or Jetson Orin Nano for viam-server installation." +no_list: true +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +# SMEs: Pete Garafano +--- diff --git a/docs/reference/device-setup/odroid-c4-setup.md b/docs/reference/device-setup/odroid-c4-setup.md new file mode 100644 index 0000000000..9e97badbeb --- /dev/null +++ b/docs/reference/device-setup/odroid-c4-setup.md @@ -0,0 +1,13 @@ +--- +title: "Odroid C4 Setup Guide" +linkTitle: "Odroid-C4 Setup" +weight: 16 +type: "docs" +description: "Image a Odroid-C4 to prepare it for viam-server installation." +images: ["/installation/thumbnails/odroid-c4.png"] +imageAlt: "Odroid-C4" +no_list: true +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +# SME: Olivia Miller +--- diff --git a/docs/reference/device-setup/orange-pi-3-lts.md b/docs/reference/device-setup/orange-pi-3-lts.md new file mode 100644 index 0000000000..8921efe432 --- /dev/null +++ b/docs/reference/device-setup/orange-pi-3-lts.md @@ -0,0 +1,13 @@ +--- +title: "Orange Pi 3 LTS Setup Guide" +linkTitle: "Orange Pi 3 LTS Setup" +weight: 16 +type: "docs" +description: "Image an Orange Pi 3 LTS to prepare it for viam-server installation." +images: ["/installation/thumbnails/orange-pi-3-LTS.png"] +imageAlt: "Orange Pi 3 LTS" +no_list: true +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +# SME: Olivia Miller +--- diff --git a/docs/reference/device-setup/orange-pi-zero2.md b/docs/reference/device-setup/orange-pi-zero2.md new file mode 100644 index 0000000000..c3ead4bdf5 --- /dev/null +++ b/docs/reference/device-setup/orange-pi-zero2.md @@ -0,0 +1,13 @@ +--- +title: "Orange Pi Zero2 Setup Guide" +linkTitle: "Orange Pi Zero2 Setup" +weight: 16 +type: "docs" +description: "Image an Orange Pi Zero2 to prepare it for viam-server installation." +images: ["/installation/thumbnails/orange-pi-zero2.png"] +imageAlt: "Orange Pi Zero2" +no_list: true +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +# SME: Olivia Miller +--- diff --git a/docs/reference/device-setup/pumpkin.md b/docs/reference/device-setup/pumpkin.md new file mode 100644 index 0000000000..a070270429 --- /dev/null +++ b/docs/reference/device-setup/pumpkin.md @@ -0,0 +1,12 @@ +--- +title: "Pumpkin Board Setup Guide" +linkTitle: "Pumpkin Board Setup" +weight: 25 +type: "docs" +images: ["/installation/thumbnails/pumpkin.png"] +imageAlt: "Pumpkin board" +description: "Configure the pin mappings to use a pumpkin board." +no_list: true +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/device-setup/rpi-setup.md b/docs/reference/device-setup/rpi-setup.md new file mode 100644 index 0000000000..67fc8b97b3 --- /dev/null +++ b/docs/reference/device-setup/rpi-setup.md @@ -0,0 +1,13 @@ +--- +title: "Raspberry Pi Setup Guide" +linkTitle: "Raspberry Pi Setup" +weight: 15 +type: "docs" +description: "Image a Raspberry Pi to prepare it for viam-server installation." +images: ["/installation/thumbnails/raspberry-pi-4-b-2gb.png"] +imageAlt: "Raspberry Pi" +no_list: true +# SME: James +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/device-setup/sk-tda4vm.md b/docs/reference/device-setup/sk-tda4vm.md new file mode 100644 index 0000000000..f88f35a194 --- /dev/null +++ b/docs/reference/device-setup/sk-tda4vm.md @@ -0,0 +1,12 @@ +--- +title: "SK-TDA4VM Setup Guide" +linkTitle: "SK-TDA4VM Setup" +weight: 25 +type: "docs" +images: ["/installation/thumbnails/tda4vm.png"] +imageAlt: "S K - T D A 4 V M" +description: "Image a Texas Instruments TDA4VM starter kit board to prepare it for viam-server installation." +no_list: true +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/glossary/api-namespace-triplet.md b/docs/reference/glossary/api-namespace-triplet.md new file mode 100644 index 0000000000..6905c55e2e --- /dev/null +++ b/docs/reference/glossary/api-namespace-triplet.md @@ -0,0 +1,6 @@ +--- +title: API Namespace Triplet +id: api-namespace-triplet +full_link: +short_description: namespace:type:subtype, for example `rdk:component:sensor` +--- diff --git a/docs/reference/glossary/api.md b/docs/reference/glossary/api.md new file mode 100644 index 0000000000..e2e3b37ee4 --- /dev/null +++ b/docs/reference/glossary/api.md @@ -0,0 +1,8 @@ +--- +title: API +id: api +full_link: +short_description: Application programming interface, a set of defined rules that enable different applications to communicate with each other. +aka: +type: "page" +--- diff --git a/docs/reference/glossary/attribute.md b/docs/reference/glossary/attribute.md new file mode 100644 index 0000000000..628036f59b --- /dev/null +++ b/docs/reference/glossary/attribute.md @@ -0,0 +1,8 @@ +--- +title: Attribute +id: attribute +full_link: +short_description: A configuration parameter of a resource. +aka: +type: "page" +--- diff --git a/docs/reference/glossary/base.md b/docs/reference/glossary/base.md new file mode 100644 index 0000000000..ff3e212786 --- /dev/null +++ b/docs/reference/glossary/base.md @@ -0,0 +1,6 @@ +--- +title: Base +id: base +full_link: /components/base/ +short_description: A physical, mobile platform that the other parts of a mobile robot attach to. +--- diff --git a/docs/reference/glossary/blob-storage.md b/docs/reference/glossary/blob-storage.md new file mode 100644 index 0000000000..ea557f2a7b --- /dev/null +++ b/docs/reference/glossary/blob-storage.md @@ -0,0 +1,8 @@ +--- +title: Blob storage +id: blob-storage +full_link: +short_description: A cheap but slow storage medium. +aka: +type: "page" +--- diff --git a/docs/reference/glossary/board.md b/docs/reference/glossary/board.md new file mode 100644 index 0000000000..ea877e6593 --- /dev/null +++ b/docs/reference/glossary/board.md @@ -0,0 +1,6 @@ +--- +title: Board +id: board +full_link: /components/board/ +short_description: A board is the signal wire hub of a machine that provides access to GPIO pins. +--- diff --git a/docs/reference/glossary/captive-web-portal.md b/docs/reference/glossary/captive-web-portal.md new file mode 100644 index 0000000000..38b24d4c3c --- /dev/null +++ b/docs/reference/glossary/captive-web-portal.md @@ -0,0 +1,5 @@ +--- +title: Captive web portal +id: captive-web-portal +short_description: A web page which is automatically displayed to users when connecting to a network. +--- diff --git a/docs/reference/glossary/client-application.md b/docs/reference/glossary/client-application.md new file mode 100644 index 0000000000..f3062213b7 --- /dev/null +++ b/docs/reference/glossary/client-application.md @@ -0,0 +1,6 @@ +--- +title: Client Application +id: client-application +full_link: +short_description: Client applications run business logic to operate your machine. +--- diff --git a/docs/reference/glossary/component.md b/docs/reference/glossary/component.md new file mode 100644 index 0000000000..4fbc8d514f --- /dev/null +++ b/docs/reference/glossary/component.md @@ -0,0 +1,5 @@ +--- +title: Component +id: component +short_description: A resource that often represents a physical piece of hardware which a computer controls; for example, a servo, a camera, or an arm. +--- diff --git a/docs/reference/glossary/flashed.md b/docs/reference/glossary/flashed.md new file mode 100644 index 0000000000..9d0ae31063 --- /dev/null +++ b/docs/reference/glossary/flashed.md @@ -0,0 +1,10 @@ +--- +title: Flash +id: flash +full_link: +short_description: The process of writing an operating system or firmware to a device's storage medium. +aka: + - flashed + - flashing +type: "page" +--- diff --git a/docs/reference/glossary/fragment.md b/docs/reference/glossary/fragment.md new file mode 100644 index 0000000000..9a2cf45f6c --- /dev/null +++ b/docs/reference/glossary/fragment.md @@ -0,0 +1,6 @@ +--- +title: Fragment +id: fragment +full_link: /fleet/reuse-configuration/ +short_description: A reusable configuration block that you can share across multiple machines. +--- diff --git a/docs/reference/glossary/frame-system.md b/docs/reference/glossary/frame-system.md new file mode 100644 index 0000000000..895b7b39f0 --- /dev/null +++ b/docs/reference/glossary/frame-system.md @@ -0,0 +1,6 @@ +--- +title: Frame System +id: frame-system +full_link: /motion-planning/frame-system/ +short_description: The frame system holds reference frame information for the relative position of components in space. +--- diff --git a/docs/reference/glossary/frame.md b/docs/reference/glossary/frame.md new file mode 100644 index 0000000000..d848ec0426 --- /dev/null +++ b/docs/reference/glossary/frame.md @@ -0,0 +1,6 @@ +--- +title: Frame +id: frame +full_link: +short_description: A frame represents a coordinate system that describes the position and orientation of an object. +--- diff --git a/docs/reference/glossary/gantry.md b/docs/reference/glossary/gantry.md new file mode 100644 index 0000000000..af0f21a5f7 --- /dev/null +++ b/docs/reference/glossary/gantry.md @@ -0,0 +1,6 @@ +--- +title: Gantry +id: attribute +full_link: /components/gantry/ +short_description: A mechanical system that only uses linear motion to carry out a task. +--- diff --git a/docs/reference/glossary/grpc.md b/docs/reference/glossary/grpc.md new file mode 100644 index 0000000000..7599e5a827 --- /dev/null +++ b/docs/reference/glossary/grpc.md @@ -0,0 +1,6 @@ +--- +title: gRPC +id: grpc +full_link: +short_description: An open source, cross-platform, high performance Remote Procedure Call (RPC) framework initially developed at Google in 2015. +--- diff --git a/docs/reference/glossary/index.md b/docs/reference/glossary/index.md new file mode 100644 index 0000000000..51eafd8fbc --- /dev/null +++ b/docs/reference/glossary/index.md @@ -0,0 +1,12 @@ +--- +title: "Glossary" +linkTitle: "Glossary" +weight: 999 +type: "docs" +layout: "glossary" +description: "A glossary that explains robotics and Viam-specific jargon." +card: + name: reference + weight: 10 + title: Glossary +--- diff --git a/docs/reference/glossary/job.md b/docs/reference/glossary/job.md new file mode 100644 index 0000000000..b83730b6a9 --- /dev/null +++ b/docs/reference/glossary/job.md @@ -0,0 +1,6 @@ +--- +title: Jobs +id: job +full_link: /fleet/scheduled-jobs/ +short_description: Automated tasks that run on machines at specified intervals to perform routine operations. +--- diff --git a/docs/reference/glossary/location.md b/docs/reference/glossary/location.md new file mode 100644 index 0000000000..b86dd3bb2e --- /dev/null +++ b/docs/reference/glossary/location.md @@ -0,0 +1,6 @@ +--- +title: Location +id: location +full_link: /reference/account/organize/ +short_description: A location is a virtual grouping of machines that allows you to organize machines and manage access to your fleet. +--- diff --git a/docs/reference/glossary/machine-config.md b/docs/reference/glossary/machine-config.md new file mode 100644 index 0000000000..9ddb032710 --- /dev/null +++ b/docs/reference/glossary/machine-config.md @@ -0,0 +1,6 @@ +--- +title: Machine Config +id: machine-config +full_link: /configure/ +short_description: The complete configuration of a single machine part. +--- diff --git a/docs/reference/glossary/machine-fqdn.md b/docs/reference/glossary/machine-fqdn.md new file mode 100644 index 0000000000..0d50be32df --- /dev/null +++ b/docs/reference/glossary/machine-fqdn.md @@ -0,0 +1,8 @@ +--- +title: Machine FQDN +id: machine-fqdn +full_link: +short_description: The fully qualified domain name (FQDN) of a machine in the Viam platform. +aka: +type: "page" +--- diff --git a/docs/reference/glossary/machine-id.md b/docs/reference/glossary/machine-id.md new file mode 100644 index 0000000000..1c7491a8b9 --- /dev/null +++ b/docs/reference/glossary/machine-id.md @@ -0,0 +1,8 @@ +--- +title: Machine ID +id: machine-id +full_link: +short_description: A unique identifier assigned to each machine in the Viam platform. +aka: +type: "page" +--- diff --git a/docs/reference/glossary/machine.md b/docs/reference/glossary/machine.md new file mode 100644 index 0000000000..60cccfe150 --- /dev/null +++ b/docs/reference/glossary/machine.md @@ -0,0 +1,6 @@ +--- +title: Machine +id: machine +full_link: /fleet/machines/ +short_description: An organizational concept, consisting of a computer and the components and services it controls, or sometimes multiple computers working closely together. +--- diff --git a/docs/reference/glossary/ml.md b/docs/reference/glossary/ml.md new file mode 100644 index 0000000000..9bdaf475b4 --- /dev/null +++ b/docs/reference/glossary/ml.md @@ -0,0 +1,8 @@ +--- +title: ML +id: ml +full_link: +short_description: Machine learning, a field of artificial intelligence focused on building systems that learn from data. +aka: +type: "page" +--- diff --git a/docs/reference/glossary/model-namespace-triplet.md b/docs/reference/glossary/model-namespace-triplet.md new file mode 100644 index 0000000000..8a6aa545fd --- /dev/null +++ b/docs/reference/glossary/model-namespace-triplet.md @@ -0,0 +1,5 @@ +--- +title: Model Namespace Triplet +id: model-namespace-triplet +short_description: namespace:module-name:name or rdk:builtin:name +--- diff --git a/docs/reference/glossary/model.md b/docs/reference/glossary/model.md new file mode 100644 index 0000000000..951ff8b8eb --- /dev/null +++ b/docs/reference/glossary/model.md @@ -0,0 +1,6 @@ +--- +title: Model +id: model +full_link: +short_description: A particular implementation of a resource. For example, UR5e is a model of the arm component API. +--- diff --git a/docs/reference/glossary/modular-resource.md b/docs/reference/glossary/modular-resource.md new file mode 100644 index 0000000000..6b17c829f1 --- /dev/null +++ b/docs/reference/glossary/modular-resource.md @@ -0,0 +1,5 @@ +--- +title: Modular Resource +id: modular-resource +short_description: A modular resource is a model of a component or service provided by a module. +--- diff --git a/docs/reference/glossary/module.md b/docs/reference/glossary/module.md new file mode 100644 index 0000000000..5ea6dc8494 --- /dev/null +++ b/docs/reference/glossary/module.md @@ -0,0 +1,6 @@ +--- +title: Module +id: module +full_link: +short_description: Modules are the code packages that provide functionality like drivers, integrations, and control logic to your machines. +--- diff --git a/docs/reference/glossary/mql.md b/docs/reference/glossary/mql.md new file mode 100644 index 0000000000..7c39e34e94 --- /dev/null +++ b/docs/reference/glossary/mql.md @@ -0,0 +1,6 @@ +--- +title: MQL +id: mql +full_link: +short_description: MQL is the MongoDB query language, similar to SQL but specific to the MongoDB document model. +--- diff --git a/docs/reference/glossary/organization.md b/docs/reference/glossary/organization.md new file mode 100644 index 0000000000..b2d1f674da --- /dev/null +++ b/docs/reference/glossary/organization.md @@ -0,0 +1,6 @@ +--- +title: Organization +id: organization +full_link: /reference/account/organize/ +short_description: An organization is a group of one or more locations that helps you organize your fleet and manage who has access to your fleet. +--- diff --git a/docs/reference/glossary/origin-frame.md b/docs/reference/glossary/origin-frame.md new file mode 100644 index 0000000000..bd29cf5cc8 --- /dev/null +++ b/docs/reference/glossary/origin-frame.md @@ -0,0 +1,6 @@ +--- +title: Origin frame +id: origin-frame +full_link: +short_description: The origin frame is the frame at the base of an arm or other component that has a complex kinematics chain. +--- diff --git a/docs/reference/glossary/package.md b/docs/reference/glossary/package.md new file mode 100644 index 0000000000..cc78d4a131 --- /dev/null +++ b/docs/reference/glossary/package.md @@ -0,0 +1,6 @@ +--- +title: Package +id: package +full_link: +short_description: An archive, module, ML model, SLAM Map, or other bundle of binary code. +--- diff --git a/docs/reference/glossary/part.md b/docs/reference/glossary/part.md new file mode 100644 index 0000000000..3be1b32931 --- /dev/null +++ b/docs/reference/glossary/part.md @@ -0,0 +1,6 @@ +--- +title: Part +id: part +full_link: /reference/architecture/parts/ +short_description: A single-board computer, desktop, laptop, or other computer running viam-server, the hardware components attached to it, and any services or other resources running on it. +--- diff --git a/docs/reference/glossary/pi.md b/docs/reference/glossary/pi.md new file mode 100644 index 0000000000..37ed77b2d0 --- /dev/null +++ b/docs/reference/glossary/pi.md @@ -0,0 +1,8 @@ +--- +title: Pi +id: pi +full_link: +short_description: Short for Raspberry Pi, a series of small single-board computers developed by the Raspberry Pi Foundation. +aka: +type: "page" +--- diff --git a/docs/reference/glossary/pin-number.md b/docs/reference/glossary/pin-number.md new file mode 100644 index 0000000000..95de28c2b0 --- /dev/null +++ b/docs/reference/glossary/pin-number.md @@ -0,0 +1,6 @@ +--- +title: Pin Number +id: pin-number +full_link: +short_description: A pin number is the index of the pin on the board. Not the same as a pin's GPIO number. +--- diff --git a/docs/reference/glossary/protobuf.md b/docs/reference/glossary/protobuf.md new file mode 100644 index 0000000000..66c946c447 --- /dev/null +++ b/docs/reference/glossary/protobuf.md @@ -0,0 +1,6 @@ +--- +title: Protocol Buffers (Protobuf) +id: protobuf +full_link: +short_description: A free and open-source, language-neutral, cross-platform data format for serializing structured data. +--- diff --git a/docs/reference/glossary/rdk.md b/docs/reference/glossary/rdk.md new file mode 100644 index 0000000000..c8bc04b6bc --- /dev/null +++ b/docs/reference/glossary/rdk.md @@ -0,0 +1,6 @@ +--- +title: RDK (Robot Development Kit) +id: rdk +full_link: /reference/platform/viam-server/ +short_description: The official Viam-developed codebase that provides all functionality of an SDK and more. +--- diff --git a/docs/reference/glossary/remote-part.md b/docs/reference/glossary/remote-part.md new file mode 100644 index 0000000000..0a270c292a --- /dev/null +++ b/docs/reference/glossary/remote-part.md @@ -0,0 +1,7 @@ +--- +title: Remote part +id: remote-part +full_link: /architecture/parts/ +short_description: A machine part which is controlled by another machine part. +aka: +--- diff --git a/docs/reference/glossary/resource.md b/docs/reference/glossary/resource.md new file mode 100644 index 0000000000..bd0b859655 --- /dev/null +++ b/docs/reference/glossary/resource.md @@ -0,0 +1,6 @@ +--- +title: Resource +id: resource +full_link: +short_description: Resources are individual, addressable elements of a machine such as components or services. +--- diff --git a/docs/reference/glossary/sdk.md b/docs/reference/glossary/sdk.md new file mode 100644 index 0000000000..a8cbd8f9ad --- /dev/null +++ b/docs/reference/glossary/sdk.md @@ -0,0 +1,6 @@ +--- +title: SDK (Software Development Kit) +id: sdk +full_link: /reference/apis/ +short_description: Viam provides software development kits (SDKs) to help you write client applications and create support for custom component types. +--- diff --git a/docs/reference/glossary/service.md b/docs/reference/glossary/service.md new file mode 100644 index 0000000000..7234d55742 --- /dev/null +++ b/docs/reference/glossary/service.md @@ -0,0 +1,5 @@ +--- +title: Service +id: service +short_description: Built-in software packages for complex capabilities such as SLAM, Computer Vision, Motion Planning, and Data Collection. +--- diff --git a/docs/reference/glossary/setup.md b/docs/reference/glossary/setup.md new file mode 100644 index 0000000000..a06d1881e9 --- /dev/null +++ b/docs/reference/glossary/setup.md @@ -0,0 +1,6 @@ +--- +title: View setup instructions +id: setup +full_link: +short_description: To view setup instructions for a machine part, navigate to the CONFIGURE tab, find the part's card, click the "..." menu in the upper right corner of the card, and select "View setup instructions". +--- diff --git a/docs/reference/glossary/slam.md b/docs/reference/glossary/slam.md new file mode 100644 index 0000000000..9b219afb5c --- /dev/null +++ b/docs/reference/glossary/slam.md @@ -0,0 +1,6 @@ +--- +title: SLAM +id: slam +full_link: /reference/services/slam/ +short_description: Simultaneous Localization And Mapping (SLAM) algorithms use data from a machine's sensors to generate a map of the environment and determine the machine's position within it. +--- diff --git a/docs/reference/glossary/smart-machine.md b/docs/reference/glossary/smart-machine.md new file mode 100644 index 0000000000..c3a442b772 --- /dev/null +++ b/docs/reference/glossary/smart-machine.md @@ -0,0 +1,6 @@ +--- +title: Smart Machine +id: smart-machine +full_link: +short_description: A machine or device that lives in the real world and has some ability to perceive the world (with a sensor, for example) and perform actions like operating a motor. +--- diff --git a/docs/reference/glossary/sql.md b/docs/reference/glossary/sql.md new file mode 100644 index 0000000000..a5aeb07e76 --- /dev/null +++ b/docs/reference/glossary/sql.md @@ -0,0 +1,6 @@ +--- +title: SQL +id: sql +full_link: +short_description: SQL (structured query language) is the widely-used, industry-standard query language popular with relational databases. +--- diff --git a/docs/reference/glossary/subtype.md b/docs/reference/glossary/subtype.md new file mode 100644 index 0000000000..6888600813 --- /dev/null +++ b/docs/reference/glossary/subtype.md @@ -0,0 +1,6 @@ +--- +title: Subtype +id: subtype +full_link: +short_description: A group of component or service models that share the same API. For example, arm is a subtype of component. +--- diff --git a/docs/reference/glossary/trigger.md b/docs/reference/glossary/trigger.md new file mode 100644 index 0000000000..a754e10e3f --- /dev/null +++ b/docs/reference/glossary/trigger.md @@ -0,0 +1,6 @@ +--- +title: Trigger +id: trigger +full_link: /reference/configuration/triggers/ +short_description: A mechanism that sends alerts by email or webhook when specific events occur in your machine or data. +--- diff --git a/docs/reference/glossary/type.md b/docs/reference/glossary/type.md new file mode 100644 index 0000000000..fae6954123 --- /dev/null +++ b/docs/reference/glossary/type.md @@ -0,0 +1,6 @@ +--- +title: Type +id: type +full_link: +short_description: Component and service are the built-in types of resource API the RDK provides. +--- diff --git a/docs/reference/glossary/viam-agent.md b/docs/reference/glossary/viam-agent.md new file mode 100644 index 0000000000..9ade548edd --- /dev/null +++ b/docs/reference/glossary/viam-agent.md @@ -0,0 +1,6 @@ +--- +title: Viam Agent +id: viam-agent +full_link: +short_description: The Viam provisioning application for deploying viam-server. +--- diff --git a/docs/reference/glossary/viam-micro-server.md b/docs/reference/glossary/viam-micro-server.md new file mode 100644 index 0000000000..5776a9cae7 --- /dev/null +++ b/docs/reference/glossary/viam-micro-server.md @@ -0,0 +1,6 @@ +--- +title: viam-micro-server +id: viam-micro-server +full_link: /reference/platform/viam-micro-server/ +short_description: The lightweight version of viam-server that can run on ESP32 devices. +--- diff --git a/docs/reference/glossary/viam-robot-api.md b/docs/reference/glossary/viam-robot-api.md new file mode 100644 index 0000000000..c7072a564b --- /dev/null +++ b/docs/reference/glossary/viam-robot-api.md @@ -0,0 +1,6 @@ +--- +title: Viam Robot API +id: viam-robot-api +full_link: +short_description: The specification for communication with resources. +--- diff --git a/docs/reference/glossary/viam-server.md b/docs/reference/glossary/viam-server.md new file mode 100644 index 0000000000..967b7591d7 --- /dev/null +++ b/docs/reference/glossary/viam-server.md @@ -0,0 +1,6 @@ +--- +title: viam-server +id: viam-server +full_link: /reference/platform/viam-server/ +short_description: The executable binary which runs on and provides functionality to machines. +--- diff --git a/docs/reference/glossary/vision-service.md b/docs/reference/glossary/vision-service.md new file mode 100644 index 0000000000..44c9eeed37 --- /dev/null +++ b/docs/reference/glossary/vision-service.md @@ -0,0 +1,8 @@ +--- +title: Vision service +id: vision-service +full_link: /reference/services/vision/ +short_description: A service that enables machines to interpret visual data from cameras using computer vision and machine learning. +aka: +type: "page" +--- diff --git a/docs/reference/glossary/web-sockets.md b/docs/reference/glossary/web-sockets.md new file mode 100644 index 0000000000..d43f9cd613 --- /dev/null +++ b/docs/reference/glossary/web-sockets.md @@ -0,0 +1,6 @@ +--- +title: Websockets +id: web-sockets +full_link: +short_description: A computer communications protocol that provides full-duplex communication channels over a single Transmission Control Protocol (TCP) connection. +--- diff --git a/docs/reference/glossary/webrtc.md b/docs/reference/glossary/webrtc.md new file mode 100644 index 0000000000..94ce30a7bf --- /dev/null +++ b/docs/reference/glossary/webrtc.md @@ -0,0 +1,6 @@ +--- +title: WebRTC +id: webrtc +full_link: +short_description: An open source project which provides applications with real-time communication (RTC) using application programming interfaces (API) allowing powerful voice and video integration. +--- diff --git a/docs/reference/glossary/world-frame.md b/docs/reference/glossary/world-frame.md new file mode 100644 index 0000000000..7d9065772b --- /dev/null +++ b/docs/reference/glossary/world-frame.md @@ -0,0 +1,7 @@ +--- +title: World frame +id: world-frame +full_link: /motion-planning/frame-system/ +short_description: The fixed, user-defined global coordinate system that is the reference point for all other coordinate frames in a robotic system. +aka: world frame, world +--- diff --git a/docs/reference/glossary_tmp/api-namespace-triplet.md b/docs/reference/glossary_tmp/api-namespace-triplet.md new file mode 100644 index 0000000000..6905c55e2e --- /dev/null +++ b/docs/reference/glossary_tmp/api-namespace-triplet.md @@ -0,0 +1,6 @@ +--- +title: API Namespace Triplet +id: api-namespace-triplet +full_link: +short_description: namespace:type:subtype, for example `rdk:component:sensor` +--- diff --git a/docs/reference/glossary_tmp/api.md b/docs/reference/glossary_tmp/api.md new file mode 100644 index 0000000000..e2e3b37ee4 --- /dev/null +++ b/docs/reference/glossary_tmp/api.md @@ -0,0 +1,8 @@ +--- +title: API +id: api +full_link: +short_description: Application programming interface, a set of defined rules that enable different applications to communicate with each other. +aka: +type: "page" +--- diff --git a/docs/reference/glossary_tmp/attribute.md b/docs/reference/glossary_tmp/attribute.md new file mode 100644 index 0000000000..628036f59b --- /dev/null +++ b/docs/reference/glossary_tmp/attribute.md @@ -0,0 +1,8 @@ +--- +title: Attribute +id: attribute +full_link: +short_description: A configuration parameter of a resource. +aka: +type: "page" +--- diff --git a/docs/reference/glossary_tmp/base.md b/docs/reference/glossary_tmp/base.md new file mode 100644 index 0000000000..ff3e212786 --- /dev/null +++ b/docs/reference/glossary_tmp/base.md @@ -0,0 +1,6 @@ +--- +title: Base +id: base +full_link: /components/base/ +short_description: A physical, mobile platform that the other parts of a mobile robot attach to. +--- diff --git a/docs/reference/glossary_tmp/blob-storage.md b/docs/reference/glossary_tmp/blob-storage.md new file mode 100644 index 0000000000..ea557f2a7b --- /dev/null +++ b/docs/reference/glossary_tmp/blob-storage.md @@ -0,0 +1,8 @@ +--- +title: Blob storage +id: blob-storage +full_link: +short_description: A cheap but slow storage medium. +aka: +type: "page" +--- diff --git a/docs/reference/glossary_tmp/board.md b/docs/reference/glossary_tmp/board.md new file mode 100644 index 0000000000..ea877e6593 --- /dev/null +++ b/docs/reference/glossary_tmp/board.md @@ -0,0 +1,6 @@ +--- +title: Board +id: board +full_link: /components/board/ +short_description: A board is the signal wire hub of a machine that provides access to GPIO pins. +--- diff --git a/docs/reference/glossary_tmp/captive-web-portal.md b/docs/reference/glossary_tmp/captive-web-portal.md new file mode 100644 index 0000000000..38b24d4c3c --- /dev/null +++ b/docs/reference/glossary_tmp/captive-web-portal.md @@ -0,0 +1,5 @@ +--- +title: Captive web portal +id: captive-web-portal +short_description: A web page which is automatically displayed to users when connecting to a network. +--- diff --git a/docs/reference/glossary_tmp/client-application.md b/docs/reference/glossary_tmp/client-application.md new file mode 100644 index 0000000000..f3062213b7 --- /dev/null +++ b/docs/reference/glossary_tmp/client-application.md @@ -0,0 +1,6 @@ +--- +title: Client Application +id: client-application +full_link: +short_description: Client applications run business logic to operate your machine. +--- diff --git a/docs/reference/glossary_tmp/component.md b/docs/reference/glossary_tmp/component.md new file mode 100644 index 0000000000..4fbc8d514f --- /dev/null +++ b/docs/reference/glossary_tmp/component.md @@ -0,0 +1,5 @@ +--- +title: Component +id: component +short_description: A resource that often represents a physical piece of hardware which a computer controls; for example, a servo, a camera, or an arm. +--- diff --git a/docs/reference/glossary_tmp/flashed.md b/docs/reference/glossary_tmp/flashed.md new file mode 100644 index 0000000000..9d0ae31063 --- /dev/null +++ b/docs/reference/glossary_tmp/flashed.md @@ -0,0 +1,10 @@ +--- +title: Flash +id: flash +full_link: +short_description: The process of writing an operating system or firmware to a device's storage medium. +aka: + - flashed + - flashing +type: "page" +--- diff --git a/docs/reference/glossary_tmp/fragment.md b/docs/reference/glossary_tmp/fragment.md new file mode 100644 index 0000000000..9a2cf45f6c --- /dev/null +++ b/docs/reference/glossary_tmp/fragment.md @@ -0,0 +1,6 @@ +--- +title: Fragment +id: fragment +full_link: /fleet/reuse-configuration/ +short_description: A reusable configuration block that you can share across multiple machines. +--- diff --git a/docs/reference/glossary_tmp/frame-system.md b/docs/reference/glossary_tmp/frame-system.md new file mode 100644 index 0000000000..895b7b39f0 --- /dev/null +++ b/docs/reference/glossary_tmp/frame-system.md @@ -0,0 +1,6 @@ +--- +title: Frame System +id: frame-system +full_link: /motion-planning/frame-system/ +short_description: The frame system holds reference frame information for the relative position of components in space. +--- diff --git a/docs/reference/glossary_tmp/frame.md b/docs/reference/glossary_tmp/frame.md new file mode 100644 index 0000000000..d848ec0426 --- /dev/null +++ b/docs/reference/glossary_tmp/frame.md @@ -0,0 +1,6 @@ +--- +title: Frame +id: frame +full_link: +short_description: A frame represents a coordinate system that describes the position and orientation of an object. +--- diff --git a/docs/reference/glossary_tmp/gantry.md b/docs/reference/glossary_tmp/gantry.md new file mode 100644 index 0000000000..af0f21a5f7 --- /dev/null +++ b/docs/reference/glossary_tmp/gantry.md @@ -0,0 +1,6 @@ +--- +title: Gantry +id: attribute +full_link: /components/gantry/ +short_description: A mechanical system that only uses linear motion to carry out a task. +--- diff --git a/docs/reference/glossary_tmp/grpc.md b/docs/reference/glossary_tmp/grpc.md new file mode 100644 index 0000000000..7599e5a827 --- /dev/null +++ b/docs/reference/glossary_tmp/grpc.md @@ -0,0 +1,6 @@ +--- +title: gRPC +id: grpc +full_link: +short_description: An open source, cross-platform, high performance Remote Procedure Call (RPC) framework initially developed at Google in 2015. +--- diff --git a/docs/reference/glossary_tmp/index.md b/docs/reference/glossary_tmp/index.md new file mode 100644 index 0000000000..51eafd8fbc --- /dev/null +++ b/docs/reference/glossary_tmp/index.md @@ -0,0 +1,12 @@ +--- +title: "Glossary" +linkTitle: "Glossary" +weight: 999 +type: "docs" +layout: "glossary" +description: "A glossary that explains robotics and Viam-specific jargon." +card: + name: reference + weight: 10 + title: Glossary +--- diff --git a/docs/reference/glossary_tmp/job.md b/docs/reference/glossary_tmp/job.md new file mode 100644 index 0000000000..b83730b6a9 --- /dev/null +++ b/docs/reference/glossary_tmp/job.md @@ -0,0 +1,6 @@ +--- +title: Jobs +id: job +full_link: /fleet/scheduled-jobs/ +short_description: Automated tasks that run on machines at specified intervals to perform routine operations. +--- diff --git a/docs/reference/glossary_tmp/location.md b/docs/reference/glossary_tmp/location.md new file mode 100644 index 0000000000..b86dd3bb2e --- /dev/null +++ b/docs/reference/glossary_tmp/location.md @@ -0,0 +1,6 @@ +--- +title: Location +id: location +full_link: /reference/account/organize/ +short_description: A location is a virtual grouping of machines that allows you to organize machines and manage access to your fleet. +--- diff --git a/docs/reference/glossary_tmp/machine-config.md b/docs/reference/glossary_tmp/machine-config.md new file mode 100644 index 0000000000..9ddb032710 --- /dev/null +++ b/docs/reference/glossary_tmp/machine-config.md @@ -0,0 +1,6 @@ +--- +title: Machine Config +id: machine-config +full_link: /configure/ +short_description: The complete configuration of a single machine part. +--- diff --git a/docs/reference/glossary_tmp/machine-fqdn.md b/docs/reference/glossary_tmp/machine-fqdn.md new file mode 100644 index 0000000000..0d50be32df --- /dev/null +++ b/docs/reference/glossary_tmp/machine-fqdn.md @@ -0,0 +1,8 @@ +--- +title: Machine FQDN +id: machine-fqdn +full_link: +short_description: The fully qualified domain name (FQDN) of a machine in the Viam platform. +aka: +type: "page" +--- diff --git a/docs/reference/glossary_tmp/machine-id.md b/docs/reference/glossary_tmp/machine-id.md new file mode 100644 index 0000000000..1c7491a8b9 --- /dev/null +++ b/docs/reference/glossary_tmp/machine-id.md @@ -0,0 +1,8 @@ +--- +title: Machine ID +id: machine-id +full_link: +short_description: A unique identifier assigned to each machine in the Viam platform. +aka: +type: "page" +--- diff --git a/docs/reference/glossary_tmp/machine.md b/docs/reference/glossary_tmp/machine.md new file mode 100644 index 0000000000..60cccfe150 --- /dev/null +++ b/docs/reference/glossary_tmp/machine.md @@ -0,0 +1,6 @@ +--- +title: Machine +id: machine +full_link: /fleet/machines/ +short_description: An organizational concept, consisting of a computer and the components and services it controls, or sometimes multiple computers working closely together. +--- diff --git a/docs/reference/glossary_tmp/ml.md b/docs/reference/glossary_tmp/ml.md new file mode 100644 index 0000000000..9bdaf475b4 --- /dev/null +++ b/docs/reference/glossary_tmp/ml.md @@ -0,0 +1,8 @@ +--- +title: ML +id: ml +full_link: +short_description: Machine learning, a field of artificial intelligence focused on building systems that learn from data. +aka: +type: "page" +--- diff --git a/docs/reference/glossary_tmp/model-namespace-triplet.md b/docs/reference/glossary_tmp/model-namespace-triplet.md new file mode 100644 index 0000000000..8a6aa545fd --- /dev/null +++ b/docs/reference/glossary_tmp/model-namespace-triplet.md @@ -0,0 +1,5 @@ +--- +title: Model Namespace Triplet +id: model-namespace-triplet +short_description: namespace:module-name:name or rdk:builtin:name +--- diff --git a/docs/reference/glossary_tmp/model.md b/docs/reference/glossary_tmp/model.md new file mode 100644 index 0000000000..951ff8b8eb --- /dev/null +++ b/docs/reference/glossary_tmp/model.md @@ -0,0 +1,6 @@ +--- +title: Model +id: model +full_link: +short_description: A particular implementation of a resource. For example, UR5e is a model of the arm component API. +--- diff --git a/docs/reference/glossary_tmp/modular-resource.md b/docs/reference/glossary_tmp/modular-resource.md new file mode 100644 index 0000000000..6b17c829f1 --- /dev/null +++ b/docs/reference/glossary_tmp/modular-resource.md @@ -0,0 +1,5 @@ +--- +title: Modular Resource +id: modular-resource +short_description: A modular resource is a model of a component or service provided by a module. +--- diff --git a/docs/reference/glossary_tmp/module.md b/docs/reference/glossary_tmp/module.md new file mode 100644 index 0000000000..5ea6dc8494 --- /dev/null +++ b/docs/reference/glossary_tmp/module.md @@ -0,0 +1,6 @@ +--- +title: Module +id: module +full_link: +short_description: Modules are the code packages that provide functionality like drivers, integrations, and control logic to your machines. +--- diff --git a/docs/reference/glossary_tmp/mql.md b/docs/reference/glossary_tmp/mql.md new file mode 100644 index 0000000000..7c39e34e94 --- /dev/null +++ b/docs/reference/glossary_tmp/mql.md @@ -0,0 +1,6 @@ +--- +title: MQL +id: mql +full_link: +short_description: MQL is the MongoDB query language, similar to SQL but specific to the MongoDB document model. +--- diff --git a/docs/reference/glossary_tmp/organization.md b/docs/reference/glossary_tmp/organization.md new file mode 100644 index 0000000000..b2d1f674da --- /dev/null +++ b/docs/reference/glossary_tmp/organization.md @@ -0,0 +1,6 @@ +--- +title: Organization +id: organization +full_link: /reference/account/organize/ +short_description: An organization is a group of one or more locations that helps you organize your fleet and manage who has access to your fleet. +--- diff --git a/docs/reference/glossary_tmp/origin-frame.md b/docs/reference/glossary_tmp/origin-frame.md new file mode 100644 index 0000000000..bd29cf5cc8 --- /dev/null +++ b/docs/reference/glossary_tmp/origin-frame.md @@ -0,0 +1,6 @@ +--- +title: Origin frame +id: origin-frame +full_link: +short_description: The origin frame is the frame at the base of an arm or other component that has a complex kinematics chain. +--- diff --git a/docs/reference/glossary_tmp/package.md b/docs/reference/glossary_tmp/package.md new file mode 100644 index 0000000000..cc78d4a131 --- /dev/null +++ b/docs/reference/glossary_tmp/package.md @@ -0,0 +1,6 @@ +--- +title: Package +id: package +full_link: +short_description: An archive, module, ML model, SLAM Map, or other bundle of binary code. +--- diff --git a/docs/reference/glossary_tmp/part.md b/docs/reference/glossary_tmp/part.md new file mode 100644 index 0000000000..3be1b32931 --- /dev/null +++ b/docs/reference/glossary_tmp/part.md @@ -0,0 +1,6 @@ +--- +title: Part +id: part +full_link: /reference/architecture/parts/ +short_description: A single-board computer, desktop, laptop, or other computer running viam-server, the hardware components attached to it, and any services or other resources running on it. +--- diff --git a/docs/reference/glossary_tmp/pi.md b/docs/reference/glossary_tmp/pi.md new file mode 100644 index 0000000000..37ed77b2d0 --- /dev/null +++ b/docs/reference/glossary_tmp/pi.md @@ -0,0 +1,8 @@ +--- +title: Pi +id: pi +full_link: +short_description: Short for Raspberry Pi, a series of small single-board computers developed by the Raspberry Pi Foundation. +aka: +type: "page" +--- diff --git a/docs/reference/glossary_tmp/pin-number.md b/docs/reference/glossary_tmp/pin-number.md new file mode 100644 index 0000000000..95de28c2b0 --- /dev/null +++ b/docs/reference/glossary_tmp/pin-number.md @@ -0,0 +1,6 @@ +--- +title: Pin Number +id: pin-number +full_link: +short_description: A pin number is the index of the pin on the board. Not the same as a pin's GPIO number. +--- diff --git a/docs/reference/glossary_tmp/protobuf.md b/docs/reference/glossary_tmp/protobuf.md new file mode 100644 index 0000000000..66c946c447 --- /dev/null +++ b/docs/reference/glossary_tmp/protobuf.md @@ -0,0 +1,6 @@ +--- +title: Protocol Buffers (Protobuf) +id: protobuf +full_link: +short_description: A free and open-source, language-neutral, cross-platform data format for serializing structured data. +--- diff --git a/docs/reference/glossary_tmp/rdk.md b/docs/reference/glossary_tmp/rdk.md new file mode 100644 index 0000000000..c8bc04b6bc --- /dev/null +++ b/docs/reference/glossary_tmp/rdk.md @@ -0,0 +1,6 @@ +--- +title: RDK (Robot Development Kit) +id: rdk +full_link: /reference/platform/viam-server/ +short_description: The official Viam-developed codebase that provides all functionality of an SDK and more. +--- diff --git a/docs/reference/glossary_tmp/remote-part.md b/docs/reference/glossary_tmp/remote-part.md new file mode 100644 index 0000000000..0a270c292a --- /dev/null +++ b/docs/reference/glossary_tmp/remote-part.md @@ -0,0 +1,7 @@ +--- +title: Remote part +id: remote-part +full_link: /architecture/parts/ +short_description: A machine part which is controlled by another machine part. +aka: +--- diff --git a/docs/reference/glossary_tmp/resource.md b/docs/reference/glossary_tmp/resource.md new file mode 100644 index 0000000000..bd0b859655 --- /dev/null +++ b/docs/reference/glossary_tmp/resource.md @@ -0,0 +1,6 @@ +--- +title: Resource +id: resource +full_link: +short_description: Resources are individual, addressable elements of a machine such as components or services. +--- diff --git a/docs/reference/glossary_tmp/sdk.md b/docs/reference/glossary_tmp/sdk.md new file mode 100644 index 0000000000..a8cbd8f9ad --- /dev/null +++ b/docs/reference/glossary_tmp/sdk.md @@ -0,0 +1,6 @@ +--- +title: SDK (Software Development Kit) +id: sdk +full_link: /reference/apis/ +short_description: Viam provides software development kits (SDKs) to help you write client applications and create support for custom component types. +--- diff --git a/docs/reference/glossary_tmp/service.md b/docs/reference/glossary_tmp/service.md new file mode 100644 index 0000000000..7234d55742 --- /dev/null +++ b/docs/reference/glossary_tmp/service.md @@ -0,0 +1,5 @@ +--- +title: Service +id: service +short_description: Built-in software packages for complex capabilities such as SLAM, Computer Vision, Motion Planning, and Data Collection. +--- diff --git a/docs/reference/glossary_tmp/setup.md b/docs/reference/glossary_tmp/setup.md new file mode 100644 index 0000000000..a06d1881e9 --- /dev/null +++ b/docs/reference/glossary_tmp/setup.md @@ -0,0 +1,6 @@ +--- +title: View setup instructions +id: setup +full_link: +short_description: To view setup instructions for a machine part, navigate to the CONFIGURE tab, find the part's card, click the "..." menu in the upper right corner of the card, and select "View setup instructions". +--- diff --git a/docs/reference/glossary_tmp/slam.md b/docs/reference/glossary_tmp/slam.md new file mode 100644 index 0000000000..9b219afb5c --- /dev/null +++ b/docs/reference/glossary_tmp/slam.md @@ -0,0 +1,6 @@ +--- +title: SLAM +id: slam +full_link: /reference/services/slam/ +short_description: Simultaneous Localization And Mapping (SLAM) algorithms use data from a machine's sensors to generate a map of the environment and determine the machine's position within it. +--- diff --git a/docs/reference/glossary_tmp/smart-machine.md b/docs/reference/glossary_tmp/smart-machine.md new file mode 100644 index 0000000000..c3a442b772 --- /dev/null +++ b/docs/reference/glossary_tmp/smart-machine.md @@ -0,0 +1,6 @@ +--- +title: Smart Machine +id: smart-machine +full_link: +short_description: A machine or device that lives in the real world and has some ability to perceive the world (with a sensor, for example) and perform actions like operating a motor. +--- diff --git a/docs/reference/glossary_tmp/sql.md b/docs/reference/glossary_tmp/sql.md new file mode 100644 index 0000000000..a5aeb07e76 --- /dev/null +++ b/docs/reference/glossary_tmp/sql.md @@ -0,0 +1,6 @@ +--- +title: SQL +id: sql +full_link: +short_description: SQL (structured query language) is the widely-used, industry-standard query language popular with relational databases. +--- diff --git a/docs/reference/glossary_tmp/subtype.md b/docs/reference/glossary_tmp/subtype.md new file mode 100644 index 0000000000..6888600813 --- /dev/null +++ b/docs/reference/glossary_tmp/subtype.md @@ -0,0 +1,6 @@ +--- +title: Subtype +id: subtype +full_link: +short_description: A group of component or service models that share the same API. For example, arm is a subtype of component. +--- diff --git a/docs/reference/glossary_tmp/trigger.md b/docs/reference/glossary_tmp/trigger.md new file mode 100644 index 0000000000..a754e10e3f --- /dev/null +++ b/docs/reference/glossary_tmp/trigger.md @@ -0,0 +1,6 @@ +--- +title: Trigger +id: trigger +full_link: /reference/configuration/triggers/ +short_description: A mechanism that sends alerts by email or webhook when specific events occur in your machine or data. +--- diff --git a/docs/reference/glossary_tmp/type.md b/docs/reference/glossary_tmp/type.md new file mode 100644 index 0000000000..fae6954123 --- /dev/null +++ b/docs/reference/glossary_tmp/type.md @@ -0,0 +1,6 @@ +--- +title: Type +id: type +full_link: +short_description: Component and service are the built-in types of resource API the RDK provides. +--- diff --git a/docs/reference/glossary_tmp/viam-agent.md b/docs/reference/glossary_tmp/viam-agent.md new file mode 100644 index 0000000000..9ade548edd --- /dev/null +++ b/docs/reference/glossary_tmp/viam-agent.md @@ -0,0 +1,6 @@ +--- +title: Viam Agent +id: viam-agent +full_link: +short_description: The Viam provisioning application for deploying viam-server. +--- diff --git a/docs/reference/glossary_tmp/viam-micro-server.md b/docs/reference/glossary_tmp/viam-micro-server.md new file mode 100644 index 0000000000..5776a9cae7 --- /dev/null +++ b/docs/reference/glossary_tmp/viam-micro-server.md @@ -0,0 +1,6 @@ +--- +title: viam-micro-server +id: viam-micro-server +full_link: /reference/platform/viam-micro-server/ +short_description: The lightweight version of viam-server that can run on ESP32 devices. +--- diff --git a/docs/reference/glossary_tmp/viam-robot-api.md b/docs/reference/glossary_tmp/viam-robot-api.md new file mode 100644 index 0000000000..c7072a564b --- /dev/null +++ b/docs/reference/glossary_tmp/viam-robot-api.md @@ -0,0 +1,6 @@ +--- +title: Viam Robot API +id: viam-robot-api +full_link: +short_description: The specification for communication with resources. +--- diff --git a/docs/reference/glossary_tmp/viam-server.md b/docs/reference/glossary_tmp/viam-server.md new file mode 100644 index 0000000000..967b7591d7 --- /dev/null +++ b/docs/reference/glossary_tmp/viam-server.md @@ -0,0 +1,6 @@ +--- +title: viam-server +id: viam-server +full_link: /reference/platform/viam-server/ +short_description: The executable binary which runs on and provides functionality to machines. +--- diff --git a/docs/reference/glossary_tmp/vision-service.md b/docs/reference/glossary_tmp/vision-service.md new file mode 100644 index 0000000000..44c9eeed37 --- /dev/null +++ b/docs/reference/glossary_tmp/vision-service.md @@ -0,0 +1,8 @@ +--- +title: Vision service +id: vision-service +full_link: /reference/services/vision/ +short_description: A service that enables machines to interpret visual data from cameras using computer vision and machine learning. +aka: +type: "page" +--- diff --git a/docs/reference/glossary_tmp/web-sockets.md b/docs/reference/glossary_tmp/web-sockets.md new file mode 100644 index 0000000000..d43f9cd613 --- /dev/null +++ b/docs/reference/glossary_tmp/web-sockets.md @@ -0,0 +1,6 @@ +--- +title: Websockets +id: web-sockets +full_link: +short_description: A computer communications protocol that provides full-duplex communication channels over a single Transmission Control Protocol (TCP) connection. +--- diff --git a/docs/reference/glossary_tmp/webrtc.md b/docs/reference/glossary_tmp/webrtc.md new file mode 100644 index 0000000000..94ce30a7bf --- /dev/null +++ b/docs/reference/glossary_tmp/webrtc.md @@ -0,0 +1,6 @@ +--- +title: WebRTC +id: webrtc +full_link: +short_description: An open source project which provides applications with real-time communication (RTC) using application programming interfaces (API) allowing powerful voice and video integration. +--- diff --git a/docs/reference/glossary_tmp/world-frame.md b/docs/reference/glossary_tmp/world-frame.md new file mode 100644 index 0000000000..7d9065772b --- /dev/null +++ b/docs/reference/glossary_tmp/world-frame.md @@ -0,0 +1,7 @@ +--- +title: World frame +id: world-frame +full_link: /motion-planning/frame-system/ +short_description: The fixed, user-defined global coordinate system that is the reference point for all other coordinate frames in a robotic system. +aka: world frame, world +--- diff --git a/docs/reference/module-configuration.md b/docs/reference/module-configuration.md new file mode 100644 index 0000000000..088e6e117b --- /dev/null +++ b/docs/reference/module-configuration.md @@ -0,0 +1,9 @@ +--- +title: "Modular resource and module configuration" +linkTitle: "Module configuration" +weight: 30 +type: docs +icon: true +description: "Configure module versions and module environment variables." +date: "2025-11-11" +--- diff --git a/docs/reference/platform/_index.md b/docs/reference/platform/_index.md new file mode 100644 index 0000000000..8dc0f26300 --- /dev/null +++ b/docs/reference/platform/_index.md @@ -0,0 +1,8 @@ +--- +title: "Platform" +linkTitle: "Platform" +weight: 50 +type: "docs" +no_list: true +description: "Reference documentation for viam-server, viam-micro-server, and viam-agent." +--- diff --git a/docs/reference/platform/viam-agent/_index.md b/docs/reference/platform/viam-agent/_index.md new file mode 100644 index 0000000000..26926f7ef8 --- /dev/null +++ b/docs/reference/platform/viam-agent/_index.md @@ -0,0 +1,10 @@ +--- +title: "viam-agent" +linkTitle: "viam-agent" +weight: 20 +type: docs +description: "The viam-agent is a self-updating service manager that maintains the lifecycle for Viam's system services, among them viam-server and provisioning." +date: "2025-02-14" +# updated: "" # When the content was last entirely checked +# SMEs: James, Ale +--- diff --git a/docs/reference/platform/viam-agent/manage-viam-agent.md b/docs/reference/platform/viam-agent/manage-viam-agent.md new file mode 100644 index 0000000000..06f0070804 --- /dev/null +++ b/docs/reference/platform/viam-agent/manage-viam-agent.md @@ -0,0 +1,13 @@ +--- +title: "Manage viam-agent" +linkTitle: "Manage viam-agent" +weight: 110 +no_list: true +type: docs +draft: false +images: ["/installation/thumbnails/manage.png"] +imageAlt: "Manage viam-agent" +description: "Control and manage the viam-agent systemd service." +date: "2024-08-16" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/platform/viam-micro-server.md b/docs/reference/platform/viam-micro-server.md new file mode 100644 index 0000000000..6948e6bf9b --- /dev/null +++ b/docs/reference/platform/viam-micro-server.md @@ -0,0 +1,12 @@ +--- +title: "The Micro-RDK and viam-micro-server" +linkTitle: "viam-micro-server" +weight: 40 +type: docs +images: ["/installation/thumbnails/esp32-espressif.png"] +imageAlt: "E S P 32 - espressif" +description: "Set up the Espressif ESP32 for development with `viam-micro-server`." +date: "2024-09-03" +# updated: "" # When the content was last entirely checked +# SMEs: Nicolas M., Gautham V., Andrew M. +--- diff --git a/docs/reference/platform/viam-server/_index.md b/docs/reference/platform/viam-server/_index.md new file mode 100644 index 0000000000..1e1d2a9eba --- /dev/null +++ b/docs/reference/platform/viam-server/_index.md @@ -0,0 +1,10 @@ +--- +title: "viam-server" +linkTitle: "viam-server" +weight: 31 +type: "docs" +description: "viam-server is the open-source, on-machine portion of the Viam platform." +tags: ["server", "rdk"] +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/platform/viam-server/debug-endpoints.md b/docs/reference/platform/viam-server/debug-endpoints.md new file mode 100644 index 0000000000..44306b4092 --- /dev/null +++ b/docs/reference/platform/viam-server/debug-endpoints.md @@ -0,0 +1,8 @@ +--- +title: "Debug Endpoints" +linkTitle: "Debug Endpoints" +weight: 130 +type: "docs" +description: "Advanced debugging endpoints available in viam-server for troubleshooting and development." +date: "2025-05-19" +--- diff --git a/docs/reference/platform/viam-server/manage-viam-server.md b/docs/reference/platform/viam-server/manage-viam-server.md new file mode 100644 index 0000000000..0d75873dcf --- /dev/null +++ b/docs/reference/platform/viam-server/manage-viam-server.md @@ -0,0 +1,13 @@ +--- +title: "Manage viam-server" +linkTitle: "Manage viam-server" +weight: 120 +no_list: true +type: docs +draft: false +images: ["/installation/thumbnails/manage.png"] +imageAlt: "Manage viam-server" +description: "If you have manually installed viam-server, you can chose to run it as a system service or on the command line." +date: "2024-08-16" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/sdks/_index.md b/docs/reference/sdks/_index.md new file mode 100644 index 0000000000..619ed51773 --- /dev/null +++ b/docs/reference/sdks/_index.md @@ -0,0 +1,7 @@ +--- +title: "Write control code with Viam SDKs" +linkTitle: "SDKs" +weight: 10 +type: "docs" +description: "Write code to control your machine with Viam's Python, Go, TypeScript, Flutter, and C++ SDKs." +--- diff --git a/docs/reference/sdks/connectivity.md b/docs/reference/sdks/connectivity.md new file mode 100644 index 0000000000..7d5e220e9a --- /dev/null +++ b/docs/reference/sdks/connectivity.md @@ -0,0 +1,11 @@ +--- +title: "Client sessions and machine network connectivity" +linkTitle: "Network connectivity" +weight: 80 +type: "docs" +description: "When you connect to a machine, the machine automatically chooses the best connection over local LAN, WAN or the internet." +tags: + ["client", "sdk", "viam-server", "networking", "apis", "robot api", "session"] +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/sdks/cpp.md b/docs/reference/sdks/cpp.md new file mode 100644 index 0000000000..fe605fbe9c --- /dev/null +++ b/docs/reference/sdks/cpp.md @@ -0,0 +1,11 @@ +--- +title: "C++" +linkTitle: "C++" +weight: 40 +type: "docs" +layout: "empty" +icon: true +images: ["/logos/cpp.svg"] +canonical: "https://cpp.viam.dev/" +description: "C++." +--- diff --git a/docs/reference/sdks/docommand.md b/docs/reference/sdks/docommand.md new file mode 100644 index 0000000000..4cfbe153c8 --- /dev/null +++ b/docs/reference/sdks/docommand.md @@ -0,0 +1,10 @@ +--- +title: "Implement or use DoCommand" +linkTitle: "DoCommand" +weight: 67 +type: "docs" +description: "Implement DoCommand in your module or use it from Viam's SDKs." +tags: ["sdk", "extend"] +date: "2025-04-29" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/sdks/flutter.md b/docs/reference/sdks/flutter.md new file mode 100644 index 0000000000..83c22926ed --- /dev/null +++ b/docs/reference/sdks/flutter.md @@ -0,0 +1,11 @@ +--- +title: "Flutter" +linkTitle: "Flutter" +weight: 50 +type: "docs" +layout: "empty" +icon: true +images: ["/logos/flutter.svg"] +canonical: "https://flutter.viam.dev/" +description: "Flutter." +--- diff --git a/docs/reference/sdks/go.md b/docs/reference/sdks/go.md new file mode 100644 index 0000000000..4b737c7e25 --- /dev/null +++ b/docs/reference/sdks/go.md @@ -0,0 +1,11 @@ +--- +title: "Go" +linkTitle: "Go" +weight: 20 +type: "docs" +layout: "empty" +icon: true +images: ["/logos/golang.svg"] +canonical: "https://pkg.go.dev/go.viam.com/rdk" +description: "Go." +--- diff --git a/docs/reference/sdks/python/_index.md b/docs/reference/sdks/python/_index.md new file mode 100644 index 0000000000..7b809d1d71 --- /dev/null +++ b/docs/reference/sdks/python/_index.md @@ -0,0 +1,11 @@ +--- +title: "Python" +linkTitle: "Python" +weight: 10 +type: "docs" +layout: "empty" +icon: true +images: ["/logos/python.svg"] +canonical: "https://python.viam.dev/" +description: "Python." +--- diff --git a/docs/reference/sdks/python/python-venv.md b/docs/reference/sdks/python/python-venv.md new file mode 100644 index 0000000000..d2db5ca388 --- /dev/null +++ b/docs/reference/sdks/python/python-venv.md @@ -0,0 +1,12 @@ +--- +title: "Prepare your Python Virtual Environment" +linkTitle: "Virtualenv for Python SDK" +weight: 10 +type: "docs" +description: "Prepare your Python Virtual Environment to program machines with the Python SDK." +images: ["/services/icons/sdk.svg"] +tags: + ["client", "sdk", "application", "sdk", "fleet", "program", "python", "venv"] +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/sdks/typescript.md b/docs/reference/sdks/typescript.md new file mode 100644 index 0000000000..520766b189 --- /dev/null +++ b/docs/reference/sdks/typescript.md @@ -0,0 +1,11 @@ +--- +title: "TypeScript" +linkTitle: "TypeScript" +weight: 30 +type: "docs" +layout: "empty" +icon: true +images: ["/logos/typescript.svg"] +canonical: "https://ts.viam.dev/" +description: "TypeScript." +--- diff --git a/docs/reference/sdks/use-extra-params.md b/docs/reference/sdks/use-extra-params.md new file mode 100644 index 0000000000..788451b2da --- /dev/null +++ b/docs/reference/sdks/use-extra-params.md @@ -0,0 +1,11 @@ +--- +title: "Using extra parameters with Viam's SDKs" +linkTitle: "Extra params" +weight: 70 +type: "docs" +description: "Using the extra parameter on resource API methods with Viam's SDKs." +images: ["/services/icons/sdk.svg"] +tags: ["sdk", "extra", "extend"] +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +--- diff --git a/docs/reference/services/_index.md b/docs/reference/services/_index.md new file mode 100644 index 0000000000..99b6fb167c --- /dev/null +++ b/docs/reference/services/_index.md @@ -0,0 +1,8 @@ +--- +title: "Services" +linkTitle: "Services" +weight: 30 +type: "docs" +no_list: true +description: "Services are built-in software packages that add high-level functionality to your machine." +--- diff --git a/docs/reference/services/base-rc/_index.md b/docs/reference/services/base-rc/_index.md new file mode 100644 index 0000000000..41271f0f87 --- /dev/null +++ b/docs/reference/services/base-rc/_index.md @@ -0,0 +1,14 @@ +--- +title: "Base Remote Control Service" +linkTitle: "Base Remote Control" +weight: 70 +type: "docs" +description: "The base remote control service allows you to remotely control a base with an input controller like a gamepad." +tags: ["base", "services", "rover", "input controller", "remote control"] +icon: true +images: ["/services/icons/base-rc.svg"] +no_service: true +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +# SME: Eric +--- diff --git a/docs/reference/services/discovery/_index.md b/docs/reference/services/discovery/_index.md new file mode 100644 index 0000000000..3e1da863b4 --- /dev/null +++ b/docs/reference/services/discovery/_index.md @@ -0,0 +1,16 @@ +--- +title: "Discovery Service" +linkTitle: "Discovery" +description: "Use a discovery service to discover available resources on a machine." +type: docs +weight: 50 +no_list: true +#icon: true +#images: ["/services/icons/discovery.svg"] +tags: ["discovery", "services"] +no_service: true +date: "2025-03-03" +# updated: "" # When the content was last entirely checked +# SMEs: John N. +modulescript: true +--- diff --git a/docs/reference/services/generic/_index.md b/docs/reference/services/generic/_index.md new file mode 100644 index 0000000000..391f9d4381 --- /dev/null +++ b/docs/reference/services/generic/_index.md @@ -0,0 +1,17 @@ +--- +title: "Generic Service" +linkTitle: "Generic Service" +childTitleEndOverwrite: "Generic Service" +weight: 500 +type: "docs" +description: "A service that does not fit any of the other APIs." +tags: ["generic", "services"] +icon: true +images: ["/icons/components/generic.svg"] +no_list: true +modulescript: true +hide_children: true +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +# SMEs: +--- diff --git a/docs/reference/services/generic/fake.md b/docs/reference/services/generic/fake.md new file mode 100644 index 0000000000..5f0a120e64 --- /dev/null +++ b/docs/reference/services/generic/fake.md @@ -0,0 +1,10 @@ +--- +title: "Configure a Fake Generic Service" +linkTitle: "fake" +weight: 10 +type: "docs" +description: "Configure a fake generic service using the generic service API." +service_description: "A model used for testing a generic service." +tags: ["generic", "services"] +toc_hide: true +--- diff --git a/docs/reference/services/slam/_index.md b/docs/reference/services/slam/_index.md new file mode 100644 index 0000000000..7e8d3a81dc --- /dev/null +++ b/docs/reference/services/slam/_index.md @@ -0,0 +1,14 @@ +--- +title: "SLAM Service" +linkTitle: "SLAM" +weight: 60 +type: "docs" +description: "Simultaneous localization and mapping (SLAM) allows your machine to create a map of its surroundings and find its location within that map." +tags: ["slam", "services"] +icon: true +images: ["/services/icons/slam.svg"] +no_list: true +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +# SMEs: John N. +--- diff --git a/docs/reference/services/slam/cartographer/_index.md b/docs/reference/services/slam/cartographer/_index.md new file mode 100644 index 0000000000..bd55c39779 --- /dev/null +++ b/docs/reference/services/slam/cartographer/_index.md @@ -0,0 +1,13 @@ +--- +title: "Cartographer Modular Resource" +linkTitle: "Cartographer" +weight: 70 +type: "docs" +description: "Configure a Simultaneous Localization And Mapping (SLAM) service with the Cartographer modular resource." +tags: ["slam", "services"] +icon: true +images: ["/services/icons/slam.svg"] +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +# SMEs: John N. +--- diff --git a/docs/reference/services/slam/cloudslam/_index.md b/docs/reference/services/slam/cloudslam/_index.md new file mode 100644 index 0000000000..b010648741 --- /dev/null +++ b/docs/reference/services/slam/cloudslam/_index.md @@ -0,0 +1,13 @@ +--- +title: "CloudSLAM Wrapper Modular Resource" +linkTitle: "CloudSLAM" +weight: 70 +type: "docs" +description: "Configure a Simultaneous Localization And Mapping (SLAM) service that runs in the cloud using Viam." +tags: ["slam", "services"] +icon: true +images: ["/services/icons/slam.svg"] +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +# SMEs: John N. +--- diff --git a/docs/reference/services/slam/orbslamv3/_index.md b/docs/reference/services/slam/orbslamv3/_index.md new file mode 100644 index 0000000000..a0a8c7f22a --- /dev/null +++ b/docs/reference/services/slam/orbslamv3/_index.md @@ -0,0 +1,12 @@ +--- +title: "ORB-SLAM3 Integrated Library" +linkTitle: "ORB-SLAM3" +weight: 70 +type: "docs" +draft: true +description: "Configure a SLAM service with the ORB-SLAM3 library." +tags: ["slam", "services"] +date: "2022-01-01" +# updated: "" # When the content was last entirely checked +# SMEs: Kat, Jeremy +--- diff --git a/docs/reference/services/vision/_index.md b/docs/reference/services/vision/_index.md new file mode 100644 index 0000000000..396ac87ee3 --- /dev/null +++ b/docs/reference/services/vision/_index.md @@ -0,0 +1,8 @@ +--- +title: "Vision Service" +linkTitle: "Vision Service" +weight: 20 +type: "docs" +no_list: true +description: "The vision service enables your machine to use its on-board cameras to intelligently see and interpret the world around it." +--- diff --git a/docs/reference/services/vision/color_detector.md b/docs/reference/services/vision/color_detector.md new file mode 100644 index 0000000000..5cbfb4b1c7 --- /dev/null +++ b/docs/reference/services/vision/color_detector.md @@ -0,0 +1,11 @@ +--- +title: "Configure a color_detector" +linkTitle: "color_detector" +weight: 10 +type: "docs" +description: "A heuristic detector that draws boxes around objects according to their hue (does not detect black, gray, and white)." +service_description: "A heuristic detector that draws boxes around objects according to their hue (does not detect black, gray, and white)." +tags: ["vision", "computer vision", "CV", "services", "detection"] +images: ["/services/vision/dog-detector.png"] +# SMEs: Bijan, Khari +--- diff --git a/docs/reference/services/vision/detector_3d_segmenter.md b/docs/reference/services/vision/detector_3d_segmenter.md new file mode 100644 index 0000000000..4471ac051e --- /dev/null +++ b/docs/reference/services/vision/detector_3d_segmenter.md @@ -0,0 +1,11 @@ +--- +title: "Configure a detector_3d_segmenter" +linkTitle: "detector_3d_segmenter" +weight: 20 +type: "docs" +description: "This model takes 2D bounding boxes from an object detector and projects the pixels in the bounding box to points in 3D space." +service_description: "A segmenter that takes 2D bounding boxes from an object detector and projects the pixels in the bounding box to points in 3D space." +tags: ["vision", "computer vision", "CV", "services", "segmentation"] +# SMEs: Bijan, Khari +draft: true +--- diff --git a/docs/reference/services/vision/mlmodel.md b/docs/reference/services/vision/mlmodel.md new file mode 100644 index 0000000000..6726a19559 --- /dev/null +++ b/docs/reference/services/vision/mlmodel.md @@ -0,0 +1,11 @@ +--- +title: "Configure an mlmodel Detector or Classifier" +linkTitle: "mlmodel" +weight: 10 +type: "docs" +description: "A detector or classifier that uses an ML model available on the machine to draw bounding boxes around objects or return a class label." +service_description: "A detector or classifier that uses a model available on the machine’s hard drive to draw bounding boxes around objects or returns a class label and confidence score." +tags: ["vision", "computer vision", "CV", "services", "detection"] +images: ["/services/vision/dog-detector.png"] +# SMEs: Bijan, Khari +---