Skip to content

Commit c7594a3

Browse files
authored
Update upgrading-the-firmware.md
1 parent e501ba5 commit c7594a3

1 file changed

Lines changed: 13 additions & 5 deletions

File tree

docs/guides/firmware/upgrading-the-firmware.md

Lines changed: 13 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,10 @@ When new features are developed or bugs are fixed we will release new versions o
1717
After updating the firmware follow this same steps to input the token and wifi credentials, after this your kit will be publishing on the same registered device than before.
1818

1919
!!! info "A note about versions"
20-
:white_check_mark: The guide below applies to both, SCK 2.0 and SCK2.1.
20+
:white_check_mark: The guide below applies to all SCK2.* versions.
21+
22+
!!! danger "If you are updating to `0.9.10`"
23+
:warning: If you are updating to `0.9.10` we recommend you update first the [ESP](#updating-the-esp-firmware) and later on the [SAM](#updating-the-sam-firmware).
2124

2225
## Updating the SAM firmware
2326

@@ -77,8 +80,13 @@ If you want to force the ESP to upload, please, follow the steps below.
7780

7881
![](/assets/images/esp-force-upload-3.png)
7982

83+
!!! warning "Make sure to disconnect your data"
84+
Modern phones will have Wi-Fi and LTE (data) active at the same time. The `SmartCitizen[...]` network doesn't have internet access, so your phone will likely switch to using your data plan. If this happens, make sure to switch it off temporarily while updating the firmware.
85+
8086
!!! danger "Doesn't work?"
81-
Sometimes in the phone the firmware selection screen will not pop up. You can always try to do the _developer-way_ with [check this guide here](/guides/firmware/edit-the-firmware/#manual-update)
87+
Sometimes in the phone, the firmware selection screen will work when you click on `Browse`. This is very likely because the browser on your phone doesn't have this feature. We recommend using a modern browser (firefox, chrome...) instead of the default Wi-Fi login portal that typically pops up in some phones.
88+
89+
You can always try to do the _developer-way_ with [check this guide here](#using-command-line-tools)
8290

8391
## Using command-line tools
8492

@@ -92,11 +100,11 @@ The steps below are a summary of the steps you will need to update the firmware
92100

93101
4. In your terminal, navigate to a folder in which you want to download the firmware in. Then, get the firmware following the [instructions here](/guides/firmware/edit-the-firmware/#getting-the-firmware)
94102

95-
5. Navigate to the firmware folder, plug the sensor to your computer and run the command below.
103+
5. Navigate to the firmware folder, plug the sensor to your computer and run the command below. The [SAM firmware has different versions](https://forum.smartcitizen.me/t/wq-sensors-wouldnt-enable/1958/3), defined by `environments`. The `environments` are: `sck2`, `sck21_air`, `sck22_air, `sck23_air` and `sck_water`. Make rue to use the corresponding one after the `--env` option below. Note that `ESP` doesn't need a flag, as it's independent.
96104

97105
This will upload the SAM firmware:
98106
```
99-
python make.py flash sam -v
107+
python make.py flash sam -v --env sck23_air
100108
```
101109

102110
This will also upload the ESP firmware:
@@ -106,5 +114,5 @@ The steps below are a summary of the steps you will need to update the firmware
106114

107115
You can upload both at the same time by:
108116
```
109-
python make.py flash sam esp -v
117+
python make.py flash sam esp -v --env sck23_air
110118
```

0 commit comments

Comments
 (0)