Astroberry Server/es

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 asistemte 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.

                 |----> Mount with GPS ---------------------------> INDI mount driver ---->|
                 |                                                                         |
Satellites ----> |----> Smart Phone with GPS ---------------------> INDI GPS NMEA -------->|----> KStars 
                 |                                                                         |
                 |----> GPS Device ------>|                  |----> INDI GPSD ------------>|
                                          |-> GPSD service ->|
/etc/location.conf ----> Virtual GPS ---->|                  |----> Astroberry GPS Panel
                                                             |
                                                             |----> Astroberry Astro Panel

Configuring network connections

TBC

Maintenance and Upgrade

Upgrading the system

Astroberry comes with online software repository. If you installed your system from downloaded image file, it is already configured for you. Using software repository you can install and update your system without need to manually download updates. Just make sure that Astroberry is connected to a network with access to the Internet and integrated software management system will download and install all updates for you.

Astroberry is Rasbian based Linux system, which uses APT software management system. You can update the system by using aptitude or Software Updater.

If you prefer to use terminal just run sudo apt update && sudo apt upgrade && sudo apt dist-upgrade

Major system upgrades are also released as a new image file. This is only for minimizing amount of updates you would have to apply between major system upgrades. There is no other need to reflash microSD card with new system image. If you decide to reflash your microSD card, make sure to backup your data first. All your data on microSD card will be overwritten during reflashing microSD card. If you update the system from software repository all your data and files are preserved.

Installing alien software

Astroberry is based on Rasbian Buster operating system. This means that it is a Linux operating system compatible with Debian 10 (Buster). Debian packages are distributed as .deb files available in numerous software repositories. Astroberry comes with it's own software repository (KStars, INDI, PHD2 etc) and additionally uses official Raspbian repository for core operating system functionalities. All of these are packages for specific version of operating system i.e. Rasbian Buster.

Using packages from other Linux distributions e.g. Ubuntu is technically possible, but sometimes requires advanced configuration changes. There is no guarantee that alien packages will work properly on Astroberry. It is common error that users add Nightly Builds repository for Ubuntu to Astroberry. It can work for some packages, sometimes. In majority of cases this can be very problematic and make your system unstable. You should not do it, unless you really know what you're doing.

The safest way to bring alien software to your system is to build it from sources. This way all dependencies and requirements are ensured at compilation time.

How-to

Flashing microSD card

After downloading Astroberry Server image you need to unzip it first. Use your preferred software to do it or run this command in your terminal:

unzip astroberry-server_2.0.1.img.zip

You can flash your microSD card with unzipped file using etcher.io or running below commands in your terminal:

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

Note that copying downloaded file to a microSD card will not work. You need to flash your microSD card with unzipped file.

FAQ

How can I update the system?

You can upgrade all system components using regular system upgrade using apt, apt-get, aptitude or Software Updater.

The image is too large for my microSD card

If the image appears to be too big shrink it according to this example

How to connect to my wireless home network?

Wireless connection is predefined for you. Just edit it and change network name and password.

• Right-click wireless icon on the taskbar
• Select Edit connections
• Double-click Wireless connection
• Enter your network name in SSID field
• Go to Wi-Fi Security tab
• Enter your network password in Password field
• Reboot

I cannot login to astroberry HotSpot

Note that default keyboard layout used in the image is QUERTY. If you use other keyboard layout the password you type in might be different than you think e.g. for French keyboard it may become astroberrz (instead astroberry). Change your keyboard layout using raspi-config or gui_rc to aligh system configuration and your keyboard.

How can I change my regional settings or add support for my language?

The easiest way is to run raspi-config (console) and rc_gui (graphical UI). The latter is accessible in Menu / Preferences / Raspberry Pi Configuration

Screen resolution does not match my display. How can I fix it?

If your display cannot handle FullHD resolution (1920x1080) you need to either connect via web browser and set Local in sliding menu Settings / Scaling OR you need to change the system resolution by running raspi-config in terminal or Raspberry Pi Configuration from Prefferences menu.

What is the source of location data in GPS Panel and Astro Panel?

The panels use GPS readings for your location. If you don't have GPS the panel uses virtualgps provided with Astroberry Server. You can set your static location by editing /etc/location.conf file or using Preferences/Geographic Location menu. After the change reboot or restart virtual GPS by running: 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