Manual 0.5.x - synfinatic/teensy-dsc GitHub Wiki
If you ordered your TeensyDSC from me, I have already pre-programmed it with your encoder settings so this step shouldn't be necessary.
-
If you have not already done so, install the following software:
- Arduino IDE v1.6.x
- Teensyduino - Teensy addon for the Arduino IDE
-
Using a USB cable, connect your computer to the micro-USB port on the TeensyDSC board. Note that the micro-USB is the smaller USB connector on the board.
-
Start the Arduino IDE software
-
Select: Tools -> Board -> Teensy 3.1
-
Select: Tools -> Port -> Teensy3.1 USB Device Name
-
Select: Tools -> Serial Monitor
-
A new window should pop up and you should see something like:
WiFly Version: 4.00 Initializing CLI's... OK!
If not, make sure your settings are "Carriage Return" and "9600 baud" and restart the serial monitor.
-
Enter the resolution of your encoders by typing the following line:
Z XXXXX YYYYY
Where XXXXX is the RA/Az resolution and YYYYY is the Dec/Alt resolution. Both values should be after any pully system which might alter the native encoder resolution. If your encoder turns backwards due to it's placement (common for the Alt encoder on dobs), specify a negative value.
Once you enter the encoder resolution, the TeensyDSC will respond with:
*
TeensyDSC can be powered one of two ways:
- 12V battery via the 2.1mm barrel connector
- USB connection
Either option works just as well. I recommend one of the following:
- Using your existing 12V battery that you might already have for your dew heater, etc
- A battery pack comprised of 8 NiCad/NiMh rechargable AA batteries
- A rechargable $10 "USB power bank" often used to recharge cell phones that you can find on Amazon.com or Monoprice.com. Important: I recommend using the larger USB-B connector for powering your TeensyDSC instead of the micro-USB port since it is more sturdy and less likely to be damaged in the field. If you damage the micro-USB port, you will not be able to re-program or change the configuration of your TeensyDSC.
Any of the above solutions should be able to power your TeensyDSC and encoders all night, even on cold nights which can sap the power from batteries.
Note: While you can use a 9V battery to power your TeensyDSC for short periods of time, 9V batteries do not have have enough capacity to run TeensyDSC for very long and so are not recommended.
First, turn on your TeensyDSC.
Then, connect your computer, iPad or other tablet to the TeensyDSC WiFi access point. If you don't see the TeensyDSC WiFi access point, ensure the TeensyDSC is powered on and you are not too far away from it. Also keep in mind that the WiFi signal may not be powerful enough to pass through walls.
Then in SkySafari select:
- Scope Type: Basic Encoder System
- IP Address: 10.0.0.1
- TCP Port: 4030
- For "Encoder Steps per Revolution" click "Get Automatically"
- Click "Connect"
If your software does not support the Basic Encoder System, you should try BBox, Sky Wizard CTI or Orion Intelliscope. Please note that not all of these protocols support automatically getting the encoder resolution, so you may need to enter it again in SkySafari, etc.
Test your scope! Ensure the cross hairs move in the correct direction with the scope and it moves at the correct rate. If you see any problems here, fix the encoder resolution stored in the TeensyDSC.
Once tested, perform a two start alignment procedure and enjoy!
TeensyDSC has three different modes:
- DSC mode. This is the default mode and runs as a digital setting circle adapter.
- CONFIG mode. This mode allows you to change the TeensyDSC settings
- WIFI mode. This mode is useful for debugging the RN-XV WiFi adapter and allows you to talk to it directly.
To change modes, type: MODE ModeName <ENTER>
Type: ? <ENTER> You should see something like:
G => get encoder resolution
P => get status
Q => get encoder values
R xxxxx xxxxx => set encoder resolution
V => get TeensyDSC version
Z xxxxx xxxxx => set encoder resolution
? => Help
MODE [WIFI|CONFIG] => change CLI mode
Switch to config mode by typing: MODE CONFIG <ENTER>
OK
Get a list of configuration commands by typing: ? <ENTER>
AP SAVE => Save WiFi access point config
AP SHOW => Shows the WiFi configuration
AP RESET => Reset WiFi to factory defaults
SET SSID <ssid> => Set the WiFi SSID
SET PASS <pass> => Set the WiFi passphrase
SET IP <x.x.x.x> => Set the WiFi IP address
SET MASK <x.x.x.x> => Set the WiFi netmask
SET CHAN <x> => Set the WiFi channel [0-12]
SET PORT <x> => Set the TCP PORT [1-65535]
SET RATE <x> => Set the WiFi rate [0-15]
SET TXP <x> => Set the WiFi TX Power [0-12]
SET AUTH [WPA2|OPEN] => Enable WPA2-PSK or no security
SET MODE [AP|CLIENT] => Enable AP or client mode
SET ALT xxxx => set ALT encoder resolution
SET AZ xxxx => set AZ encoder resolution
GET <OPTION> => Get a config option
GET IPA => Get IP of WiFi AP
GET ALL => Get all saved EEPROM settings
SAVE => Save settings to EEPROM
RESET => Reset all EEPROM settings
? => Help
MODE [DSC|WIFI] => Change CLI mode
- First you should download the following software/libraries:
- Arduino IDE v1.6.x
- Teensyduino - Teensy addon for the Arduino IDE
- TeensyDSC Software
- AnySerial - Serial port abstraction layer for Arduino
- WiFly_Shield - Customized to use AnySerial
- Flash - Easy access to EEPROM flash memory
- MsTimer2 - MsTimer2 with Teensy3.x support
- Install the Arduino IDE software
- Install the Teensyduino addons for the Arduino IDE
- Unzip the AnySerial, WiFly_Shield, Flash and MsTimer2 libraries and move the files to your Arduino IDE library directory (For example, on OS X you'd move them to: /Applications/Arduino.app/Contents/Resources/Java/libraries)
- Unzip teensy-dsc-simple-dsc.zip
- Start the Arduino IDE and open the file: teensy-dsc-simple-dsc/src/teensy_dsc/teensy_dsc.ino
- Use a micro-USB cable to plug the Teensy 3.1 board to your computer
- In the Arduino IDE, from the main menu select:
- Tools -> Board -> Teensy 3.1
- Tools -> CPU Speed ->72Mhz
- Tools -> Serial Port -> Teensy3.1 USB Device Name
- To compile & upload the code, select: File->Upload
- With the Teensy 3.1 board still connected to your computer, select: Tools -> Serial Monitor
- A new window should pop up and you should see something like:
WiFly Version: 4.00
Initializing CLI's... OK!
If not, make sure your settings are "Carriage Return" and "9600 baud" and restart the serial monitor.