archive
/
pixoPython
mirror of https://github.com/c0de-archive/pixoPython.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Refine Telegram Spec

This commit is contained in:
David Todd 2018-10-30 02:03:51 -05:00
parent c881cf9e9e
commit 43e1c335d6
1 changed files with 32 additions and 21 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

53
server/readme.md
View File

@ -25,43 +25,54 @@ For all commands that accept, but aren't supplied a specific input, the bot will
- `/send [name/id] *ATTACHMENT*` - Sends the attached media (if supported) to the selected device.
- If `/auto` is configured for any device, simply forwarding media to the bot will `/send` it to the device(s)
- `/newdevice [name/id]` - Alias of `/device new [name/id]`, if no name provided, starts "New Device Wizard", a series of `/device` sub-commands to get started
- Does not allow changing of `/data/config` commands
- Runs through these sub-commands
1. `/connect`
2. `/data` - Name, resolution, and type
3. `/auto` - Read `/send` above
4. `/protect` - Prevent further changes to the device until turned off, unique per device pin
- Does not allow changing of `/config` commands
- Does not allow `/sensor` commands, the bot will poll for sensor endpoints automatically. These sensors can be later removed by
1. `/device edit name`
2. `/sensor del sensor-name`
- `/deldevice [name/id]` - Alias of `/device del [name/id]`
- `/ping [name/id]` - Alias of `/device [name/id] ping`
- If the device has `/protect` turned on, the user must enter the pin before confirming the deletion
- `/ping [name/id]` - Pings the selected device and responds with how long it took/offline.
- `/device [new/edit/del] [name/id] [opts]` - `[opts]` are sub-commands to run directly. **Enters Device Configuration Mode** with the following commands.
- /exit - Returns to normal mode
- `/device [new/edit/del] [name/id]` - New enrolls a new device, Del will purge the device from the database, Edit engages **Device Configuration Mode** with the following available commands.
- `/exit` - Returns to normal mode
1. If `/protect` is not on, the user will be asked if they want to enable it
- /connect - Connects to the device with various options
1. /device (default) - The device will connect to the server from time to time (configurable in device settings). Generates a shared secret to be inputted in device settings
2. /discover - If the device is on the same network as the server, we can attempt autodiscovery and the server will establish a connection
- `/connect` - Connects to the device with various options
1. `/device` (default) - The device will connect to the server from time to time (configurable in device settings). Generates a shared secret to be inputted in device settings
2. `/discover` - If the device is on the same network as the server, we can attempt autodiscovery and the server will establish a connection
- The device should prompt for acceptance, either via button press or other UI
3. /direct - If the device can be accessed with a hostname/domain/IP:port, the server will establish a connection
3. `/direct` - If the device can be accessed with a hostname/domain/IP:port, the server will establish a connection
- The device should prompt for acceptance, either via button press of other UI
- /data - Provides meta-data about the device
1. /resolution - Dimensions of device. Expects to be in format like 16x16
2. /name - Sets a unique to you name for the device, any length
3. /type - What type of device is it (eg. pixo-pixel)
- /auto [on/off] - If on, the device will automatically recieve any media sent to the bot, if the media is supported. Default off
- `/data` - Provides meta-data about the device
1. `/resolution` - Dimensions of device. Expects to be in format like 16x16
2. `/name` - Sets a unique to you name for the device, any length
3. `/type` - What type of device is it (eg. pixo-pixel)
- `/auto [on/off]` - If on, the device will automatically recieve any media sent to the bot, if the media is supported. Default off
- /protect - User will be prompted to input a pin that will not be displayed. Prevents further changes to the **device configuration**
1. This does not prevent reading of known sensors, use `/sensor del [name]` to remove and make inaccessable
- `/protect [on/off/clear]` - User will be prompted to input a pin that will not be displayed. Prevents further changes to **all device configuration**
1. This does not prevent reading of known sensors, use `/sensor del [name]` to remove and make them inaccessable when `/protect` is off
- This prevents deletion and addition of sensors if enabled
2. When sent again, the user will be asked if they want to remove the protection
3. If the user attempts to delete the device, and `/protect` is on, they will first be prompted for their device pin
4. If the user attempts to edit the device, they will be told to turn off `/protect` first
5. If off, `/protect` will remember the last set pin. Use `/protect clear` to remove the pin
- /sensor [add/del] [name] [endpoint] - If a sensor is not automatically detected, or you wish to remove a sensor, this will communicate to the device and
- /read [sensor] - If the device has the named sensor, read the value and return it
- `/sensor [add/del] [name] [endpoint]` - If a sensor is not automatically detected, or you wish to remove a sensor, this will communicate to the device and read the value.
1. If the device does not have the endpoint, the sensor will not be added
- `/read [sensor]` - If the device has the named sensor, read the value and return it
1. The sensor can be physical (ie, temperature, gyroscope, etc) or it can be virtual (ie, CPU/MEM utilization, WIFI traffic, etc)
- /poll [sensor] [timer] - Performs a `/read` every `timer` seconds
- `/poll [sensor] [timer]` - Performs a `/read` every `timer` seconds
1. Every new message will include a button to stop the timer/stop button will be available in custom keyboard as priority option
- /ping - Pings the selected device and responds with how long it took/offline.
- /cmd [cmd] [opts] - Sends an API request to the selected device with the selected command with options
- `/cmd [cmd] [opts]` - Sends an API request to the selected device with the selected command with options
1. These API requests are *in the documetation for the device*
- /config [option] [value] - If supported, sets/replaces device config option (ex, change wifi, secret key, etc)
- `/config [option] [value]` - If supported, sets/replaces device config option (ex, change wifi, secret key, etc)
1. If the device has been `/protect`ed, these changes will fail
### Images