Skip to content

Commit 261f2c4

Browse files
authored
DOCS-1101: Update to smart machine more broadly (#1863)
1 parent daf8f8a commit 261f2c4

File tree

26 files changed

+104
-104
lines changed

26 files changed

+104
-104
lines changed

docs/appendix/glossary/board.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,11 +2,11 @@
22
title: Board
33
id: board
44
full_link: /components/board/
5-
short_description: A board is the signal wire hub of a robot that provides access to GPIO pins, SPI or I2C.
5+
short_description: A board is the signal wire hub of a smart machine that provides access to GPIO pins, SPI or I2C.
66
aka:
77
---
88

9-
A board is the signal wire hub of a robot that provides access to GPIO pins, SPI or I2C.
9+
A board is the signal wire hub of a smart machine that provides access to GPIO pins, SPI or I2C.
1010

1111
Examples of boards include Jetson, Raspberry Pi, Numato, or Arduino.
1212

docs/appendix/glossary/client-application.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,11 +2,11 @@
22
title: Client Application
33
id: client-application
44
full_link:
5-
short_description: Client applications run business logic to operate your robot.
5+
short_description: Client applications run business logic to operate your smart machine.
66
aka:
77
---
88

9-
Client applications run business logic to operate your robot.
9+
Client applications run business logic to operate your smart machine.
1010

1111
You can run a client application on the same {{< glossary_tooltip term_id="part" text="part" >}} that runs `viam-server`, or on a separate device.
12-
Client applications typically use an {{< glossary_tooltip term_id="sdk" text="SDK" >}} to talk to their robot.
12+
Client applications typically use an {{< glossary_tooltip term_id="sdk" text="SDK" >}} to talk to their smart machine.

docs/appendix/glossary/fragment.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,11 +2,11 @@
22
title: Fragment
33
id: fragment
44
full_link: /manage/configuration/#fragments
5-
short_description: A reusable configuration block that you can share across multiple robots.
5+
short_description: A reusable configuration block that you can share across multiple smart machines.
66
aka:
77
---
88

9-
A reusable configuration block that you can share across multiple robots.
9+
A reusable configuration block that you can share across multiple smart machines.
1010
For example, if you are deploying a specific mobile robot that is always physically connected the same way, you can create a fragment to make managing your fleet easy.
1111

1212
For more information, see [Fragments](../../manage/configuration/#fragments).

docs/appendix/glossary/location.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,10 +2,10 @@
22
title: Location
33
id: location
44
full_link: /manage/fleet/locations/
5-
short_description: A location is a virtual grouping of robots that allows you to organize robots and manage access to your fleet.
5+
short_description: A location is a virtual grouping of smart machines that allows you to organize smart machines and manage access to your fleet.
66
aka:
77
---
88

9-
A location is a virtual grouping of robots that allows you to organize robots and manage access to your fleet.
9+
A location is a virtual grouping of smart machines that allows you to organize smart machines and manage access to your fleet.
1010

1111
For more information, see [Manage Locations and Sub-Locations](/manage/fleet/locations/).

docs/appendix/local-configuration-file.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -14,16 +14,16 @@ The `viam-server` binary uses a JSON-formatted configuration file to define all
1414

1515
When you [install `viam-server`](/installation/) from [the Viam app](https://app.viam.com), you configure your robot directly in the app, and the app will automatically sync your configuration to your robot.
1616

17-
However, if your robot will never connect to the internet, you will need to create your own local configuration file, using one of these options:
17+
However, if your smart machine will never connect to the internet, you will need to create your own local configuration file, using one of these options:
1818

19-
* [Build a local configuration file in the Viam app](#build-a-local-configuration-file-in-the-viam-app) - Use the Viam app to build the configuration file and copy it to your robot, without connecting your robot to the Viam app.
19+
* [Build a local configuration file in the Viam app](#build-a-local-configuration-file-in-the-viam-app) - Use the Viam app to build the configuration file and copy it to your smart machine, without connecting your smart machine to the Viam app.
2020
* [Build a local configuration file manually](#build-a-local-configuration-file-manually) - Build your own local configuration file based on the example file.
2121

2222
For information on the individual configuration options available, see [Configuration](/manage/configuration/).
2323

2424
## Build a local configuration file in the Viam app
2525

26-
If your robot will never connect to the internet, and you want to create a local configuration file manually, you can still use the Viam app to build the configuration file even without connecting your robot to it.
26+
If your robot will never connect to the internet, and you want to create a local configuration file manually, you can still use the Viam app to build the configuration file even without connecting your smart machine to it.
2727
Follow the steps below to build and then download your configuration file:
2828

2929
1. Navigate to [the Viam app](https://app.viam.com) and select the **Config** tab.

docs/components/_index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ description: "In-depth information on the various components available within th
88
images: ["/icons/components.png"]
99
---
1010

11-
A *component* represents a physical piece of electrical or electromechanical hardware in a robot.
11+
A *component* represents a physical piece of electrical or electromechanical hardware in a smart machine.
1212

1313
The following component types are natively supported.
1414
If you would like to use additional component types, you can [extend Viam with custom components and services](/extend/).

docs/components/camera/_index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ linkTitle: "Camera"
44
childTitleEndOverwrite: "Camera Component"
55
weight: 40
66
type: "docs"
7-
description: "A camera captures 2D or 3D images and sends them to the computer controlling the robot."
7+
description: "A camera captures 2D or 3D images and sends them to the computer controlling the smart machine."
88
no_list: true
99
tags: ["camera", "components"]
1010
icon: "/icons/components/camera.svg"

docs/extend/_index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -16,7 +16,7 @@ Viam's [Robot Development Kit (RDK)](/internals/rdk/) provides built-in support
1616
- Various types of hardware [components](/components/).
1717
- High-level functionality exposed as [services](/services/).
1818

19-
However, if you want to work with a new hardware component that is not already supported by Viam, or want to introduce a new software service or service model to support additional functionality on your robot, you can extend Viam by adding a [modular resource](/extend/modular-resources/) to your robot.
19+
However, if you want to work with a new hardware component that is not already supported by Viam, or want to introduce a new software service or service model to support additional functionality on your smart machine, you can extend Viam by adding a [modular resource](/extend/modular-resources/) to your smart machine.
2020

2121
Click on the cards below for instructions on implementing modular resources through {{< glossary_tooltip term_id="module" text="modules" >}} or {{< glossary_tooltip term_id="remote" text="remotes" >}}:
2222

docs/extend/modular-resources/_index.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -4,25 +4,25 @@ linkTitle: "Modular Resources"
44
weight: 10
55
type: "docs"
66
tags: ["server", "rdk", "extending viam", "modular resources", "components", "services"]
7-
description: "Use the Viam module system to implement modular resources that can be included in any Viam-powered robot."
7+
description: "Use the Viam module system to implement modular resources that can be included in any Viam-powered smart machine."
88
no_list: true
99
aliases:
1010
- "/program/extend/modular-resources/"
1111
---
1212

13-
At Viam, a robot is configured with one or more {{< glossary_tooltip term_id="resource" text="resources" >}} ([components](/components/) or [services](/services/)) which are each defined by a [public API](/extend/modular-resources/key-concepts/#valid-apis-to-implement-in-your-model).
14-
While Viam offers a number of built-in implementations against these APIs, such as the [wheeled base](/components/base/wheeled/), you may also write your own implementations in order to extend the capabilities of your robot.
13+
At Viam, a smart machine is configured with one or more {{< glossary_tooltip term_id="resource" text="resources" >}} ([components](/components/) or [services](/services/)) which are each defined by a [public API](/extend/modular-resources/key-concepts/#valid-apis-to-implement-in-your-model).
14+
While Viam offers a number of built-in implementations against these APIs, such as the [wheeled base](/components/base/wheeled/), you may also write your own implementations in order to extend the capabilities of your smart machine.
1515

1616
For example, you can:
1717

18-
- **Implement a custom component:** If your robot has specialty hardware, such as an unsupported [motor](/components/motor/), and you want to control it using Viam, you can write a driver to support your hardware by implementing the corresponding component API.
18+
- **Implement a custom component:** If your smart machine has specialty hardware, such as an unsupported [motor](/components/motor/), and you want to control it using Viam, you can write a driver to support your hardware by implementing the corresponding component API.
1919

20-
- **Implement a custom service:** If your robot makes use of a specialty algorithm or data model when working with services such as [SLAM](/services/slam/), [Vision](/services/vision/), or [Motion planning](/services/motion/), you can implement your own algorithm or model against the corresponding service API.
20+
- **Implement a custom service:** If your smart machine uses a custom algorithm or data model when working with services such as [SLAM](/services/slam/), [Vision](/services/vision/), or [Motion planning](/services/motion/), you can implement your own algorithm or model against the corresponding service API.
2121

22-
- **Implement fully custom logic:** If your robot runs specialty or proprietary logic, and you want to use Viam to manage and control that logic, such as when managing a software development lifecyle, you can implement your own custom logic by wrapping the generic API.
22+
- **Implement fully custom logic:** If your smart machine runs custom or proprietary logic and you want to use Viam to manage and control that logic, such as when managing a software development lifecyle, you can implement your own custom logic by wrapping the generic API.
2323

24-
These custom implementations are called *modular resources*, and are made available for use on a robot through {{< glossary_tooltip term_id="module" text="modules" >}}.
25-
A module can provide one or more modular resources, and can be added to your robot from the Viam registry.
24+
These custom implementations are called *modular resources*, and are made available for use on a smart machine through {{< glossary_tooltip term_id="module" text="modules" >}}.
25+
A module can provide one or more modular resources, and can be added to your smart machine from the Viam registry.
2626

2727
## The Viam registry
2828

@@ -34,12 +34,12 @@ Once the module has been uploaded to the registry, you can [deploy the module](/
3434

3535
### Uploading to Viam registry
3636

37-
After you finish programming your module, you can [upload your module to the Viam registry](/extend/modular-resources/upload/) to make it available for deployment to robots.
37+
After you finish programming your module, you can [upload your module to the Viam registry](/extend/modular-resources/upload/) to make it available for deployment to smart machines.
3838
As part of the upload process, you decide whether your module is *private* (visible only to other members of your [organization](/manage/fleet/organizations/)), or *public* (visible to all Viam users).
3939

4040
You can see details about each module in the [Viam registry](https://app.viam.com/registry) on its module details page.
4141
See the [Odrive module](https://app.viam.com/module/viam/odrive) for an example.
42-
Public modules also display the number of times a module has been deployed to a robot.
42+
Public modules also display the number of times a module has been deployed to a smart machine.
4343

4444
When you make changes to your module, you can [uploaded the newer version](/extend/modular-resources/upload/#update-an-existing-module) with a new version number, and the Viam registry will track each version that you upload.
4545

docs/extend/modular-resources/create/_index.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,11 +4,11 @@ linkTitle: "Create"
44
weight: 20
55
type: "docs"
66
tags: ["server", "rdk", "extending viam", "modular resources", "components", "services"]
7-
description: "Use the Viam module system to implement modular resources that can be included in any Viam-powered robot."
7+
description: "Use the Viam module system to implement modular resources that can be included in any Viam-powered smart machine."
88
no_list: true
99
---
1010

11-
You can extend Viam by creating a custom {{< glossary_tooltip term_id="module" text="module" >}} that provides one or more modular {{< glossary_tooltip term_id="resource" text="resources" >}} ([components](/components/) and [services](/services/)) or {{< glossary_tooltip term_id="model" text="models" >}}, and can be added to any robot running on Viam.
11+
You can extend Viam by creating a custom {{< glossary_tooltip term_id="module" text="module" >}} that provides one or more modular {{< glossary_tooltip term_id="resource" text="resources" >}} ([components](/components/) and [services](/services/)) or {{< glossary_tooltip term_id="model" text="models" >}}, and can be added to any smart machine running on Viam.
1212

1313
A common use case for modular resources is to create a new [model](/extend/modular-resources/key-concepts/#models) that implements an existing Viam [API](/program/apis/).
1414

0 commit comments

Comments
 (0)