/myo-for-max

Myo for Max - A max external for communication with the Myo Armband

Primary LanguageMaxMozilla Public License 2.0MPL-2.0

myo for max

myo for Max is a max external for communication with the Myo armband.

This object has been developed by Jules Françoise and Yves Candau at Simon Fraser University, in the context of the MovingStories research partnership, funded by the Social Sciences and Humanities Research Council (SSHRC).

Compatibility: Mac OS X 10.8+, Max 6.1+, 64-bit only. Windows, 32-bit and 64-bit.

It is based on the Myo c++ API by Thalmic Labs. This object should be compiled with Max SDK version 6 or greater.

Usage

General

Install the myo package by copying the max-package/ folder to one of the two possible Max package folders:

  • Max 7/Packages in your Documents (Mac) or My Documents (Windows) folder, or
  • Max 7/Packages in your /Users/Shared (Mac) or C:\ProgramData (Windows) folder

More information on Max packages is available here.

Mac

myo for max is only compatible with MacOS 10.8+, with Max running in 64-bit mode. To switch Max to 64-bit:

  1. In the finder, finder "Max.app" in the applications folder
  2. Right click and "Get Info"
  3. Uncheck "Open in 32-bit mode"
  4. restart Max

Windows

Max needs dll files to load myo for max. You will otherwise get the following error message:

Error 126 loading external myo

Install the package as previously indicated to make the dll files in the package available to Max.

Authors

This code has been initially authored by Jules Françoise during his Postdoctoral Fellowship at Simon Fraser University, in the context of the MovingStories research partnership. Windows version by Yves Candau.

Contact: Jules Françoise jfrancoi@sfu.ca

Copyright

Copyright (C) 2015 Jules Françoise.

Licence

This project is released under the Mozilla Public License 2.0 (MPL-2.0).

This Source Code Form is subject to the terms of the Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed with this file, You can obtain one at http://mozilla.org/MPL/2.0/.

Covered Software is provided under this License on an "as is" basis, without warranty of any kind, either expressed, implied, or statutory, including, without limitation, warranties that the Covered Software is free of defects, merchantable, fit for a particular purpose or non-infringing. The entire risk as to the quality and performance of the Covered Software is with You. Should any Covered Software prove defective in any respect, You (not any Contributor) assume the cost of any necessary servicing, repair, or correction. This disclaimer of warranty constitutes an essential part of this License. No use of any Covered Software is authorized under this License except under this disclaimer.

Compiling the external

XCode

See the xcode project in ide/osx-xcode/. You need to have

  • Cycling'74 Max SDK (> 6.1)
  • Myo SDK (placed in the root directory) Then, change paths in the project setting to include the right frameworks and headers.

Visual Studio

See the Visual Studio project and solution in ide/win-vs/. You need to have:

  • Cycling'74 Max SDK, currently set to 7.3.3 in the project, and placed in the same parent folder as the repository:
──┬── max-sdk-7.3.3
  └── myo-for-max

For a different folder structure, change the macro that indicates the path to the Max SDK support folder, in ide/win-vs/max_extern_common.props, currently set to:

<C74SUPPORT>$(ProjectDir)..\..\..\max-sdk-7.3.3\source\c74support\</C74SUPPORT>

The externals are built in max-package/externals/.