Skip to content

Commit

Permalink
update readme files for the Kortex API 2.5.0 release (#134)
Browse files Browse the repository at this point in the history
  • Loading branch information
felixmaisonneuve authored Nov 30, 2022
1 parent 2c9fc16 commit 392c312
Show file tree
Hide file tree
Showing 16 changed files with 129 additions and 6 deletions.
4 changes: 4 additions & 0 deletions api_cpp/doc/markdown/enums/Base/NetworkEvent.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,10 @@ Enumeration NetworkEvent
|WIFI\_AUTH\_WRONG\_KEY|8|Wi-Fi wrong PSK supplied|
|WIFI\_AUTH\_CONN\_FAILED|9|Wi-Fi connection failure during auth|
|WIFI\_AUTH\_FAILED|10|Wi-Fi authentication failure|
|WIFI\_ENABLED|11|Wi-Fi has been enabled|
|WIFI\_DISABLED|12|Wi-Fi has been disabled|
|BLUETOOTH\_ENABLED|13|Bluetooth has been enabled|
|BLUETOOTH\_DISABLED|14|Bluetooth has been disabled|

**Parent topic:** [Base \(C++\)](../../summary_pages/Base.md)

3 changes: 3 additions & 0 deletions api_cpp/doc/markdown/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,6 +53,7 @@
- [class AppendActionInformation](messages/Base/AppendActionInformation.md)
- [class ArmStateInformation](messages/Base/ArmStateInformation.md)
- [class ArmStateNotification](messages/Base/ArmStateNotification.md)
- [class BluetoothEnableState](messages/Base/BluetoothEnableState.md)
- [class BridgeConfig](messages/Base/BridgeConfig.md)
- [class BridgeIdentifier](messages/Base/BridgeIdentifier.md)
- [class BridgeList](messages/Base/BridgeList.md)
Expand Down Expand Up @@ -152,6 +153,7 @@
- [class ProtectionZoneNotification](messages/Base/ProtectionZoneNotification.md)
- [class ProtectionZoneNotificationList](messages/Base/ProtectionZoneNotificationList.md)
- [class Query](messages/Base/Query.md)
- [class RFConfiguration](messages/Base/RFConfiguration.md)
- [class RequestedActionType](messages/Base/RequestedActionType.md)
- [class RobotEventNotification](messages/Base/RobotEventNotification.md)
- [class RobotEventNotificationList](messages/Base/RobotEventNotificationList.md)
Expand Down Expand Up @@ -199,6 +201,7 @@
- [class WaypointValidationReport](messages/Base/WaypointValidationReport.md)
- [class WifiConfiguration](messages/Base/WifiConfiguration.md)
- [class WifiConfigurationList](messages/Base/WifiConfigurationList.md)
- [class WifiEnableState](messages/Base/WifiEnableState.md)
- [class WifiInformation](messages/Base/WifiInformation.md)
- [class WifiInformationList](messages/Base/WifiInformationList.md)
- [class Wrench](messages/Base/Wrench.md)
Expand Down
18 changes: 18 additions & 0 deletions api_cpp/doc/markdown/messages/Base/BluetoothEnableState.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
# class BluetoothEnableState

**Member values**

|Member name|Data type|Description|
|-----------|---------|-----------|
|enabled|bool| |

**Member functions**

|Function name|Return type|Input type|Description|
|-------------|-----------|----------|-----------|
|enabled\(\)|bool|void|Returns the current value of enabled. If the enabled is not set, returns 0.|
|set\_enabled\(\)|void|bool|Sets the value of enabled. After calling this, enabled\(\) will return value.|
|clear\_enabled\(\)|void|void|Clears the value of enabled. After calling this, enabled\(\) will return 0.|

**Parent topic:** [Base \(C++\)](../../summary_pages/Base.md)

28 changes: 28 additions & 0 deletions api_cpp/doc/markdown/messages/Base/RFConfiguration.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,28 @@
# class RFConfiguration

**Member values**

|Member name|Data type|Description|
|-----------|---------|-----------|
|wifi\_enable\_state| [WifiEnableState](WifiEnableState.md#)| |
|bluetooth\_enable\_state| [BluetoothEnableState](BluetoothEnableState.md#)| |

**Member functions**

|Function name|Return type|Input type|Description|
|-------------|-----------|----------|-----------|
|has\_wifi\_enable\_state\(\) const|bool|void|Returns true if wifi\_enable\_state is set.|
|wifi\_enable\_state\(\)|const [WifiEnableState](WifiEnableState.md#)&|void|Returns the current value of wifi\_enable\_state. If wifi\_enable\_state is not set, returns a [WifiEnableState](WifiEnableState.md#) with none of its fields set \(possibly wifi\_enable\_state::default\_instance\(\)\).|
|mutable\_wifi\_enable\_state\(\)| [WifiEnableState](WifiEnableState.md#) \*|void|Returns a pointer to the mutable [WifiEnableState](WifiEnableState.md#) object that stores the field's value. If the field was not set prior to the call, then the returned [WifiEnableState](WifiEnableState.md#) will have none of its fields set \(i.e. it will be identical to a newly-allocated [WifiEnableState](WifiEnableState.md#)\). After calling this, has\_wifi\_enable\_state\(\) will return true and wifi\_enable\_state\(\) will return a reference to the same instance of [WifiEnableState](WifiEnableState.md#).|
|clear\_wifi\_enable\_state\(\)|void|void|Clears the value of the field. After calling this, has\_wifi\_enable\_state\(\) will return false and wifi\_enable\_state\(\) will return the default value.|
|set\_allocated\_wifi\_enable\_state\(\)|void| [WifiEnableState](WifiEnableState.md#) \*|Sets the [WifiEnableState](WifiEnableState.md#) object to the field and frees the previous field value if it exists. If the [WifiEnableState](WifiEnableState.md#) pointer is not NULL, the message takes ownership of the allocated [WifiEnableState](WifiEnableState.md#) object and has\_ [WifiEnableState](WifiEnableState.md#)\(\) will return true. Otherwise, if the wifi\_enable\_state is NULL, the behavior is the same as calling clear\_wifi\_enable\_state\(\).|
|release\_wifi\_enable\_state\(\)| [WifiEnableState](WifiEnableState.md#) \*|void|Releases the ownership of the field and returns the pointer of the [WifiEnableState](WifiEnableState.md#) object. After calling this, caller takes the ownership of the allocated [WifiEnableState](WifiEnableState.md#) object, has\_wifi\_enable\_state\(\) will return false, and wifi\_enable\_state\(\) will return the default value.|
|has\_bluetooth\_enable\_state\(\) const|bool|void|Returns true if bluetooth\_enable\_state is set.|
|bluetooth\_enable\_state\(\)|const [BluetoothEnableState](BluetoothEnableState.md#)&|void|Returns the current value of bluetooth\_enable\_state. If bluetooth\_enable\_state is not set, returns a [BluetoothEnableState](BluetoothEnableState.md#) with none of its fields set \(possibly bluetooth\_enable\_state::default\_instance\(\)\).|
|mutable\_bluetooth\_enable\_state\(\)| [BluetoothEnableState](BluetoothEnableState.md#) \*|void|Returns a pointer to the mutable [BluetoothEnableState](BluetoothEnableState.md#) object that stores the field's value. If the field was not set prior to the call, then the returned [BluetoothEnableState](BluetoothEnableState.md#) will have none of its fields set \(i.e. it will be identical to a newly-allocated [BluetoothEnableState](BluetoothEnableState.md#)\). After calling this, has\_bluetooth\_enable\_state\(\) will return true and bluetooth\_enable\_state\(\) will return a reference to the same instance of [BluetoothEnableState](BluetoothEnableState.md#).|
|clear\_bluetooth\_enable\_state\(\)|void|void|Clears the value of the field. After calling this, has\_bluetooth\_enable\_state\(\) will return false and bluetooth\_enable\_state\(\) will return the default value.|
|set\_allocated\_bluetooth\_enable\_state\(\)|void| [BluetoothEnableState](BluetoothEnableState.md#) \*|Sets the [BluetoothEnableState](BluetoothEnableState.md#) object to the field and frees the previous field value if it exists. If the [BluetoothEnableState](BluetoothEnableState.md#) pointer is not NULL, the message takes ownership of the allocated [BluetoothEnableState](BluetoothEnableState.md#) object and has\_ [BluetoothEnableState](BluetoothEnableState.md#)\(\) will return true. Otherwise, if the bluetooth\_enable\_state is NULL, the behavior is the same as calling clear\_bluetooth\_enable\_state\(\).|
|release\_bluetooth\_enable\_state\(\)| [BluetoothEnableState](BluetoothEnableState.md#) \*|void|Releases the ownership of the field and returns the pointer of the [BluetoothEnableState](BluetoothEnableState.md#) object. After calling this, caller takes the ownership of the allocated [BluetoothEnableState](BluetoothEnableState.md#) object, has\_bluetooth\_enable\_state\(\) will return false, and bluetooth\_enable\_state\(\) will return the default value.|

**Parent topic:** [Base \(C++\)](../../summary_pages/Base.md)

18 changes: 18 additions & 0 deletions api_cpp/doc/markdown/messages/Base/WifiEnableState.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,18 @@
# class WifiEnableState

**Member values**

|Member name|Data type|Description|
|-----------|---------|-----------|
|enabled|bool| |

**Member functions**

|Function name|Return type|Input type|Description|
|-------------|-----------|----------|-----------|
|enabled\(\)|bool|void|Returns the current value of enabled. If the enabled is not set, returns 0.|
|set\_enabled\(\)|void|bool|Sets the value of enabled. After calling this, enabled\(\) will return value.|
|clear\_enabled\(\)|void|void|Clears the value of enabled. After calling this, enabled\(\) will return 0.|

**Parent topic:** [Base \(C++\)](../../summary_pages/Base.md)

7 changes: 7 additions & 0 deletions api_cpp/doc/markdown/summary_pages/Base.md
Original file line number Diff line number Diff line change
Expand Up @@ -161,6 +161,10 @@ Base service. Broadly useful service. Provides functions for configuring a range
|ComputeForwardKinematics|[Pose](../messages/Base/Pose.md#)|[JointAngles](../messages/Base/JointAngles.md#)|Get the forward kinematics given specified angular positions of actuators|
|ComputeInverseKinematics|[JointAngles](../messages/Base/JointAngles.md#)|[IKData](../messages/Base/IKData.md#)|Get the inverse kinematics given a specified cartesian pose and guess of joint angles|
|ValidateWaypointList|[WaypointValidationReport](../messages/Base/WaypointValidationReport.md#)|[WaypointList](../messages/Base/WaypointList.md#)|Validate a waypoint list, returns an empty trajectory error report list if the waypoint list is valid. If the use\_optimal\_blending option is true, a waypoint list with optimal blending will be return.|
|SetWifiEnableState|[Empty](../messages/Common/Empty.md#)|[WifiEnableState](../messages/Base/WifiEnableState.md#)|Enable or disable the wifi capabilities on the arm|
|GetWifiEnableState|[WifiEnableState](../messages/Base/WifiEnableState.md#)|[Empty](../messages/Common/Empty.md#)|Get the wifi capabilities state \(enabled or disabled\)|
|SetBluetoothEnableState|[Empty](../messages/Common/Empty.md#)|[BluetoothEnableState](../messages/Base/BluetoothEnableState.md#)|Enable or disable the Bluetooth capabilities on the arm|
|GetBluetoothEnableState|[BluetoothEnableState](../messages/Base/BluetoothEnableState.md#)|[Empty](../messages/Common/Empty.md#)|Get the Bluetooth capabilities state \(enabled or disabled\)|

## Class reference

Expand All @@ -184,6 +188,7 @@ This section describes the data classes used in this API.
|[AppendActionInformation](../messages/Base/AppendActionInformation.md#)|Representation of the result of appending \(adding at the end\) an action to an existing sequence \(not implemented yet\)|
|[ArmStateInformation](../messages/Base/ArmStateInformation.md#)|Information about the arm state|
|[ArmStateNotification](../messages/Base/ArmStateNotification.md#)|Notification about a single arm state event|
|[BluetoothEnableState](../messages/Base/BluetoothEnableState.md#)| |
|[BridgeConfig](../messages/Base/BridgeConfig.md#)|Bridge configuration information. It is used to either create a bridge or to retrieve information about an existing bridge|
|[BridgeIdentifier](../messages/Base/BridgeIdentifier.md#)|Bridge identifier|
|[BridgeList](../messages/Base/BridgeList.md#)|An array of configuration information for different bridges.|
Expand Down Expand Up @@ -283,6 +288,7 @@ This section describes the data classes used in this API.
|[ProtectionZoneNotification](../messages/Base/ProtectionZoneNotification.md#)|Notification about a single protection zone event|
|[ProtectionZoneNotificationList](../messages/Base/ProtectionZoneNotificationList.md#)|Array of protection zone notifications|
|[Query](../messages/Base/Query.md#)|Parameters of an event log query \(not implemented yet\)|
|[RFConfiguration](../messages/Base/RFConfiguration.md#)| |
|[RequestedActionType](../messages/Base/RequestedActionType.md#)|Message used for requesting all action instances of a specific action type|
|[RobotEventNotification](../messages/Base/RobotEventNotification.md#)|Notification about a single robot event|
|[RobotEventNotificationList](../messages/Base/RobotEventNotificationList.md#)|Array of robot event notifications|
Expand Down Expand Up @@ -330,6 +336,7 @@ This section describes the data classes used in this API.
|[WaypointValidationReport](../messages/Base/WaypointValidationReport.md#)|Waypoint Validation results|
|[WifiConfiguration](../messages/Base/WifiConfiguration.md#)|Wi-Fi connection configuration|
|[WifiConfigurationList](../messages/Base/WifiConfigurationList.md#)|Array of Wi-Fi connection configuration for different networks|
|[WifiEnableState](../messages/Base/WifiEnableState.md#)| |
|[WifiInformation](../messages/Base/WifiInformation.md#)|Information about a specific Wi-Fi network|
|[WifiInformationList](../messages/Base/WifiInformationList.md#)|Array of information about different Wi-Fi networks|
|[Wrench](../messages/Base/Wrench.md#)|A wrench \(force and torque\)|
Expand Down
4 changes: 2 additions & 2 deletions api_cpp/examples/readme.md
Original file line number Diff line number Diff line change
Expand Up @@ -74,7 +74,7 @@ On Windows, make sure you add CMake to your PATH variable
```
<a id="markdown-procedure-to-install-gcc-54-under-linux-ubuntu-1604" name="procedure-to-install-gcc-54-under-linux-ubuntu-1604"></a>

#### Procedure to install GCC under Linux (GCC 5.4 on Ubuntu 16.04, GCC 7.4 on Ubuntu 18.04)
#### Procedure to install GCC under Linux (GCC 5.4 on Ubuntu 16.04, GCC 7.4 on Ubuntu 18.04, GCC 9.4 on Ubuntu 20.04)
```sh
sudo apt-get install build-essential
```
Expand Down Expand Up @@ -159,7 +159,7 @@ Example (build-mingw.bat)
```

This will effectively revert to the old build method. It requires downloading the Kortex Api library:
+ Download the archive via Kinova's Artifactory server: [kortex_api](https://artifactory.kinovaapps.com/artifactory/generic-public/kortex/API/2.3.0/)
+ Download the archive via Kinova's Artifactory server: [kortex_api](https://artifactory.kinovaapps.com/ui/repos/tree/General/generic-public/kortex/API/2.5.0/)
+ Uncompress the content of the archive and place it in the directory `kortex_api`.

```sh
Expand Down
4 changes: 4 additions & 0 deletions api_python/doc/markdown/enums/Base/NetworkEvent.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,6 +17,10 @@ Enumeration NetworkEvent
|WIFI\_AUTH\_WRONG\_KEY|8|Wi-Fi wrong PSK supplied|
|WIFI\_AUTH\_CONN\_FAILED|9|Wi-Fi connection failure during auth|
|WIFI\_AUTH\_FAILED|10|Wi-Fi authentication failure|
|WIFI\_ENABLED|11|Wi-Fi has been enabled|
|WIFI\_DISABLED|12|Wi-Fi has been disabled|
|BLUETOOTH\_ENABLED|13|Bluetooth has been enabled|
|BLUETOOTH\_DISABLED|14|Bluetooth has been disabled|

**Parent topic:** [Base \(Python\)](../../summary_pages/Base.md)

3 changes: 3 additions & 0 deletions api_python/doc/markdown/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,6 +53,7 @@
- [class AppendActionInformation](messages/Base/AppendActionInformation.md)
- [class ArmStateInformation](messages/Base/ArmStateInformation.md)
- [class ArmStateNotification](messages/Base/ArmStateNotification.md)
- [class BluetoothEnableState](messages/Base/BluetoothEnableState.md)
- [class BridgeConfig](messages/Base/BridgeConfig.md)
- [class BridgeIdentifier](messages/Base/BridgeIdentifier.md)
- [class BridgeList](messages/Base/BridgeList.md)
Expand Down Expand Up @@ -152,6 +153,7 @@
- [class ProtectionZoneNotification](messages/Base/ProtectionZoneNotification.md)
- [class ProtectionZoneNotificationList](messages/Base/ProtectionZoneNotificationList.md)
- [class Query](messages/Base/Query.md)
- [class RFConfiguration](messages/Base/RFConfiguration.md)
- [class RequestedActionType](messages/Base/RequestedActionType.md)
- [class RobotEventNotification](messages/Base/RobotEventNotification.md)
- [class RobotEventNotificationList](messages/Base/RobotEventNotificationList.md)
Expand Down Expand Up @@ -199,6 +201,7 @@
- [class WaypointValidationReport](messages/Base/WaypointValidationReport.md)
- [class WifiConfiguration](messages/Base/WifiConfiguration.md)
- [class WifiConfigurationList](messages/Base/WifiConfigurationList.md)
- [class WifiEnableState](messages/Base/WifiEnableState.md)
- [class WifiInformation](messages/Base/WifiInformation.md)
- [class WifiInformationList](messages/Base/WifiInformationList.md)
- [class Wrench](messages/Base/Wrench.md)
Expand Down
10 changes: 10 additions & 0 deletions api_python/doc/markdown/messages/Base/BluetoothEnableState.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
# class BluetoothEnableState

**Member values**

|Member name|Data type|Description|Usage|
|-----------|---------|-----------|-----|
|enabled|bool| |You can manipulate the field enabled as if it were a regular field. To clear the value of enabled and reset it to the default value for its type, you call the ClearField\(\) method of the Message interface.|

**Parent topic:** [Base \(Python\)](../../summary_pages/Base.md)

11 changes: 11 additions & 0 deletions api_python/doc/markdown/messages/Base/RFConfiguration.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
# class RFConfiguration

**Member values**

|Member name|Data type|Description|Usage|
|-----------|---------|-----------|-----|
|wifi\_enable\_state| [WifiEnableState](WifiEnableState.md#)| |To set wifi\_enable\_state, you simply assign a value directly to a field within wifi\_enable\_state. You can also use the parent message's HasField\(\) method to check if a message type field value has been set.|
|bluetooth\_enable\_state| [BluetoothEnableState](BluetoothEnableState.md#)| |To set bluetooth\_enable\_state, you simply assign a value directly to a field within bluetooth\_enable\_state. You can also use the parent message's HasField\(\) method to check if a message type field value has been set.|

**Parent topic:** [Base \(Python\)](../../summary_pages/Base.md)

10 changes: 10 additions & 0 deletions api_python/doc/markdown/messages/Base/WifiEnableState.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
# class WifiEnableState

**Member values**

|Member name|Data type|Description|Usage|
|-----------|---------|-----------|-----|
|enabled|bool| |You can manipulate the field enabled as if it were a regular field. To clear the value of enabled and reset it to the default value for its type, you call the ClearField\(\) method of the Message interface.|

**Parent topic:** [Base \(Python\)](../../summary_pages/Base.md)

Loading

0 comments on commit 392c312

Please sign in to comment.