Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion config.toml
Original file line number Diff line number Diff line change
Expand Up @@ -1261,7 +1261,7 @@ theme = "doc-theme"
weight = 20

[[menu.main]]
name = "Pybytes iOS"
name = "Pybytes App"
url = "/pybytes/smart/"
identifier = "pybytes@smart"
parent = "pybytes"
Expand Down
21 changes: 19 additions & 2 deletions content/gettingstarted/programming/ftp.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,17 +10,23 @@ This page discusses the possibility to upload files through the internal FTP ser

On each Pycom device, there is a small internal filesystem called `/flash`, to which the Python code is uploaded. We can access this filesystem through an internally running FTP server, that allows us to make changes to the files. Next to that, a Telnet connection can be made to communicate with the device through the REPL.
## Connecting
1. **Connect through the Access Point**

In the past, Pycom devices came with the Access Point enabled from the factory. Nowadays, they come with [smart-configuration](/pybytes/smart/) and Pybytes enabled by default, allowing quick and easy provisioning to Pybytes using the app. Follow the steps below to disable that and use enable the Access Point or connect to another WiFi network on boot.

1. **Connect through the Access Point**

You can activate the internal Access Point (AP) on boot by using the following:
```python
import pycom
from network import WLAN
import machine
pycom.pybytes_on_boot(False) #we do not want Pybytes using the WLAN
pycom.smart_config_on_boot(False) #we also do not want smart config
pycom.wifi_on_boot(True)
pycom.wifi_mode_on_boot(WLAN.AP)
pycom.wifi_ssid_ap('ssid')
pycom.wifi_pwd_ap('')
machine.reset()
```

> You can find the methods to change the default settings [here](/firmwareapi/pycom/pycom/#boot-methods)
Expand All @@ -29,9 +35,20 @@ On each Pycom device, there is a small internal filesystem called `/flash`, to w

It is also possible to connect your pycom device to a WiFi network first, and then connect to its IP address. Note that you will have to figure out its IP address before you can access the FTP server or use [MDNS](/tutorials/networkprotocols/mdns/). For that, you can use the following command. This will return a tuple with four items, where the first item will contain the assigned IP address.
```python
import pycom
from network import WLAN
import machine
#You can set this to True if Pybytes connects to your router already, and skip the rest
pycom.pybytes_on_boot(False)

pycom.smart_config_on_boot(False)
pycom.wifi_on_boot(True)
pycom.wifi_mode_on_boot(WLAN.STA)
pycom.wifi_ssid_sta('router ssid')
pycom.wifi_pwd_sta('router password')
wlan.ifconfig()
machine.reset()
```

Note that if you make changes to the WLAN Configuration in the uploaded Python code, for example by using Pybytes or changing the WiFi credentials, the connection might drop. Moreover, if your program contains continuous reboot loops, sleep cycles or coredumps, you might not be able to recover the wireless connection without [safe booting](../safeboot/)

## FTP Server
Expand Down
2 changes: 1 addition & 1 deletion content/pybytes/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ In a nutshell, Pybytes is an environment designed to optimise your IoT applicati

## Let's get started!


* [Provision your device using the Pybytes app](/pybytes/smart/)
* [Getting started with Pybytes](/pybytes/gettingstarted/)
* [Connect your Pycom module to Pybytes](/pybytes/connect/)
* [Visualise data from your device](/pybytes/dashboard/)
Expand Down
3 changes: 2 additions & 1 deletion content/pybytes/gettingstarted.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,8 @@ If you already have a Forum or Webshop account, you can use the same credentials
Else, go to [Pybytes](https://pybytes.pycom.io) and create an account

## Step 2: Create a device
1. Click on [Add Device](https://pybytes.pycom.io/devices). You can either add a device using USB, or the Pybytes App for [iPhone](https://apps.apple.com/us/app/pybytes/id1465696479) or [Android](https://play.google.com/store/apps/details?id=io.pycom.pybytes_android&hl=en). In this guide, we will describe the process using USB.
1. Click on [Add Device](https://pybytes.pycom.io/devices). You can either add a device using USB, or the [Pybytes App](/pybytes/smart/). If you are planning on provisioning a lot of devices, we would definitely recommend using the Pybytes app. In this guide, we will describe the process using USB.

![](/gitbook/assets/pybytes/add-device/add-device-btn.png)

2. Select your device (WiPy, LoPy, SiPy, etc.).
Expand Down
66 changes: 24 additions & 42 deletions content/pybytes/smart/_index.md
Original file line number Diff line number Diff line change
@@ -1,81 +1,63 @@
---
title: "Pybytes iOS"
title: "Pybytes App"
aliases:
---

Pybytes iOS app will allow you to quickly provision any number of devices effortlessly to Pybytes.
The Pybytes app will allow you to quickly provision any number of devices effortlessly to Pybytes. This is especially useful if you are planning to provision multiple devices, as the device type, WiFi network and name get automatically assigned in the Pybytes application, and all you will need to do is power up the devices that need provisioning.

<span style="background-color:#00cc96;">&nbsp;Tip:&nbsp;</span>&nbsp;Your devices will need to run **firmware 1.20.1** or newer.
> Your devices will need to run **firmware 1.20.1** or newer.

Further down the page you will find the following information:

* [Pybytes iOS installing and Device Provisioning](#installing)
* [Take into consideration](#recommendations)
* [Pybytes app installing and Device Provisioning](#pybytes-app-installing-and-device-provisioning)
* [Take into consideration](#take-into-consideration)
* [Quick help/FAQ](#faq)

> Before starting, make sure you have enabled Pybytes smart config on the devices you want to provision by using `pybytes.smart_config(True)`, or by checking the option in the firmware updater tool. New devices will come with pybytes and smart config enabled by default.

<a id="installing"></a>
### Pybytes iOS installing and Device Provisioning

1. Go to the App Store and download Pybytes iOS app.
2. Use your Pybytes web app account to log in.
<br/>
<br/>
<span style="background-color:#00cc96;">&nbsp;Tip:&nbsp;</span>&nbsp;Go to Pybytes web app with Safari on iOS or macOS and save your log-in credentials.
Then your iPhone will pre-fill your saved password.
## Pybytes app installing and Device Provisioning

1. Install the app for [iPhone](https://apps.apple.com/us/app/pybytes/id1465696479) or [Android](https://play.google.com/store/apps/details?id=io.pycom.pybytes_android&hl=en).
2. Use your Pybytes account to log in.
3. On the next screen, you will need to enter your Wi-Fi credentials.
<br/>
<br/>
<img src="/gitbook/assets/pybytes/iOS/login.jpg" alt="Pybytes iOS login" width="200" style="padding:0px;box-shadow: 2px 2px 8px 2px #cccccc;"/>&nbsp;&nbsp;&nbsp;&nbsp;<img src="/gitbook/assets/pybytes/iOS/loginSavedPasswords.jpg" alt="Pybytes iOS login" width="200" style="padding:0px;box-shadow: 2px 2px 8px 2px #cccccc;" />

4. After pressing the START button, a list of devices will appear on the screen. It may take up to several minutes to provision all of your devices. The first device usually appears on the screen within one minute.
<br/>
<br/>
<span style="background-color:#00cc96;">&nbsp;Tip:&nbsp;</span>&nbsp;The name of a device provisioned device is its Wireless MAC address.
<br/>
<br/>
<img src="/gitbook/assets/pybytes/iOS/wifiSettings.jpg" alt="Pybytes iOS login" width="200" style="padding:0px;box-shadow: 2px 2px 8px 2px #cccccc;"/>&nbsp;&nbsp;&nbsp;&nbsp;
<img src="/gitbook/assets/pybytes/iOS/provisionedDevicesIOS.jpg" alt="Pybytes iOS login" width="200" style="padding:0px;box-shadow: 2px 2px 8px 2px #cccccc;"/>

![](/gitbook/assets/pybytes/iOS/login.jpg)
![](/gitbook/assets/pybytes/iOS/wifiSettings.jpg)
![](/gitbook/assets/pybytes/iOS/provisionedDevicesIOS.jpg)

> The name of a device provisioned device is its Wireless MAC address.

5. As your devices are provisioning in Pybytes devices management platform, you will see notifications appearing on the screen when the provisioning is successful. You will also see the provisioned devices in the Devices section.
<br/>
<br/>
<img src="/gitbook/assets/pybytes/iOS/provisionedDevicesPybytes.png" alt="Pybytes iOS login" style="padding:0px;box-shadow: 2px 2px 8px 2px #cccccc;"/>

<a id="recommendations"></a>
### Take into consideration
![](/gitbook/assets/pybytes/iOS/provisionedDevicesPybytes.png)

## Take into consideration

* If you are using iOS 12, turn off your Wi-Fi completely on your iPhone.
* Only use a Wi-Fi network with 2.4GHz as Pycom devices cannot connect to a 5GHz network.
* Your device might be provisioned faster if you move your device closer to your Wi-Fi router.
* Make sure your devices are powered on and running firmware 1.20.1 or newer.
* You cannot provision the same devices on the different Pybytes account unless you [erased them completely](../../advance/cli/#erase-all) and flashed the latest firmware again with FW updater tool.
* If there is a spinning wheel on your screen, that means that your device is being provisioned. If it has disappeared, then press the START button again.
* Please take into account that we are developing a new feature and therefore some niggles can occur. (Please bear with us!) If any issues occur whilst you are using Pybytes iOS, then drop us a line at <a href="mailto:support@pycom.io">support@pycom.io</a>.

<a id="faq"></a>
### FAQ

<span style="background-color:#00cc96;">&nbsp;I can’t connect to Wi-Fi in Pybytes iOS&nbsp;</span>
## FAQ

### I can’t connect to Wi-Fi in Pybytes iOS

* Firstly, check your version of iOS. If it is iOS 12, then turn off the Wi-Fi connection on your phone. Following this, try to use Pybytes iOS again, and it should now automatically connect to the WiFi.

* If you have version that is later than iOS 12, check your Wi-Fi router setting. It should run on a 2.4 HGz Wi-Fi network.

<span style="background-color:#00cc96;">&nbsp;No devices were provisioned after 5 min.&nbsp;</span>
### No devices were provisioned after 5 min.

* Check if your devices are on

* Move your devices closer to the Wi-Fi router

* Check that no-one else in the room is trying to provision devices with the Pybytes iOS app.

<span style="background-color:#00cc96;">&nbsp;How long does the provisioning take?&nbsp;</span>
### How long does the provisioning take?

* On average, it takes up to 2 minutes to provision 6 devices.

<br/>
Our hope is that Pybytes iOS will simplify the device provisioning process. However, as we are still in a development pipeline, sometimes there can be a hitch in the silk. If that happens, please let us know! Drop us a line at <a href="mailto:support@pycom.io">support@pycom.io</a>.
<br/>
<br/>
<br/>
Binary file modified static/gitbook/assets/pybytes/iOS/login.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified static/gitbook/assets/pybytes/iOS/provisionedDevicesIOS.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified static/gitbook/assets/pybytes/iOS/wifiSettings.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.