Mosmena Documentation
Mosmena is an Android learning project that demonstrates a simple acoustic pulse-echo workflow on a phone.
What the app does
- It generates a short high-frequency chirp.
- It plays that chirp through the phone speaker.
- It records audio from the phone microphone.
- It looks for the direct speaker-to-microphone coupling peak.
- It looks for the next significant peak, which is interpreted as the nearest reflection.
- It converts the extra delay into a distance estimate.
Who this documentation is for
- Beginners who want a patient explanation of the code
- Android developers who want a testable signal-processing demo
- Reviewers who want to understand the project's quality gates
Documentation map
- Start with Beginner Quickstart if you want the shortest step-by-step path.
- Start with Getting Started if you are new to the repo.
- Read First Measurement Walkthrough for a guided tour.
- Read Acoustic Ranging Explained to understand the algorithm.
- Read Architecture before changing the app structure.
- Read Testing and Quality before opening a pull request.
- Read External Libraries when you need third-party references.
- Open API Docs for generated reference material.