SimpleMotion V2

From Granite Devices Knowledge Wiki
(Redirected from SimpleMotion library)
Jump to: navigation, search
SimpleMotionlogo.png

SimpleMotion V2 is open source and royalty free field bus for industrial devices, such as motor drives and I/O's.

SM V2 is a complete redesign of the original SimpleMotion library. The main goals have been increasing flexibility and performance while still preserving the simplicity of the API.

Main features[edit | edit source]

SimpleMotion V2 bus with integrated hard-wired safety used in multiaxis drive system

Parameter communications[edit | edit source]

SM V2 is based on parameter communications. This means that all commands are implemented as settable and readable numeric parameters. For example commanding axis target position could be done by setting parameter such as SMP_TARGET_REFERENCE to a desired value. See also SimpleMotion motion control strategies.

Multidrop[edit | edit source]

SM V2 is based on RS485 physical interface yielding ability to link multiple device nodes into a single data link. Each device in the bus has unique address making it possible to target the commands to specific axis.

Buffered commands[edit | edit source]

In addition to instantly executed commands, SM V2 supports buffered commands meaning that commands may sent as chunks of multiple commands that are later interpreted by devices at predefined pace. This makes it possible to implement multiaxis synchronous interpolation without requiring a real time controller. Ring buffer implementation allows running infinite length sequences of commands. See also SimpleMotion motion control strategies.

Performance[edit | edit source]

Due to relatively high bitrate of RS485 bus and byte-efficient serial protocol, SM V2 performs very well in multiaxis real time & buffered applications. At default bit rate at least 6 axis continuously interpolated motion is possible.

Safety[edit | edit source]

SM V2 physical bus incorporates a dedicated wire for emergency stopping switch. All devices in the same bus will perform safe torque off and braking once e-stop button is pressed.

Library[edit | edit source]

SM V2 applications may be implemented by using a SM V2 C-language open source library. By default the library compiles on Windows & Unix with GNU GCC compiler and should be easily portable to other patforms, such as microcontrollers. The compiled library binary (DLL) may be used with virtually any programming tool (C#, VS, Labview etc).

Downloads[edit | edit source]

Library source code

For latest version, check out the develop branch. Download-icon.png SimpleMotion V2 at GitHub

Qt example projects

See Installing Qt SDK from scratch for instructions how to use this project.

VisualStudio 2013 C++ example project

Download-icon.png SMV2VScppExample.zip

Notice: this package contains outdated SimpleMotion library. For actual projects, it's recommended to fetch latest SM library sources from GitHub.

VS project needs updating library and header file paths from project properties (Right click on VScppExample on Solution explorer pane and go to Configuration properties->VC++ Directories and change Include directories and Library directories to point your location of SimpleMotionV2dll_Release_2 (included in the zip). Also smv.dll must be copied in the same folder than project .exe file (I.e. in Debug or Release folder).

Documentation[edit | edit source]


In no event the Product Information or parts hereof shall be regarded as guarantee of conditions or characteristics. The Product Information or any part thereof may also not be regarded as a warranty of any kind. No liability of any kind shall be assumed by Author with respect to Product Information or any use made by you thereof, nor shall Author indemnify you against or be liable for any third party claims with respect to such information or any use thereof.

As content of this Wiki may be edited by user community, Granite Devices Oy or it's affiliates do not take any responsibility of the contents of this Wiki. Use information at your own risk. However, Granite Devices staff attempts to review all changes made to this Wiki and keep information trustworthy.

Without written consent, Granite Devices' Products or Intellectual Property shall not be used in situations or installations where living beings, material property, or immaterial property could be harmed by the operation, features or failures of Product. Products may only be used in a way where hazards like moving parts, electric shock, laser radiation, or fire can't be realized even if the content of this Wiki would suggest otherwise.