manual
← projectThe user manual of the WattWind fan. The fan shows this same page under the ? next to its title (/help).
Quick start
- Plug the fan in. It starts in Auto with the fan off. The first time it opens its own Wi-Fi network WattWind-XXXX (password wattwind).
- Join that network on your phone. The page usually opens by itself; if not, open http://192.168.4.1.
- Set up your fan (the card at the top of the page, once): your own password for the fan's network and a settings PIN, each typed twice. Until then the settings can't be changed; the fan buttons already work. This device remembers the PIN.
- Connect it to your home Wi-Fi: Settings → Wi-Fi and address → Find networks → Use next to yours → password → Test Wi-Fi → Save and switch. Note the address it shows (details: Wi-Fi).
- Open the page on your home network: http://wattwind.local or that address, and put it on your home screen so it opens like an app: iPhone (Safari): Share ⎙ → Add to Home Screen; Android (Chrome): menu ⋮ → Add to home screen.
- Enter your values: Settings → Rider → FTP, HR max and HR rest (Settings).
- Wear the strap and start pedaling. The fan finds your sensors by itself and remembers them (Sensors); the dots turn green. In Auto the fan comes on as you work harder.
The screen
- Big number: the fan level now, 0 (Off) to 3 (High), with its name below.
- Mode (top right of the level): Auto = the fan decides; Manual = you picked a level; Follow = a linked fan copying its leader (Linked fans). In Manual the fan is an ordinary fan: the level stays, even after you stop riding, until you change it or "Manual → auto after" runs out (8 hours unless you change it; 0 = never).
- Line under the level: what happens next, e.g. Waiting for sensors (Auto with no data: the fan starts when you ride), Back to Auto in … or Off in … (Manual), Following wattwind or … not heard (a linked fan), switching to … (a level change in progress).
- W, rpm, bpm: power, cadence and heart rate. – means no data.
- demand: how hard you are working, 0 to about 1 (How Auto decides). Auto picks the level from it. Next to it, what decided: power, heart rate or both. When one sensor is missing, it shows the other one taking over. Demand comes from power and heart rate only; a CORE sensor's heat strain works separately, as a minimum level (below).
- Core (only with a CORE body temperature sensor): your core temperature, skin temperature and CORE's heat strain with its heat zone; orange in zone 3, red in zone 4. → fan at least level 2 / 3: in Auto, the heat strain is high enough to keep the fan at least at that level while you ride (Heat from CORE). Quality poor / fair: CORE's own note that its estimate isn't settled yet (after putting it on, or without heart rate at hard efforts). From its signal: the fan reads the temperature CORE sends out while it isn't connected; heat strain needs the connection.
- Rider: who is selected, shown when there is more than one rider.
- Dots: Sensors, filled green = connected, red ring = not connected or, for heart rate, (not worn); · shared = an app or watch gets the heart rate through the fan (Share heart rate, Sensors); a third dot for a CORE sensor, while one is connected or its signal is heard. On a linked fan: Leader, filled green = its leader is heard.
- Orange line (only when needed): a sensor battery at 15 % or less (CORE's too), heat strain in CORE's zone 4 (7 or more: ease off, cool down, drink), the controller running hot (chip at 70 °C or more), firmware files that don't match (Troubleshooting), a test version (below), or a Safe start (Troubleshooting).
- Set up your fan (a card at the top, only until it is done): your own access point password and settings PIN, at the first start, after a PIN reset or after Erase everything. The settings stay locked until then; the fan buttons work.
- Message with OK: a one-time message, e.g. after the PIN was reset.
- Lost contact: when the page can't reach the fan, a red line says so and the values are greyed out, because they are not live. The network and the fan's address are in Settings → Wi-Fi and address (use the address when wattwind.local doesn't work). After a restart you started (reboot, update, restore) the page reconnects by itself and says when the fan is back.
- Top: next to the logo the fan's name (the name in http://name.local, Settings → Wi-Fi and address), so with several fans you see which one this page controls; ? on the right opens this manual.
How Auto decides
Every second the fan works out two scores and uses the higher one as demand (or only one of them, if the rider's Decide by setting says so: Settings):
- Power: smoothed power ÷ FTP. 200 W with FTP 240 gives 0.83.
- Heart rate: where you are between rest and max. HR 150 with rest 60 and max 180 gives 0.75.
The level changes one step at a time, with a gap between "up" and "down" so the fan doesn't flicker around a threshold (defaults):
| Level | Step up when demand ≥ | Step down when demand < |
|---|---|---|
| 1 | 0.45 | 0.38 |
| 2 | 0.70 | 0.63 |
| 3 | 0.88 | 0.81 |
- Steps up after at least 15 s at the current level, down after at least 60 s (defaults, changeable in Settings).
- You stop pedaling (cadence 0 or under 20 W for 5 s): the fan keeps its level for a while (60 s with Normal response) so you cool down, then drops one level per minute until off. Start pedaling again and it carries on from where it is.
- Power sensor missing: heart rate only. Heart rate missing: power only. Both missing: keeps the level 2 minutes, then one level down per minute.
- Power is smoothed: it rises within seconds when you push, and falls slowly when you ease off, so short recoveries don't switch the fan down.
- Heat from CORE (with a CORE body temperature sensor; on unless switched off for the rider): CORE's heat strain keeps the fan at least at level 2 from 3 (CORE's heat zone 3: "adjust pacing, hydrate and cool") and at level 3 from 7 (zone 4), while you ride, even when your power and heart rate alone would say less. Both values can be changed per rider (Settings). CORE's heat strain normally runs from 0 to 10. It lets go 0.5 lower (below 2.5 and 6.5), so it doesn't flicker. The same step-up times apply, Highest level still caps it, and after the ride the fan winds down and goes off as usual. Higher demand still steps up as before. The Core line on the screen shows it: → fan at least level 2 (or 3).
In training-zone terms
The two scores are the usual training measures, so the step levels can be read in your zones:
- Power score = % of FTP, as in Coggan's power zones: Z1 recovery up to 55 %, Z2 endurance 56–75 %, Z3 tempo 76–90 %, Z4 threshold 91–105 %, Z5 VO2max 106–120 % (sources differ by a percent or two at the edges).
- Heart-rate score = % of heart-rate reserve (where you are between rest and max), the Karvonen method many watches offer as "%HRR" zones: usually 50–60, 60–70, 70–80, 80–90 and 90–100 %. That is not the same as % of maximum heart rate.
| Level | from | Power | Heart rate |
|---|---|---|---|
| 1 | 0.45 | easy spinning, below Z2 | below the 50–60 % zone |
| 2 | 0.70 | upper endurance (Z2) | start of the 70–80 % zone |
| 3 | 0.88 | top of tempo (Z3), sweet spot | upper 80–90 % zone |
Want a level from a certain zone? Set its "step up" to that zone's lower edge, e.g. 0.76 for level 2 from tempo, and keep its "step down" about 0.07 lower (Settings → Rider).
Fan response
Settings → Rider → Fan response (saved per rider) sets how much your power is smoothed before it is used, and how long the fan keeps its level after you stop pedaling. Power jumps around a lot from second to second; smoothing turns it into a steady average that rises faster than it falls:
- Follows a push (table below): how long smoothed power takes to get most of the way to a new, higher power.
- Eases off: the same when power drops. Longer means short recoveries don't switch the fan down.
- Hold after stop: how long the level is kept once you stop pedaling, before it steps down.
| Follows a push | Eases off | Hold after stop | |
|---|---|---|---|
| Calm | ~20 s | ~2 min | 90 s |
| Normal | ~12 s | ~75 s | 60 s |
| Quick | ~6 s | ~40 s | 30 s |
Calm suits long steady rides and intervals with short rests; Quick suits rides where you want the fan to drop soon after an effort. Heart rate smoothing and the minimum times before a step up or down (Settings → Timing) are the same for all three.
Settings
Settings opens in groups: Rider, Timing, Wi-Fi and address, PIN, Sensors, Linked fans, Maintenance (backup, firmware update, detailed recording, restart) and Erase everything. Tap a group to open it. When something needs the settings PIN, the page asks for it once and this device remembers it. Messages for a part of the page you can't see pop up at the top.
- Rider: several people can share the fan.
- Saved per rider: FTP, HR max / rest, Decide by, fan response, the step up / down levels (someone who runs hot can get the fan earlier), Heat from CORE and its levels, the heart-rate strap and the CORE sensor. Everything else is shared.
- Add creates a rider with the default values (then enter theirs); Rename and Delete work on the selected one. The last rider can't be deleted.
- A rider's strap: select the rider, wear the strap, then under Sensors Find sensors and Use for HR, or just wait: a rider without a strap gets the first free one found. A strap belongs to one rider; giving it to another rider moves it.
- Switching by strap: straps only send while worn, so when only another rider's strap is around, the fan switches to that rider within about 20 seconds. A rider chosen in the list stays selected (no switching by strap) until you choose again or the fan restarts.
- Reset to defaults: Reset this rider's values (below the step levels) and Reset these timing settings (below Timing) undo your changes. The rider's name and strap, network settings and the PIN are never reset there.
- FTP: your functional threshold power. Too high → the fan comes on late; too low → early.
- HR max / HR rest: your maximum and resting heart rate. Use measured values: "220 minus age" is off by 10 bpm or more for many people, and that shifts when the fan reacts to your heart rate. HR max: the highest value your watch or training app has recorded in a hard all-out effort (often in its zone settings). HR rest: in the morning, lying down, before getting up. The defaults (190 / 60) suit an average 30-year-old.
- Heat from CORE (only matters with a CORE sensor): the tick box switches the heat rule on or off for this rider (it saves at once; the Core line still shows the values when it's off). Level 2 from heat strain / Level 3 from heat strain: the heat strain from which the fan runs at least at that level while you ride (defaults 3 and 7, CORE's heat zones 3 and 4; 1 to 10, level 2's value below level 3's). Lower values bring the fan earlier, for a rider who runs hot (How Auto decides).
- Decide by: what Auto follows when both sensors are there. Power and heart rate (the default)
takes whichever says you are working harder. If the chosen one is missing, Auto uses the other, so the fan
keeps working.
- Power only, when your heart rate doesn't show your effort well: medication that keeps it low (beta blockers), an optical armband that jumps around, a cold or caffeine that raises it, or the strap is only worn for your training app.
- Heart rate only, when you'd rather the fan follow how your body feels than every power change: on rollers or a basic trainer with estimated power, or in sprint or ERG workouts where power jumps around.
- Fan response: Calm, Normal or Quick (Fan response).
- Thresholds: the table in How Auto decides. Lower numbers = more fan. Each "down" must be below its "up".
- Min. time before step up / down: the 15 s and 60 s in How Auto decides.
- Manual → auto after: return to Auto this many minutes after you pick a level (default 480 = 8 hours, up to 1440 = 24 hours; 0 = never). If you are still riding, Auto carries on from the current level. If nobody is riding, Auto steps the fan down one level a minute until it is off.
- Auto: highest level: the highest level Auto (and the + nudge) may choose, 1 to 3 (default 3). For example 2 for quiet evenings. Levels you pick by hand are not limited.
- Auto: off after no pedaling: fan off after this many minutes without pedaling, or with no sensor data at all (default 15). With a heart-rate strap only, the fan can't see pedaling: Auto follows your heart rate down instead, and the timer starts when the strap disconnects. Manual is not affected, so you can keep the fan on after a ride.
- Wi-Fi and address: at the top, where the fan is connected, the signal (good / fair / weak, and in dBm: weaker than about -75 dBm can drop out) and its address (http://name.local and its IP: bookmark one). Your Wi-Fi: your home network (see Wi-Fi; saving reboots the fan). The fan's own Wi-Fi: the password of its network WattWind-XXXX, used for setting up and when your Wi-Fi isn't there (8+ characters, typed twice, never the default wattwind). The fan's name (hostname): the name in http://name.local; give each fan its own if you have several. The password and the name apply after a reboot.
- Settings PIN (4–16 characters, chosen at the first setup): changing settings, installing firmware, reading the logbook, backups, the detailed recording and Erase everything need it, so nobody else on your network can. Each device (phone, tablet, computer) asks for it once and then remembers it (in the browser, for that address); Forget the PIN on this device clears it, for example on a shared tablet. New settings PIN changes it; it can't be removed. The fan buttons work without it, unless you tick Fan buttons need the PIN too (useful with children in the house, or a shared network). Forgot it? See Forgot the PIN or password.
- Saving: as soon as you change a value, its field gets a coloured edge and a bar at the bottom of the screen says Unsaved changes, with Save (writes what changed) and Undo (shows the saved values again). A change counts only once it is saved: until then the fan keeps the old value. A value the fan can't take is marked red, with what to change. Choosing another rider or sensor, or leaving the page, asks first. Decide by and Fan response are saved as soon as you pick.
- Backup: Download settings saves the settings as a file (riders with their FTP, heart rate, levels and straps, timing, sensors, Wi-Fi name, linked fans). Restore from a file puts them back, on this fan or another one (after swapping the Pico, or to set up a second fan alike); the fan checks every value and restarts. Passwords, the PIN and the linked-fans keys are only in the file if you tick Include passwords and keys: then keep the file private.
- Firmware update: get the update file (wattwind-update-….tar, from the project's releases: github.com/wattwind/wattwind) onto your phone or computer, pick it here and press Install (settings PIN). First the fan checks the file's signature: it installs only updates from the maker of the firmware it runs (the signature doesn't match: see Troubleshooting). Then it turns off while the files come in (about a minute), checks every file, and only then restarts with the new version; your settings stay. If anything goes wrong on the way (the connection drops, a file arrives damaged, the file is not a WattWind update), nothing changes and the fan carries on with its old version. The page warns when the file is an older version. MicroPython itself is not updated this way (that needs USB, rarely needed). Test versions (e.g. 1.0.1-test.2): sometimes made to try a fix for a problem you reported. The page says Test version while one runs; when the fix works, install the official version (1.0.1 here) the same way. It counts as newer, so the page doesn't warn.
- Check for updates (above Choose update file): your phone or computer asks the project's GitHub page whether there is a newer version, and if so links to it (what's new, and the update file). The fan itself doesn't go online for it, and nothing is installed by itself. It needs internet on the phone: on the fan's own Wi-Fi it can't check. To hear about new versions without checking, open the project on GitHub (github.com/wattwind/wattwind) and choose Watch → Custom → Releases (needs a free GitHub account): GitHub then emails you when one comes out.
- Line at the bottom: firmware version and the boards it is made for, how long the fan has been running, why it last restarted, the firmware file check (files: ok, see below), the Wi-Fi signal (weaker than about -75 dBm can drop out), the Pico chip's temperature, the sensors' battery level if they report it (read when a sensor connects, then every 10 minutes), (test version) for a test build and detailed recording on while one runs. Useful when asking for help. The chip temperature is not the room or box temperature: the chip warms itself (processor and radio), so it reads about 10-15 °C above the air, and its sensor is only roughly accurate. It is there to spot the box getting hot, not to read the room.
- Logbook (link at the end of that line): the fan writes a line at every start (with the reason) and a status line (mode, level, Wi-Fi, chip temperature, free memory, sensors): every 5 minutes while something changes, every 30 minutes when nothing does. The logbook is two files: when the current one is full, the older one is deleted and a new one starts, so it always holds about 4½ to 9 days of a busy fan, weeks of an idle one. Logbook shows the current file, Older the one before, Download both (see below). It needs the settings PIN (each device asks once). Events: Wi-Fi joins and drops with their timing, sensors connecting and dropping, an app or watch connecting to Share heart rate, program errors, buttons pressed on the page, settings saved (names only, not values), every fan level change with its reason (for example fan 1 -> 2 (auto: demand 0.72 >= 0.7 (power)), stopped pedaling, manual), why the fan turned itself off (idle off, off timer, back to Auto), firmware updates, and security events (wrong PINs, pairing, unpairing, refused requests), kept across restarts. Times are UTC once the fan got the time from the internet. So you can see whether the fan restarted overnight, and why, from your phone. Download (in the logbook) saves a diagnostics file: the logbook plus status, settings (without passwords, PIN or keys), free space, memory and Wi-Fi state. Send it when you ask for help, but privately: it contains your network name and your sensors' addresses.
- Detailed recording (Settings → Maintenance), for finding a problem: for 24 h the fan records every second what it gets (power, cadence, heart rate; with a CORE: core and skin temperature, heat strain and quality) and what it does (level, mode), every minute its memory, Wi-Fi signal and how promptly it runs, and events such as sensor data gaps over 2 s, in a file of its own (the normal logbook keeps its history). Start recording, ride until the problem shows, then Download recording and send it with your report. It also continues after a restart (often the problem itself). It stops by itself after 24 h; the file stays for download and is deleted 7 days later, at the next Start, with Delete recording or Erase everything. When full it drops its oldest part, keeping the latest 5-6 hours of riding. A firmware update that needs the space deletes it, and so does installing an older firmware that doesn't have this feature. It holds your heart rate: share it only with someone you trust.
- Erase everything: before giving the fan away, or to start again. Deletes all settings, riders, sensors, the Wi-Fi network, the PIN, the linked-fans keys, paired apps and watches, the logbook and a detailed recording (settings PIN). The fan restarts as new: its own access point WattWind-XXXX with the password wattwind, the page says Everything was erased and shows the setup card. The firmware stays. To keep your settings, download a backup first (above): Restore from a file puts them back afterwards.
Sensors
- The fan uses one heart rate sensor and one power sensor (a smart trainer or power meter), both at once, and, if you have one, a CORE body temperature sensor as a third.
- With none chosen, it takes the first one it finds and remembers it, so it won't later pick up another rider's sensor.
- Find sensors lists what is nearby; Use picks one. Forget disconnects the current one and takes the first one found again. Each sensor shows its signal in dBm (also when connected, if the fan hears it): weaker than about -90 dBm (weak) can drop out: move the fan closer, or wear the sensor on the side facing it (your body blocks the signal). The lines above the button show the chosen sensors: name, address, connected or not, and the signal the last time the fan heard it (in Find sensors, or while looking for it after a drop; "5 min ago" when not just now).
- Wake the sensor first: wear the strap (moisten it), start pedaling on the trainer.
- CORE (greenTEG's body temperature sensor; release 1.1): the fan connects to it like to a strap, saves it for the selected rider, and shows your core temperature and heat strain (The screen), which Auto can use (How Auto decides, Heat from CORE). Find sensors lists it as CORE: Use as CORE. CORE is more accurate with your heart rate: if it reports that it gets none, the fan sends it the strap's, once a second; if CORE already gets heart rate from your strap (set up in the CORE app), the fan leaves it alone. While CORE isn't connected, the fan still reads the temperature CORE sends out (from its signal; no heat strain then). No pairing needed. Your watch or bike computer can stay connected to CORE at the same time.
- Strap taken off: some straps keep sending their last value for a minute or two. The fan notices within a few seconds if the strap reports skin contact or beat-to-beat times (most chest straps do) and shows (not worn); Auto then goes by power. The fan remembers which straps send beat-to-beat times, so this also works when it reconnects to a strap lying off, after a restart. A reading under 30 bpm (a strap held in the hand can send 0) counts as no reading. Sensors that report neither (some optical armbands), and a new strap at its very first connection, count as missing when they stop sending or disconnect.
- Some sensors accept only one or two connections. If the fan can't connect, close other apps that use the sensor, or free a connection in the trainer app. Most straps and trainers also speak ANT+: connect the training app over ANT+ and the Bluetooth connection stays free for the fan.
- Share heart rate (off until you tick it): for a strap that allows only one connection. The fan passes the strap's heart rate on as a Bluetooth heart-rate sensor of its own, named WattWind-XXXX HR: in your app or watch, add a heart-rate sensor and choose that name instead of the strap. It sends exactly what the strap sends (heart rate and beat-to-beat times), and nothing while the strap is off or missing. One app or watch at a time. The line below the tick box says whether it is waiting or connected, and the status shows · shared next to the strap's name. Not on a follower (it has Bluetooth off). It works with apps and bike computers that connect without pairing (tried: MyWhoosh, Wahoo ELEMNT Bolt and Roam), and with those that pair, such as a Garmin Edge (tried: Edge 1040): it pairs once, without a code, and then reconnects by itself, also after the fan restarts or loses power. Pairing needs the MicroPython file of release 1.1 or later on the fan; the line below the tick box says if this fan has it. With an older file a Garmin says pairing failed: install the new file once over USB (build guide), or let the Garmin take the strap over ANT+. The older file also allows only 3 Bluetooth connections (the new one: up to 4 sensors plus 1 app or watch): with a strap, a trainer and a CORE sensor they are all in use, and the line below the tick box says that no app or watch can connect (also before you tick it). The tick box stays on: sharing starts once the new file is installed. Erase everything forgets the paired devices; a Garmin then pairs again by itself the next time it connects.
Linked fans
- Other WattWinds can follow this one, as many as you like: only this fan (the leader) talks to your sensors, the others get the values over Wi-Fi. That leaves the sensors' Bluetooth connections free for your training app.
- Pairing, once: on the leader, Settings → Linked fans → Pair a new fan (open for 60 s). On the other fan, press Follow next to the leader in the same list. It restarts and follows from then on.
- Same level: the follower runs at the leader's level, whatever the leader does (Auto, the buttons, the off timer), so the leader's page works as one remote for all of them. One / two lower makes it a gentler side fan that joins in with harder efforts: one lower is off while the leader is at 1, two lower runs only when the leader is at 3. One higher suits a weaker or farther fan (when the leader is off, it is off too). Own settings: it takes the leader's heart rate and power (and a CORE's heat strain) and decides with its own Auto settings, for example a fan that only starts at harder efforts.
- On the follower, Settings → Linked fans: Follow (same level / own settings) and Level apply at once, no restart.
- The follower's own buttons still work; its Follow button (where Auto is) hands it back to the leader. Its screen shows the leader's heart rate and power, and a Leader dot.
- If the leader goes quiet (unplugged, Wi-Fi gone), the follower holds its level for a minute, then steps down one level a minute until off.
- Both fans must be on the same home network. Guest networks, or routers with "client isolation", block it.
- Stop following (on the follower) switches it back to its own sensors; it restarts.
- Followers only listen and send nothing, so the leader doesn't list them; each follower shows on its own page whether it hears the leader. The list on the leader shows other leaders, for following one.
- Unpair all followers (on the leader) gives it a new key: every fan following it stops, holds its level for a minute, then turns off, and its page says so. To link one again: Pair a new fan on the leader, then Pair again on the follower (no restart).
- The messages are encrypted and signed with the key that pairing hands over: other devices on your home network can't read the heart rate, power or fan level, and can't fake them. Only the fan's name is readable, so an unpaired fan can list the leaders nearby.
- Update linked fans together. Most updates don't change how fans talk to each other, but when one does (the release notes say so), a fan on older firmware can't read the leader and acts as if it were switched off.
Wi-Fi
- First setup: join WattWind-XXXX; the page usually opens by itself (a "sign in to network" message on most phones). If not, open http://192.168.4.1. (Some other plain http:// addresses lead there too, but not https:// ones, and not on phones that use their own "private DNS": 192.168.4.1 always works.) An iPhone shows the sign-in sheet only until you choose "Use without Internet"; after that, open Safari yourself. Fill in the Set up your fan card first (see Quick start). Then Settings → Wi-Fi network: tap Find networks and Use next to yours (or type its name), enter the password and tap Test Wi-Fi. The fan joins it while its own network stays on and shows the address your router gave it: note it, then tap Save and switch. A wrong password or a network out of range is reported right away, and nothing is saved.
- Home network: open http://wattwind.local (works on iPhone, Mac, Windows and most
laptops; Android often not). Otherwise use the fan's IP address, given by your router. To find it:
- your router's app or admin page lists connected devices: look for wattwind;
- open http://wattwind.local on a PC or laptop (they resolve .local): the address is shown in Settings → Wi-Fi and address;
- a network scanner app on the phone (e.g. Fing) lists it too;
- with USB connected, the fan prints it at start-up (wifi: connected … IP …).
- Fan's own network: if no home network is saved or found at start-up, the fan starts the network WattWind-XXXX with the password you chose at the first setup (wattwind before it). Join it and open http://192.168.4.1.
- Router goes away (or starts slower than the fan after a power cut): the fan keeps trying for 2 minutes, then starts its own network so the page stays reachable. It tries the home network again after 2 minutes (a router that has just been switched on is usually back by then), then every 5 minutes, and switches back by itself (not while the page is open over its own network).
- Which networks: the fan uses 2.4 GHz Wi-Fi with WPA2 (or WPA2/WPA3 mixed). 5 GHz-only and WPA3-only networks don't work; most routers have a 2.4 GHz network or a setting for it.
- Change network later (from the home network): Settings → Wi-Fi and address → Save Wi-Fi and reboot. The fan reboots and joins it; if it can't, it starts its own network so you can fix the settings.
- The fan keeps working without Wi-Fi; the page is only for watching and control.
Shortcuts and home automation
The fan buttons are simple web requests, so a phone shortcut, a voice assistant or Home Assistant can press them too. Use the fan's address: http://wattwind.local works on iPhone; on Android and in Home Assistant use its IP address (Settings → Wi-Fi and address).
- iPhone (Shortcuts app): new shortcut → action Get Contents of URL → URL http://wattwind.local/api/mode → Method POST, Request Body JSON, fields mode = manual (Text) and level = 3 (Number). Name it "Fan high": Siri runs it by name, and it can go on the home screen. For Auto use mode = auto; add nudge = 1 for "a bit more fan".
- Android: the free app HTTP Shortcuts: new shortcut, method POST, URL http://<IP>/api/mode, body type custom text, content type application/json, body {"mode":"manual","level":3}. Add it to the home screen as a button.
- Home Assistant: the fan as a sensor and buttons in a dashboard. The ready-made configuration is in the build guide on the project site (The fan's API).
- If Fan buttons need the PIN too is on, add "pin": "1234" (your PIN) to the request.
- Reserve the fan's IP in your router (see Wi-Fi) so the shortcuts keep working.
Troubleshooting
- Page doesn't load: use the IP address instead of .local; check which network your phone is on; reboot the fan (Settings → Maintenance → Restart, or power off and on).
- 192.168.4.1 doesn't open on Android: Android sees that WattWind-XXXX has no internet and quietly uses mobile data instead. Tap Stay connected / Use this network when it asks, or turn mobile data off while you set up.
- Several fans in one home: give each its own hostname (Settings → Wi-Fi and address → The fan's name, e.g. wattwind2, wattwind3), or they all answer at wattwind.local.
- Fan stays off in Auto: check the dots and the demand value. Demand below the level 1 threshold means no fan yet: check FTP and HR settings.
- Fan switched off by itself: in Auto, the "off after no pedaling" time (15 min unless changed). In Manual, the Off in… timer, or "Manual → auto after" (8 hours unless changed) handed it back to Auto, which turns the fan off when nobody is riding. The logbook says which.
- Fan changes level often: choose Calm, or widen the gap between "up" and "down" thresholds.
- Sensor not found: see Sensors above; a sensor already connected to the fan usually stops advertising, so it may not appear in Find sensors (it shows as connected).
- A linked fan doesn't follow, or the leader isn't in its list: both must be on the same home network (not a guest network; no "client isolation" in the router). A fan that follows another can't be a leader itself. Pairing: press Pair a new fan on the leader first, then Follow within 60 s.
- "not addressed to this fan": the page was opened by a name the fan doesn't know as its own. It answers only to its hostname (wattwind, wattwind.local, or with the router's usual local ending such as .lan, .home or .fritz.box) and to its IP address. This protects it from websites that try to reach devices in your home through your browser. Open it as http://wattwind.local or by its IP.
- "too many wrong PINs": after two wrong PINs, each further try has to wait (1, 2, 4 … up to 60 seconds) so a PIN can't be guessed quickly. Wait the time shown, then enter the right PIN.
- "first set your own access point password and a PIN": the fan's first setup isn't done yet (a new fan, after a PIN reset or Erase everything). Fill in the Set up your fan card at the top of the page.
- "the signature doesn't match" (Firmware update): the file isn't from the maker of the firmware your fan runs, for example a modified or foreign firmware. Nothing changed. Use the official release file; firmware from someone else can only be installed over USB (see the build guide).
- Reboot: Settings → Maintenance → Restart turns the fan off and restarts it (about 30 s).
- "The settings file was damaged" (a message on the page): the fan couldn't read its settings (rare, for example after a flash fault) and started with default settings, so it asks for the first setup again. A copy of the damaged file stays on the fan (config.json.bad). Restore a backup if you have one (Settings → Maintenance → Restore from a file); otherwise enter the settings again.
- The fan runs although the page says Off, or a level doesn't change the speed: unplug the fan. A relay contact has probably failed (welded shut, it happens with age). One failed relay alone can't keep the fan running when it is off, the board is built that way, but it needs repair before further use: replace the relays.
- "The controller is running hot": the chip is at 70 °C or more (rated to 85 °C), so the air in the box is around 55 °C. Give the box air: don't cover it, keep it out of the sun and away from heaters.
- Restarts by itself: the line at the bottom of Settings shows why it last restarted (after a firmware update from the page it says firmware updated to …; after copying files by USB, end of update mode). "Watchdog" means the program stopped responding and was restarted with the fan off; if that repeats, note the firmware version and report it.
- "Safe start" (an orange line and a message): the fan restarted three times in a row after an error, so it started with default ride settings to stay reachable. Network, Wi-Fi, PIN and sensors are kept, and your saved settings are untouched, but they can't be changed until the next normal start. Install the latest firmware (Settings → Maintenance), or Restart to try your settings again; the logbook shows what failed (worth reporting). If the fan couldn't start with its saved settings at all, the message says so, and it starts the same safe way.
- "Some saved settings were not valid": at every start the fan checks each saved setting the way the page checks a new one. One that fails (saved by an older version, or damaged) goes back to its default, and the message names it: check it in Settings.
- "Firmware files differ from their list": when it starts, the fan checks every firmware file against the list that comes with the firmware (manifest.json). A file is changed or missing, usually from an upload that stopped halfway or a file left from another version. The fan still runs, but install the release's update file again (Settings → Maintenance → Firmware update), or copy the whole firmware folder again by USB. (For people who change the firmware: run tools/make_manifest.py before copying, and the check says ok again.) files: not checked means there is no list on the fan.
Forgot the PIN or password
- New router or home network: no PC needed. The fan doesn't find the old network, so about 20 s after plugging it in it starts its own network WattWind-XXXX. Join it and set up Wi-Fi as in Wi-Fi (First setup).
- Forgot the access point password, but the fan is still on your home network: open the page and set a new one in Settings.
- Forgot the settings PIN: settings, Wi-Fi, Restart, firmware update, the logbook, backups, the detailed recording and Erase everything are locked (and the fan buttons, if you chose that).
Reset the PIN and the access point password (no tools needed):
- Plug the fan into the wall socket, wait 2–3 seconds, unplug it.
- Do that 3 times in a row.
- Then plug it in a fourth time and leave it plugged in: this fourth power-up does the reset. After about a minute, open the page: it says PIN and access point password were reset. Tap OK (the message also goes away when you use the fan buttons or save settings).
Now the page shows the Set up your fan card again: choose a new access point password and PIN. Until you do, the fan's own network uses the password wattwind, and the settings can't be changed. Everything else stays: home Wi-Fi, FTP, heart rate, thresholds, timeouts, sensors and hostname. If the home network is gone, the fan starts WattWind-XXXX with the password wattwind. If the page doesn't show the message, unplug for a few seconds and start again: each short plug-in must be under 10 seconds.
Know the PIN and just want a clean start? Settings → Erase everything. Last resort without the PIN: someone with a computer can delete config.json on the fan over USB (with mpremote), which resets all settings.
Your data
Everything stays on the fan. It has no cloud, no account and no app, and sends nothing to the maker or anyone else; the only thing it asks the internet is the time (below). Check for updates is your phone asking GitHub, only when you press it.
- Stored on the fan: the settings (riders' names, FTP and heart-rate range, the sensors' Bluetooth addresses, the Wi-Fi network and password, the PIN, the linked-fans key), the pairing keys of apps and watches that paired with Share heart rate, and the logbook (events and a status line, without heart rate or power values). Heart rate, power, cadence and a CORE sensor's body and skin temperature and heat strain are only kept in memory while you ride, unless you start a Detailed recording (Maintenance): then they are kept, second by second, for up to 24 h, and the file is deleted 7 days later at the latest.
- Leaves the fan: the page you open, over your home network (plain HTTP, inside your Wi-Fi's encryption); on a leader of linked fans, one packet a second on the home network with its level, heart rate, power, cadence and, with a CORE, body temperature and heat strain (encrypted, readable only by its paired fans); with a CORE that gets no heart rate of its own, your heart rate to the CORE; with Share heart rate on, your heart rate over Bluetooth to the app or watch connected to it (below); and a time query to the internet (NTP), for the logbook's clock. Not from the fan: Check for updates (Maintenance) is a question from your phone or computer to GitHub, only when you press it, so GitHub sees your internet address, as with any website.
- Sensors: heart-rate straps send their values unencrypted over Bluetooth (that is how the standard works, for every receiver); the fan only listens to the ones it has saved. With Share heart rate on, the fan sends your heart rate the same way, like a strap: any app or watch nearby can connect to it, one at a time. One that pairs (a Garmin Edge) gets it encrypted.
- Delete it: Settings → Erase everything (above). The page confirms it after the restart.
Safety
- The controller switches mains voltage. Keep the enclosure closed and the cables in their strain reliefs; unplug it before opening.
- In Auto the fan can start by itself when the sensors report riding (a linked fan when its leader does). Unplug the fan before cleaning it, moving it or reaching into it.
- The fan keeps its own earth wire to its metal parts: don't disconnect it when wiring the controller.
- Only one speed is ever switched on, and the fan is off whenever the controller starts or restarts.
- If the software stops responding, a watchdog restarts it within seconds, with the fan off.