Medialon MxMs' Help 
  
Name : Doremi Labs V1 & Nugget
Version : 1.0.3
Available for : Manager V5 (all versions), Showmaster (ST & Pro).
Limitation In :
Device Brand : Doremi Labs
Positrack Compatible : Yes
Resources type : UDP/IP Network or Serial
 
Compatible hardware interfaces - available resource modules (MRC) :
 

 

> Overview | > Installation (MXM) | > Creation (Device) | > Commands (List Of) | > Variables (List Of) | > Support


Overview :



Doremi Labs offers a range of MJPEG ,MPEG and uncompressed high quality video players and recorders. This MxM allows the control of Doremi Labs V1 or Doremi Labs Nugget machines.
This type of video recorder/player offers an interesting alternative to the standard analog video recorders.

The connection between the MXM and the device could be either a RS422
connection (Sony 9 Pin connector) or a Network connection (UDP/IP).

In addition to the standard VTR commands, this MXM provides Clips management function. Clips are named Segments in the Doremi V1 litterature (which is more closed to what a clip is, inside a V1) for single file machines and are named Files for multi files machines.
Single file machines are seems as a 24h virtual tape machine like a VTR whereas multiple files machines are seems as video file servers (multiple 24h virtual tape). In this last case, each file has a name (Clip name) composed by a maximum of 8 caracters.

In a single file machine a clip is a reference to a Timecode In and a Timecode Out position in the video contents (virtual tape). An important feature of clips in addition to "save" portions of video into memories, is to be able to link these clips in between seamless (back to back) and to create loops with them. NOTE : When clips are used, positack feature inside timelines is not relevant and cannot be used.

In a multi files machine, a clip is a file name combined with a Timecode In and a Timecode Out information. This means that multiple Clips can reference the same file but with different Timecode In and Timecode Out.

The MXM remains compatible with previous version of the V1 (single file), therefore some commands and variables have different behavior and/or meaning if the controlled device is a previous V1 (single file) or a new V1/Nugget (multi files). Those differences are explained in detail below.

IMPORTANT
: To be able to support multi files machines, 'Clip ID' has been changed to 'Clip Name' but if the machine is a single file one, the Clip Name MUST be a numeric ID (1 to 2047) otherwize commands using Clip Name will fail.

Synchronisation consideration :
In order to synchronize (frame accurate) two or more V1 (or Nugget), devices must have the same clock to garanty playback synch. The first device should be in "Internal Sync" synchronisation mode when others devices should be in "Synch In"
synchronisation mode.
To do ina V1 machine, go into the Main menu, item "Sync from" (N°2) and select appropiate synchronisation mode (i.e "Internal Synch for the first device, "Synch In" for others).

Device wiring :

When the device is used with a serial connection, the following wiring diagram could be used :

> Top


Installation (MXM) :

No special installation required.

> Top


Creation (Device) :

Device Creation Window :


When Serial Port Connection is used :

COM Port :
Com port number used to communicate with the device.

When Network Connection is used :

IP Address :
IP Address used to communicate with the device.

Channel :

Channel of the player/recorder inside the device. This is used when the V1 has 2 or more channels (player/recorder).


Start Time Code :
Timecode value of the first available image on the Device. This value is used for positrack purpose.

Fields per Frame:
Indicate the number of fields use per frame. This value must be set in accordance with the menu settings of the V1. In case of this menu is not available (for instance new firmware version 4.x), LCD display indicates F1/F2 when playback if two fields per frame mode is used.

> Top


Commands (List Of) :

Stop :

      Description : Stop the device currently in play mode or record mode.
      Parameters : no parameter.
Play :
      Description : Start playing video.
      Parameters : no parameter.
      Usage : This command start playing from the current position to the end of video contents. When clips are pending in the PendingClipList then the playback continue until the last clip is played.

Record :
      Description : Start recording video.
      Parameters : no parameter.
      Usage : The device must be configured to accept this command. In certain case the record capability of the device is disabled to increase best response time in play mode.
Step Forward :
      Description : Set the device position to the next frame (image) refering to the current position. If the device is playing, it will cause playing stop.
      Parameters : no parameter.

Step Reverse :
      Description : Set the device position to the previous frame (image) refering to the current position. If the device is playing, it will cause playing stop.
      Parameters : no parameter.
Fast Forward :
      Description : Perform a fast forward play on the device at the maximum speed.
      Parameters : no parameter.

Fast Reverse :
      Description : Perform a fast reverse play on the device at the maximum speed.
      Parameters : no parameter.
Locate :
      Description : Set the device time position to the specified position.
      Parameters :
      TimeCode : [Type : Time] : Time position to go to.

Variable Speed :
      Description : Cause the device to play in variable speed, forward or reverse.
      Parameters :
      Mode : [Type : Enum] : Variable speed mode.
          Availables values :
          "Var" : Basic variable speed.
          "Shuttle" : Shuttle variable speed.
          "Jog" : Jog variable speed.
          "Program Play" Program Play variable speed.
      Speed : [Type : Integer] : Percent of speed. This value could be negative (reverse play) or positive (forward play).
      For example a value of 50% start playing in forward direction at 1/2 normal speed, a value of 200% start playing in forward direction at 2x normal speed and a value of -200% start playing in reverse direction at
      2x normal speed.
Set Edit Mode :
      Description : Selection the edit mode of the device.
      Parameters :
      Mode : [Type : Enum] : Insert mode.
          Availables values :
          "Insert" : Insert Mode.
          "Assemble" : Assemble Mode.
      Video : [Type : Enum] : Select or de-select video edition.
          Availables values :
          "Off" : Video not concerned.
          "On" : Video concerned.
      Audio1 : [Type : Enum] : Select or de-select audio 1 edition.
          Availables values :
          "Off" : Audio 1 not concerned.
          "On" : Audio 1 concerned.
      Audio2 : [Type : Enum] : Select or de-select audio 2 edition.
          Availables values :
          "Off" : Audio 2 not concerned.
          "On" : Audio 2 concerned.
      TC : [Type : Enum] : Select or de-select timecode edition.
          Availables values :
          "Off" : Timecode not concerned.
          "On" : Timecode concerned.
Edit :
      Description : Enter or leave edit mode.
      Parameters :
      Command : [Type : Enum] : Command value.
          Availables values :
          "Off" : Enter Edit mode.
          "On" : Leave Edit mode.

Set TC Generator :
      Description : Select the start timecode value for the internal timecode generator.
      Parameters :
      TimeCode : [Type : Time] : Timecode value.

Set Start Timecode :
      Description : Change the timecode of the first availabe frame (image) on the device.
      Parameters :
      TimeCode : [Type : Time] : Timecode value.
Create Clip :

      Description : Create or modify a Clip in the V1 (if the clip already exists, it is loaded for record).
      Parameters :
      Clip Name : [Type : String] : Name of clip to be created or modified. If the device is a single file machine, this value is in range from 1 to 2047 otherwize if the device is a multi files machine this value is a name composed with max 8 caracters.
      In Time : [Type : Time] : Timecode in position for the clip.
      Out Time : [Type : Time] : Timecode out position for the clip.
      Usage : If the clip name does not exist then it is created else the clip parameter (In Time and Out Time) are changed.
      Rem : In a single file machine, if a timecode offset has been defined (i.e. using OPTION+IN Keys), current timecode position must be at least after the timecode offset value to allows clip creation.
      In a multi files machine each file is considered as virtual 24h video tape, so before In Time and after Out Time video is black.

Delete Clip :

      Description : Delete a Clip from the V1.
      Parameters :
      Clip Name : [Type : String] : Name of clip to be deleted. If the device is a single file machine, this value is in range from 1 to 2047 otherwize if the device is a multi files machine this value is a name composed with max 8 caracters.
      Usage : In a single file machine, deleting a clip does NOT mean that the video contents will be erased. Only the clip references (In Time, Out Time and Link attributes) will be erased.
      In a multi files machine video material will be erased.

Load Clip :

      Description : Load a Clip.
      Parameters :
      Clip Name : [Type : String] : Name of clip to playback. If the device is a single file machine, this value is in range from 1 to 2047 otherwize if the device is a multi files machine this value is a name composed with max 8 caracters.
      In Time : [Type : Time] : Timecode in position for the clip. This parameter has no effect on single file machines.
      Out Time
      : [Type : Time] : Timecode out position for the clip. This parameter has no effect on single file machines.
      Auto Play
      : [Type : Enum] : Enable to start playing directly after loading completed.

          Availables values :
          "Off" : Device wait for Play command.
          "On" : Device start to play after load.

Usage : In a multi file machine, LoadClip command reset all pending Clips and stop playback.

           

Link Clip :

    Description : Created a link between two clips in the V1.
    Parameters :
    Clip Name : [Type : String] : Name of clip to be linked. If the device is a single file machine, this value is in range from 1 to 2047 otherwize if the device is a multi files machine this value is a name composed with max 8 caracters.
    To Clip Name : [Type : String] : Name of clip to ne linked to. If the device is a single file machine, this value is in range from 1 to 2047 otherwize if the device is a multi files machine this value is a name composed with max 8 caracters.
    Usage :
    In a single file machine, linking two clips will cause the playback to swap from the first clip to the second clip seamless (back to back) when the first clip reach the end.
    If both Clip IDs are the same then a loop on the given clip is created.
    To create a loop between severals clips a link must be down before each clip as well as between the last clip and the first one. Ex Link 1->2 + Link 2->3 + Link 3->1 will create a loop including clips 1, 2 and 3.

    In a multi files machine, the 'To Clip Name' clip is added to the PendingClipList if the 'Clip Name' does not exist in the PendingClipList otherwize it is inserted after the 'Clip Name' clip in the PendingClipList.

Get Clip Info :

    Description : Retreive attributes from a Clip inthe V1.
    Parameters :
    Clip Name : [Type : String] : Name of clip to retreive informations from. If the device is a single file machine, this value is in range from 1 to 2047 otherwize if the device is a multi files machine this value is a name composed with max 8 caracters.
    Usage : In a single file machine, when this command is issued, the contents of variables "InTime", "OutTime", "CurrentClip", "PreviousClip" and "NextClip" are updated with the clip attributes.
    If the given clip name does not exist then the contents of those variables is set to 0.
    In a multi files machine, this command has no effect.

Get Clip List :

    Description : Retreive the list of clip already defined in the machine.
    Parameters : No Parameter.
    Usage : In a single file machine, this command has no effect.
    In a multi files machine, this starts the retreiving process. When the process is finished the ClipList variable is filled with the list of clips (the ClipCount variable contains the number of clips in the list).

Load Next Clip :

      Description : Load the next clip to be played.
      Parameters :
      Clip Name : [Type : String] : Name of clip to playback. If the device is a single file machine, this value is in range from 1 to 2047 otherwize if the device is a multi files machine this value is a name composed with max 8 caracters.
      In Time : [Type : Time] : Timecode in position for the clip.
      Out Time
      : [Type : Time] : Timecode out position for the clip.
      Usage : In a single file machine, this command has no effect.
      In a multi files machine, this add a new clip in the PendingClipList. When a play is ussued, the current clip is played then the clips into the PendingClipList are played.

Skip Current Clip :

      Description : Skip the current played clip.
      Parameters : No Parameter
      Usage : In a single file machine, this command has no effect.
      In a multi files machine, this command force the current played clip to reach its Timecode out position. If a clip is pending in the Pending Clip List then the next clip starts playing.

> Top


Variables (List Of) :

TimeCode :

      Type : Time.
      Description : Current time position of the device.

CurrentStatus:
      Type : Enum.
      Description : Current status of the device.
      Available Values :
        "No disk" : Device disk is not mounted or not present.
        "Tension release" : Should never be used. This is maintains for compatibility with Sony RS422 protocol.
        "Stop" : The device is in stop mode.
        "Still" : The device is in still mode (same state as Stop).
        "Play" : The device is playing.
        "Record" : The device is recording.
        "Forward" : The device is in fast forward play.
        "Rewind" : The device is in fast rewind play.
        "Locate" : The device is performing a time position.
        "Var Speed Still" : The device is in basic variable speed but at speed 0.
        "Var Speed Reverse" : The device is in basic variable speed, reverse play.
        "Var Speed Forward" : The device is in basic variable speed, forward play.
        "Shuttle Speed Still" : The device is in shuttle variable speed but at speed 0.
        "Shuttle Speed Reverse" : The device is in shuttle variable speed, reverse play.
        "Shuttle Speed Forward" : The device is in shuttle variable speed, forward play.
        "Jog Speed Still" : The device is in jog variable speed but at speed 0.
        "Jog Speed Reverse" : The device is in jog variable speed, reverse play.
        "Jog Speed Forward" : The device is in jog variable speed, forward play.
        "Program Play Reverse" : The device is in program reverse play.
        "Program Play Forward" : The device is in program forward play.

CurrentError :
      Type : Enum.
      Description : Last occured error.
      Available Values :
        "No Error" : No error.
        "Command Error" : The last command could not be completed due to unacceptable in this state or not supported.
        "Not Online" : The device don't respond, not online.

        "Invalid Clip Name" : The given clip name in invalid or does not exist.
        "Unsupported Command" : The command is not supported with this machine (i.e multi files machine command on a single file machine).

StartTimeCode :

      Type : Time.
      Description : Timecode of the first availabe frame (image) on the device.

      Rem : In a multi file machine, this variable is not used.


RemainingTime :

Type : Time.
Description : Free record space on disk in time (available time for record).
Rem :
In a multi file machine, this variable is not used.

ActiveDisk :

Type : Integer.
Description : Indicate if the device is single file (0) or multi files (1).
Rem :
This variable was used in previous version of the MXM to indicate the current mounted disk Id, but this information is no longer used in the V1 nor Nugget. The variable name & type has been kept for backward compatibility.

InTime :

    Type : Time.
    Description : In a single file machine, this variable indicates the timecode In of the clip which Name is in variable the "CurrentClip".

    In a multi files file machine, this variable indicates the timecode In of the clip which Name is in variable the "CurrentClipName".

OutTime :

    Type : Time.
    Description : In a single file machine, this variable indicates the timecode Out of the clip which Name is in variable the "CurrentClip".
    In a multi files file machine, this variable indicates the timecode Out of the clip which Name is in variable the "CurrentClipName"
    .

CurrentClip :

    Type : Integer.
    Description : Numeric name of current clip. This value is updated after each clip management command. These value does NOT reflect the current clip name in playback (if any).

    In a multi files machine, this variable is not used.

PreviousClip :

    Type : Integer.
    Description : Numeric name of the clip backward linked with the clip ID in "CurrentClip" variable. This value is updated after each clip management command.
    In a multi files machine, this variable is not used.

NextClip :

    Type : Integer.
    Description : Numeric name of the clip forward linked with the clip ID in "CurrentClip" variable. This value is updated after each clip management command. After a LinkClip command these value should reflect the parameter "To Clip ID" of this command.
    In a multi files machine, this variable is not used.

CurrentClipName :

    Type : String.
    Description : Name of the current loaded clip. This value is updated after each clip management command. After a LoadClip command these value reflect the parameter "Clip Name" of this command.
    When PendingClipList is not empty, this variable is automatically updated during playback to reflect the current played file.
    In a single file machine, this variable is not used.

ClipList :

    Type : String.
    Description : Contains the list of available clips on the device after a Get Clip List command has been issued.
    In a single file machine, this variable is not used.

ClipCount :

    Type : Integer.
    Description : Indicates the number of clip names in the ClipList variable.
    In a single file machine, this variable is not used.

PendingClipList :

    Type : String.
    Description : Contains the list of pending clips for playback. This variable is updated both when Load Next Clip/Link Clip commands are used or when a pending clip is swicthed to current played clip (CurrentClipName variable).
    In a single file machine, this variable is not used.

PendingClipCount :

    Type : Integer.
    Description : Indicates the number of clip names in the PendingClipList variable.
    In a single file machine, this variable is not used.

> Top


Support (Difference with previous versions) :

V 1.0.1:

  • Added: Support for Showmaster.

V 1.0.2:

  • Bug Fixed: a false "Serial Port Error" is reported when loading a project under Showmaster (if serial port is used by the device).

V 1.0.3:

  • Added: Support for Showmaster Pro.

> Top