WiSP DDE Client Ver. 4.3
marzo-2005 Fernando Mederos - CX6DD

	** Utilizar ajuste de lnea para leer este documento **

	INTRODUCCION:
	-------------

	"WiSP DDE Client" es el nombre de una pequea aplicacin Win98/2000(*) escrita para controlar equipos de radio e interfaces de rotores de acuerdo con informacin recibida desde un programa de prediccin orbital.

	Windows incorpora una forma 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, Satscape, WXTrack y Orbitron. 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 puertos paralelos bajo WinNT/2000 se debe instalar PORT95NT.
El archivo PORT95NT.ZIP ubicado en el directorio de WiSPDDE contiene el instalador de ese programa.



	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


	Distribucin:

	"WiSP DDE Client" es distribudo sin cargo para su uso por Radioaficionados.
	Ultima versin disponible en: http://www.laboratoriomederos.com/CX6DD/wispdde



	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.


	Transparent-Tuning:

	Comenzando con la versin 4.0 se incorpora lo que se ha llamado "Transparent-Tuning" o sintona transparente. Esto presta gran utilidad para operar satlites con transponders analgicos.


	Registro de Eventos y Comandos:

	Comenzando con la versin 4.3 se incorpora el registro de eventos y de comandos en un archivo de disco. En principio esta funcin est habilitada nicamente para eventos y comandos relacionados con el control de las radios, eventualmente sarn agragados rotor y enlace DDE. Esta funcin es til para la depuracin de bugs que afecten el control de radios, rotor y enlace DDE. El registro de eventos y comandos de radio son escritos a un archivo de nombre "Radio_Log.txt", los de rotor a "Rotor_Log.txt" y los de enlace DDE a "DDELink_Log.txt".


	INSTALACIN:
	------------

	A partir de la versin 4.1 WiSPDDE es distribudo por con un ejecutable de instalacin 'setup.exe' para facilitar la tarea de puesta en funcionamiento del programa.


	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.
	Si se est reemplazando una versin anterior de WiSPDDE es posible que se presenten errores al comenzar el programa debido a incompatibilidades en la forma de guardar la informacin de configuracin entre las distintas versiones de WiSPDDE. WiSPDDE provee una solucin simple para esto: eliminar toda la configuracin de la versin anteriro y arrancar de cero con una nueva configuracin. Para esto es necesario iniciar WiSPDDE con el argumento R en su lnea de comando: escribir "wispdde R" en la opcin Ejecutar... del men inicio.


	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.
	Se debe configurar el campo de Separador Decimal de acuerdo al formato numrico utilizado por el programa de prediccin orbital ('.' o ','). Se puede conocer cual es el Separador Decimal mediante los valores de Azimuth y Elevacin en la ventana de WiSPDDE.


	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.laboratoriomederos.com/CX6DD/wispdde


	USO de WiSPDDE con Servidores DDE:
	----------------------------------

	"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.


	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).

	Existe una funcin para eliminar completamente la configuracin del programa almacentada el el Windows-Registry. Para ello se agrega una "r" en la lnea de comandos (wispdde.exe r).


	Espero encuentres este programa til!,
	Bugs y comentarios: CX6DD@amsat.org.

	73 de Nando, CX6DD.


Fernando Mederos, marzo-2005.
