Difference between revisions of "Cradlepoint"

From HSYCO
Jump to navigation Jump to search
 
(10 intermediate revisions by 2 users not shown)
Line 33: Line 33:
 
|-
 
|-
  
−
|rowspan="2"|inputdiscovery
+
|query
−
|rowspan="2"|false
+
|/status/wan/connection_state /status/system/wan_signal_strength /status/wan/stats
−
|true
+
|space-separated pathnames
−
|automatically creates the list of all inputs in the systemtopo.txt file. Should be enabled to allow the automatic update of (button) objects’ states
+
|this parameter can be used to retrieve specific status data from the router. Use / to retrieve all data (note that using / the router will need several seconds to return all data, and the number of generated data points will be huge. You should specify the / full path only for development purposes
−
|-
 
−
|false
 
−
|auto-detect for input devices is disabled
 
 
|-
 
|-
  
−
|rowspan="2"|outputdiscovery
+
|}
−
|rowspan="2"|false
+
 
−
|true
+
== Datapoints ==
−
|automatically creates the list of all outputs in the systemtopo.txt file. Should be enabled to allow the automatic update of (button) objects’ states
+
 
−
|-
+
The status information that the driver retrieves from the Cradlepoint router depends on the pathnames defined in the query option.
−
|false
 
−
|auto-detect for output devices is disabled
 
−
|-
 
  
−
|inputs
+
Refer to the CRADLEPOINT Router CLI Overview document for the description of the file system structure and the list of valid directories.
−
|8
+
Each directory contains status information that this driver translates into standard HSYCO data points.
−
|0 ... 8
 
−
|use input pins from 0 to the specified value
 
−
|-
 
  
−
|outputs
+
When no query option is explicitly set, the driver retrieves all data located in the following directories:
−
|8
+
* /status/wan/connection_state
−
|0 ... 8
+
* /status/system/wan_signal_strength
−
|use output pins from 0 to  the specified value
+
* /status/wan/stats
−
|-
 
  
−
|}
 
  
 +
{{note|The following table lists the read-only data poins that are generated using the default query.}}
  
−
== Datapoints ==
 
  
 
{| class="wikitable"
 
{| class="wikitable"
Line 75: Line 64:
 
|-
 
|-
  
−
|send
+
|rowspan="2" |connection
−
|<command_code>
+
|online
−
|W
+
|R
−
|send the specified control command (see table below)
+
|connection established
 +
|-
 +
|offline
 +
|R
 +
|HSYCO can't connect to the router
 
|-
 
|-
−
|}
 
  
−
Most Samsung Smart TV models should accept the following command codes. Other undocumented commands may also be supported.
+
|status.system.wan_signal_strength
 +
|0..100
 +
|R
 +
|wireless WAN connection signal strength
 +
|-
  
−
{| class="wikitable"
+
|status.wan.connection_state
−
!Command code
+
|<status>
−
!Description
+
|R
 +
|WAN connection status
 
|-
 
|-
  
−
|0
+
|status.wan.stats.bps
−
|0
+
|<number>
 +
|R
 +
|WAN total throughput in BPS
 
|-
 
|-
−
|1
+
 
−
|1
+
|status.wan.stats.collisions
 +
|<number>
 +
|R
 +
|number of collisions on the WAN connection
 
|-
 
|-
−
|2
+
 
−
|2
+
|status.wan.stats.ibps
 +
|<number>
 +
|R
 +
|WAN input throughput in BPS
 
|-
 
|-
−
|3
+
 
−
|3
+
|status.wan.stats.idrops
 +
|<number>
 +
|R
 +
|wireless WAN input packets dropped
 
|-
 
|-
−
|4
+
 
−
|4
+
|status.wan.stats.ierrors
 +
|<number>
 +
|R
 +
|wireless WAN input errors
 
|-
 
|-
−
|5
+
 
−
|5
+
|status.wan.stats.imcasts
 +
|<number>
 +
|R
 +
|wireless WAN input multicast traffic
 
|-
 
|-
−
|6
+
 
−
|6
+
|status.wan.stats.in
 +
|<number>
 +
|R
 +
|wireless WAN total input bytes of current connection
 
|-
 
|-
−
|7
+
 
−
|7
+
|status.wan.stats.ipackets
 +
|<number>
 +
|R
 +
|wireless WAN total input packets of current connection
 
|-
 
|-
−
|8
+
 
−
|8
+
|status.wan.stats.noproto
 +
|<number>
 +
|R
 +
|wireless WAN total no protocol packets
 
|-
 
|-
−
|9
+
 
−
|9
+
|status.wan.stats.obps
 +
|<number>
 +
|R
 +
|WAN output throughput in BPS
 
|-
 
|-
−
|UP
+
 
−
|up
+
|status.wan.stats.oerrors
 +
|<number>
 +
|R
 +
|wireless WAN output errors
 
|-
 
|-
−
|DOWN
+
 
−
|down
+
|status.wan.stats.omcasts
 +
|<number>
 +
|R
 +
|wireless WAN output multicast traffic
 
|-
 
|-
−
|LEFT
+
 
−
|left
+
|status.wan.stats.opackets
 +
|<number>
 +
|R
 +
|wireless WAN total output packets of current connection
 
|-
 
|-
−
|RIGHT
+
 
−
|right
+
|status.wan.stats.out
 +
|<number>
 +
|R
 +
|wireless WAN total output bytes of current connection
 
|-
 
|-
−
|ENTER
+
 
−
|enter
+
|status.wan.stats.ts
 +
|<number>
 +
|R
 +
|wireless WAN current connection time in seconds (ignore the decimal part)
 
|-
 
|-
−
|INFO
+
 
−
|info
+
|command
 +
|<command>
 +
|W
 +
|send a generic CLI command to the router. The <command> value is a text string exactly as specified in the CLI documentation
 
|-
 
|-
−
|EXIT
+
 
−
|exit
+
|router
−
|-
+
|reboot
−
|RETURN
+
|W
−
|return
+
|reboot the router
−
|-
 
−
|MENU
 
−
|menu
 
−
|-
 
−
|TOOLS
 
−
|tools
 
−
|-
 
−
|SOURCE
 
−
|source
 
−
|-
 
−
|VOLUP
 
−
|increase volume
 
−
|-
 
−
|VOLDOWN
 
−
|decrease volume
 
−
|-
 
−
|MUTE
 
−
|mute
 
−
|-
 
−
|CHUP
 
−
|next channel
 
−
|-
 
−
|CHDOWN
 
−
|previous channel
 
−
|-
 
−
|TV
 
−
|select the internal TV tuner source
 
−
|-
 
−
|HDMI
 
−
|select one of the HDMI sources (depends on the TV model)
 
−
|-
 
−
|POWEROFF
 
−
|turn TV off (can’t turn it back on)
 
−
|-
 
−
|PIP_ONOFF
 
−
|picture-in-picture on/off
 
−
|-
 
−
|PIP_CHDOWN
 
−
|next channel in PIP window
 
−
|-
 
−
|PIP_CHUP
 
−
|previous channel in PIP window
 
−
|-
 
−
|PIP_SWAP
 
−
|swaps PIP and main screen sources
 
 
|-
 
|-
 
|}
 
|}
  
−
== User Interface ==
+
== Release Notes ==
 +
=== 3.5.0 ===
 +
*performance improvements
  
−
You can easily associate any user button to a specific command to be sent to the TV. Set ''name'' to the I/O Server name and ''param'' to the command code.
+
=== 3.4.0 ===
−
 
+
*initial release
−
[[File:IO Server SamsungTV Interface.png]]
 
−
 
 
−
You can also enable the Repeat mode, so that multiple commands will be sent to the TV while the button is pressed.
 
−
 
 
−
== Release Notes ==
 
−
=== 3.3.0 ===
 
−
*initial release version
 
  
 
----
 
----
  
  
−
''Samsung and Samsung Smart TV are either trademarks or registered trademarks of Samsung Electronics Co., Ltd.''
+
''Cradlepoint is a registered trademark of CradlePoint Technology, Inc.

Latest revision as of 18:43, 18 May 2015

The Cradlepoint driver for HSYCO allows you to monitor the real-time status of the Cradlepoint IBR6xx series of routers.

IO Servers Cradlepoint.png

HSYCO Configuration

Add a CRADLEPOINT I/O Server in the I/O Servers section of the Settings and set its parameters:

Communication

  • IP Address: LAN IP address of the IBR6xx router
  • IP Port: TCP/IP port to use for the SSH CLI (Command Line Interface), leave blank to use default port 22.

High Availability

  • Shutdown when inactive: defaults to false.

Options

ID Default Values Description
startupevents false true generate IO events also during the driver’s start-up phase
false start generating events only after HSYCO is aligned with the current status of the system
query /status/wan/connection_state /status/system/wan_signal_strength /status/wan/stats space-separated pathnames this parameter can be used to retrieve specific status data from the router. Use / to retrieve all data (note that using / the router will need several seconds to return all data, and the number of generated data points will be huge. You should specify the / full path only for development purposes

Datapoints

The status information that the driver retrieves from the Cradlepoint router depends on the pathnames defined in the query option.

Refer to the CRADLEPOINT Router CLI Overview document for the description of the file system structure and the list of valid directories. Each directory contains status information that this driver translates into standard HSYCO data points.

When no query option is explicitly set, the driver retrieves all data located in the following directories:

  • /status/wan/connection_state
  • /status/system/wan_signal_strength
  • /status/wan/stats


The following table lists the read-only data poins that are generated using the default query.


ID Value R/W Description
connection online R connection established
offline R HSYCO can't connect to the router
status.system.wan_signal_strength 0..100 R wireless WAN connection signal strength
status.wan.connection_state <status> R WAN connection status
status.wan.stats.bps <number> R WAN total throughput in BPS
status.wan.stats.collisions <number> R number of collisions on the WAN connection
status.wan.stats.ibps <number> R WAN input throughput in BPS
status.wan.stats.idrops <number> R wireless WAN input packets dropped
status.wan.stats.ierrors <number> R wireless WAN input errors
status.wan.stats.imcasts <number> R wireless WAN input multicast traffic
status.wan.stats.in <number> R wireless WAN total input bytes of current connection
status.wan.stats.ipackets <number> R wireless WAN total input packets of current connection
status.wan.stats.noproto <number> R wireless WAN total no protocol packets
status.wan.stats.obps <number> R WAN output throughput in BPS
status.wan.stats.oerrors <number> R wireless WAN output errors
status.wan.stats.omcasts <number> R wireless WAN output multicast traffic
status.wan.stats.opackets <number> R wireless WAN total output packets of current connection
status.wan.stats.out <number> R wireless WAN total output bytes of current connection
status.wan.stats.ts <number> R wireless WAN current connection time in seconds (ignore the decimal part)
command <command> W send a generic CLI command to the router. The <command> value is a text string exactly as specified in the CLI documentation
router reboot W reboot the router

Release Notes

3.5.0

  • performance improvements

3.4.0

  • initial release


Cradlepoint is a registered trademark of CradlePoint Technology, Inc.

Retrieved from "http://wiki.hsyco.com/3.5.0/index.php?title=Cradlepoint&oldid=5755"