在社交媒体上共享

YEI 3-Space Application Programming Interface(API)应用开发接口

Python API

 

 

 

 

 

 

 

 

 

Description描述

The YEI 3-Space Application Programming Interface (API) is a series of functions, classes, and structure definitions designed to make writing applications that utilize the YEI 3-Space family of sensors fast and easy to support. Binary libraries (or source files depending on the supported language) are included for convenient integration into projects of any size or application.

Currently, the YEI 3-Space API supports C/C++ and Python natively. The Python variant of the API is provided as a main module source file with several support/utility source files. The C variant of the API is distributed as a header (.h) and dynamic link library (.dll + .lib). With the C API, users that require easy integration of the 3-Space family of sensors into programming environments not natively supported may import the dynamic link library and call its contained functions from the importing program, as the API's function prototypes are all compiled as C prototypes and are name mangled as such.

Key Features主要特点

  • Supports all members of the YEI 3-Space Sensor family
  • Provides access to all supported commands available to the 3-Space family of hardware in a human readable way
  • Designed to support all 3-Space hardware across all firmware versions, making application forward compatibility easy
  • Native support for Python (2.5x and 3.x) and C/C++
  • Support for any language that can import Microsoft Windows Dynamic Link Libraries (.dll)
  • Open source and free, allowing users to try and modify the API without consequence

System Requirements系统要求

Software

Operating System - Windows XP(32-Bit), Windows Vista/7(32-Bit or 64-Bit)

3-Space Firmware Version - Firmware dated 11 Jan 2012 is the oldest recommended firmware.
NOTE: Due to changes being made to the gyroscope calibration pipeline, the "setGyroCalibrationParam" and "getGyroCalibrationParam" functions are not currently supported.

Dependencies - Python

PySerial 2.6 or newer

License

The YEI 3-Space APIs are released under the YEI 3-Space Open Source License, which allows for both non-commercial use and commercial use with certain restrictions.

For Non-Commercial Use, your use of Covered Works is governed by the GNU GPL v.3, subject to the YEI 3-Space Open Source Licensing Overview and Definitions.

For Commercial Use, a YEI Commercial/Redistribution License is required, pursuant to the YEI 3-Space Open Source Licensing Overview and Definitions. Commercial Use, for the purposes of this License, means the use, reproduction and/or Distribution, either directly or indirectly, of the Covered Works or any portion thereof, or a Compilation, Improvement, or Modification, for Pecuniary Gain. A YEI Commercial/Redistribution License may or may not require payment, depending upon the intended use.

Full details of the YEI 3-Space Open Source License can be found here

Downloads and Documentation下载与文档

Documentation

Legacy For firmware 1.0+

3-Space Python API Quick Start Guide, 1.0.0, updated 12 Apr 2012

3-Space Python API Documentation Reference (PDF), 1.1.0, updated 14 May 2012

3-Space C API Quick Start Guide, 1.1.0, updated 13 Jul 2012

3-Space C API Documentation Reference (PDF), 1.1.3, updated 13 Jun 2012

Python API

3-Space Python API Installer, 2.0.2.3, updated 19 Jun 2014

3-Space Python API Source, 2.0.2.3, updated 19 Jun 2014

Legacy Hosted on SourceForge (For firmware 1.0+)

Project Main Page

Downloads

Source

C API

3-Space C API, 2.0.6.1, updated 06 Mar 2014

3-Space C API Source, 2.0.6.1, updated 06 Mar 2014

Legacy Hosted on SourceForge (For firmware 1.0+)

Project Main Page

Downloads

Source

API Examples

YEI 3-Space Python API Examples

YEI 3-Space C API Examples

Informational Resources

Forums

3-Space Python API Forum

3-Space C API Forum

Links

http://www.python.org - Main site for the Python programming language.

http://pyserial.sourceforge.net - Project page for the PySerial Python module.

 

YEI 3-Space Interactive Cube-Space Demos  互动立方演示

空迷宫,得着

Description

The YEI 3-Space Sensor Interactive Cube-Space Demos are designed to demonstrate the fast real-time response and accuracy of the YEI 3-Space Sensor™ family in a user friendly and entertaining way. There are two games included, a 3-dimensional maze and a color matching game. The maze game demonstrates the fine accuracy of the sensor as the player freely rotates a cube-shaped maze on all axes and navigate a ball to the the maze's goal. The color matching game demonstrates the fast response time of the 3-Space Sensor as the player matches an on-screen cube's color with a series of approaching colored rings.

Key Features

  • Supports all members of the YEI 3-Space Sensor family
  • Easy to setup demonstration of the 3-Space sensor
  • Interactive 3D demos illustrate the responsiveness and accuracy of 3-Space Sensor technology
  • Free and open source, allowing users to see a working example of the integration of the YEI 3-Space sensor in to an application
  • Includes multiple game examples

System Requirements

Software

Operating System - Windows XP SP3(32-Bit), Windows Vista/7(32-Bit or 64-Bit)

Processor - P4 or greater

Memory - 512MB Ram

Video Card - Dedicated video card recomended

License

The YEI 3-Space Interactive Cube-Space Demos are released under the YEI 3-Space Open Source License, which allows for both non-commercial use and commercial use with certain restrictions.

For Non-Commercial Use, your use of Covered Works is governed by the GNU GPL v.3, subject to the YEI 3-Space Open Source Licensing Overview and Definitions.

For Commercial Use, a YEI Commercial/Redistribution License is required, pursuant to the YEI 3-Space Open Source Licensing Overview and Definitions. Commercial Use, for the purposes of this License, means the use, reproduction and/or Distribution, either directly or indirectly, of the Covered Works or any portion thereof, or a Compilation, Improvement, or Modification, for Pecuniary Gain. A YEI Commercial/Redistribution License may or may not require payment, depending upon the intended use.

Full details of the YEI 3-Space Open Source License can be found here

Downloads and Documentation

Documentation

3-Space Sensor Interactive Examples Quick-Start Manual, 1.0.0, updated 18 Jan 2012

Download

3-Space Sensor Interactive Examples Installer, Firmware 2 Compatible 2.0.0, updated 19 Jun 2013

Change in 2.0.0: Wireless sensors not plugged via USB no longer show up in pause menu. Now select the Dongle they are paired with instead. Page Up and Page Down Keys will go through Sensors paired to the Dongle.

3-Space Sensor Interactive Examples Installer, 1.0.1, updated 24 Feb 2012

Videos

YEI 3-Space Sensor Blender Motion Capture Plug-in  BM插件

3-Space传感器Blender动捕Plug-in插件

 

3-Space传感器动捕截屏

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Description

The YEI 3-Space Sensor Blender Motion Capture Plug-in is an addon for the open source 3D modeling program Blender. Once installed, the plugin provides tools for interfacing the YEI 3-Space family of sensors with Blender, configure individual sensors, pair sensors with Blender armature bones, and record orientation data over time for driving armatures created in Blender. Utilizing these features, users may put Blender to work as an all in one tool for motion capture animation recording, clean-up, and editing.

Flexibility in capture options is also provided by the plugin. Options ranging from data stream and data poll rates to keyframe scaling options are all provided in an easy to use interface. Constraints on the length of time and number of frames captured may also be defined to further optimize any motion capture workflow. All data capture and storage is also performed from within Blender, which means any part of the capture pipeline may benefit from the collection of tools and options provided by Blender out of the box.

The 3-Space Motion Capture Plugin utilizes Blender's powerful Python based API for creating the menus and tools necessary for interacting with the 3-Space family of sensor natively from within Blender. The plugin is also provided for free under an open source licence. This means others may expand, enhance, and learn from the code that drives it.

Accessories

We also offer Strap Sets that can be used for placing the 3-Space Sensor devices.

Key Features

  • Supports all members of the YEI 3-Space Sensor family
  • Built with the Blender 2.6x Python API and compatible with all modern versions of Blender (32-Bit and 64-Bit)
  • Provides tools for configuring YEI 3-Space sensors and dongles
  • Supports realtime data streaming and threaded orientation data recording
  • Records orientation data as armature keyframes, thus making editing and clean-up easy
  • Open source and free, allowing users to try and modify the plugin without consequence

System Requirements

Software

Operating System - Windows XP(32-Bit), Windows Vista/7(32-Bit or 64-Bit)

Blender Version - Blender 2.60a or newer(32-Bit or 64-Bit) for Windows. Blender may be downloaded here.
NOTE: Version 2.61 of Blender is not supported by the YEI 3-Space Blender Motion Capture Plugin due to a bug in that version of Blender. To use the plugin, please either install 2.60a or a version newer than 2.61 of Blender.

License

The YEI 3-Space Sensor Blender Motion Capture Plug-in is released under the YEI 3-Space Open Source License, which allows for both non-commercial use and commercial use with certain restrictions.

For Non-Commercial Use, your use of Covered Works is governed by the GNU GPL v.3, subject to the YEI 3-Space Open Source Licensing Overview and Definitions.

For Commercial Use, a YEI Commercial/Redistribution License is required, pursuant to the YEI 3-Space Open Source Licensing Overview and Definitions. Commercial Use, for the purposes of this License, means the use, reproduction and/or Distribution, either directly or indirectly, of the Covered Works or any portion thereof, or a Compilation, Improvement, or Modification, for Pecuniary Gain. A YEI Commercial/Redistribution License may or may not require payment, depending upon the intended use.

Full details of the YEI 3-Space Open Source License can be found here

Downloads and Documentation

Documentation

3-Space Blender Quick Start Manual, 1.0.0, updated 18 Jan 2012

Plugin Downloads

3-Space Blender Plugin Installer, 1.0.3, updated 17 May 2012

3-Space Blender Plugin Archive, 1.0.3, updated 17 May 2012

Videos

Informational Resources

Links

http://en.wikipedia.org/wiki/Blender3d - Wikipedia entry describing the open source Blender 3D modelling and animation application.

http://www.blender.org - Link to the Blender 3D website.

 

YEI 3-Space Sensor Software Suite 传感器演示软件

3-Space sensor software suite 1

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

3 Space Sensor Software suite 2

 

 

 

 

 

 

 

 

 

 

 

 

 

3-Space Sensor Suite terminal

 

Description描述

The YEI 3-Space Sensor Software Suite is meant to make setup and configuration of the 3-Space Sensor easy. It provides a graphical view of the orientation output of the sensor, and gives access to many orientation calibration parameters such as oversampling and averaging. The data chart gives a quick view of either normalized or raw data coming from the accelerometer, compass, and gyroscope, and has options for logging data to the PC.

The 3-Space Sensor Software Suite provides support for all members of the 3-Space Sensor family, including configuration options for specific members. Features include a simple table interface to set up connections between 3-Space Wireless sensors and 3-Space Dongles, and capability to set the current time on the 3-Space Data Logging's real time clock based on the PC's system time.

The 3-Space Sensor Software Suite makes setup of some of the more advanced sensor options easy, as well. The suite provides HID customization capabilities, by which the sensor can be made to act as a joystick or mouse for the PC with user defined buttons and motion axes. The suite also has a wizard for setting up the sensor's Multi-Reference calibration scheme, which can increase accuracy after a short calibration process. It gives access to firmware update capabilities as well.

Key Features主要特点

  • Realtime interactive 3D display of orientation
  • Realtime display of sensor data in strip-chart format
  • Access to calibration and performance features
  • Sensor data capture to file
  • Access to all sensor configuration parameters
  • Supports all members of the YEI 3-Space Sensor family
  • Allows sensor firmware updates
  • Data terminal for interactive ASCII communication and debugging
  • Installer includes latest drivers

System Requirements系统要求

Software

Operating System - Windows XP(32-Bit), Windows Vista/7(32-Bit or 64-Bit)

Downloads and Documentation

Documentation文档

3-Space Sensor Suite Manual, v3.1, updated 11 Apr 2019 (传感器测试软件用户手册)

 

Download 下载

3SpaceSuite-v1.1.7-Installer for Windows 7 to 10 (includes drivers) updated March-11-2020  (3-Space Sensor测试软件 v1.1.7)

Legacy 3-Space Sensor Suite Installer for Windows 10 (includes drivers), 3.0r7, updated 28 Mar 2017

Legacy 3-Space Sensor Suite Installer for Windows 7, 8, 8.1, 3.0r7, updated 10 Apr 2017

 

EXPERIMENTAL PROJECTS  成功案例

Using a YEI 3-Space Embedded Sensor and Sony HMZ-T1 Headset a simple head tracking demo in UDK was made. Taking advantage of UDK's ability to bind external DLLs, getting orientation data into Unreal requires only a few lines of uscript and the 3-Space C API dll.

Real-time Head Tracking using an off-the-self HMD

Head Tracking with YEI 3-Space Sensor in UDK; 索尼MHZ-T1带3-Space传感器。

Works on the entire 3-Space Sensor Family

Model for Embedded sensor clip available for download

Built and tested with Unreal Development Kit(May 2012)

Free and open source, thus allowing use and modification of the application without consequences

 

TSS-EM/Sony HMZ-T1头部跟踪UDK虚幻视频http://pan.baidu.com/s/1c2cdnUS

 

Android 3-Space Bluetooth App 安卓手机蓝牙App

To demonstrate the capability of using the 3-Space Bluetooth on Android this app was created. It is designed to be an example to understand how to communicate with the 3-Space Sensor in Android. Requires basic understanding of Android development, source code provided only.

Android 3-Space Bluetooth App;安卓系统应用蓝牙传感器。
  • Real-time visualization of orientation
  • Set axis directions and LED color
  • Get Sensor info from your phone
  • Built and tested with multiple phones
  • Free and open source, thus allowing use and modification of the application without consequences

 

Head Tracking in Simulations and Games

Using a YEI 3-Space Sensors in existing games and simulators for basic head tracking.

  • 2DOF working in ArmA2 and Day-Z, requires no additional software

 ArmA2头部跟踪http://pan.baidu.com/s/1kUGks1x

 

Real-time Mocap and VR in UDK

This is a video of the live demo that was at ION GNSS 2012 September 17-21.

Using 17 YEI 3-Space Wireless Sensors and 3 3-Space Wireless Dongles motions from an actor can be applied to a mesh in real-time and can be
used to interact with a virtual scene. Adding a HMD to the suit allows for an immersive first-person experience with head and body tracking.

  • Uses UDK to render impressive and interactive scenes
  • Using a head mounted display can be used for more immersive VR
  • System does not rely on line of sight to function
  • Sensor fusion is done on-chip greatly simplifying implementation
  • Real-time mocap with low cpu usage

实时动捕与虚拟现实UDK虚幻http://pan.baidu.com/s/1o78CCIY

 

Real-time Motion Capture with YEI Mocap Bundle in Ogre3d

This is the video of the live demo that was at Sensors Expo 2012 in Chicago.

  • Uses Ogre3d for a completely open source example
  • System does not rely on line of sight to function
  • Sensor fusion is done on-chip greatly simplifying implementation
  • Real-time mocap with low cpu usage
  • An early test for simple translation

 实时动捕Ogre3D游戏http://pan.baidu.com/s/1mhCe3cW