WiSP DDE Client Ver. 3.0
octubre-2001 Fernando Mederos - CX6DD


	INTRODUCCION:

	"WiSP DDE Client" es el nombre de una pequea aplicacin Win98/2000(*) escrita para controlar equipos de radio e interfaces de rotores desde WiSP, Station Program, WinOrbit, Nova for Windows, SatPC32 y otros programas de seguimiento de satlites.
	Windows incorpora una forma muy prctica de pasar informacin entre aplicaciones: "DDE" (Dynamic Data Exchange, o intercambio dinmico de datos). Gracias a esto aplicaciones ejecutando concurrentemente pueden compartir informacin de todo tipo, por ejemplo el nombre del satlite que se est siguiendo, su posicin, frecuencias de transmisin y recepcin y tambin los modos. "WiSP DDE Client" utiliza esta caracterstica para establecer la comunicacin entre el programa de seguimiento (el que efecta los clculos de la rbita) y los interfaces de rotor y de radio.
	El programa acepta comunicacin DDE desde WiSP, Station Program de AmSAT-BDA, el software del ARS de EA4TX, Nova for Windows, SatPC32, WinOrbit y Satscape. Station Program enva por DDE nicamente informacin sobre la posicin del satlite, no de sus frecuencias, por lo tanto no es posible controlar la radio en este caso.
	Las interfaces de rotor actualmente soportadas son: GS-232, FODTrack, CI-V, IF-100 y TrakBox. La interface CI-V es una que se conecta a la misma caja de adaptacin CT-17 que cualquier equipo Icom, de esta forma se puede utilizar el mismo puerto serial del PC para controlar las radios y los rotores.
	Las radios soportadas son: IC-821, IC-970, IC-275, IC-475, IC-746, IC-R7000, IC-R8500, PCR-1000, FT-847, FT-817, FT-100, FT-736, AR-5000, AR-8000, TH-D7, TM-D700, TS-790 y TS-2000.

	(*) Nota: Para utilizar interfaces que requieran puertos paralelos bajo Win2000 leer la informacin contenida en "inoutnt.zip" provista por Howard-G6LVB.

	Crditos: Rutinas de control de AOR y enlace DDE desde WinOrbit gracias a David-EB5DGP. Rutinas de control de FT-817, FT-100 y TS-2000 por Howard-G6LVB



	MULTI-RIG:

	Comenzando con la versin 3.0 se incorpora una til funcin 'Multi-Rig' que permite	a WiSPDDE seleccionar 2 radios de una lista para encargarlas del canal de bajada (downlink) y del canal de subida (uplink) respectivamente. Ambos canales podrn ser asignados a una misma radio siempre y cuando sta sea dual-band. Informacin sobre el nombre del satlite en seguimiento, la frecuencia y el modo son tenidos en cuenta durante el proceso de seleccin automtica que se realiza cada vez que cambia el satlite. Hay una gran flexibilidad en las combinaciones que se pueden llevar a cabo: las radios no necesariamente deben estar conectadas al mismo puerto del PC ni tienen porqu ser de la misma marca etc. Reitero que una nica radio dual-band full-duplex puede ser asignada a ambos canales, de subida y de bajada.


	"WiSP DDE Client" es distribudo sin cargo para su uso por Radioaficionados.
	Ultima versin disponible en: http://www.chasque.apc.org/franky

	El programa es empacado con los siguientes archivos:

		wispdde.exe		-Ejecutable Win95/98/2000.
		InOut.dll		-Librera para acceso a puertos LPT.
		Mscomm32.ocx		-Librera utilizada para acceso a puertos COM.
		readme.txt		-Texto en Ingls.
		leeme.txt		-Texto en Espaol.
		inoutnt.zip		-informacin sobre uso con Win2000.

	wispdde.exe y los archivos .txt pueden ser ubicados en cualquier directorio. INOUT.DLL y MSCOMM32.OCX (v.6) se incluyen en caso de que no estn ya presentes en el sistema. Si se necesitan debern estar en el directorio Windows\System.
	Adems de estos archivos, se necesitarn VBRUN300.DLL, COMCTL32.OCX (v.6) y MSVBVM60.DLL, en caso que no se encuentren en el sistema pueden ser descargados de la pgina del "Microsoft Download Center" o de la ma. 
	Para utilizar WiSPDDE como servidor de SatPC32 se deben copiar los archivos wispdde.exe, readme.txt y leeme.txt en el directorio de SatPC32. Leer al final de este documento para ms informacion importante sobre la configuracin con SatPC32.


	CONFIGURACION:

	La primera vez que WiSP DDE Client es ejecutado estar configurado para recibir informacin desde WiSP y no controlar ningn interfaz de rotor o radio.

	Enlace DDE:
	Se debera comenzar por asegurar que la seleccin de DDE en la ventana de configuracin DDE Link es la correcta y que el intervalo de refresco es adecuado. Un intervalo muy corto puede entorpecer la operacin, se recomienda un valor mayor a un segundo.

	Radio:
	Luego abrir la opcin de men Radio y seleccionar el nmero de la radio que se desea configurar en el campo Rotor Index. Se deber marcar Enable Radio para acceder al resto de los campos. No hay lmite impuesto sobre el nmero de radios que se puedan mantener en la lista, adems puede ser conveniente asignar ms de un nmero a la misma radio.
	Luego seleccionar el modelo de la radio, el puerto al que est conectada, la velocidad (baudrate) y la direccion CI-V (solo para equipos Icom). Si se utiliza un puerto mayor que COM4 se puede escribir directamente sobre el campo.
	El campo "Bidirectional Interface" tambin sirve nicamente para equipos Icom y especifica al programa si ste tiene que esperar respuesta del equipo de radio o no. Esto es til para quienes se construyan un adaptador CI-V simple, sin capacidad de recibir datos desde la radio.
	El campo "TNC up/dn..." permite al TNC con mdem PSK corregir la frecuencia de recepcin de la radio sin ser interferido por WiSP. La frecuencia de recepcin ser actualizada por WiSP unas pocas veces al comienzo de la pasada del satlite y mientras ste se encuentre a menos de 3 de elevacin, para luego ser dejada bajo control del modem. Esta funcin slo tendr efecto cuando el modo de recepcin sea USB o LSB, en cualquier otro caso la operacin ser normal.

	Seleccin Automtica:
	El botn Auto-Selection Config. abre la ventana de condiciones de seleccin de la radio que se est configurando.
	Si desea utilizar esta radio como canal de bajada marcar Downlink; como canal de Subida marcar Uplink. Con Radios dual-band puede marcar ambos, si no marca ninguno la radio quedar deshabilitada.
	En el campo Satellites entrar todos los satlites que sern seguidos por esta radio, o dejar en blanco si todos lo sern. Tener en cuenta que si se deja en blanco la radio podr ser seleccionada inclusive cuando no haya ningn satlite en seguimiento. No hay lmite sobre el nmero de satlites entrados. Tener cuidado de escribir los nombres de satlite tal cual WiSP los llama de lo contrario no sern reconocidos.
	En el campo Modes entrar los modos en que se usara esta radio, aqu tampoco hay lmite sobre el nmero de modos pero WiSP utiliza solo los siguientes: LSB, USB, CW, CW-N, FM-N, FM y FM-W.
	En el campo Freq. Ranges escribir todos los rangos de frecuencia en los que se usar la radio. Los rangos se entran con el comienzo en MHz, un guin '-' y el final en MHz. Se pueden entrar tantos rangos como se desee separados por un espacio y no tienen que estar en ningn orden especfico.
	El 'Accesory Port' es includo para controlar dispositivos tales como relays y dems con el fin de modificar la configuracin de la estacin en funcin a los requerimientos de seguimiento. Si se marca en Acc.Port Enable se enviar el valor de Port Value a la direccin de salida Port Address. Las radios de subida (Uplink) y bajada (Downlink) pueden compartir un mismo puerto accesorio o no, no hay restricciones aqu. En caso que compartan el mismo puerto ambos valores de Port Value sern mezclados (funcin OR) y el resultado enviado al puerto.
	Hay un botn de Reset que inicializa todos los campos con valores de ejemplo para tomar como referencia durante la configuracin.
	Guardar los cambios con el botn Save y volver a la ventana de Radios con el botn Finished.
	Durante la operacin normal del programa se iniciar un proceso de seleccin automtica de radios cada vez que cambie el satlite en seguimiento. Este proceso consiste en examinar todas las condiciones impuestas sobre cada radio configurada empezando por la radio nmero 1. Si el nombre del satlite, la frecuencia o el modo no estn dentro de los previstos para esta radio sta ser descartada y se proseguir con la prxima radio en la lista hasta encontrar una adecuada. Este proceso se repite dos veces, la primer vez para el canal de bajada (downlink) y luego para el canal de subida (uplink).

	Rotor:
	Luego en el men Rotor elegir el interfaz de rotor que se vaya a usar.
	El valor de "Step Size" o tamao de paso es utilizado para redondear las coordenadas de azimut y elevacin al mltiplo entero ms cercano del nmero ingresado.
	El campo "Auto Flip" se utilizaba para versiones anteriores de WiSP (pre-2000) las cuales no efectuaban el "flip" en las coordenadas enviadas por DDE. WiSP actualmente (GSC-2.03) si enva coordenadas "flipeadas" por DDE as que este campo no se activar ms con WiSP.
	"North/South Stop Position" deben reflejar la posicin elegida para los topes del rotor de azimut.

	NOTA: Informacin detallada acerca del interfaz de rotores CX6DD en sus variantes CI-V y GS-232 est disponible en http://www.chasque.apc.org/franky


	USO de WiSPDDE con Servidores DDE (WiSP, WinOrbit, Nova, Station, ARS o Satscape):

	"WiSP DDE Client" debe estar corriendo al mismo tiempo que el servidor DDE para funcionar, en segundo plano o minimizado estar bien. No importa si se lanza antes o despus que el servidor, pero los satlites no sern seguidos hasta que este se encuentre funcionando tambin. Se debe seleccionar el interfaz tipo DDE en la seccin de configuracin de programa de seguimiento para que ste comienze a enviar informacin por DDE.


	USO de WiSPDDE con Clientes DDE (SatPC32):

	Para utilizar WiSPDDE como servidor DDE de SatPC32 se deben copiar los archivos wispdde.exe, readme.txt y leeme.txt en el directorio de SatPC32. Luego Modificar los archivos CatServer.SQF y RotorServer.SQF para que contengan nicamente la palabra "wispdde" sin comillas y en minsculas, los dos archivos iguales.
	Luego correr el programa SatPC32 y en el men "Options" habilitar los cuadros "Rotor Control" y "Cat Control", tambin deben estar habilitados "DDE Rotor" y "DDE Cat", luego click en "Store" para guardar cambios. En el men "CAT" verificar que el campo "Interval (Hz)" contenga un valor superior o igual a 50Hz si se pretende sintonizar satlites LEO, pues de lo contrario las actualizaciones de frecuencia sern demasiado rpidas.
	Reiniciar SatPC32 y verificar que WiSPDDE es abierto automticamente y recibe informacin de SatPC32. WiSPDDE ser abierto y cerrado automticamente junto con SatPC32.


	MISCELANEOS:

	Los cuadros "Auto Update" habilitan la actualizacin automtica del azimut/elevacin y frecuencias/modos respectivamente.
	Los botones "Radio" y "Rotor" envan inmediatamente los datos de los campos correspondientes al interfaz apropiado.

	El programa puede ser ejecutado en modo "Single-Pass" agregando una "s" en la lnea de comandos (wispdde.exe s). De esta forma WiSPDDE se cerrar automticamente cuando el satlite se encuentre fuera de vista (LOS).


	Espero encuentres este programa til!,
	Bugs y comentarios: CX6DD@amsat.org o va satlite KO-23, KO-25 o UO-22.

	73 de Nando, CX6DD.


Fernando Mederos, marzo-2000.
