ogecko / alpaca-benro-polaris

Open up the Benro Polaris Tripod Head with an HTTP-based REST API allowing applications to leverage the platform.
https://www.kickstarter.com/projects/jdmorriso/alpaca-benro-polaris-driver?ref=9a035f
MIT License
12 stars 0 forks source link
ascom-alpaca astrophotography rest-api synscan tripod

Home | Hardware Guide | Installation Guide | Using Stellarium | Using Nina | Troubleshooting | FAQ

Introduction

Overview

Are you interested in trying your hand at amateur astrophotography? Invest in a Benro Polaris with its Astro Kit, and this project will transform it from a great Tripod Head to a full-featured, open Telescope Mount. This project aims to provide users with a way to control their Benro Polaris using more advanced astrophotography software, including Stellarium, Nina, and other applications that support the ASCOM Alpaca platform.

Intended Audience

The project documentation and features target individuals familiar with astrophotography concepts and software like deep sky astronomy, image sequencing, plate solving, polar alignment, equatorial coordinates, and image stacking. The first release is intended for users comfortable with technical setups involving MacOS or Windows, mini-PCs, Command Windows, and Networks, as these are presented as options for running the Alpaca-Benro-Polaris Driver.

Project Purpose

The Benro Polaris tripod head is a great product. It's manufactured to a high standard, comes in a compact and sturdy design, and its mobile App has many easy-to-use features. Although its not cheap, it is cheaper than a modern telescope mount like the ZWO AM3 Harmonic Equatorial Mount. The Polaris can also be used for other photography projects beyond astro-photography.

That said, the mobile App and firmware updates appear to have slowed down. Many of the promised features from the original Kickstarter Project haven't materialised. We are still waiting for 3 Point Alignment, a larger catalogue of deep sky objects, linking with planetarium software, improved sequencing of image capture, plate solving and framing. The product has more potential if only we could enable it.

That is what this project is all about. The intention is to open up the Benro Polaris with an HTTP-based REST API that will allow other applications to leverage this great platform.

The Alpaca Benro Polaris (ABP) supports a standard ASCOM device interface called ITelescopeV3 interface to control the Benro Polaris tripod head. This standard interface supports applications like Stellarium Desktop (a free open-source planetarium application) and Nina (Nighttime Imaging 'N' Astronomy - An astrophotography imaging suite).

The ABP also supports a subset of the SynSCAN protocol over the network. This allows the Driver to support mobile applications like Stellarium Mobile PLUS or Sky Safari 7 Plus and Pro.

The priorities of this open-source project reflect feedback from the Polaris Camera Controller Global Group. This group provided great suggestions and encouragement for this project, with over 120 supporting it in just 2 days. I've summarised the feedback comments below with features getting the most requests listed as high-priority. The open-source project meets ALL feasible requests. There are still some challenges to the 3-point alignment; although we have some ideas!

Overview

Documentation Overview

The Alpaca Benro Polaris has documentation to help you prepare your hardware, install software and use the features in Stellarium and Nina. Since the ABP is an ASCOM standard driver, many other applications can make use of it. Let us know what you've found that works.

Release Notes

The Release Notes is a reference document that outlines new features, compatible software, bug fixes, known issues and untested features of the Alpaca Benro Polaris Driver. The new features are organised by application to help document what new capabilities are enabled by using the driver with a given application.

Hardware Guide

The Hardware Guide(s) outlines the recommended hardware platforms for running the Alpaca Benro Polaris Driver, ranging from basic laptop setups to more advanced mini-PC configurations for controlling all astronomy equipment. It offers step-by-step guidance on setting up a "NinaAir" mini-PC, ensuring users can establish a robust and dedicated astrophotography control center.

Installation Guide

The Installation Guide provides step-by-step instructions for installing and running the Alpaca Benro Polaris Driver on Windows 11 or MacOS, including setting up prerequisite software like Python and configuring Stellarium for initial use. It walks users through each step of the installation process, ensuring they can successfully install the driver and connect to their Benro Polaris.

Using Stellarium

The Using Stellarium Guide focuses on using Stellarium with the Benro Polaris, explaining how to establish a connection, control the mount, and leverage Stellarium's features. It outlines the compatibility of different Stellarium versions and protocols, guiding users on connecting their setup and navigating Stellarium's interface for effective telescope control.

The University of Western Australia has A Guide To Using Stellarium for a more complete reference.

Using Nina

The Using Nina Guide explains how to use Nina with the Benro Polaris for capturing, focusing, and aligning astrophotography images. It delves into essential features of Nina, such as equipment setup, target finding, image sequencing, and autofocus techniques, empowering users to optimize their astrophotography workflow.

For more detailed reference material refer to the thorough Nina online documentation or Nina PDF Manual for the standard documentation. You can find some very informative, long form videos on Nina at the following youtube channels.

Troubleshooting and FAQ

We have included a comprehensive Troubleshooting Guide which provides solutions for common issues encountered while setting up and using the Alpaca Benro Polaris Driver. It offers practical advice on starting the Benro Polaris device, establishing a network connection, and troubleshooting plate-solving issues with Nina and ASTAP.

A list of Frequently Asked Questions addresses common questions about the Alpaca standard, the Benro Polaris's capabilities, and the use of Nina and Stellarium for astrophotography. It clarifies misconceptions about Alpaca and provides realistic expectations for using the Benro Polaris for deep-sky photography, emphasizing the importance of proper equipment and settings.

Beta Test Results

The Beta Test Results provides an analysis and summary of the beta test results and feedback for the Alpaca Benro Polaris Driver, highlighting its strengths and areas for improvement. Additionally, it outlines the guidelines followed during the beta testing phase and lists the individuals involved along with their testing environments and experiences.

Recognition

I'd like to thank the following people who helped make this project a reality:

Technical Expertise

Beta Testers

The Beta Testers' perseverance and feedback helped improve the documentation and final quality of the software. I greatly appreciate their encouragement and the testing they performed.

Kickstarter Backers

I want to thank all the 117 Kickstarter Project Backers, especially those who pledged Game-Changing and That's-Awesome amounts. I will keep the Kickstarter project open to continue funding ongoing support and making enhancements to this project. PS. Let me know if you want to be anonymous.

GAME CHANGER Thats Awesome Thats Awesome Thats Awesome
Mack Cameron Adrian Squirrell Ed Mike Drinkwater
Mark Bahu Alan Smallbone Fernando Ribeiro Moshe Salama
Peter Alessio Zanotti Fernando Villaverde Gaviña Nagendra Narayan
Richard Swaim Alex Murdoch Humayun Qureshi Patryk Lesiecki
Simone Chiari Alvin Christie Ian Cannan Paul Moulton
William Siers Amy Kemp Ian Morgan Paul Olsavsky
Andreas Bichler Ilya Chernikov Paul Rickwood
Andrew Roberts James White Peps Choufme
Baha Baydar John Phil Dando
Bikram Ghosh Jonathan Shribman Pudeldestodes
Bill Lazar Juan Manuel López Fernández Richard Healey
Blair Dunlop Juan Martinez Rob Bristow
Boyce Fitzgerald Kaingc Roger Good
Brad Anderson Kym Wallis Sandra Coffey
Cameron Palmer Ladislav Svoboda Santanu Majumder
Carlo Mascellani Mahmudur Rahman Simon Modera
Charles T. Simet Mangoe Steve Renter
Dan Suskin Mark Penberthy Steven
David Proudfoot Max Izod Stlwarehouse
Donald Dunbar Michael C

User Group Feedback

Organisations and Services

And finaly, just a brief note about risks....

Caution - Use at own Risk

Please be aware that this is not official Benro Software. If you decide to use it - you are doing so at your own risk.

There is a chance of voiding the warranty or damaging your Benro Polaris hardware. There is a chance that you may use the driver/hardware in a way, unintended by its design. The driver is not official Benro software. They may not support you. Due to the extensive testing, the risk of hardware damage is very low.

Also note that the ASCOM Alpaca standard is not secure. It is open by design. Simply stated, Alpaca and network security are separate things. Only use within an isolated protected virtual or local network.

Finally, it's important to note that while the Alpaca Benro Polaris Driver unlocks significant potential from the Benro Polaris, it cannot entirely overcome the device's inherent hardware limitations. Users aiming for extended exposures, particularly with longer focal lengths, might still encounter tracking errors despite the driver's enhancements. Therefore, managing your expectations regarding the Polaris's capabilities, especially for deep-sky astrophotography, is crucial.