View source for Getting started with hardware

You want to build an Objects in Space controller? Great! Here's how to get started.

__TOC__

== Configuring the game ==

The hardware interface is not enabled by default. To turn it on, add the following to your [[Configuration file]] (ref: [http://forum.objectsgame.com:88/t/objects-in-space-beta-technical-notes/809 Objects in Space Beta Technical Notes])

<pre>hardware=true</pre>

Windows users may also want to add this option to prevent the game from scanning the hardware COM1 and COM2 ports:

<pre>ignorecom12=true</pre>

== Arduinos ==

Getting started with Arduino is way too big a topic to cover here. The [https://www.arduino.cc/en/Guide/HomePage Arduino Getting Started Guide] and [https://www.arduino.cc/en/Tutorial/HomePage Arduino Tutorial index] are a good jumping-off point. It's recommended, at bare minimum, to familiarise yourself with, and understand how the BlinkWithoutDelay and Debounce example sketches work, and be able to write new sketches that use these techniques. They're very important for driving basic I/O with Objects in Space.

== The serial protocol ==

The [[ExternalProtocol|External Protocol]] documentation includes a description of the serial protocol itself, as well as lists of the commands that are possible and data that can be requested from the game.

== Arduino libraries ==

A number of projects are underway to encapsulate the serial protocol and make writing code to work with the game easier. See [[Arduino Librarys|Arduino Libraries]].

[[Category:HardwareInterfacing]]