Astroberry Server

Astroberry Server es un sistema para Raspberry Pi para controlar equipamiento astronómico.

Corre en una computadora simple y se ejecuta sobre el sistema operativo Linux. Astroberry permite controlar remotamente su telescopio, enfocador, cámara y otros dispositivos utilizados en astronomía. Puede controlar su equipamiento ubicado en su jardín o a cientos de kilómetros de distancia. El sistema puede ser accedido mediante un escritorio remoto, a través de un explorador de internet o un cliente VNC o puede actuar como un server INDI, accesible por clientes INDI como KStars, Skycharts / Cartes du Ciel o Stellarium. Astroberry Server está basado en software de código abierto, desarrollado y mejorado por astrofanáticos alrededor del mundo.

El sitio del proyecto de Astroberry Server está en www.astroberry.io

Características

• Soporte para Raspberry Pi 3 y 4, Pi Zero y... probablemente cualquier otra versión de Raspberry Pi liberada hasta el momento
• Raspbian Buster Desktop oficial por Raspberry Pi Foundation
• Repositorio APT para Raspbian Buster (si, ahora todos los usuarios de Raspbian Buster pueden instalar Astroberry Server con 'apt install')
• Interfaz Web incluyendo Panel GPS y Panel Astro (almanaque celestial para su ubicación)
• Hotspot Inalámbrico Astroberry permite el acceso al sistema en forma directa, esto es sin necesidad de una red inalámbrica externa por ej. en el campo
• Escritorio remoto accesible sobre VNC en astroberry.local:5900 o vía web browser en http://astroberry.local/desktop
• Framework INDI con todos los drivers de dispositivos disponibles
• Software planetario KStars y Ekos con todos los drivers de dispositivos disponibles además de drivers astroberry personalizados
• Programas planetarios SkyChart / Cartes du Ciel (sólo en la imagen prearmada)
• Programa planetario Hallo Northern SKY (sólo en la imagen prearmada)
• Software de captura CCDciel (sólo en la imagen prearmada)
• Astrometry para solución en campo (archivos índice no provistos, deben ser descargados por separado)
• ASTAP, the Astrometric STAcking Program (sólo en la imagen prearmada)
• PHD2 para autoguiado
• Gnome Predict para seguimiento de satélites
• oaCapture para toma de imágenes planetarias
• FireCapture para toma de imágenes planetarias
• SER Player para ver los streams de video capturados (sólo en la imagen prearmada)
• Drivers DIY Astroberry para enfocador y placa de relay
• Drivers Astroberry PiFace para enfocador y placa relay
• Astroberry Motor HAT para enfocador basado en Adafruit Motor HAT
• GPS Virtual para usuarios que no tengan un dispositivo GPS
• Servidor de archivos compartidos permitiendo acceso por red a las imágenes capturadas
• Soporte para raspi-config (consola) y rc_gui (IU gráfica) para configuración simple de las opciones de Raspberry Pi

Requerimientos de Sistema

• Raspberry Pi 4 (recomendada) o Raspberry Pi 3 (mínimo)
• Tarjeta microSD de 32GB (recommendada) o 16BG (mínimo)

Inicio Rápido

Verificación de Imagen

Puede verificar el archivo descargado con cualquier programa de checksum para su sistema o ejecutando los siguientes comandos en su terminal:

sha256sum astroberry-server_2.0.1.img.zip

Asegúrese que la salida del comando es 098d986f9e31f209e2bf58321977d3d7232d63d2b5981dce5f23036c6ef0d141.

De no ser así, el archivo está corrupto y debe ser descargado nuevamente. Si lo descarga de nuevo y el checksum continúa incorrecto, por favor háganoslo saber.

Instalación

La instalación básica del sistema requiere flashear su tarjeta microSD una tarjeta con el archivo de imagen del sistema. No es lo mismo copiar el archivo a la tarjeta microSD. Si sólo copia el archivo descargado a su microSD, no va a funcionar.

Puedes flashear tu microSD (se necesita un mínimo de 16GB) utilizando etcher.io o ejecutando los siguientes comandos en su terminal:

unzip astroberry-server_2.0.1.img.zip
sudo dd if=astroberry-server_2.0.1.img of=/dev/sdX bs=8M status=progress

Nota: Reemplace sdX con el identificador de su tarjeta microSD. Asegúrese que es correcto antes de ejecutar el comando!

El proceso lleva algún tiempo, sea paciente. Si cancela el proceso de flasheo, su sistema no funcionará.

Primer Inicio

Luego del primer inicio, busque por el hotspot inalámbrico 'astroberry' y conecte su PC a él utilizando 'astroberry' como clave. Ingrese con su web browser a https://astroberry.local o https://10.42.0.1 para acceder a Astroberry Server. Para acceso a Internet, conecte su Astroberry a su red inalámbrica wifi. Haga clik con el botón derecho en el ícono de barras Wi-Fi y edite Wireless connection ingresando el SSID de su red wifi y su clave. Estando conectado a Internet, puede actualizar su sistema ejecutando los siguientes comandos en su terminal: sudo apt update && sudo apt upgrade && sudo apt dist-upgrade

Instalación

Instalación simple

Vea la sección #Inicio Rápido

Instalación Avanzada

Puede instalar los paquetes de Astroberry Server sobre un sistema Raspbian Buster con escritorio oficial. Esto no se recomienda para principiantes. No provee todas las características de Astroberry Server disponibles en la imagen prearmada y ud debe configurar su sistema por su cuenta, lo que requiere un conocimiento avanzado del sistema Linux. Consume mucho tiempo pero mantienes el control completo sobre el proceso.

Descarga la imagen oficial de Raspbian Buster con escritorio y flashea tu tarjeta microSD con ella. Conecta un teclado, mouse y monitor HDMI a tu Raspberry Pi, configura tu sistema con el asistente oficial de primer inicio y ejecuta los siguientes comandos en tu terminal:

wget -O - https://www.astroberry.io/repo/key | sudo apt-key add -
sudo su -c "echo 'deb https://www.astroberry.io/repo/ buster main' > /etc/apt/sources.list.d/astroberry.list"
sudo apt update
sudo apt upgrade

En este punto, puedes elegir instalar todos los paquetes de Astroberry d una vez ejecutando sudo apt install astroberry-server-full o puedes instalar sólo paquetes seleccionados.

Paquetes instalados por astroberry-server-full incluyen:

• astroberry-server-wui
• astroberry-server-sysmod
• indi-full
• libindi-dev
• kstars-bleeding
• astrometry.net
• gsc
• phd2
• phdlogview
• oacapture
• ser-player
• gpredict
• indi-astroberry-amh
• indi-astroberry-diy
• indi-astroberry-piface
• virtualgps
• gwenview
• indiwebmanagerapp

Configuración

Ajustando la fecha y hora

Raspberry Pi no tiene un reloj de tiempo real (RTC), que recuerda la fecha y hora entre reinicios. Como resultado, no las conoce apenas inicia. Para superar esta limitación, sincroniza la fecha y hora de Internet. Esto obviamente sólo funciona si tiene un acceso a Internet. Si no lo tiene su sistema pensará que es el 1 de Enero de 1970.

Hay algunas formas de asegurar que su sistema tenga la fecha y hora correctas.

Conexión a Internet

Conecte su Raspberry Pi a una red que tenga acceso a Internet por ej. la red de su casa o su smartphone, utilizando la función de hotspot y el sistema hará el resto por uds. Si no puede tener siempre conectada su Raspberry Pi a una red con acceso a Internet, necesita utilizar otras opciones.

Módulo RTC

Consiga un módulo de reloj de tiempo real (RTC) y conéctelo a GPIO. Recordará la fecha y hora entre reinicios. Adicionalmente, si conecta su Raspberry Pi a una red con acceso a Internet, su fecha y hora se sincronizarán para minimizar cualquier diferencia.

Módulo GPS

Consiga un módulo y conéctelo a su Raspberry Pi. Puede utilizar una conexión USB (plug-and-play) o un dispositivo serial conectado a GPIO. El módulo GPS sincronizará su fecha y hora con los satélites GPS. Tenga en cuenta que los satélites proveen la fecha en UTC y no conocen el huso horario suyo. Si ud configura su huso horario correctamente en el sistema, será utilizado para ajustar la hora recibida de los satélites. Utilizar un módulo GPS le da prestaciones adicionales como fijar su ubicación, lo que es requerido por varias aplicaciones de astronomía.

Configuración manual

Ud puede fijar su fecha y hora en forma manual luego de cada inicio. No es la forma mas conveniente de mantenerlos precisos pero es bueno saber como hacerlo de todos modos. Para fijar la fecha al 19 de Mayo de 2020 y la hora a 11:14:00 ejecute en su terminal: sudo date -s "2020-05-19 11:14:00"

Configurando su ubicación geográfica

Configurar su ubicación geográfica es muy importante al utilizar Astroberry. Muchas aplicaciones utilizan esa ubicación para proveerle de posiciones precisas de estrellas y planetas. Asegúrese de configurar su ubicación antes de ejecutar esas aplicaciones.

Dispositivo GPS

Para proveer información de ubicación general, Astroberry utiliza el servicio GPSD. Toma los datos de un dispositivo GPS y los provee a todo el sistema operativo y aplicaciones que necesiten esta información. Si utiliza un dispositivo GPS, todo el sistema y las aplicaciones podrán obtener ubicación geográfica precisa de él. Al utilizar un dispositivo GPS, asegúrese que GPS Virtual esté detenido y deshabilitado, ejecutando systemctl stop virtualgps && systemctl disable virtualgps. De otra forma, el servicio GPSD utilizará la ubicación de dos fuentes distintas, GPS y GPS Virtual.

GPS Virtual

Si no posee un dispositivo GPS, Astroberry provee GPS Virtual, que utiliza una ubicación estática configurada en el archivo /etc/location.conf.

Puede fijar su ubicación ejecutando Preferences/Geographic Location del menú del sistema o ejecutando sudo nano /etc/location.conf en la consola.

Luego de fijar su ubicación en el archivo necesita asegurarse que el servicio de GPS Virtual está ejecutándose.

• Ejecute sudo systemctl status virtualgps para validar status
• Ejecute sudo systemctl enable virtualgps para habilitar el servicio
• Ejecute sudo systemctl disable virtualgps para deshabilitar el servicio
• Ejecute sudo systemctl start virtualgps para iniciar el servicio
• Ejecute sudo systemctl stop virtualgps para detener el servicio
• Ejecute sudo systemctl restart virtualgps para reiniciar el servicio

Como obtienen los datos de ubicación las aplicaciones

Por defecto, las aplicaciones utilizan los datos de ubicación generales del servicio GPSD. Pero puede haber otras opciones, que deben ser tenidas en cuenta.

• Kstars puede utilizar los datos generales de ubicación del servicio GPSD o los puede leer de uno de los drivers GPS, por ejemplo INDI GPSD o INDI GPS NMEA
• El Panel GPS de Astroberry utiliza los datos del servicio GPSD
• El Panel Astro de Astroberry Astro Panel utiliza los datos del servicio GPSD

Arquitectura de ubicación geográfica

La arquitectura del sistema de ubicación geográfica es bastante compleja.

                 |----> Montura con GPS -------------------------> Driver de montura INDI ---->|
                 |                                                                             |
Satélites -----> |----> Smart Phone con GPS ---------------------> INDI GPS NMEA ------------->|----> KStars 
                 |                                                                             |
                 |----> Dispositivo GPS ------>|                   |----> INDI GPSD ---------->|     
                                               |-> Servicio GPSD ->|
/etc/location.conf ----> GPS Virtual --------->|                   |----> Panel GPS Astroberry
                                                                   |
                                                                   |----> Panel Astro Astroberry

Configurando las conexiones de red

TBC

Mantenimiento y Actualización

Actualizando el sistema

Astroberry posee un repositorio de software online. Si ha instalado su sistema de un archivo de imagen descargado, ya está configurado por ud. Utilizando el repositorio de software, puede instalar y actualizar su sistema sin la necesidad de descargar actualizaciones manualmente. Sólo asegúrese que Astroberry esté conectado a una red con acceso a Internet y el sistema integrado de manejo de software descargará e instalará las actualizaciones por ud.

Astroberry es un sistema Linux basado en Rasbian, que utiliza el sistema de manejo de archivos APT. Ud puede actualizar el sistema utilizando aptitude o Software Updater.

Si prefiere utilizar un terminal, ejecute sudo apt update && sudo apt upgrade && sudo apt dist-upgrade

Actualizaciones grandes también se publican como un nuevo archivo de imagen. Esto es sólo para minimizar la cantidad de actualizaciones que ud deba aplicar entre actualizaciones grandes del sistema. No hay necesidad de reflashear su tarjeta microSD con una nueva imagen. Si ud decide reflashear su tarjeta microSD, asegúrese de hacer un backup de sus datos primero. Todos los datos en su tarjeta microSD será sobre-escrito durante el reflasheo. Si ud actualiza el sistema del repositorio de software, todos sus datos y archivos serán preservados.

Instalando software externo

Astroberry se basa en el sistema operativo Rasbian Buster. Esto significa que es un sistema operativo Linux compatible con Debian 10 (Buster). Los paquetes Debian son distribuidos como archivos .deb disponibles en numerosos repositorios de software. Astroberry tiene su propio repositorio de software (KStars, INDI, PHD2 etc) y utiliza adicionalmente el repositorio oficial Raspbian para las funcionalidades del sistema operativo. Todos estos paquetes son versiones específicas de sistema operativo por ej. Rasbian Buster.

Utilizar paquetes de otras distribuciones Linux por ej. Ubuntu es técnicamente posible, pero algunas veces necesita de cambios de configuración avanzados. No hay garantías que software extraño trabajen bien en Astroberry. Es un error común que usuarios agreguen Nightly Builds repository for Ubuntu a Astroberry. Puede funcionar para algunos paquetes, algunas veces. En la mayoría de los casos esto puede ser muy problemático y dejar su sistema inestable. Ud no debería hacerlo, salvo que realmente sepa lo que está haciendo.

La forma mas segura de traer software extraño a su sistema es hacerlo desde su código fuente. De esta forma, todas sus dependencias y requerimientos se aseguran al momento de la compilación.

How-to

Flashear una tarjeta microSD

Después de descargar la imagen de Astroberry Server, ud necesitará descomprimirla primero. utilice su software preferido para hacerlo o ejecute este comendo en su terminal:

unzip astroberry-server_2.0.1.img.zip

Ud puede flashear su tarjeta microSD card con el archivo descomprimido utilizando etcher.io o ejecutando los siguientes comandos en su terminal:

sudo dd if=astroberry-server_2.0.1.img of=/dev/sdX bs=8M status=progress

Tenga en cuenta que copiar el archivo descargado a la tarjeta microSD no funcionará. Ud necesita flashear su tarjeta microSD con un archivo descomprimido.

FAQ

¿Como puedo actualizar el sistema?

Ud puede actualizar todos los componentes del sistema ejecutando regularmente actualizaciones utilizando apt, apt-get, aptitude o Software Updater.

La imagen es demasiado grande para mi tarjeta microSD

Si la imagen parece ser muy grande, achíquela siguiendo este ejemplo

¿Cómo conectar a mi red inalámbrica?

Hay una conexión inalámbrica predefinida por ud. Sólo edítela y cambie el nombre de la red y la clave.

• Click con botón derecho en el icono wifi en la barra de tareas
• Seleccione Editar Conexiones
• Doble click en conexión inalámbrica
• Ingrese el nombre de su red en el campo SSID
• Vaya a la pestaña Seguridad Wi-Fi
• Ingrese la clave de su red en el campo Password
• Reinicie

No puedo conectarme al HotSpot astroberry

Tenga en cuenta que la distribución por defecto del teclado en la imagen es QUERTY. Si utiliza otra distribución de teclado, la clave que ingresa puede ser diferente de la que cree estar escribiendo. Por ej. en un teclado Francés puede cambiar a astroberrz (en lugar de la correcta, astroberry). Cambie la distribución de su teclado utilizando raspi-config o gui_rc para configurar la distribución correcta.

¿Cómo puedo cambiar las configuraciones regionales o agregar soporte para mi lenguaje?

La forma más simple es ejecutar raspi-config (consola) y rc_gui (IU gráfica). La última se puede acceder en Menú / Preferencias / Configuración Raspberry Pi

La resolución de pantalla no es la de mi monitor. ¿Cómo lo soluciono?

Si su monitor no puede manejar una resolución FullHD (1920x1080), necesitará o conectarse vía web browser y configurar Local en el menú deslizante Configuraciones / Escalar O necesita cambiar la resolución del sistema ejecutando raspi-config en un terminal o Configuración en el menú Preferencias Raspberry Pi.

¿Cuál es la fuente de datos de ubicación en el Panel GPS Panel y Panel Astro?

Los paneles utilizan lecturas de GPS para su ubicación. Si no tiene GPS, el panel utiliza virtualgps provisto con Astroberry Server. Ud puede fijar una ubicación estática editando el archivo /etc/location.conf o utilizando el menú Preferencias/Ubicación Geográfica. Luego del cambio, reinice Raspberry o el servicio GPS Virtual ejecutando: sudo systemctl restart virtualgps.service

¿Cómo puedo conectarme a la cuenta de usuario pi defecto?

La cuenta de usuario Pi está deshabilitada por razones de seguridad. La puede reactivar en cualquier momento ejecutando: sudo passwd -u pi

Ayuda y Soporte

Astroberry Server es un software gratis y de código abierto. No posee soporte comercial. Mucha información sobre cómo se lo utiliza puede ser encontrada en esta documentación y en Fórum INDI. También asegúrese de revisar los problemas abiertos en GitHub

Reporte un Bug

Presente sus problemas en GitHub