Lanternfish User's Manual

Lanternfish

User’s manual

Download PDF

1.Lanternfish modes

To make our lives a bit easier when we go over how to set up the Lanternfish and how to use it to achieve different results, we’ll quickly cover the different modes available beforehand. Don’t worry if you don’t know how to access them yet—we’ll cover this in the next sections.

Quick Mode

When you enter Quick Mode, the Lanternfish will show a “wait” message, and shortly thereafter the current sky quality on its OLED screen (i.e. take a single reading). It will turn off after a bit. The readings taken in Quick Mode can be logged or not—this is configurable from the web interface.

Periodic Mode

Periodic Mode takes periodic readings for as long as you want it to. This mode is fully configurable from the web interface, such that you can decide how frequently readings are collected, and what makes the device turn off (when the sky gets to a certain brightness, after a certain amount of time, or never at all!).

All these readings are logged, and accessible from the web interface.

Configuration Mode

The Configuration Mode is part of the Lanternfish’s web interface, and can be accessed via its Access Point or a Wi-Fi network. From it, you can access all the settings and information about your unit.

Remote Mode

The Lanternfish’s Remote Mode is a combination of all the other ones. It’s accessible, like the Configuration Mode, from the Lanternfish’s Access Point as well as a Wi-Fi network, and includes all the features from the other modes combined, plus the option to access all the data and plot graphs.

We’ll break it down later, but for now, know that from the remote mode you can take instant readings (these are logged automatically), you can start and stop periodic recording, you can download the CSVs of the data and see summaries of them, you can plot and download graphs, and you can access all the settings and information that you can also access from the Configuration Mode.

2.Setting up for the first time

Configuring the Lanternfish

The Lanternfish can be accessed via its own Access Point, or via a Wi-Fi network. The first part of the process is the same for both of these scenarios.

  1. Press the button to wake your Lanternfish up. If you leave it, it will show you a reading and turn off after a bit (by default, the mode on boot is Quick Mode, this can be configured). If you press the button again, you will access the menu (do that).
  2. Cycle to CONFIG and select it (short presses navigate through menu options, a long press selects).
  3. The screen will then show a QR code. If you have a device to scan it with, go right ahead. Otherwise, press the button again, and you’ll see the name of the Lanternfish’s Access Point (it will be Lanternfish_X, where X is the unit’s serial number). Connect to it (no password is required).
  4. Once in, the OLED screen will show a success message and the IP address to navigate to. It’ll be 192.168.4.1. Just open a browser and navigate to http://192.168.4.1 (you might not even need the http://, but if you’re struggling, add it as browsers tend to try to force https instead). You’ll be greeted by a page like the one on the right.

This is your configuration page. The settings available here are also accessible from the Remote Mode (more on that later). Depending on whether or not you actually want to access the data stored in the Lanternfish or just care about the readings in the moment you’re taking them, this page might be enough. Take a look at the different available settings, they should be clear, and a lot of them include an information symbol in case you’re not sure what they do.

Just a note: the Sky Quality reference value is the calibration value and is unique to each unit, if you choose to change this for whatever reason, you can find the factory calibration value by setting 0 as the value. For information about how Lanternfish are calibrated, check this article.

Remember to press Apply at the bottom when you modify anything. A popup will show up on the bottom-right corner with feedback about whether or not the settings have been applied successfully (occasionally an error message will be shown after applying network settings, even if they have been applied successfully, because the changes will have been applied and connection thereby lost).

Once you’ve modified any settings you deem appropriate, you’re all set up for hand-held operation! But keep reading if that’s not all you want.

Accessing your data

Chances are you’ll want to see the data you collect. This can be achieved from the Remote Mode. If you’ve enabled Wi-Fi STA and put in your Wi-Fi settings, once you access Remote Mode, simply navigate to the IP address on the screen from a device connected to that same network, and you will find yourself facing the Lanternfish’s homescreen.

If not using the Wi-Fi network, just connect to the Lanternfish’s Access Point and access 192.168.4.1 like before—you’ll see the homescreen, instead of the configuration page.

Here you can see the graph for the most recent dataset, and you can scroll through the datasets and plot any graph you like. If you click on the graph, you’ll be redirected to a page where you can see it in fullscreen. You can scroll to zoom in and out, and hover over points to see their value.

There’s buttons—both here and in the homepage—to download the graph as a PNG and to toggle/untoggle the temperature readings.

Note

The temperature value refers to the temperature of the Lanternfish, which is related to but isn’t the ambient temperature.

Head back to the homepage now. Let’s place our focus for a second in the Control Panel, the box with the light blue background.

Here you can see the current sky quality (along with when this value is from), the device’s battery, and options to read once and start periodic recording. You can also turn the device off from here (you’ll need to turn it on by hand).

The readings taken by pressing read once or start recording will be logged by default. The “Start recording” option starts logging readings following the same settings configured for periodic recordings (except the stop triggers, to stop recording, press the stop button).

Speaking of the stop triggers—you can enable those to apply in Remote Mode as well. That is, you can make the device turn off automatically when the same MPSAS value is reached or the same on-time is reached.

Most of the settings are either self-explanatory or carry with them a handy information sign you can press for clarification.

The interface varies slightly from device to device. If you’re planning on using this page often from your phone or tablet, why not pin it to the homescreen so it’s as accessible as an app? When working through your network, this’ll work extra-well if the IP address is always the same. You can disable DHCP and set up a fixed IP address from the settings. If using the Access Point, you just need to be connected to it when pressing on the icon.

The way to pin it varies between devices and browsers, but it’ll be something like:

Share or settings

Add to Home Screen

Voilà!

3.Tips and notes

There’s not much more to mention in this manual. Once you understand how to turn the Lanternfish on (pressing the button), access the menu (press it again), cycle through the modes (pressing), select a mode (hold the button down for a bit), and turn it off (hold the button down for a bit from any of the modes—you’ll see the Lanternfish logo as the device is shutting down); and you’re familiar with the web interface, this device is as straightforward as it gets.

There’s a few things worth pointing out, though:

Regardless of its limitations, though, the Lanternfish doesn’t need a network connection to reliably collect and store data. Even if, for some reason, you can’t access the data at any point, it’ll be safely stored in your unit and you’ll be able to retrieve it whenever you can access its web interface.

4.Version history

All versions released as firmware updates, owners of a Lanternfish can always update from the Remote or Configuration menus.

1.0.0. Initial Lanternfish release

1.0.1. Minor changes and bug fixes:

2.0.0 Upcoming

5.Other information

Technical specifications

Maintenance

Clean the sensor window with a soft cloth. Do not use solvents. Store in a dry place.

Safety instructions

Device safety:

Battery safety:

This product must not be disposed of with household waste. Dispose of it through appropriate electronic waste collection channels.

Didn’t find what you were looking for? Check out the Lanternfish’s printed manual, it’ll have arrived in its box, but you can see it online too. If you still need assistance, reach out to us on the forum or to support@lunaticoastro.com.