removed redundant pybytes api pages

This commit is contained in:
gijsio
2020-10-02 14:43:42 +02:00
parent 7adbc56ebc
commit feba689db9
27 changed files with 0 additions and 773 deletions

View File

@@ -1,39 +0,0 @@
---
title: "Activate Device"
aliases:
- pybytes/api/activate.html
- pybytes/api/activate.md
---
Activate device on Pybytes, via Pymakr plugin.
**Method**
----
**pybytes.activate(activation_string)**
**Parameters**
----
| name | Description | is Required | Default value
| ------------- |:-------------:|:-------------:|:-------------:|
| activation string | Generated by Pybytes | Yes | - |
**Example**
----
`pybytes.activate("eyJhIjoiNTYzM...")`
**Success Response**
----
```
>> Please wait while we try to connect to Pycom
>> Wifi connection established... activating device!
>> WMAC: 807D3AC325E8
>> Firmware: 1.20.1.r2
>> Pybytes: 1.3.0
>> Initialized watchdog for WiFi and LTE connection with timeout 1260000 ms
>> WiFi connection established
>> Pybytes connected successfully (using the built-in pybytes library)
```

View File

@@ -1,36 +0,0 @@
---
title: "Connect Device"
aliases:
- pybytes/api/connect
---
Initialize connection based on the configured parameters.
**Method**
----
**pybytes.connect()**
**Example**
----
`pybytes.connect()`
**Success Response**
----
WiFi:
```
>> Connecting with SSID and PASSWORD
>> WiFi connection established
```
LTE:
```
>> LTE connection established
```
LoRa ABP:
```
>> Trying to join LoRa.ABP for 15000 seconds...
>> Setting up LoRa socket...
>> Connected using LoRa
```

View File

@@ -1,31 +0,0 @@
---
title: "Connect LoRa ABP"
aliases:
- pybytes/api/connect_lora_abp
---
Initialize LoRa ABP connection.
**Method**
----
**pybytes.connect_lora_abp(timeout, nanogateway)**
**Parameters**
----
| name | Description | is Required | Default value
| ------------- |:-------------:|:-------------:|:-------------:|
| timeout | Connection timeout | Yes | - |
| nanogateway | Enable nanogateway | Yes | - |
**Example**
----
`pybytes.connect_lora_abp(15000, false)`
**Success Response**
----
```
>> Trying to join LoRa.ABP for 15000 seconds...
>> Setting up LoRa socket...
>> Connected using LoRa
```

View File

@@ -1,31 +0,0 @@
---
title: "Connect LoRa OTAA"
aliases:
- pybytes/api/connect_lora_otaa
---
Initialize LoRa OTAA connection.
**Method**
----
**pybytes.connect_lora_otaa(timeout, nanogateway)**
**Parameters**
----
| name | Description | is Required | Default value
| ------------- |:-------------:|:-------------:|:-------------:|
| timeout | Connection timeout | Yes | - |
| nanogateway | Enable nanogateway | Yes | - |
**Example**
----
`pybytes.connect_lora_otaa(timeout=15, nanogateway=False)`
**Success Response**
----
```
>> Trying to join LoRa.OTAA for 15 seconds...
>> Setting up LoRa socket...
>> Connected using LoRa
```

View File

@@ -1,29 +0,0 @@
---
title: "Connect LTE"
aliases:
- pybytes/api/connect_lte
---
Initialize watchdog for WiFi and LTE connection.
**Method**
----
**pybytes.connect_lte(reconnect=True, check_interval=0.5)**
**Parameters**
----
| name | Description | is Required | Default value
| ------------- |:-------------:|:-------------:|:-------------:|
| reconnect | Boolean | Yes | - |
| check_interval | interval in seconds | Yes | - |
**Example**
----
`pybytes.connect_lte(reconnect=True, check_interval=0.5)`
**Success Response**
----
```
>> LTE connection established
```

View File

@@ -1,22 +0,0 @@
---
title: "Connect Sigfox"
aliases:
- pybytes/api/connect_sigfox
---
Initialize Sigfox connection.
**Method**
----
**pybytes.connect_sigfox()**
**Example**
----
`pybytes.connect_sigfox()`
**Success Response**
----
```
>> Connected using Sigfox. Only upload stream is supported
```

View File

@@ -1,19 +0,0 @@
---
title: "Connect Wifi"
aliases:
- pybytes/api/connect_wifi
---
Initialize watchdog for the WiFi and LTE connection.
**Method**
----
**pybytes.connect_wifi()**
**Success Response**
----
```
>> Connecting with SSID and PASSWORD
>> WiFi connection established
```

View File

@@ -1,34 +0,0 @@
---
title: "Deepsleep"
aliases:
- pybytes/api/deepsleep
---
Start deepsleep mode for the given period
**Method**
----
**pybytes.deepsleep(ms, pins, mode, enable_pull)**
**Parameters**
----
| name | Description | is Required | Default value
| ------------- |:-------------:|:-------------:|:-------------:|
| ms | Sleep period in ms | Yes | - |
| pins | A list or tuple containing the GPIO to setup for deepsleep wakeup | No | None |
| mode | Configure how GPIOs can wake up -> **machine.WAKEUP_ALL_LOW** or **machine.WAKEUP_ANY_HIGH** | No | None |
| enable_pull | If set to **True** keeps the pull up or pull down resistors enabled during deep sleep | No | None |
**Example**
----
`>> pybytes.deepsleep(1000)`
**Success Response**
----
After deepsleep, the device reconnects.
```
>> Connecting with SSID and PASSWORD
>> WiFi connection established
```

View File

@@ -1,22 +0,0 @@
---
title: "Disconnect"
aliases:
- pybytes/api/disconnect
---
Disconnect device
**Method**
----
**pybytes.disconnect()**
**Success Response**
----
```
>> Watchdog timeout has been increased to 2147483647 ms
>> self.__connection_status=1 | self.__network_type=0
>> MQTT over WIFI||LTE... disconnecting MQTT
>> Packet sent. (Length: 2)
>> Connected over WIFI... disconnecting
```

View File

@@ -1,29 +0,0 @@
---
title: "Dump CA"
aliases:
- pybytes/api/dump_ca
---
Make a dump_ca
**Method**
----
**pybytes.dump_ca(ca_file)**
**Parameters**
----
| name | Description | is Required | Default value
| ------------- |:-------------:|:-------------:|:-------------:|
| ca_file | File path | No | /flash/cert/pycom-ca.pem |
**Example**
----
`pybytes.dump_ca(ca_file='/flash/cert/pycom-ca.pem')`
**Success Response**
----
```
>> Successfully created /flash/cert/pycom-ca.pem
```

View File

@@ -1,36 +0,0 @@
---
title: "Enable LTE"
aliases:
- pybytes/api/enable_lte
---
Enable LTE connection
**Method**
----
**pybytes.enable_lte(carrier, cid, band, apn, type, reset, fallback)**
**Parameters**
----
| name | Description | is Required | Default value
| ------------- |:-------------:|:-------------:|:-------------:|
| carrier | Carrier | No | None |
| cid | Cid | No | None |
| band | Band | No | None |
| apn | APN | No | None |
| type | Type | No | None |
| reset | Reset | No | None |
| fallback | If **True** extends network preferences with the given LTE information| No | False |
**Example**
----
`pybytes.enable_lte('standard', 1, 8, 'soracom.io', 'IP', False)`
**Success Response**
----
```
>> Pybytes configuration written to /flash/pybytes_config.json
>> Watchdog timeout has been increased to 2147483647 ms
>> Initialized watchdog for WiFi and LTE connection with timeout 1260000 ms
```

View File

@@ -1,29 +0,0 @@
---
title: "Enable SSL"
aliases:
- pybytes/api/enable_ssl
---
Enable SSL
**Method**
----
**pybytes.enable_ssl(ca_file, dump_ca)**
**Parameters**
----
| name | Description | is Required | Default value
| ------------- |:-------------:|:-------------:|:-------------:|
| ca_file | File Path | No | /flash/cert/pycom-ca.pem |
| dump_ca | Dump_ca | No | Yes |
**Example**
----
`pybytes.enable_ssl('/flash/cert/pycom-ca.pem', True)`
**Success Response**
----
```
>> Please reset your module to apply the new settings
```

View File

@@ -1,15 +0,0 @@
---
title: "Enable Terminal"
aliases:
- pybytes/api/enable_terminal
---
Enable Terminal
**Method**
----
**pybytes.enable_terminal()**
**Example**
----
`pybytes.enable_terminal()`

View File

@@ -1,28 +0,0 @@
---
title: "Export configuration file"
aliases:
- pybytes/api/export_config
---
Exports all configuration data into a file at specified path.
**Method**
----
**pybytes.export_config(file)**
**Parameters**
----
| name | Description | is Required | Default value
| ------------- |:-------------:|:-------------:|:-------------:|
| file | File Path | No | /flash/pybytes_config.json |
**Example**
----
`pybytes.export_config()`
**Success Response**
----
```
>> Pybytes configuration exported to /flash/pybytes_config.json
```

View File

@@ -1,64 +0,0 @@
---
title: "Get configuration"
aliases:
- pybytes/api/get_config
---
Returns configuration data.
**Method**
----
**pybytes.get_config(key)**
**Parameters**
----
| name | Description | is Required | Default value
| ------------- |:-------------:|:-------------:|:-------------:|
| Key | Returns a specific key-value | No | None |
**Example**
----
`pybytes.get_config()`
**Success Response**
----
```json
{
'ssl': True,
'wifi': {
'ssid': 'SSID',
'password': 'PASSWORD'
},
'lte': {
'apn': 'apn',
'cid': 999,
'reset': False,
'carrier': 'carrier',
'band': 999,
'type': 'type'
},
'username': 'user@email.com',
'network_preferences': ['lte', 'lora_otaa'],
'cfg_msg': 'Pybytes configuration read from file.json',
'dump_ca': True,
'wlan_antenna': 0,
'server': 'xx.x.x.xx',
'lora': {
'otaa': {
'app_key': 'app_key',
'app_device_eui': 'app_device_eui',
'app_eui': 'app_eui'
}
},
'ota_server': {
'port': 999,
'domain': 'software.pycom.io'
},
'pybytes_autostart': True,
'ssl_params': {
'ca_certs': 'ca_certs'
},
'device_id': 'device_id'
}
```

View File

@@ -1,24 +0,0 @@
---
title: "Pybytes library API"
aliases:
- pybytes/api/is_connected
---
**Is connected**
----
Returns true if connected.
**Method**
----
**pybytes.is_connected()**
**Example**
----
`pybytes.is_connected()`
**Success Response**
----
```
>> True
```

View File

@@ -1,22 +0,0 @@
---
title: "Is connected"
aliases:
- pybytes/api/isconnected
---
Returns true if connected.
**Method**
----
**pybytes.isconnected()**
**Example**
----
`pybytes.isconnected()`
**Success Response**
----
```
>> True
```

View File

@@ -1,35 +0,0 @@
---
title: "Print config"
aliases:
- pybytes/api/print_config
---
Prints the current configuration in the terminal.
**Method**
----
**pybytes.print_config()**
**Example**
----
`pybytes.print_config()`
**Success Response**
----
```
>> ssl = True
>> wifi = {'ssid': '', 'password': ''}
>> lte = {'apn': 'apn', 'cid': 999, 'reset': False, 'carrier': 'carrier', 'band': 999, 'type': 'type'}
>> username = user@email.com
>> network_preferences = ['lte', 'lte', 'lte', 'lora_otaa']
>> cfg_msg = Pybytes configuration read from file.json
>> dump_ca = True
>> wlan_antenna = 0
>> server = xx.x.x.xx
>> lora = {'otaa': {'app_key': 'app_key', 'app_device_eui': 'app_device_eui', 'app_eui': 'app_eui'}}
>> ota_server = {'port': 000, 'domain': 'domain.com'}
>> pybytes_autostart = True
>> ssl_params = {'ca_certs': 'ca_certs'}
>> device_id = device_id
```

View File

@@ -1,29 +0,0 @@
---
title: "Read configuration"
aliases:
- pybytes/api/read_config
---
Reads the configuration from the given file.
**Method**
----
**pybytes.read_config(file', reconnect)**
**Parameters**
----
| name | Description | is Required | Default value
| ------------- |:-------------:|:-------------:|:-------------:|
| file | File Path | No | /flash/pybytes_config.json |
| reconnect | Reconnect after changes | No | False |
**Example**
----
`pybytes.read_config()`
**Success Response**
----
```
>> Pybytes configuration read from /flash/pybytes_config.json
```

View File

@@ -1,24 +0,0 @@
---
title: "Reconnect"
aliases:
- pybytes/api/reconnect
---
Reconnects device.
**Method**
----
**pybytes.reconnect()**
**Example**
----
`pybytes.reconnect()`
**Success Response**
----
After the device disconnects:
```
>> Connecting with SSID and PASSWORD
>> WiFi connection established
```

View File

@@ -1,15 +0,0 @@
---
title: "Send information message"
aliases:
- pybytes/api/send_info_message
---
Send information message.
**Method**
----
**pybytes.send_info_message()**
**Example**
----
`pybytes.send_info_message()`

View File

@@ -1,15 +0,0 @@
---
title: "Send ping message"
aliases:
- pybytes/api/send_ping_message
---
Send ping message.
**Method**
----
**pybytes.send_ping_message()**
**Example**
----
`pybytes.send_ping_message()`

View File

@@ -1,28 +0,0 @@
---
title: "Send signal"
aliases:
- pybytes/api/send_signal
---
Send signal to the given signal number.
**Method**
----
**pybytes.send_signal(pin, value)**
**Parameters**
----
| name | Description | is Required | Default value
| ------------- |:-------------:|:-------------:|:-------------:|
| pin | pin | Yes | - |
| value | signal value | Yes | - |
**Example**
----
`pybytes.send_signal(13,25)`
**Success Response**
---
```
To check the result, look at Pybytes → Device → Data
```

View File

@@ -1,32 +0,0 @@
---
title: "Set configuration"
aliases:
- pybytes/api/set_config
---
Set device configuration.
**Method**
----
**pybytes.set_config(key, value, permanent, silent, reconnect)**
**Parameters**
----
| name | Description | is Required | Default value
| ------------- |:-------------:|:-------------:|:-------------:|
| key | key | Yes | None |
| value | value | No | None |
| permanent | boolean | No | True |
| silent | boolean | No | False |
| reconnect | boolean | No | False |
**Example**
----
`pybytes.set_config(key="network_preferences", value="wifi", permanent=True, silent=False, reconnect=False)`
**Success Response**
----
```
>> Pybytes configuration written to /flash/pybytes_config.json
```

View File

@@ -1,28 +0,0 @@
---
title: "Send custom message callback"
aliases:
- pybytes/api/set_custom_message_callback
---
Sends custom message callback.
**Method**
----
**pybytes.set_custom_message_callback(callback)**
**Parameters**
----
| name | Description | is Required | Default value
| ------------- |:-------------:|:-------------:|:-------------:|
| callback | function | Yes | - |
**Example**
----
`pybytes.set_custom_message_callback(print("Hello Pycom!"))`
**Success Response**
----
```
>> Hello Pycom!
```

View File

@@ -1,27 +0,0 @@
---
title: "Start"
aliases:
- pybytes/api/start
---
Opens the Pybytes library.
**Method**
----
**pybytes.start()**
**Example**
----
`pybytes.start()`
**Success Response**
----
```
>> WMAC: 807D3AC325E8
>> Firmware: 1.20.1.r2
>> Pybytes: 1.3.0
>> Initialized watchdog for WiFi and LTE connection with timeout 1260000 ms
>> WiFi connection established
>> Pybytes connected successfully (using the built-in pybytes library)
```

View File

@@ -1,30 +0,0 @@
---
title: "Update configuration"
aliases:
- pybytes/api/update_config
---
Update device configuration parameters.
**Method**
----
**pybytes.update_config(key, value, permanent, silent, reconnect)**
**Parameters**
----
| name | Description | is Required | Default value
| ------------- |:-------------:|:-------------:|:-------------:|
| key | key | Yes | None |
| value | value | No | None |
| permanent | boolean | No | True |
| silent | boolean | No | False |
| reconnect | boolean | No | False |
**Example**
----
`pybytes.update_config(key="wifi", value={'password': 'Pa$$w0rd'}, permanent=True, silent=False, reconnect=False)`
**Success Response**
----
Pybytes configuration written to /flash/pybytes_config.json