QA/TDAI/NewFramework/DeviceCommands

StartPrg

• Protocol: Raw Sockets (telnet)
• Data Flow: TestAgent => Device
• Usage: StartPrg <prog_name>
• Ex: StartPrg '\firefox.exe -profile \testdata\testprofile -no-remote http://1.2.3.4:8888/tests/mytest.html'

• Questions:
  • Debugger connection - mention of this as a parameter?
  • will this be sync or async?
  • can we > or >> the output to a log file?

StopPrg

• Protocol: Raw Sockets (telnet)
• Data Flow: TestAgent => Device
• Usage: StopPrg <prog_name>
• Ex: StopPrg firefox.exe

• Questions:
  • should we do program name, or process ID?

Heartbeat

• Send unique id as payload

• Protocol: Raw Sockets (?)
• Data Flow: Device => TestAgent
• Usage: background only
• Payload: TBD

• Questions:
  • How will the TestAgent be listening?
  • Do we need a Registration Server?
    • How would this be listening?
  • What happens when TestAgent is down and can't recieve heartbeat?
  • What if networking is down on the device?
  • What is the payload

FileSend

• Protocol: Raw Sockets (telnet)
• Data Flow: TestAgent => Device
• Usage: FileSend <remoteFile>, data payload, close socket
• Ex:
  • 'FileSend \\tests\\fennec\\fennec.txt'
  • hello world
  • [close socket]

• Questions
  • is the close socket acceptable?

FileRecv

• Protocol: Raw Sockets (telnet)
• Data Flow: TestAgent => Device
• Usage: FileRecv <remoteFile>
• Ex:
  • 'FileRecv \\tests\\fennec\\fennec.txt'
  • [capture the reply]

• Questions
  • any issues with the size of data coming back for large or binary files?
  • is capturing the data returned reasonable?

FileDelete

• Protocol: Raw Sockets (telnet)
• Data Flow: TestAgent => Device
• Usage: FileDelete <remoteFile>
• Ex:
  • 'FileDelete \\tests\\fennec\\fennec.txt'

• Questions:
  • do we need to support regex: FileDelete \\tests\\*

DeviceInfo

• OS
  • Current OS & Version
• CPU
  • Type
  • Utilization
• Memory
  • Memory size
  • Disk space
  • Bytes free
• Programs running
  • List of currently
• Screen info
  • Height
  • Width
  • Bit Depth

Generate unique device id

• Use api on mobile
• Could use mac address on primary NIC

SendMsg

• Msg to send

RecvMsg

• Msg

Ping (RTT)

• Protocol: Raw Sockets (telnet)
• Data Flow: TestAgent => Device
• Usage: Ping <hostname/ip>
• Ex:
  • 'Ping 10.2.3.4'
• Returns an average rtt for 4 pings: i.e. 200ms

• Notes
  • this is intended to be used to calculate the latency for talos web pages being served remotely instead of locally.

SetEnvVar

• Variable name
• Value

SysAlert

• Sound
• Visual

SetServer

• Base server url

Other

API's that we have in our agent that are not listed above:

• exec [> file]
• fire [> file]
• run
• cat(q)
• mkdr
• rmdr
• cp
• mv
• ls
• ps
• rebt
• stat
• mems
• tmpd