Tesira Client
1 Interface
Tesira
Tesira-Number
Tesira-Response
TExpr
tesira?
tesira-number?
tesira-connect
tesira-send
2 Utilities
tesira-get
tesira-set
7.0

Tesira Client

Jan Dvořák <[email protected]>

 (require tesira) package: tesira

This library allows for basic communication with Biamp Tesira devices over their telnet interfaces. It implements message framing, but leaves all RPC specifics to the user.

It is strongly suggested to consult relevant materials freely available on Biamp’s website. Especially the Tesira Text Protocol specification.

1 Interface

syntax

Tesira

Type for tesira client object.

Type for tesira-compatible numbers. Currently an alias for (U Integer Inexact-Real).

Type for values obtained from the device.

syntax

TExpr

Type for arguments that can be passed to tesira-send. Very similar to JSON expressions, but not completely.

procedure

(tesira? v)  Boolean

  v : Any
Predicate identifying Tesira instances.

procedure

(tesira-number? v)  Boolean

  v : Any
Predicate identifying Tesira-Number values.

procedure

(tesira-connect host [port notify])  Tesira

  host : String
  port : Positive-Integer = 23
  notify : (-> Tesira-Response Void) = void
Connect to a remote device via it’s Telnet interface.

When a different notify function is given, it will be called every time an asynchronous notification arrives in the middle of a tesira-send call.

procedure

(tesira-send a-tesira alias verb attr arg ...)  Tesira-Response

  a-tesira : Tesira
  alias : Symbol
  verb : Symbol
  attr : Symbol
  arg : TExpr
Perform remote call and return the result.

The client object is locked for the duration of the call and any concurrent call will be blocked until the first one receives it’s reply.

2 Utilities

 (require tesira/util) package: tesira

Set of convenience function to simplify some typical tasks.

procedure

(tesira-get a-tesira alias attr arg ...)  TExpr

  a-tesira : Tesira
  alias : Symbol
  attr : Symbol
  arg : TExpr
Retrieve a single value.

procedure

(tesira-set a-tesira alias attr arg ...)  Void

  a-tesira : Tesira
  alias : Symbol
  attr : Symbol
  arg : TExpr
Modify a single value.