This document includes updated information for Release 2.7.1 of the
Osprey-1000 software and drivers.
For more information on the Osprey-1000 and other Osprey products,
visit the MultiMedia Access home page.
Contents
Drivers Set for 2MB
The drivers have been updated to default to the 2MB RAM configuration.
Previously, the drivers were configured for 1MB, even though the Osprey-1000
boards have been shipping with 2MB of RAM standard for nearly two years.
The old 1MB setting was a legacy to the old 1MB boards because the 2MB
setting would cause incompatibility problems evident by poor video.
If you are using an old board with 1MB, simply run the "Osprey-1000 RAM
Configuration" program found in the Osprey-1000 program group to set the
drivers to 1MB.
H.263 Microcode Updated
New microcode was added for H.263 that should provide a better picture
quality and better performance. This also allows PAL support for
H.263. Because this is new microcode, the current default settings
for H.263 may not provide the best image quality, so the user is encouraged
to try various settings in order to obtain a satisfactory image.
See Current Known Bugs and Conflicts for information
about known limitations.
Osprey-1000 Demo Changes
The Osprey-1000 demo will now default to raw (uncompressed) video,
QCIF size. Previously, it defaulted to raw CIF size. The video
window will automatically resize to CIF size. Use Edit -> Options
to change the image size.
H.320 Improved Output Timing
H.320 video output now has improved timing for both NTSC and PAL.
This will make the video output more "friendly" to VCRs and other external
equipment.
H.320 Echo Cancellation Option
H.320 will now ship with two versions of audio, one with Acoustic Echo
Cancellation (AEC) turned off, and the other with AEC turned on.
Users can select which version they want to run on a per device basis with
an INI file change.
Updates for G2 Codec
The Osprey-1000 drivers have been updated to support hardware encoding
with RealNetworks RealProducer G2. This is enabled via a separate
software package, "Osprey-1000 G2 Codec", which can be purchased from MMAC.
Tcl/Tk Control Panel added
A control panel built using Tcl/Tk and our Osprey-1000 Programming
Interface (OPI) has been added to Release 2.7.1. With the purchase
of the developer's kit, you will get the source code to this control panel.
Bugs and Conflicts Fixed
in Release 2.7.1
G.723 Startup Bug Fixed
Previously, G.723 would occasionally fail when starting to play or
record. Upon failure, G.723 would not work until the machine was
rebooted. The failure was due to uninitialized memory on the DSP
and an invalid flag being set within the DSP firmware. This has been
fixed in the DSP for Release 2.7.1.
Video Slicing fixed
The video slicing problem with the Osprey-1000 not synching video capture
with copying video out of the kernel has been fixed via a new setting in
the VPIC.
YVU9 Format Display
The YVU9 video format was being displayed improperly, causing flourescent
colors instead of proper RGB. This has been fixed and the YVU9 format
should now display properly.
H.320 PAL Window Frame Sizing
H.320 window frame sizing has been modified to allow the whole PAL
image to be viewed in the PC window. Previous releases cropped the
PAL image to NTSC size.
H.263 Display in Osprey-1000 Demo
H.263 display has been fixed in the Osprey-1000 Demo. The draw
library was updated to properly position the video.
Miscellaneous
See notes at the top of Current Known Bugs and Conflicts
for information on audio issues.
Video Capture Driver:
The Video Capture Driver supports CellB (ICLB), two packetizations
of H261 (IP64 and H261) and several uncompressed capture formats (RGB 24-bit,
RGB 8-bit, RGB555, RGB565, YVU9, YUYV). Switching between them is done
using the Setup option on the Drivers applet of the control panel or the
Format menu. The "H261" packetization support is still experimental, does
not support hardware decode, and probably should not be used.
H.261 self-view is supported with Overlay, Preview, or through PIP support. The Source menu can be used to enable Picture-In-Picture to provide a self-view during H261 decode. PiP is active when both sending and receiving video. When only receiving video, the self view PiP box will appear blank.
H261 Bitrate and Max Quantization can be changed dynamically while the driver is open through the Format menu, or through the Drivers applet. Frame rate can be changed dynamically through standard Video for Windows interfaces. Other parameters (size, compression, etc) require stopping the video driver and restarting it (e.g. under Communique, this means closing the TV Tool and reopening it).
To counteract packet drop in lossy networks, the period at which H261 macroblocks are replaced with intra-coded blocks can be set through the Format menu or through the Drivers applet for the Video Capture Driver via the setting: "Intra Block Refresh Period". The shorter the refresh period, the sooner bad video blocks will be updated (at the expense of compression ratio).
With the Osprey G2 Codec, G2 hardware compression with a MultiMedia Access provided version of the RealProducer G2 is supported.
With Iterated's ClearVideo Live, the CVLive Fractal codec is supported.
H263 has been updated in Release 2.7.1 for improved video quality and performance. PAL support has been added.
H261 CIF and QCIF sizes are supported.
CellB CIF and QCIF sizes are supported.
Uncompressed CIF and QCIF sizes are supported.
PAL support has been added in release 1.1 (Windows 3.1/95 only).
Installable Compression Manager (IP64)
The ICM supports playback of IP64 bitstreams.
The ICM supports displaying IP64 in either the true aspect ratio (default) or stretching it to fill the entire 288 lines. This parameter can be changed through the Drivers applet.
The Osprey-1000 can only decode one stream at a time. In order to provide multi-way conferencing, you must use a SW decompressor supplied by another vendor. Under Communique, this SW decompressor is called IP64_32.dll and can be entered through the IP64 Selection program, or the configuration box for the ICM available through the Control Panel's Drivers applet. If you use HW only decompression, and try to decompress multiple streams, the video bitstreams will be interleaved and you will see blocks from both streams in each window.
Insoft's Communique! does not provide a H.261 software decompressor for Windows 3.1.
Demos
The Osprey-1000 demo shows H261, H263, and passthrough video. In Release
2.2 and greater, the Osprey-1000 demo under NT now defaults to 16-bit mode.
You can also set bit rate and quantization for the H.261 and H.263 formats.
Osprey RAM Configuration program
The Osprey RAM Configuration program allows the user to configure the
Osprey software to properly utilize the amount of RAM on their Osprey-1000
board. The standard Osprey-1000 board comes with 1MB of on-board RAM. You
can purchase an Osprey-1000/2 board with 2MB of on-board RAM. The program
prompts for the amount of RAM, and then configures ini files (and a registry
setting under Windows NT).
As noted in the program, do not select the 2MB configuration unless you are certain you have an Osprey-1000/2 board. Doing so with a standard board with 1MB of RAM can have an adverse affect on the functionality of the Osprey software.
Audio/Video Mixer
The program oti1kctl.exe has been installed into the directory chosen
during installation. For audio, you can use this program to select input
and adjust volume, gain and mixing (mixing sends the audio input directly
to the audio output). For video, you can control contrast, brightness,
hue, video input, and video gain. In addition, you can use the mixer to
send the video output to the NTSC output jack on the card. Output can not
be sent to NTSC out and the computer monitor simultaneously. The mixer
may also be used to select PAL instead of NTSC input.
The mixer stores settings in the current user's section of the registry. The Osprey-1000 will load the settings the next time an application opens the drivers. The mixer will also dynamically control the Osprey-1000 if any application is currently using it.
If an application opens the Osprey-1000 and does not close it before shutting down, the Osprey-1000 will continue to run, but the mixer will not dynamically change the settings on the Osprey-1000. For example, our demo program will loop through audio whenever raw video or H.261 is displayed. However, our demo does not close the Osprey-1000, so audio will continue to loop through after the demo application is closed. After the demo has been closed, the mixer will not affect the Osprey-1000 until another application opens the Osprey-1000 again.
Video Output Selection
H261 video capture and decode viewing (both CIF and QCIF) may optionally
be redirected to analog NTSC video at the "Video Out" connector of the
Osprey-1000 card. The Osprey-1000 Control Panel applet provides a Video
Output section which allows toggling of video output between an application
window and analog NTSC video output. The application program must be restarted
for a change to video output to take effect. When video is redirected to
NTSC, the application window may continue to display a frozen view from
its video input source, or it may simply show a plaid test pattern.
Some video capture devices may not be able to gen-lock to the analog video output produced by the Osprey-1000 (the SunVideo card, for example). If you experience this problem, try editing the H261.INI file: replace the contents of the [VIDOUT.BT.NTSC] and [VIDOUT.BT.PAL] sections with the contents of the [VIDOUT.BT.NTSC.MASTER] and [VIDOUT.BT.PAL.MASTER] sections, respectively. This will cause the Osprey-1000 to generate interlaced video output with sync. timings which may be more acceptable to some video capture devices.
H.263 video capture also supports NTSC video output.
Raw video capture under the Osprey-1000 Demo does not support analog NTSC video output.
The Osprey-1000 does not support simultaneous PAL capture and analog NTSC video output.
Video Input Selection
H.261 and Cellb capture and compression may be obtained from a PAL
source instead of NTSC. The Osprey-1000 Control Panel applet provides a
Video Input section which allows toggling of video input between NTSC and
PAL. The application program must be restarted for a change in video input
to take effect.
SW and HW decoding
An applet is provided to swap between a software IP64 decoder, a HW/SW
strategy, and the HW only decode provided by the Osprey-1000 card. A user
needs to use the SW decoder or the HW/SW version to enable a multiway conference.
Passthrough (Raw) Video
The width of passthrough video has been changed to 320. When running
the Osprey-1000 Demo in passthrough mode, you may notice a black or green
bar on the right side of the image. This is due to the new size of passthrough
video and the fact that the Osprey-1000 Demo is set for a CIF-size width
of 352.
Audio Compression Manager
The audio compression manager supports PCM (8-bit and 16-bit), G.711
(mu-law and A-law) in mono and stereo at sampling rates from 8kHz to 44.1
kHz. It also supports G.722 and G.728. Support for G.711, G.722 and G.728
may be enabled/disabled through the Control Panel's Drivers applet. All
audio parameters (compression type, sampling rate, number of channels)
must be the same when performing simulataneous recording and playback.
G.723 is new for Release 2.1, and is available for all versions of Windows. G.723 and G.722/G.728 are mutually exclusive. The ACM Configuration Dialog box by default has G.722/G.728 enabled. Enabling G.723 disables G.722/G.728.
G.723 has two formats, 5.3 kbps and 6.3 kbps. The Microsoft format box will list them as 0.667kHz, 8 bits per sample, and 0.800kHz, 8 bits per sample, respectively. It is recommended that you use the 6.3 kbps format.
PCI Info
In order for the Osprey-1000 to function, PCI bus mastership must be
enabled on the slot that the Osprey card is plugged into. On some platforms,
the user must enable this themselves via the boot bios setup of the host
machine. Also, you may need to disable bus mastership on other PCI bus
slots.
If you get a parity error in booting with the Osprey-1000, please check your BIOS settings for a setting that allows disabling parity on the PCI slots.
Performance
Note that performance is highly dependent on the video drivers and
video card used. We suggest contacting your video card manufacturer to
see if they have updated drivers for your card. We have seen a 20% difference
in performance between the S3 compatible driver installed under NT and
the Diamond supplied driver on their Web Site. We have also seen a significant
difference between video cards when trying to perform scaling.
Additionally, graphics performance in NT 3.51 and current versions of NT 4.0 is very poor. Thus, in some respects, video performance of the Osprey-1000 on NT is limited due to limitations in the NT graphics subsystem itself. Raw NT graphics performance should improve considerably with the addition of DirectDraw under Windows NT 4.0 and beyond.
Current Known Bugs and Conflicts
H.263 is limited to 192kbps, even though the video capture driver will allow higher bitrates (up to 1024kbps) to be set.
Overlay video is not supported with H.263 in this release.
For Windows 95/98, H.263 supports streaming video only, no preview or overlay. If you run the VidCap application, you will be able to capture an H.263 stream, but you won't be able to preview it. The VidCap window will be black.
For H.263 decode, the local view initially may be displayed for a short time before the hardware switches to decoding/displaying the far view. The user may also notice an inverted frame displayed initially before the video appears.
H.263 decoder in the hardware currently requires an H.263 intra frame before it will start to decode H.263. until this intra frame is found, the hardware will not start decoding H.263. This is an issue for broadcast of H.263 data in which the initial key frame is lost.
There is a problem with audio playback via the Osprey-1000. If your Osprey-1000 is used for playback, there may be a delay between the audio and video streams, causing an audio lag. This does not occur during record, and if you are using a standard sound card for playback, there will be no audio lag.
YUYV video format has some display problems. In some cases, it may appear that the red and blue components are swapped.
Under Windows 95, the installation directory must use a short pathname. This is detailed during installation, and the install script should force the user to assign a destination directory less than 12 characters in length.
G.723 audio does not work if you pass it unusually large buffers. It will stream data, but the data will not contain audio. Unusually large buffers are buffers larger than 600 bytes, which translates to over 1 second of data. Normal buffer sizes for G.723 are 40-120 bytes.
If you have echo cancellation turned on and you overdrive the input, the audio will sound very bad, with a sound somewhat like a beeper going off in the background. Without echo cancellation turned on, overdriving sounds as expected.
With the change from 1MB to 2MB onboard memory standard on Osprey-1000 boards, a change was made to the firmware to handle double-buffered images in the extra memory. Because of this change, local views after a single image decompression do not update properly. Thus, the local view may appear to be stopped in some applications, such as VIDCAP32, when displaying local overlay views. The local view will resume updating when compression is resumed. If you must display overlay views while performing single-frame capture, then you may reconfigure the Osprey-1000 to utilize only 1MB of onboard memory via the Osprey-1000 RAM Configuration Program (osp2cfg.exe), found in the bin subdirectory of the Osprey-1000 software installation. Note that with onboard memory set to 1MB, video decompression may proceed at a slightly lower frame rate.
The uninstaller currently may leave some files on the system. While this is not a problem if you plan on reinstalling or installing a new version of the software, it may be a problem if you are trying to clear the Osprey files from a system. If you wish to make sure all files are deleted after an uninstall, you will need to do the following:
Acoustic Echo Cancellation (AEC) is for use with voice data only. If it is used on music, it can cause distortion problems.
Currently, the demo and the IP64 decoder set up the Osprey-1000 hardware to constantly DMA video out to a memory buffer which is then copied for DrawDib operations. On one machine with old video drivers, this has been shown to cause problems with the entire display (random color speckles). If this problem appears, try running the demo with the draw on demand option selected (under the MISC menu). This will cause video to be dma'd from the Osprey-1000 only when desired for a DrawDib operation.
Application specific problems may also be listed below under the Application Specific Infomation section.
If DCI is enabled, decompression to a memory buffer is not supported. This means that some programs (AVIClip in VFW development kit, for example) will only work when DCI is disabled.
The IRQ used by the Osprey-1000 is assigned by the Power-up & Self-test (POST) sequence of the BIOS when the system is booted and is not reassignable by the user. The assigned IRQ may conflict with some PCI Ethernet cards which assume a certain IRQ asignment, typically causing failures in either or both cards. This problem may usually be resolved by doing one or more of the following: (1) reassign the Ethernet card IRQ via the Adapter Card Setup in the Control Panel Network applet; (2) obtain updated I/O drivers from the Ethernet card manufacturer; or (3) swap Ethernet card and Osprey-1000 card expansion slots.
See the Osprey 1000 User's Guide Troubleshooting Section for more information on IRQ conflicts.
Occasional & random failures have been observed when the Osprey-1000 card is installed in a system with an ATI PCI graphics adapter card. This problem has usually been resolved by doing one or both of the following: (1) obtain updated graphics adapter I/O drivers fromn ATI; (2) swap graphics adapter and Osprey-1000 card expansion slots.
If you have another audio device installed (such as a Sound Blaster) and your application does not allow you to choose which audio device to use, select the Osprey-1000 as the preferred device via the Control Panel Sound Mapper or Multimedia applet (depending on OS). If you still have trouble mapping to the Osprey-1000 device, then also check the "Use Preferred Device Only" check-box.
The H320 application in Release 2.2 and greater is incompatible with the H320 application in previous releases. See the H320 section below for more details.
Multiboard Support:
Release 1.3 added support for multiple Osprey-1000 boards installed
in the same computer, but with the restriction that each board had to be
associated with a single separate process. Release 2.1 removed the restriction
- a single process may simultaneously access all Osprey-1000 boards present.
The software has been tested with eight Osprey-1000 boards. No special installation procedure is required; the Osprey-1000 kernel driver detects multiple boards at startup. The boards are numbered "Board 1", "Board 2", etc., in the order in which NT detects them. You must empirically determine which board has which number.
A simple way to verify a two-board installation is to run start two copies of the DEMO applet. DEMO now includes a menu selection called "Board 2" to associate the given copy of the applet with the second board. Enable "Board 2" for one of the two copies. Each DEMO will display video from its associated board.
The low level audio and video parameters that are controlled by the Osprey control panel applet are individually settable for each installed board. When multiple boards are installed a board select combo box appears in the applet, and your selection determines which board the current settings apply to. You can run two DEMOs as above along with one copy of the control panel applet. You will be able to control brightness, contrast, etc., separately for the two boards, and the final settings will be saved separately to the registry. It should also be mentioned that the registry keeps this information on a per-user basis as well as a per-board basis.
The Video Capture Driver, Installable Compression Manager, and Audio Compression Manager all support multi-board installations. All of these these have a board select combo box in their configuration dialogs (accessible through the system control panel ... drivers .. setup function) so that different settings can be saved for different boards. Higher level multimedia applications that attempt to simultaneously access more than one Osprey system will successively access board 1, then board 2, etc.
NOTE: On some systems, after installing the Release with multiple boards, the system may hang during reboot without any error messages. If the system is reset (via the reset button), it will reboot and come up properly. This may happen only after the first reboot after the software is installed, or it may occur on all subsequent reboots. The workaround is to press reset if the system does not come up.
Installable Compression Manager (Other)
ICM decompressors have been added in 1.3 for ICLB and YUYV formats,
and in 1.4 for H.263 formats.
Performance
Note that performance is highly dependent on the video drivers and
video card used. We suggest contacting your video card manufacturer to
see if they have updated drivers for your card. We saw a 20% differerence
is performance between the S3 compatible driver installed under NT and
the Diamond supplied driver on their Web Site. We also saw a significant
difference between video cards when trying to perform scaling.
Additionally, graphics performance in NT_3.51 and current versions of NT_4.0 is very poor. Thus, in some respects, video performance of the Osprey-1000 on NT is limited due to limitations in the NT graphics subsystem itself. Raw NT graphics performance should improve considerably with the addition of DirectDraw under Windows NT 4.0 and beyond.
DirectDraw
With Release 1.4, hardware drawing from the Osprey-1000 directly to
the graphics adapter via Microsoft's DirectDraw is supported on Windows
NT 4.0. DirectDraw provides for optimal data transfers directly from video
capture and codec devices to the display device, but is not supported by
all graphics adapters.
To successfully use DirectDraw with the Osprey-1000, you must have a graphics adapter and related I/O driver that support DirectDraw. The Windows NT 4.0 distribution provides drivers with DirectDraw support for many major brands (we have tested the ATI Mach64, Diamond Stealth64 Graphics 2000 & Video 3000, and the Number Nine 9FX Motion 771). In some cases, you may need to obtain the latest I/O driver from the adapter manufacturer to enable DirectDraw support (for the Diamond Stealth 3D 2000, for instance). Your graphics adapter must support 16-bit color (65536 colors at the desired screen resolution). You will need a minimum of 2MB of onboard memory to properly support hardware drawing from the Osprey-1000, and at least 4MB for 16-bit display resolutions above 800x600.
The Win32 SDK and the DirectX 2 SDK from Microsoft provide a tool (DXVIEW, the DirectX Viewer) to display the DirectX capabilities of your system (DirectDraw is a subset of DirectX). As a minimum, your display adapter must show support under the DirectDraw Devices / Primary Display Driver folder for BLT under General Caps, OFFSCREENPLAIN & PRIMARYSURFACE under Surface Caps, and SRCCOPY under ROPS. BLTSHRINK & BLTSTRETCH under FX Caps are also desirable capabilities (supported by the 9FX Motion 771, for one).
If your graphics adapter supports the above minimum requirements, then you may enable it for video capture and decompression by the Osprey 1000 device by checking the "Use DirectDraw" check-box on the Osprey-1000 Control Panel. You must also set your Color Palette to 65536 Colors via the Settings tab of the Display Properties on the Windows NT 4.0 desktop. With these settings, the Osprey-1000 video capture driver, decompression portion of the video codec, and misc. demos. will attempt to use DirectDraw for their display window output. DirectDraw support will thus also be made available to those applications that query for and utilize Video-for-Windows hardware drawing capabilities. Stretch & shrink capabilities will also be made available if supported.
We suggest that you try running and observing the Osprey-1000 Demo. in 16-bit mode with DirectDraw enabled as described above to determine whether your configuration meets the minimum requirements for DirectDraw. If the demo. is not successful in obtaining the necessary DirectDraw resources, you should see a pop-up message box describing the failure. After you OK the message, the demo. will fall back to DIB drawing mode and continue. The pop-up message will also appear for other applications using the Osprey-1000 under Video-for-Windows if they fail to initialize when DirectDraw is enabled. Fall-back behavior in those cases will be as implemented by the application. You may suppress the pop-up messages for DirectDraw failures by resetting the "PopupOnError" variable in the Software/Osprey/Osprey1000/Device0/DrwDll/Settings folder in the Windows NT Registry key for the current user.
Some support is also provided for 8-bit color (256 colors), but the display adapter color palette may not be properly loaded by the Osprey-1000 libraries in some cases. We suggest that you try running and observing the Osprey-1000 Demo. in 8-bit mode (256 colors) with DirectDraw enabled to determine whether color palettizing is properly supported for your display adapter.
Due to hardware and software limitations, the Osprey-1000 cannot gracefully support hardware and non-hardware drawing modes simultaneously. Thus, when hardware drawing is enabled, all non-hardware decompresses WILL FAIL. If you do not see proper video in your application when you have hardware drawing enabled, turn off hardware drawing.
DirectDraw is not currently supported by the Osprey-1000 on Windows 95 and Windows NT 3.5x.
Miscellaneous
Some initialization is still done through global .ini files instead
of the registry. Parameters controlled by the mixer are set on a per-user
basis.
To draw to the display the Osprey-1000 kernel driver needs to acquire a block of non-paged memory. It acquires this when NT boots. The installation script modifies the registry to increase the non-paged pool size to allow DMA of video data from the Osprey-1000. In the demo, if you get the message "OpenMemDMA Failed" it is because the driver was not able to acquire enough memory to dma video data from the hardware. Try rebooting your system if this occurs.
During an uninstall, it is possible that some registry settings may not be removed. The install will not reset values that were changed while the software was installed. For example, if you modified the audio settings from the Osprey Control Panel, uninstalled, and then reinstalled, it's possible the changes you made will still be shown in the Control Panel. To ensure a clean install, you can go through the registry and search for the key "oti1k" and "osprey", and delete any references you find.
Windows 95 Specific Information
DCI
Using DCI can provide a significant performance boost. However, some
machines/driver combinations do not work properly. If you have enabled
DCI and encounter any problems with video lockups or bad video, turn off
DCI.
Due to hardware/software limitations, it is impossible to support DCI for video overlay and decompression to a memory buffer simultaneously. In order to provide the best speed support for applications which can benefit from DCI, we do not support decompression to a memory buffer if DCI is checked. This means that some programs (AVIClip in VFW development kit, for example) will only work when DCI is disabled
Audio Compression Manager
The audio compression manager supports 8-bit and 16-bit PCM and G.711
(mu-law and A-law) in mono and stereo. Currently, compression and decomporession
formats must be the same. G.711 support may be enabled/disabled through
the Control Panel's Drivers applet.
New 32-bit Application
With Release 2.4, the Windows 95 version of the Osprey software has
updated drivers to handle the mixture of 16-bit and 32-bit applications.
The new H320 Demo is the only true 32-bit application that we ship with
the Windows 95 software. The other demos, because they use Video
for Windows, are 16-bit. Therefore, if you did not purchase an H320
package from Osprey and are not planning on using the H320 demo, the Windows
95 software will essentially be the same.
The main change that will be obvious to users is that there will be two Osprey-1000 Control Panels installed. One will be a 32-bit version for use with H320, and the other will be the standard 16-bit version. This is necessary because you can not have the 32-bit H320 Demo running and open the 16-bit Control Panel. This holds true in reverse, you can not have one of the 16-bit demos running and open the 32-bit Control Panel. The Control Panels will be clearly marked. If the wrong one is selected, you will simply be warned via an error message.
If you are running the H320 Demo, make sure you use the 32-bit Control Panel. If you are running any other Osprey demo, use the 16-bit Control Panel.
Known Problems
During uninstall, an entry for vao.386 may not be removed from the
WINDOWS\system.ini file. Also, an entry for the file oti1kdrv.vxd may not
be removed. After uninstalling the Osprey software, you may have to remove
these entries by hand.
General Information:
There is beta support available for Videoserver Connections V.25 (DDM)
board. It is not enabled in Release 2.6, but beta testers may enable
it via changes to INI files provided by Osprey Technologies. This
support is for VsC Release 5.2.0.6.
H320 is now available for all the Windows versions of the Osprey-1000 software. To use H320, a Videoserver Connections ISDN card is required, available through purchase of the Osprey-320/2 or Osprey-320/6 package. If you do not have the ISDN card, you will only be able to view a local raw image with the H320 demo.
Also added is the H320 Configuration program. This program allows the user to make the necessary changes to H320 and Promptus ini files without having to edit the files by hand. The program can be run during installation or after by selecting the H320 Configuration program icon in the Osprey Program Manager Group. See the Osprey-1000 User's guide for details on running this program, and the Osprey H320 User's Guide for information on the data required.
Supported features:
Audio: G.711 A-law, G.711 u-law, G.722, G.728 (all with AEC)
Video: NTSC video displayed in a window, or to composite output
H.261 with Picture-in-Picture
Videoserver Connections:
BRI-2 ISDN interface (2 B-channels, 1 D-channel) (2B+D)
BRI-6 ISDN interface 3 x (2B+D) with/without IMUX
North American telephone
switch support:
BRI - AT&T 5ESS
BRI - Northern Telecom DMS100
BRI - U.S. National ISDN - 1 (some areas of Canada)
Outside North America telephone
switch support:
BRI - Australia
Multiboard Support:
As of Release 2.1, the Osprey-1000 H320 DLL library and Demo. Application
Program support multiple pairs of Osprey-1000 and Videoserver Connections
BRI boards on Windows NT. Support for eight pairs has been tested on an
industrial PC, however most commercially available computers typically
will have slots available only for two pairs (each pair requires one PCI
slot and one full-length ISA slot).
Specific Osprey-1000/Videoserver Connections pairs are addressed via the subsystem argument to the H320 DLL library functions, and are indexed starting from zero. You must add Device# sections to the OTIH320.INI and OTI320DM.INI files and a MODULE # section to the PROMPTUS.INI file for each pair added beyond the first pair. This is done either at initial Osprey-1000 software installation or subsequently via the H320 Configuration applet in the Osprey Program Manager Group. A unique IO_Base must be specified for each Videoserver Connections BRI board installed (a single IRQ may be shared by all Videoserver Connections boards).
Index ordering of successive Osprey-1000 boards is determined by physical slot placement in the PCI bus. Please consult your computer manufacturer's documentation to determine actual slot ordering. Alternatively, you may determine index ordering experimentally by directing the Demo. App. to use a specified subsystem, then running the Demo. App. and observing its display window while attaching a video source to successive Osprey-1000 boards until the board corresponding to the current index is identified. Index ordering of Videoserver Connections boards is defined by setting the I/O base address of the board to the corresponding IO_Base parameter specified in the MODULE # section of the PROMPTUS.INI file (physical slot placement is immaterial). Once the subsystem index of an Osprey-1000 board is established, it must be paired with the like-indexed Videoserver Connections board via a 40-conductor cable between MVIP connectors on the boards.
On Windows NT, the H320 Demo. Application Program will detect the number of Osprey-1000/Videoserver Connections pairs present and will select between a SDI (single-document interface) and a MDI (multi-document interface) presentation accordingly. In the MDI mode of operation, the video image from each subsystem will be displayed in a separate child window within the main window of the application. The child windows may be cascaded or tiled, and they may be resized individually. Menu and toolbar actions are applied to the subsystem whose display window currently is selected. The Demo. App. also supports loopback testing, where one subsystem can be used to call another.
The H320 DLL library is thread-safe on Windows NT for simultaneous operations on separate subsystems, with one exception - because of a limitation in the underlying Videoserver Connections DLL, calls to the H320_Start function for different subsystems must be performed in serial fashion, with no overlapping operation. On Windows NT, the H320 Demo. App. uses separate threads to perform operations such as call initiation and termination to demonstrate threading of the H320 DLL library for multiple subsystem support. The H320 DLL library is also thread-safe on Windows NT for attempted simultaneous operations on the same subsystem, although most such attempts will result in a COM_SUBSYSTEM_LOCKED error return for subsequent threaded calls while a threaded request is in progress.
Future additions:
T.123
Expanded international telephone switch protocols
Videoserver Connections PRI
Not supported:
Videoserver Connections BRI-2 does not support IMUX.
Known problems:
Audio output via the Osprey-1000 Wave Driver is not supported during
a H320 session, during which attempts to perform wave file output to the
Osprey-1000 (either from another application or an attempt to play a system
sound in response to a Windows event) may cause its video output to scramble
and may also cause the device to become unresponsive. If this happens,
the Osprey-1000 device may be recovered by re-starting the application
and downloading the Osprey-1000 firmware again. This conflict may be prevented
by disabling the Osprey-1000 Wave Driver (on Windows 95, for instance,
check the "Do not use audio features on this device" button on the properties
sheet of the Osprey-1000 Wave Driver accessed via the Advanced tab of the
Multimedia Properties applet of the Control Panel) while you are using
the Osprey-1000 device for H320 conferencing (this will not affect the
audio of the conference, since H320 audio does not use the Wave Driver).
Re-enable the driver afterwards if you use the Osprey-1000 to play system
sounds or to run other applications such as Osprey NetDemo. You may avoid
most conflicts by simply disabling system sounds (on Windows 95 and Windows
NT, for instance, by selecting "No Sounds" from the Schemes list of the
Sounds applet of the Control Panel), however this will not prevent applications
running simultaneously with H320 conferencing from attempting to play wave
files. On Windows NT, the H320 application will take precedence, and attempts
to perform wave file output by other applications will be ignored during
the H320 session, with no effect on Osprey-1000 performance.
The H320 application in Release 2.2 is not compatible with previous versions. If one tries to connect the 2.2 version of H320 with a previous version, it may report that all lines are connected, but in reality only one will be connected. If you have version 2.2 and you call another system running the Osprey H320 application and the connection doesn't seem right, check to make sure the other system is running Release 2.2.
The MVIP connector to connect the Videoserver Connections board is not keyed as shown in the manual.
Problem Resolution:
Symptoms:
Application Specific
Information
In Release 2.0.1, NetDemo (version 2.0.4) has been updated to use seperate threads for audio and video socket streams. In exchange for this performance modification, this version of NetDemo will not work with previous versions.
The Audio pull-down menu has also been modified to include an "Enabled" selection for enabling or disabling audio.
The "Send Only" and "Receive Only" options are now working in Release 2.2.
Picture in Picture (PIP) has been added to the Video pull-down menu so you can enable PIP and select its location in the video window.
When running the Network Demo (NetDemo) under Windows 95, the Video Format pull down menu does not work. To select a video format, you must go to the Windows Control Panel and select Multimedia. From there, go to the Advanced folder and look under Video Capture Devices for the Osprey-1000. Select it, and the select "settings" to get the video format window. Once you've selected the desired format, click OK and exit Multimedia. Now you can run NetDemo with the format you've selected.
You can now select 24-bit RGB as a video format for the Osprey-1000. For RealVideo encoding, use 24-bit RGB or RGB555 as the video format. Set a custom size of 176 x 144, and the Aspect Ratio to SQR (Square).
You may also use audio from the Osprey-1000 with RealVideo.
Use YVU9 or RGB555 as the capture format. Precept will convert this to 4cc H261 format video.
4cc H261 hardware support is still experimental and should not be used.
Before installing Netmeeting, set the Osprey Video Capture Driver to RGB555 or RGB 24-bit format, size QCIF. Then install Netmeeting. By setting the driver format first, Netmeeting can accurately test the video capture card. If you do not set this format before installing Netmeeting, it may not be able to get the proper video from the card and may report that it can not use the video capture device.
During installation or when running the Audio Tuning Wizard, Netmeeting may report that the Osprey-1000 is not a supported audio device and that audio may not work. You may ignore this error as audio does work between the Osprey-1000 and Netmeeting. If you are having problems getting audio to work, go to the Tools menu, select Options, and go to the Audio tab. Check the box for "Enable full duplex audio...", and then click the Advanced button. Select the compression option "Microsoft ADPCM, 8.000 k", and click the "Up" button to move it to the top of the list. Exit this setup and try audio again.
There are no special requirements in terms of setup for the Osprey-1000 to run the NetShow player. However, in order to run the ASF Realtime Encoder, you will need to configure the Osprey-1000 for RGB555 or RGB 24-bit video format before running the Encoder. By default, the Osprey-1000 software installs with H.261 as the video format. There is a bug in the Osprey driver that causes the ASF Encoder to crash if it is run with H.261 as the video format when it is set for HW-only compression. The crash will only occur once, and on subsequent runs of the Encoder, it will work fine. Setting the Osprey-1000 to RGB555 or RGB 24-bit avoids this initial crash.
Video Settings
Use RGB 8-bit, 16-bit, or 24-bit (RGB 8-bit, RGB 555, or RGB 24-bit) as the capture format. Check the cuseeme.ini file in the windows directory. Under [Compressor Settings], make sure CompressorType is set to SFMC. Under [Capture Settings], make sure CaptureDepth is set to 8, 16, or 24 depending on the RGB format selected.
The Cornell version of CU-SeeMe requires RGB 8-bit capture format, 256 grays, and the Invert Palette option.
Audio Settings
Recent updates have been made to improve audio with White Pine's Enhanced CU-SeeMe. Osprey recommends selecting the Delta-Mod compression codec in the CU-SeeMe Audio Preferences. Full Duplex should be checked, and Echo Reduction should not.
Known Problems
If the video codec format is not set to RGB before running, the White Pine version of CU-SeeMe may have difficulty running and the process may cause a page fault. To set the video format before running CU-SeeMe, bring up the Control Panel, and select drivers. Double click on the Osprey Video Capture Driver and it will give you the format panel. Change to the desired format and close. CU-SeeMe should then run without problems.
To change the video format using Windows 95 or NT4.0, bring up the Control
Panel and select Multimedia. Go to Advanced (or Drivers) and select Video
Capture Drivers and then the Osprey-1000. Click on Settings and it will
give you the format panel.
SW and HW decoding (NT/95 only)
The proper setting for SW decoder is IP64_32.DLL. Best results can be obtained by using the HW/SW combined strategy.
Recommended Registry Settings
/HKEY_CURRENT_USER/SOFTWARE/Insoft/Communique!/CurrentVersionAudio/OutputWaveDeviceBuffersEnqueued = 2
If you experience significant audio dropouts, also set
/HKEY_CURRENT_USER/SOFTWARE/Insoft/Communique!/CurrentVersionAudio/OutputWaveDeviceBuffers = 0x18
Insoft Mic Settings
On Insoft Mic: Mic Switch Settings: 1 0 0 0 1 0 1
Mic Gain at min
Using Osprey 1000 Audio Control Panel:
Osprey Input set to Mic
Osprey Gain set 1/3 up from min
Known Bugs
After starting TV Tool with H.261, the self-view image may have a green band along the bottom of the window. After starting a conference, switching the self-view mode to either preview, overlay, or no self-view will remove the green band.
With audio and video running in a two-way CIF H261 conference at 10 fps, almost the entire CPU of a 90 MHz Pentium is used. Moving the mouse into non-Communique windows can cause enough additional CPU utilitization that audio dropouts occur. On any class machine, if the CPU utilitization reaches 100%, audio starts to drop out.
On any class machine, if the CPU utilitization reaches 100%, audio starts to drop out. Sometimes, when CPU utilitization reaches 100%, it stays there even if the video and audio are stopped. You must leave the conference to get back to normal.
Currently, the demo and the IP64 decoder set up the Osprey-1000 hardware to constantly DMA video out to a memory buffer which is then copied for DrawDib operations. On one machine with old video drivers, this has been shown to cause problems with the entire display (random color speckles). If this problem appears, try running the demo with the draw on demand option selected (under the MISC menu). This will cause video to be dma'd from the Osprey-1000 only when desired for a DrawDib operation. Also try obtaining and installing the latest device drivers for your video card from its manufacturer.
During mixed mode conferencing (QCIF -> CIF, CIF -> QCIF) overlay does not work properly. However, the remote view will be fine, and preview works fine as well.
During mixed mode conferencing (CellB -> IP64), the person sending CellB must start Video Tool before receiving video from the IP64 sender. Otherwise, the card will already be busy decoding H.261 and be unable to generate CellB.
Don't use Auto-Send for Video.
For Audio Auto-Start:
Do not auto-start receive only (Communique bug);
If you auto-start audio, and no firmware is currently running on the card, then it takes approximately 5 seconds for the audio to start. During this time, the buttons on the Audio Tool are active, but should NOT be pressed. Pressing them may cause a device open error. To avoid this problem, start TVTool before starting audio.
If using HW only decoding, then the video can swap for a single frame whenever a preview grab is done.