Siemens 7 Translate Source Code, Software Requirements, Preparing the Translation, Compiler Flags

Page 26

Multiplexer Driver Developer’s Guide

6 Translate Source Code

s

6 Translate Source Code

6.1Software Requirements

The WinMux build environment has been designed to work together with a Microsoft Visual Studio 6.0 SP3 or higher and the Microsoft Windows XP SP1 DDK. It is possible to use a Windows 2000 DDK as well, but in this case adaptations to the different build control files might be necessary.

6.2Preparing the Translation

1Create the environment variables “WINMUXVSTUDIOROOT” and “WINMUXDDKROOT” containing the path to the root of your Visual Studio and Windows DDK installation. Alternatively you can edit the file “driver\dir_env.cmd” and enter the correct paths to the DDK and the VC 6.0 there.

2Open the workspace sermux in the root directory. Select batch build.

3The executable files can be found under lib\wdm\[frechk] _wxp_x86\i386.

Note: The DDK is a software tool for Windows driver development.

6.3Compiler Flags

There is only one compiler flag “MUX_MANUAL” for a conditional compile of the driver. With this compiler flag set the driver can be compiled in a special manual version where opening and closing of the multiplexer can be controlled via special DeviceIoControl() commands instead of automatic control via the opened virtual channels. This manual version is used for internal automated module testing and is not relevant for usual driver operation.

Mux_Drv_DevGuide_v07	Page 26 of 36	2006-9-27
Confidential / Released

Image 26

Contents User’s Guide General Notes CopyrightContents Multiplexer Driver Developer’s Guide Tables List of TablesFigures List of FiguresDocument History Chapter What is newDocument History Multiplexer Driver Developer’s Guide Introduction IntroductionSupported Product Versions Supported Product VersionsRelated Documents Related DocumentsAbbreviations Abbreviation DescriptionUser Hierarchy Chart in the SystemArchitecture ArchitectureModule Detection Signal DescriptionHandling of the Physical Serial Port Handling of the Physical Serial PortHandling of Control Lines on Virtual Ports Handling of Control Lines on Virtual PortsLimitation of Virtual Ports Module Initializing Sequence Command Response Function Associated Registry ValueModule Initializing Sequence Power Down after Closing the Last Port Power DownPower Down on PC Suspend Module Re-initializationPower Down on PC Shutdown Power DownInstalling the WinMux2k Driver InstallationFiles Required for WinMux2k Driver Installation InstallationWindows Deinstalling the DriverDeinstalling the Driver Windows XP new desktop, not the classic desktopDevice Settings and Properties Device Settings and PropertiesSettings on the Serial Multiplexer Properties Value Data Example Properties Settings Stored in the Windows RegistrySettings Stored in the Windows Registry TC45, XC18 only Multiplexer Driver Developer’s Guide Values Data Example Properties Fax Settings Settings for ApplicationsDial-up Network Settings Settings for ApplicationsPreparing the Translation Translate Source CodeSoftware Requirements Compiler FlagsAdditional Source Documentation Additional Source DocumentationInteraction of the Different Driver Objects Internal Driver States Internal Driver StatesBuffer Handling Buffer HandlingData Transfer To th e S e rM u x O b je c t a re in d ic a te dMultiplexer Driver Developer’s Guide SerMuxSend Function SerMuxSend and SerMuxSendPort0 FunctionsStart +++-Parser +++-ParserShutdown of the Operating System Known ProblemsBooting Operating System Standby of the Operating SystemAutomatic Shutdown in case of Emergency Special EnvironmentsOperation on Virtual USB Port Special Environments