====== MSeven M17 — Getting Started Guide ====== //Ham Radio · Digital Voice · iOS// **This content was produced for KJ7T by ClaudeAI on March 20, 2026, edits by KJ7T on March 21, 2026** **Amateur License Required** · Developer: Gregg Wonderly · Protocol: M17 Open Source ---- ===== Intro: What Is This App? ===== **MSeven M17** is an iOS app that turns your iPhone or iPad into a digital voice radio, connecting you to the M17 reflector network over the internet — no physical radio hardware required. M17 is a fully open-source digital voice and data protocol for amateur radio, using the **Codec 2** voice encoder. Think of it like D-STAR or DMR, but community-built with no proprietary licensing. Reflectors are internet servers that link users together, similar to how IRLP or AllStar works. ⚠ **License Required:** You must hold a valid Amateur Radio license to transmit. You can listen (monitor) without transmitting, but you must identify with your callsign to use PTT. ---- ===== Step 1: Install the App ===== - **Find it on the App Store** — Search for //"MSeven M17"// on the Apple App Store, or search for developer name //"Gregg Wonderly"//. The app icon features the M17 logo. - **Download & Install** — Tap //Get// and authenticate with Face ID, Touch ID, or your Apple ID password. The app is free to download. - **Grant Microphone Permission** — When prompted, tap //Allow// to grant microphone access. This is required for transmitting. Without it you can still receive audio. ---- ===== Step 2: Initial Configuration ===== Before connecting to any reflector, you need to configure your callsign and basic settings. Look for a **Settings** or gear icon in the app. ^ Setting ^ What to Enter ^ | Callsign | Your full FCC callsign in UPPERCASE (e.g., **W7XYZ**). This is your identity on the network — no registration needed, your callsign is your ID. | | CAN (Channel Access Number) | Leave at **0** unless the reflector specifies otherwise. CAN 0 is the standard default. | | Audio Input | Select your iPhone's built-in microphone, headset, or AirPods. The app includes built-in audio processing for clarity. | | Audio Output | Speaker, headphones, or Bluetooth. CarPlay is also supported for in-vehicle use. | ✓ **Tip:** The app supports spectrum equalization for both transmitted and received audio — you may want to experiment with audio settings if you find the received audio sounds thin or boomy. ---- ===== Step 3: Connecting to a Reflector ===== M17 reflectors are named with a prefix of **M17-** followed by up to 3 characters, and each reflector has lettered **modules** (A through Z) that act like separate rooms or channels. - **Add a Reflector** — Tap the /+/ button or "Add Reflector" option. You'll enter a reflector name and module letter. - **Enter the Reflector Address** — Type the reflector name (e.g., **M17-M17**) and select a module (e.g., **C**). The app will look up the server address automatically using the M17 reflector directory. - **Save It** — Save the reflector to your list. You can save multiple reflectors and switch between them — including with the CarPlay prev/next track controls. - **Tap Connect** — Tap your saved reflector and then //Connect//. The app will link to the reflector over your internet connection (Wi-Fi or cellular). ==== Good Starter Reflectors ==== ^ Reflector ^ Description ^ | M17-M17 / C | Main M17 community reflector. Friday nets at 17:00 UTC. Great for newcomers. | | M17-USA / A | US-focused general activity reflector. | | M17-CAN / A | Canadian activity reflector. | | M17-WW / A | Worldwide general linking reflector. | | M17-KCW / A | America's Kansas City Wide Network. | ✓ **Find more:** A full list of M17 reflectors worldwide is at **m17project.org** and the M17 Foundation Wiki. ---- ===== Step 4: Transmitting (PTT) ===== - **Press and Hold PTT** — The large PTT (Push-To-Talk) button puts you in transmit mode. Hold it while speaking, just like a radio. - **Identify Yourself** — It is polite to say your callsign at the start of each transmission. Example: //"W7XYZ monitoring"// or //"W7XYZ, good morning"//. - The actual [[https://www.law.cornell.edu/cfr/text/47/97.119|FCC rule (97.119)]] says you must identify at the //end// of each communication and at least //every 10 minutes// during a communication. Identification must be given using your FCC-assigned call sign. - You are not required to identify at the start of a transmission, but many hams do ID at the start out of habit or courtesy — it's good practice and helps others know who they're talking to. - I like what I've heard on British nets where some stations say their call sign is returning, e.g., for me, I would say "KJ7T returning" at the start of my transmission. - **Release PTT to Receive** — Release the button to switch back to receive mode. The app shows you the callsign of whoever is currently transmitting. - **Watch for [DOUBLE]** — If you see a **[DOUBLE]** indicator, it means two stations transmitted simultaneously. The app will automatically un-key your PTT after 3 seconds to prevent a stuck transmit situation. ⚠ **Doubling:** If [DOUBLE] appears frequently on a busy reflector, wait for a pause before keying up — same courtesy as on a repeater. ---- ===== Step 5: Key Features to Know ===== ^ Feature ^ How It Works ^ | Station Map | The app displays a map showing the geographic location of active stations on the reflector. Tap a pin to see their callsign and details. | | Active Callsign Display | The currently transmitting station's callsign is prominently shown on screen in real time. | | Transient Station List | A scrollable log of recent stations that have transmitted on the connected reflector — useful for seeing who's been active. | | Contact Logging | Log contacts with comments directly in the app. Add notes to remember conversations — handy for mobile operation. | | Mute Button | Mutes received audio without disconnecting from the reflector. Useful in meetings or noisy environments. | | CarPlay Support | Full CarPlay integration. Use your car's screen to connect, monitor, and PTT. Step through saved reflectors with prev/next track buttons; play/pause selects and connects. | ---- ===== FAQ: Common Questions ===== ==== Do I need a hotspot or radio hardware? ==== No. MSeven M17 connects directly to M17 reflectors over your phone's internet connection. No MMDVM hotspot, Raspberry Pi, or physical radio is needed. Your iPhone //is// the transceiver. ==== Can I use it on cellular data? ==== Yes. The app works on both Wi-Fi and cellular (LTE/5G). Audio quality may vary on weak cellular signals, but it generally works well on any reasonable connection. ==== What's the audio quality like compared to FT8/FT4? ==== M17 is primarily a voice mode, not a data-exchange mode like FT8. It uses Codec 2 at 3200 bps — think of it as similar quality to DMR or D-STAR, quite intelligible and clear on a good connection, with the app's built-in equalization helping further. ==== Can I monitor without transmitting? ==== Yes. Connect to a reflector and simply don't press PTT. You can listen all you like. No license is required just to receive. ==== The app shows a CRC error or "checking CRC" message. What do I do? ==== Newer versions of the app include a fix for CRC calculation issues that caused error messages on certain hotspots. Make sure you are running the latest version from the App Store. ==== How do I find active M17 nets and schedules? ==== The main M17 community net runs on **M17-M17 module C** every Friday at 17:00 UTC — a great place to test your setup and meet other M17 operators. Check m17project.org and the M17 Foundation Discord for more net listings. ==== Can I use Bluetooth headsets or AirPods? ==== Yes. The app supports Bluetooth audio output. AirPods and other Bluetooth headsets should work through standard iOS audio routing. For CarPlay, the car's microphone and speakers are used. ---- //MSeven M17 — Getting Started Guide//\\ //Developer: Gregg Wonderly · Available on the Apple App Store// M17 Project: [[https://m17project.org|m17project.org]] · M17 Foundation Wiki: [[https://wiki.m17foundation.org|wiki.m17foundation.org]] //**This is not official documentation. Always comply with FCC regulations and identify with your callsign when transmitting.**//