| Name | dexsensor JSON |
| Version |
0.1.17
JSON |
| download |
| home_page | None |
| Summary | A Python library for processing sensor data on Dexmate Robots |
| upload_time | 2025-07-25 00:50:20 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | <3.14,>=3.10 |
| license | None |
| keywords |
robot
robotics
sensors
camera
imu
python
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Dexsensor
A unified sensor management system for Dexmate robots. Dexsensor provides automatic robot detection and configuration for cameras, IMU, LiDAR, and other sensors through an easy-to-use command line interface.
## Features
- **Automatic Robot Detection**: Detects robot model and loads appropriate sensor configuration
- **Multiple Robot Variants**: Support for different robot models with optimized sensor configurations
- **Unified Sensor Management**: Consistent interface for cameras, IMU, LiDAR, and other sensors
- **Real-time Communication**: High-performance sensor data streaming
- **Flexible Configuration**: Easy configuration management with YAML files
- **Command Line Interface**: Simple CLI for sensor control and configuration
## Installation
DexSensor is distributed as a pre-built package for Dexmate robot systems.
```bash
# Install DexSensor package
pip install dexsensor
# Verify installation
dexsensor --help
```
## Quick Start
### Automatic Robot Detection
Set your robot model and launch sensors:
```bash
# Launch sensors with automatic detection
dexsensor launch
```
### Manual Robot Selection
```bash
# Launch specific sensors only
dexsensor launch --sensor head_camera base_front_camera
# Override configuration values
dexsensor launch --set head_camera.fps=60 lidar.enable=true
```
## Command Line Interface
### Launch Sensors
```bash
# Basic usage
dexsensor launch
# Launch specific sensors
dexsensor launch --sensor head_camera lidar
# Launch all sensors (enables all sensors regardless of default config)
dexsensor launch --sensor all
# Launch all base cameras (base_left, base_right, base_front, base_back)
dexsensor launch --sensor base_camera
# Override configuration
dexsensor launch --set head_camera.fps=60 lidar.enable=true
# Use custom configuration file
dexsensor launch --config /path/to/config.yaml
# Combine options
dexsensor launch --set head_camera.fps=30 --sensor head_camera
```
### Configuration Management
```bash
# Generate configuration template
dexsensor gen-cfg
# Save to custom location
dexsensor gen-cfg --output /path/to/config.yaml
```
### Command Options
| Option | Description | Example |
|--------|-------------|---------|
| `--robot` | Specify robot variant | `--robot vega-1` |
| `--sensor` | Launch specific sensors, "all", or "base_camera" | `--sensor head_camera lidar`, `--sensor all`, or `--sensor base_camera` |
| `--config` | Use custom config file | `--config config.yaml` |
| `--set` | Override config values | `--set head_camera.fps=60` |
| `--zenoh` | Custom Zenoh config | `--zenoh zenoh.json5` |
## Configuration
### Configuration Files
DexSensor uses YAML configuration files with the following precedence:
1. **Command line overrides** (`--set key=value`)
2. **Custom configuration files** (`--config file.yaml`)
3. **Default configuration file** (`~/.dexmate/sensors/default_config.yaml`)
4. **Robot variant defaults** (based on detected/specified robot model)
### Configuration Example
```yaml
head_camera:
enable: true
fps: 30
resolution: HD1080
depth_mode: NEURAL
base_front_camera:
enable: true
width: 640
height: 480
fps: 30
format: MJPG
lidar:
enable: false
ip_address: "192.168.50.41"
udp_port: 8089
base_imu:
enable: true
head_imu:
enable: true
```
## Licensing
This project is dual-licensed:
### Open Source License
This software is available under the GNU Affero General Public License v3.0 (AGPL-3.0).
See the [LICENSE](./LICENSE) file for details.
### Commercial License
For businesses that want to use this software in proprietary applications without the AGPL requirements, commercial licenses are available. Contact us for commercial licensing: contact@dexmate.ai
Commercial licenses provide:
- Right to use in closed-source applications
- No source code disclosure requirements
- Priority support options
Raw data
{
"_id": null,
"home_page": null,
"name": "dexsensor",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.14,>=3.10",
"maintainer_email": null,
"keywords": "robot, robotics, sensors, camera, imu, python",
"author": null,
"author_email": "Dexmate <contact@dexmate.ai>",
"download_url": null,
"platform": null,
"description": "# Dexsensor\n\nA unified sensor management system for Dexmate robots. Dexsensor provides automatic robot detection and configuration for cameras, IMU, LiDAR, and other sensors through an easy-to-use command line interface.\n\n\n\n\n## Features\n\n- **Automatic Robot Detection**: Detects robot model and loads appropriate sensor configuration\n- **Multiple Robot Variants**: Support for different robot models with optimized sensor configurations \n- **Unified Sensor Management**: Consistent interface for cameras, IMU, LiDAR, and other sensors\n- **Real-time Communication**: High-performance sensor data streaming\n- **Flexible Configuration**: Easy configuration management with YAML files\n- **Command Line Interface**: Simple CLI for sensor control and configuration\n\n## Installation\n\nDexSensor is distributed as a pre-built package for Dexmate robot systems.\n\n```bash\n# Install DexSensor package\npip install dexsensor\n\n# Verify installation\ndexsensor --help\n```\n\n## Quick Start\n\n### Automatic Robot Detection\n\nSet your robot model and launch sensors:\n\n```bash\n# Launch sensors with automatic detection\ndexsensor launch\n```\n\n### Manual Robot Selection\n\n```bash\n# Launch specific sensors only\ndexsensor launch --sensor head_camera base_front_camera\n\n# Override configuration values\ndexsensor launch --set head_camera.fps=60 lidar.enable=true\n```\n\n\n## Command Line Interface\n\n### Launch Sensors\n\n```bash\n# Basic usage\ndexsensor launch\n\n\n# Launch specific sensors\ndexsensor launch --sensor head_camera lidar\n\n# Launch all sensors (enables all sensors regardless of default config)\ndexsensor launch --sensor all\n\n# Launch all base cameras (base_left, base_right, base_front, base_back)\ndexsensor launch --sensor base_camera\n\n# Override configuration\ndexsensor launch --set head_camera.fps=60 lidar.enable=true\n\n# Use custom configuration file\ndexsensor launch --config /path/to/config.yaml\n\n# Combine options\ndexsensor launch --set head_camera.fps=30 --sensor head_camera\n```\n\n### Configuration Management\n\n```bash\n# Generate configuration template\ndexsensor gen-cfg\n\n\n# Save to custom location\ndexsensor gen-cfg --output /path/to/config.yaml\n```\n\n### Command Options\n\n| Option | Description | Example |\n|--------|-------------|---------|\n| `--robot` | Specify robot variant | `--robot vega-1` |\n| `--sensor` | Launch specific sensors, \"all\", or \"base_camera\" | `--sensor head_camera lidar`, `--sensor all`, or `--sensor base_camera` |\n| `--config` | Use custom config file | `--config config.yaml` |\n| `--set` | Override config values | `--set head_camera.fps=60` |\n| `--zenoh` | Custom Zenoh config | `--zenoh zenoh.json5` |\n\n## Configuration\n\n### Configuration Files\n\nDexSensor uses YAML configuration files with the following precedence:\n\n1. **Command line overrides** (`--set key=value`)\n2. **Custom configuration files** (`--config file.yaml`)\n3. **Default configuration file** (`~/.dexmate/sensors/default_config.yaml`)\n4. **Robot variant defaults** (based on detected/specified robot model)\n\n### Configuration Example\n\n```yaml\nhead_camera:\n enable: true\n fps: 30\n resolution: HD1080\n depth_mode: NEURAL\n\nbase_front_camera:\n enable: true\n width: 640\n height: 480\n fps: 30\n format: MJPG\n\nlidar:\n enable: false\n ip_address: \"192.168.50.41\"\n udp_port: 8089\n\nbase_imu:\n enable: true\n\nhead_imu:\n enable: true\n```\n\n\n## Licensing\n\nThis project is dual-licensed:\n\n### Open Source License\nThis software is available under the GNU Affero General Public License v3.0 (AGPL-3.0).\nSee the [LICENSE](./LICENSE) file for details.\n\n### Commercial License\nFor businesses that want to use this software in proprietary applications without the AGPL requirements, commercial licenses are available. Contact us for commercial licensing: contact@dexmate.ai\n\nCommercial licenses provide:\n- Right to use in closed-source applications\n- No source code disclosure requirements\n- Priority support options\n",
"bugtrack_url": null,
"license": null,
"summary": "A Python library for processing sensor data on Dexmate Robots",
"version": "0.1.17",
"project_urls": null,
"split_keywords": [
"robot",
" robotics",
" sensors",
" camera",
" imu",
" python"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "969de70d16db1c2b03dbc7302b1aa5f539828fff7b8d1bd36069cdb725911488",
"md5": "41cbff66e1da2e673e9aeaa0eb31311e",
"sha256": "8d080a393b4a28e4cbadd53cbb948b8f21452496ac3871d70ebaad2372d24d63"
},
"downloads": -1,
"filename": "dexsensor-0.1.17-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl",
"has_sig": false,
"md5_digest": "41cbff66e1da2e673e9aeaa0eb31311e",
"packagetype": "bdist_wheel",
"python_version": "cp310",
"requires_python": "<3.14,>=3.10",
"size": 1305727,
"upload_time": "2025-07-25T00:50:20",
"upload_time_iso_8601": "2025-07-25T00:50:20.641952Z",
"url": "https://files.pythonhosted.org/packages/96/9d/e70d16db1c2b03dbc7302b1aa5f539828fff7b8d1bd36069cdb725911488/dexsensor-0.1.17-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "a232dcb4b0f508388c454113e9c473bd6777adfee9f59f0c529b15e98452f301",
"md5": "748e3f6a4522fdc8144f176a1636506b",
"sha256": "2635369f7080b15acd36cb71b1c29007b0c1c6e22fbf41da7a50b3154b9f4923"
},
"downloads": -1,
"filename": "dexsensor-0.1.17-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"has_sig": false,
"md5_digest": "748e3f6a4522fdc8144f176a1636506b",
"packagetype": "bdist_wheel",
"python_version": "cp310",
"requires_python": "<3.14,>=3.10",
"size": 1391490,
"upload_time": "2025-07-25T00:50:21",
"upload_time_iso_8601": "2025-07-25T00:50:21.900188Z",
"url": "https://files.pythonhosted.org/packages/a2/32/dcb4b0f508388c454113e9c473bd6777adfee9f59f0c529b15e98452f301/dexsensor-0.1.17-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "157fa3815ef92832dfa6c961cc4102308185349a5312e488ba03d96ac4e06153",
"md5": "4a20c2d65f73b6ac5a18a2b88f0372d8",
"sha256": "1f1cd1f405841ebe9c035291596bf2c7b5329db6bc90fcf9cc84c3529a91fc34"
},
"downloads": -1,
"filename": "dexsensor-0.1.17-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl",
"has_sig": false,
"md5_digest": "4a20c2d65f73b6ac5a18a2b88f0372d8",
"packagetype": "bdist_wheel",
"python_version": "cp311",
"requires_python": "<3.14,>=3.10",
"size": 1274359,
"upload_time": "2025-07-25T00:50:23",
"upload_time_iso_8601": "2025-07-25T00:50:23.391184Z",
"url": "https://files.pythonhosted.org/packages/15/7f/a3815ef92832dfa6c961cc4102308185349a5312e488ba03d96ac4e06153/dexsensor-0.1.17-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "95ca75e3309b5004a87e3429b5a3f22ef57292d5e7c86ef925d555dc60c8425e",
"md5": "98254a0acc7f8cb55496162796452018",
"sha256": "669ab69abe5856ac2c7e4f034a190af5443872e23816413994f83f713553b94c"
},
"downloads": -1,
"filename": "dexsensor-0.1.17-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"has_sig": false,
"md5_digest": "98254a0acc7f8cb55496162796452018",
"packagetype": "bdist_wheel",
"python_version": "cp311",
"requires_python": "<3.14,>=3.10",
"size": 1362648,
"upload_time": "2025-07-25T00:50:24",
"upload_time_iso_8601": "2025-07-25T00:50:24.723701Z",
"url": "https://files.pythonhosted.org/packages/95/ca/75e3309b5004a87e3429b5a3f22ef57292d5e7c86ef925d555dc60c8425e/dexsensor-0.1.17-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "4037cf239e88540c57bac771fcf913543440625a28385da3a2f93f0509872037",
"md5": "2cd7f35192b251b933d36be825347447",
"sha256": "dee467d603643bdd4cf901f86493185652acc11943e65dd672e8f8fa206cbfa3"
},
"downloads": -1,
"filename": "dexsensor-0.1.17-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl",
"has_sig": false,
"md5_digest": "2cd7f35192b251b933d36be825347447",
"packagetype": "bdist_wheel",
"python_version": "cp312",
"requires_python": "<3.14,>=3.10",
"size": 1358039,
"upload_time": "2025-07-25T00:50:26",
"upload_time_iso_8601": "2025-07-25T00:50:26.276929Z",
"url": "https://files.pythonhosted.org/packages/40/37/cf239e88540c57bac771fcf913543440625a28385da3a2f93f0509872037/dexsensor-0.1.17-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "ce5bc17f899ed97ca5cf1cba1ca122ef1ddb9a6d70b23289cd0c876dabec6870",
"md5": "365ef94033f8d3215dc41ee268ee5e3f",
"sha256": "e8df6b3cdd9faadf44e3c23107276d2bef0c813e2c5701d79f48afbb8e77e57a"
},
"downloads": -1,
"filename": "dexsensor-0.1.17-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"has_sig": false,
"md5_digest": "365ef94033f8d3215dc41ee268ee5e3f",
"packagetype": "bdist_wheel",
"python_version": "cp312",
"requires_python": "<3.14,>=3.10",
"size": 1481602,
"upload_time": "2025-07-25T00:50:27",
"upload_time_iso_8601": "2025-07-25T00:50:27.395633Z",
"url": "https://files.pythonhosted.org/packages/ce/5b/c17f899ed97ca5cf1cba1ca122ef1ddb9a6d70b23289cd0c876dabec6870/dexsensor-0.1.17-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "dec14c9fce10c8dbfa11066c37d3ee30713d0161971febdf367e91e89fcb2323",
"md5": "9640d88ae1bbee4e9a5aba4eaf5a0dfc",
"sha256": "64656630ca5fdd435da7590da022ee1e2eef7c7b7cc3926608801bc221446d93"
},
"downloads": -1,
"filename": "dexsensor-0.1.17-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl",
"has_sig": false,
"md5_digest": "9640d88ae1bbee4e9a5aba4eaf5a0dfc",
"packagetype": "bdist_wheel",
"python_version": "cp313",
"requires_python": "<3.14,>=3.10",
"size": 1362367,
"upload_time": "2025-07-25T00:50:28",
"upload_time_iso_8601": "2025-07-25T00:50:28.979861Z",
"url": "https://files.pythonhosted.org/packages/de/c1/4c9fce10c8dbfa11066c37d3ee30713d0161971febdf367e91e89fcb2323/dexsensor-0.1.17-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "4c237e0d9cd0ec175a85426425eae6b2a94a2c89c5387fb6a68d9465b3b983e8",
"md5": "8ea2a856c858ced15516b1cf8122475f",
"sha256": "b00a1eace1c0006319e377d379fb04ccf9d65f338e000d4e72caba8a7eeb967b"
},
"downloads": -1,
"filename": "dexsensor-0.1.17-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"has_sig": false,
"md5_digest": "8ea2a856c858ced15516b1cf8122475f",
"packagetype": "bdist_wheel",
"python_version": "cp313",
"requires_python": "<3.14,>=3.10",
"size": 1486001,
"upload_time": "2025-07-25T00:50:30",
"upload_time_iso_8601": "2025-07-25T00:50:30.470138Z",
"url": "https://files.pythonhosted.org/packages/4c/23/7e0d9cd0ec175a85426425eae6b2a94a2c89c5387fb6a68d9465b3b983e8/dexsensor-0.1.17-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-25 00:50:20",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "dexsensor"
}
