HASduck

HASduck is a modern take on Radiodirection finding (RDF) where the hunt is for an interactive intelligent device rather than a simple beacon. We call these devices 'Ducks.' With a RPi Zero W and attached RF Module. you can use the HASduck framework to build and program your own Ducks. Adding sensors you can have your Duck react to the environment and adjust the signal and/or message being beaconed out.

Quick Start

The quickest way to get started with HASduck is to

• Buy the hardware
• Install Raspberry Pi OS Lite on a microSD card using Raspberry Pi Imager
• Log in as Pi
• Clone the repo
• cd into the repo directory and run ./HASduck_install_fresh.sh
• Read the fine manual
• From the OLED select DUCKHUNT then RUN DUCK

Duck Framework

Simple beacons used in radio direction finding transmit a simple message at intervals until they are turned off or a time-out has been reached. The premise here is the person with the beacon wants to be found. Suppose they don't?

The core of the Duck framework is defining a worklfow using five simple commands in order;

• message is the text you want to send

• interval is how many seconds between retransmission of message

• trigger is an event you are waiting for before taking an action. Trigger has two arguements that include type and value. Types envisioned include gps, bluetooth, wifi, and custom. Values can be named signal detection, etc

• action is taken when trigger has been set. Action has one argument that can be next, reset, or quit. Next continues to the next workflow, reset is repeat the workflow, or quit altogether.

• duration is time-out in seconds for the curren workflow.

The framework remains a work in progress.

Files

Root folder

HASduck.py

• Duck app

HASduck_config.py

• Config Duck and save to hasDUCK.json

HASduck.sh

• Script to stop/start/install/remove Duck service

HASduck_instakll_fresh.sh

• Script for fresh install of HASduck

HASduck.service

• Service file for systemd for Duck app run on start

font5x8.bin

• Font file for OLED display

HASrf95.py

• RFM95 Module used by HASvioletRF.py

HASviolet_config.py

• Configure your station. Updates HASviolet.json

HASvioletHID.py

• HID library for OLED and buttons

HASvioletRF.py

• RF library

Config Folder (cfg/)

#hasDUCK.json

• Duck config file

hasVIOLET.json

• RF config file

hvdn-logo.xbm

• OLED graphic