Table of Contents
- This page has moved
- CAUTION
- Getting the firmware
- Choosing the right firmware version for your Model
- Wuhan/Hankou/Chongqing...what hardware version do i have?
- Installing the firmware
- About Languages and fonts
- Known Firmware Versions (Mi Band 3 without NFC)
- 0.0.0 series (Alpha, not recommened to try)
- 1.0.1 series (Probably beta, not recommended to flash, device name is still "Wuhan")
- >1.1.0 series
- Known Firmware Versions (Mi Band 3 with NFC)
This page has moved
⚠ The wiki has been replaced by the new website - this page has been moved: https://gadgetbridge.org/internals/specifics/mi-band-3/
NOTE
Our policy in the known firmware lists is to list every firmware only once, and name the first stable Mi Fit version where it can be found (version scheme A.B.C not A.B.C.D). If the a firmware can only be found in beta versions, then name the fist beta version where it can be found.
CAUTION
This feature has the potential to brick your Mi Band 3. You are doing this at your own risk.
It seems that the Mi Band 3 (non-NFC) Firmware 2.2.0.14 is a transition firmware that should be flashed before going to a newer firmware!!
Getting the firmware
Since we may not distribute the firmware, you have to do a little work. You need to find and download a Mi Fit APK file. There is an APK Mirror Web site that might help you find Mi Fit. Extract the downloaded .apk file with "unzip", and you will find an assets/
directory containing *.fw
files, among others.
Choosing the right firmware version for your Model
Device Name | HW Revisions | needed files |
---|---|---|
Mi Band 3 | V0.18.3.2 V0.18.3.4 V0.18.3.6 V0.18.4.1 V0.18.4.3 | Mili_wuhan.fw, Mili_wuhan.res |
Mi Band 3 (with NFC) | V0.20.131.33 | Mili_chongqing.fw Mili_chongqing.res |
Note: After flashing some firmware versions the first time coming from prior versions you have to remove the pairing in Android Bluetooth settings, then press the + button in Gadgetbridge to pair again. Do this if you have problems connecting after a firmware update, you wont lose any data. After that continue with flashing the .res file.
Wuhan/Hankou/Chongqing...what hardware version do i have?
Use this article on geekdoing.com to determine version of your band.
Here is a small recap:
Model: Mi Band 3 without NFC (Chinese / Global Version), Code Name Wuhan:
Hardware Revisions: V0.18.3.2, V0.18.3.4, V0.18.3.6, V0.18.3.8, V0.18.3.10
Hardware Revisions: V0.18.4.1, V0.18.4.3, V0.18.4.5, V0.18.5.1
Model: XMSH05HM
Firmware Files: Mili_wuhan.fw, Mili_wuhan.res
Model: Mi Band 3 without NFC (Global Version), Code Name Hankou:
Hardware Revisions: V0.23.18.49, V0.23.19.49, V0.23.35.49
Model: XMSH05HM
Firmware Files: Mili_hankou.fw, Mili_hankou.res
Model: Mi Band 3 with NFC (Chinese Version), Code NameChongqing:
Hardware Revisions: V0.20.131.33
Model: XMSH06HM
Firmware Files: Mili_chongqing.fw, Mili_chongqing.res
Installing the firmware
Copy the desired Mi Band 3 .fw and .res files to your Android device and open the .fw file from any file manager on that device. The Gadgetbridge firmware update activity should then be started and guide you through the installation process. Repeat with the .res file (you don't have to do this if the previous version you
flashed had exactly the same .res version).
If you get the error "Element cannot be installed" or "The file format is not supported" try a different file manager. Amaze should work.
About Languages and fonts
There are two font files for the Mi Band 3, Mili_wuhan.ft (the normal, pre-installed one) and Mili_wuhan.ft.kj which is only for Japanese and Korean. In older firmware versions language set in Gadgetbridge has to match the font file (.ft.kj file for Japanese and Korean, .ft file for everything else) - else the menu text is blank and the Mi Band will ask you to update if you reconnect, which means you have to install the matching font file. This is no longer the case since at least firmware 2.3.0.6, Flashing the .ft.kj font allows to use ALL languages. Still language switching will change the available characters, even if they share the same font. For example switching to German will enable ä,ö,ü but disable all Chinese characters.
Known Firmware Versions (Mi Band 3 without NFC)
0.0.0 series (Alpha, not recommened to try)
fw ver | MiFit ver | tested | known issues | res ver | fw-md5 | res-md5 |
---|---|---|---|---|---|---|
0.0.0.8 | 3.2.0.1 | no | ? | 3 | ca4907e6ad5f5714d0cdfc834c27dc23 | 6fda92d7beaaa5a90b756836f72e1093 |
0.0.0.9 | 3.2.2 | no | ? | 4 | 9b22823e032a0e686c9d67c4bad4dcbe | 7031b4b74a860beb0d0d8734c2ee6588 |
0.0.0.15 | 3.2.2.2 | no | ? | 8 | 52bafd7161d82fc384e4d6a637552528 | 78f93c3ad65cdc9fdb6f729356b66343 |
0.0.0.21 | 3.2.2.3 | no | ? | 10 | 6334ceaa9444a343867328ff3d6fb8a3 | 83ab66ca9ea6a32a0eda9aacca5e680a |
0.0.0.29 | 3.2.3.1 | no | ? | 12 | ff796309ee758057b1f5ddc8407844f6 | a4b1a11252f5c79a024fed213bbb60b0 |
0.0.0.30 | 3.2.5 | no | ? | 12 | 7b01597a7d72d5c5ad576c2bf726a3e4 | a4b1a11252f5c79a024fed213bbb60b0 |
0.0.0.35 | 3.2.5.1 | no | ? | 13 | 18756050d6397c094d03e383a7124a49 | 83ed6c31cd0e7f972501dd554dfcff70 |
0.0.0.36 | 3.2.5.2 | no | ? | 14 | 2e73191d3af03919cee13f53639b3600 | 5d75abcc8f92e9d2d6cb9fd2d58dfe5d |
0.0.0.40 | 3.2.7.1 | no | ? | 16 | 71c90b194f474449be7660f3dbea6830 | 32562a63766697f777f7dcc1dc1e11f7 |
0.0.0.42 | 3.2.7 | no | ? | 17 | c420a69d6387965f7ad148d31ca33c9f | cf92efd216110269bae8cf60617e18de |
0.0.0.48 | 3.2.8.1 | no | ? | 17 | b7118f5438aa710856776c140a85cf9d | cf92efd216110269bae8cf60617e18de |
0.0.0.54 | 3.3.0.1 | no | ? | 19 | 7cbd641f472045ef84795a81342663ac | a8e069f81e95809ce91e962ec2efb486 |
0.0.0.55 | 3.0.0.2 | no | ? | 19 | cdab230ce94d7f74c7ef1e3d1e15040a | a8e069f81e95809ce91e962ec2efb486 |
0.0.0.65 | 3.3.2.1 | no | ? | 23 | ce1400be96226e68ecdbc0ff3c675fde | a0febd689fa05616807665cb25851903 |
1.0.1 series (Probably beta, not recommended to flash, device name is still "Wuhan")
fw ver | MiFit ver | tested | known issues | res ver | fw-md5 | res-md5 |
---|---|---|---|---|---|---|
1.0.1.0 | 3.3.2.1 | no | ? | 26 | 7b4e6d52f9f2aca67482e58b96058ac5 | 0957a421d54f6aeae0dbe11f80090c34 |
1.0.1.5 | 3.3.1 | no | ? | 27 | 40eace0caab14b83ce89c78f4ee108bf | 9becdd15814462c050249d216321330a |
1.0.1.10 | 3.3.4.1 | no | ? | 28 | 79a737a3a6cdce9bd09aeeb060559092 | 03c9edeb32186c775464bf25aa06aea6 |
1.0.1.17 | 3.3.2 | no | ? | 28 | 959a3938131558c31e2ce5706e6c8fa5 | 03c9edeb32186c775464bf25aa06aea6 |
1.0.1.50 | 3.3.6 | no | ? | 29 | 92a3541414faf7338bc2b119e6c655f8 | fd7e7236d1cd4380b433876802a23f37 |
>1.1.0 series
fw ver | MiFit ver | tested | known issues | res ver | fw-md5 | res-md5 |
---|---|---|---|---|---|---|
1.1.0.14 | 3.4.1 | no | ? | 33 | 95cacbb55b73cba072be60da649b8964 | 57d2724c4d9b7af6f52ba07007c36251 |
1.2.0.8 | 3.4.4.1 | no | ? | 34 | d5fdd509d40c0a3a65bb2b01efdb9475 | 0787aede985e4c3b3a08f30f41c4da89 |
1.3.0.4 | 3.4.4 | no | ? | 35 | 28a5d5b8d858ed1fb9c2e982d6d451f1 | 108869297b7d33a7fcd4c9dc3bb7eae5 |
1.3.0.8 | 3.4.6.8 | yes | ? | 37 | bfb6f624ac30288b06fbfe1874b59bf6 | 6aff668df38678a4f99308a103f3d96c |
1.4.0.6 | 3.4.5 | no | ? | 37 | 185de410470ad4af118cbbe47fc99023 | 6aff668df38678a4f99308a103f3d96c |
1.4.0.12 | 3.4.6.6 | no | ? | 40 | b88a78645b6ceba7f352c70471018e67 | 36019608bbe73ba09acf15c4dc1d9a09 |
1.5.0.2 | 3.4.6 | yes | ? | 40 | d35b91d0e1c33edfbc128412b285159d | 36019608bbe73ba09acf15c4dc1d9a09 |
1.5.0.7 | 3.4.7.10 | no | ? | 40 | e25aa35f47df6a5d256e158c1fd5e7e1 | 36019608bbe73ba09acf15c4dc1d9a09 |
1.5.0.11 | 3.4.7.27 | no | ? | 40 | 4013ff5318f2f5be99a64a71f00acb4c | 36019608bbe73ba09acf15c4dc1d9a09 |
1.6.0.16 | 3.4.7 | no | ? | 40 | efa49a6d1e0e48add3099d4e819874b6 | 36019608bbe73ba09acf15c4dc1d9a09 |
1.8.0.0 | 3.5.2 | yes | ? | 42 | 7dd4b563f47584d923729e07165ecba2 | 8b6394b18f81c25ad9c5b5c10a027b01 |
2.0.0.4 | 3.5.3 | yes | ? | 44 | d3c210c3fde4f02da8a012bd78875756 | 0dfb4d6a39c7d3651c7a5c26dd45846c |
2.2.0.12 | 3.5.5.3 | yes | ? | 46 | c0e8a785f58b31b83d8b9dd9686ef73a | 36639114613677305ccc935234d09ea8 |
2.2.0.14 | 3.5.5 | yes | ? | 46 | b9365c294b1d54f852e6d44a57c86456 | 36639114613677305ccc935234d09ea8 |
2.2.0.42 | 3.5.7 (Mi Store) | yes | ? | 46 | 7439a8a3f021ea70aaff4aff7af11c37 | 36639114613677305ccc935234d09ea8 |
2.3.0.2 | 3.5.8 | yes | ? | 46 | 5506158003e04f1632e9948774dac559 | 36639114613677305ccc935234d09ea8 |
2.3.0.6 | 3.5.9 | yes | ? | 46 | 97297cb1b21361df5de6e555fbea4794 | 36639114613677305ccc935234d09ea8 |
2.3.0.28 | 4.0.0 | yes | ? | 47 | fc1d136ee0111bb672ef45dd2fe13764 | e752a9c2c1a038a91994ed2830a108e1 |
2.4.0.12 | 4.0.5 | yes | ? | 49 | a17873ec4046f9e739cf3f7683343af1 | 36a25c1a103c89fb6312993c019f2b22 |
2.4.0.20 | 4.0.8 | yes | ? | 49 | e78ca23d38afd0d0ab15778f67a09072 | 36a25c1a103c89fb6312993c019f2b22 |
2.4.0.32 | 5.3.0 | yes | ? | 49 | e5d0830f819ca4e13d418865453d3e74 | 36a25c1a103c89fb6312993c019f2b22 |
Known Firmware Versions (Mi Band 3 with NFC)
0.0.0 series (Alpha, not recommened to try)
fw ver | MiFit ver | tested | known issues | res ver | fw-md5 | res-md5 |
---|---|---|---|---|---|---|
0.0.0.31 | 3.4.0.1 | no | ? | 32 | ef39594666b06badee7889e956b872fd | fcd43383c85180380ee7bcd908cfd574 |
0.0.0.47 | 3.4.2 | no | ? | 33 | 04dbb9ecba849cbb4a2690c5497745f7 | 57d2724c4d9b7af6f52ba07007c36251 |
>1.0.0 series
fw ver | MiFit ver | tested | known issues | res ver | fw-md5 | res-md5 |
---|---|---|---|---|---|---|
1.0.0.3 | 3.4.4.1 | no | ? | 34 | 22c116ed6112ccc0360dbe693da7c6a2 | 0787aede985e4c3b3a08f30f41c4da89 |
1.1.0.20 | 3.4.6.8 | no | ? | 37 | c6a8a78e9a71e3fe184ad6e032ea060d | 6aff668df38678a4f99308a103f3d96c |
1.1.0.4 | 3.4.3 | no | ? | 34 | a6073b0e3806191f033997a2231bcb1f | 0787aede985e4c3b3a08f30f41c4da89 |
1.2.0.0 | 3.4.6.6 | no | ? | 40 | 0a4b4a2167713605666842ca6a0e959e | 36019608bbe73ba09acf15c4dc1d9a09 |
1.2.0.2 | 3.4.7.2 | no | ? | 40 | 017d8c919ca6fc31da55e3e09196d091 | 36019608bbe73ba09acf15c4dc1d9a09 |
1.2.0.26 | 3.4.7 | no | ? | 40 | 9c44dc42acaac35f882e08d35d57702d | 36019608bbe73ba09acf15c4dc1d9a09 |
1.2.0.30 | 3.5.0 | no | ? | 40 | 28ae6347c526d9ce07f404427d34b7b7 | 36019608bbe73ba09acf15c4dc1d9a09 |
1.2.0.8 | 3.4.7.58 | no | ? | 40 | 0e285b28cb6abde8bfc24c800c7171e2 | 36019608bbe73ba09acf15c4dc1d9a09 |
1.3.0.0 | 3.5.2 | no | ? | 42 | 69567576eec1338584d469830c8e8a28 | 8b6394b18f81c25ad9c5b5c10a027b01 |
1.3.0.3 | 3.5.2.2 | no | ? | 43 | 5e8d086cd35de2e26d2629485c20cb47 | 8e471c4a0610788cc4bce9c9bb1825a3 |
1.4.0.2 | 3.5.3.1 | no | ? | 44 | 857ea0786a76a1c44c962fc418d35bfa | 0dfb4d6a39c7d3651c7a5c26dd45846c |
1.4.0.4 | 3.5.3 | no | ? | 44 | b79dc37bc482a3c292ff05a9dcca68d3 | 0dfb4d6a39c7d3651c7a5c26dd45846c |
1.5.0.2 | 3.5.4 | no | ? | 44 | 950c505a783824ae921ff95cc8114543 | 0dfb4d6a39c7d3651c7a5c26dd45846c |
1.6.0.6 | 3.5.5.3 | no | ? | 46 | 2849fd65e08c02a57d11fa4971162cc9 | 36639114613677305ccc935234d09ea8 |
1.6.0.10 | 3.5.5 | no | ? | 46 | b8ac10f8a76bc3d396cfd09e7f3cd69d | 36639114613677305ccc935234d09ea8 |
1.7.0.4 | 3.5.8 | no | ? | 46 | 2501bb07b7aa2940cdfd7161c60fee54 | 36639114613677305ccc935234d09ea8 |
1.7.0.16 | 4.0.0 | no | ? | 47 | d64f151aaa7baa4963fee4143f57c5e9 | e752a9c2c1a038a91994ed2830a108e1 |
? | 4.0.5 | no | ? | 49 | d31e9f0a58816223b347431abdc9b6fd | 36a25c1a103c89fb6312993c019f2b22 |
? | 4.0.10 | no | ? | 49 | e5346266fba6c8a11b711d07e188ef73 | 36a25c1a103c89fb6312993c019f2b22 |
? | 4.2.0 | no | ? | 49 | 8d4ca34a091f16cf0fa419805b89f34e | 36a25c1a103c89fb6312993c019f2b22 |
? | 5.3.0 | no | ? | 49 | c737b63d301551cb72b5a6db23a927b6 | 36a25c1a103c89fb6312993c019f2b22 |
NEW WEBSITE
General
- Home
- FAQ
- ReadMe
- Configuration
- Notifications
- ChangeLog
- Widget
- Weather
- Data Backup
- Pairing
- Find phone
- Music info
- Permissions Explained
- Firmware Update
- Automation via Intents
Sports/Activities
- Sports Activities Workouts
- Activity Sessions List
- Activity and Sleep Charts
- Heartrate measurement
- Integrating Sports Tracking apps with Gadgetbridge Sports Activities/Workouts
Smart Device Related
- Bangle.js
- Casio devices
- FitPro
- Fossil Hybrid HR
- Garmin devices
- HPlus
- Huami devices
- Amazfit Active
- Amazfit Active Edge
- Amazfit Balance
- Amazfit Band 5
- Amazfit Band 7
- Amazfit Bip
- Amazfit Bip Lite
- Amazfit Bip S
- Amazfit Bip U
- Amazfit Bip 3 Pro
- Amazfit Bip 5
- Amazfit Cheetah
- Amazfit Cheetah Pro
- Amazfit Cor
- Amazfit Cor 2
- Amazfit Falcon
- Amazfit GTR
- Amazfit GTR 3
- Amazfit GTR 3 Pro
- Amazfit GTR 4
- Amazfit GTR Mini
- Amazfit GTS
- Amazfit GTS 3
- Amazfit GTS 4
- Amazfit GTS 4 Mini
- Amazfit Neo
- Amazfit T-Rex
- Amazfit T-Rex 2
- Amazfit T-Rex Ultra
- Mi Band 1
- Mi Band 2
- Mi Band 3
- Mi Band 4
- Mi Band 5
- Mi Band 6
- Mi Band 7
- MyKronoz ZeTime
- Pebble
- PineTime
- Sony Wena 3
- SMA
- WithingsSteel
Wireless Earbuds
Others
- iTag Keyring trackers
- Nut Keyring trackers
- UM25 USB Voltage meter
- VESC BLDC controller VESC
- Flipper Zero Multi-tool Device for Geeks
- Roidmi Roidmi/Mojietu FM Trans.
- Vibratissimo Private toy
- Shell Racing Toy RC cars
- Femometer Vinca II
Full list of supported devices
Development
- How to Release
- Developer Documentation
- BT Protocol Reverse Engineering
- Support for a new Device
- New Device Tutorial
- Translating Gadgetbridge
- OpenTracks-API
- Intent-API
Feature Discussion
FAQ