Skip to content

Commit

Permalink
doc: updated readme
Browse files Browse the repository at this point in the history
  • Loading branch information
rdu-weston committed May 9, 2024
1 parent b5d50bf commit bfa180d
Show file tree
Hide file tree
Showing 2 changed files with 48 additions and 4 deletions.
40 changes: 38 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,8 +8,8 @@
This software package provides a C++ interface to communicate with the mobile platforms, for sending commands to the
robot and receiving the latest robot state. The repository is a joint effort by the development teams at Weston Robot (Singapore) and AgileX Robotics (China).

- Copyright (c) 2020-2023 [Weston Robot](https://www.westonrobot.com/)
- Copyright (c) 2020-2023 [AgileX Robotics](http://www.agilex.ai/?lang=zh-cn)
- Copyright (c) 2020-2024 [Weston Robot](https://www.westonrobot.com/)
- Copyright (c) 2020-2024 [AgileX Robotics](http://www.agilex.ai/?lang=zh-cn)

Please create an issue on Github at https://github.com/westonrobot/ugv_sdk/issues if you encounter any problems when
using the packages.
Expand Down Expand Up @@ -62,6 +62,42 @@ $ cd ..
$ catkin_make
```

### Build the package as a CMake project

```
$ git clone https://github.com/westonrobot/ugv_sdk.git
$ cd ugv_sdk
$ mkdir build && cd build
$ cmake .. && make
```

If you need Python binding, you can build the package with the following command

```
$ cmake -DENABLE_PYTHON_BINDING=ON .. && make
```

### Build the package as a Python package

For development and testing, you can use inplace build

```bash
$ python setup.py build_ext --inplace
```

It will generate library files in build/temp.linux-x86_64-3.10/lib (the name could be different based on your system).
You can add the path to the PYTHONPATH environment variable to use the library.

```bash
$ export PYTHONPATH=$PYTHONPATH:<path-to-the-repo>/build/temp.linux-x86_64-3.10/lib
```

You can also install the package to your Python environment using

```bash
$ python setup.py install
```

## Setup CAN-To-USB Adapter

1. Enable gs_usb kernel module
Expand Down
12 changes: 10 additions & 2 deletions setup.py
Original file line number Diff line number Diff line change
Expand Up @@ -44,11 +44,19 @@ def build_extension(self, ext):

setup(
name='ugv_sdk_py',
version='0.1.1',
version='0.2.0',
author='Ruixiang Du',
author_email='[email protected]',
description='Python bindings for the ugv_sdk library using pybind11',
long_description='',
long_description='ugv_sdk C++ library: https://github.com/westonrobot/ugv_sdk, by Weston Robot & AgileX Robotics',
classifiers=[
'Operating System :: POSIX :: Linux',
'Programming Language :: Python :: 3',
'Programming Language :: Python :: 3.8',
'Programming Language :: Python :: 3.10',
],
platforms=['Linux'],
python_requires='>=3.8',
ext_modules=[CMakeExtension('ugv_sdk_bindings')],
cmdclass=dict(build_ext=CMakeBuild),
zip_safe=False,
Expand Down

0 comments on commit bfa180d

Please sign in to comment.