Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore
CONTRIBUTING.md
LICENSE
README.md

README.md

Connect to M2X API using Teensy

The AT&T M2X API provides all the needed operations to connect your Teensy based device to AT&T's M2X service.

You can use the existing Arduino Client Library on a Teensy board. It is fully compatible.

NOTE: The following instructions are tested on either Teensy 2.0 or Teensy++ 2.0 board. If you are using other boards, some steps may vary.

This information is also availabe as a M2X Teensy Tutorial.

Getting Started

  1. Signup for an M2X Account.
  2. Obtain your Master Key from the Master Keys tab of your Account Settings screen.
  3. Create your Device and copy its Device ID.
  4. Review the M2X API Documentation.

Please consult the M2X glossary if you have questions about any M2X specific terms.

How to Run the Ethernet examples

In order to connect using Ethernet, WIZ812 Ethernet Module and Teensy to WIZ812 Ethernet Adaptor Kit are needed in addition to a Teensy board. In order to connect all devices together, soldering work is also required.

  1. Solder the adaptor according to the guide here. Depending on the specification of your Teensy board, you may or may not need to perform additional soldering work.
  2. When the soldering is done, connect the Teensy board, WIZ812 Ethernet Module and the adaptor together as shown in the guide.
  3. Install Arduino on your system.
  4. Install Teensyduino on your system.
  5. Install the M2X Arduino library following the steps here
  6. Since there's a bug in Teensyduino, please download the file in this gist, and use the Print.cpp file to replace the same file in Teensyduino. On a Mac with standard installation, this file is at /Applications/Arduino.app/Contents/Resources/Java/hardware/teensy/cores/teensy/Print.cpp. If you are using other OSes, the specific path may be similar but slightly different. One tip is to start looking in the Arduino application folder.
  7. Then you can open the EthernetUnoPost example, and tweak the Device ID, Stream Name and M2X Key to the valid values.
  8. Select the board to want to run the example on (Teensy or Teensy++), click Upload, follow any instructions on screen, your board should be reporting data to M2X shortly!