vulpes/README.md

60 lines
2.4 KiB
Markdown
Raw Normal View History

2023-09-25 22:06:49 -05:00
# Vulpes
2023-11-02 08:26:04 -05:00
An ESP32-based radio orienteering controller. This repo is for
the code. There will be another repo for the schematic and PCB
design.
2023-09-25 22:06:49 -05:00
2023-11-02 08:24:55 -05:00
## What
Radio orienteering, or amateur radio direction finding (ARDF) is a
sport where people run around and look for hidden transmitters. One
necessary component is a controller on each transmitter that tells
it when and what to transmit.
This is my attempt at a simple, easy-to-use controller with a low
parts count. Rather than programming a microcontroller and/or
using DIP switches, time delays, and sync cables, the ESP32 development
2023-11-02 17:51:41 -05:00
board lets you set up each controller using a web browser (e.g., on your
smartphone or tablet).
2023-11-02 08:24:55 -05:00
2023-11-02 17:51:41 -05:00
The [ARRL ARDF page](https://www.arrl.org/amateur-radio-direction-finding)
is an OK starting point for learning about radio orienteering, but
there are probably better ones.
2023-11-02 08:24:55 -05:00
## Hardware
I designed a simple custom printed circuit board (PCB) to make
assumbling this controller easy to do. The repo for schematic and
board design is here: [link to new repo].
Because the ESP32 doesn't track time when it is powered off, and
I wanted to avoid specific delays (e.g., push a button two hours
before an event starts), an additional real-time clock (RTC) is
included. The RTC runs on a watch battery to track time when the
controller is not powered on.
## Software/Firmware
2023-11-02 17:51:41 -05:00
Power on the controller by plugging in a micro-USB cable to a 5V
source (e.g., computer or battery pack). After the device is powered on,
it will start an internal webserver and set up a wireless network called
"vulpes."
Connect to the "vulpes" wireless network and use a web browser to navigate
to `http://192.168.0.1` (note "http" not "http**s**"). You will see the
settings below. Note that you will not be able to access the Internet while
connected to this network, and each controller sets up a separate network.
2023-11-02 08:24:55 -05:00
### General Settings
### Cycle Settings
### Network Settings
#### Access Point
2023-09-25 22:06:49 -05:00
When using as a wireless access point, the network SSID is "vulpes"
2023-11-02 08:24:55 -05:00
with no password. Navigate to http://192.168.0.1 to access webform.
## License
GNU GPLv3. See `LICENSE` file for details, and
https://choosealicense.com/licenses/ if you're like me and don't
understand all of this stuff.
## Acknowledgments
Special thanks to [Mark Fickett](http://www.markfickett.com/) for his
[arduinomorse](https://github.com/markfickett/arduinomorse) library.