2 * This DLL contains the user interface for the serial driver.
3 * a dialog box to configure the specified COMM port
4 * an interface to the control panel (??)
5 * functions to load and save default configuration
7 * Eventually the 32 bit comm port driver could be moved into here
8 * and interfaced to KERNEL32 using the WIN95 or WINNT comm driver interface.
9 * This way, different driver DLLS could be written to support other
10 * serial interfaces, such as X.25, etc.
12 * Basic structure copied from COMCTL32 code.
14 * Copyright 2000 Mike McCormack
16 * This library is free software; you can redistribute it and/or
17 * modify it under the terms of the GNU Lesser General Public
18 * License as published by the Free Software Foundation; either
19 * version 2.1 of the License, or (at your option) any later version.
21 * This library is distributed in the hope that it will be useful,
22 * but WITHOUT ANY WARRANTY; without even the implied warranty of
23 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
24 * Lesser General Public License for more details.
26 * You should have received a copy of the GNU Lesser General Public
27 * License along with this library; if not, write to the Free Software
28 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
38 #include "wine/debug.h"
42 WINE_DEFAULT_DEBUG_CHANNEL(comm);
44 HMODULE SERIALUI_hModule = 0;
46 /***********************************************************************
47 * SERIALUI_LibMain [Internal] Initializes the internal 'SERIALUI.DLL'.
50 * hinstDLL [I] handle to the DLL's instance
52 * lpvReserved [I] reserved, must be NULL
60 SERIALUI_LibMain (HINSTANCE hinstDLL, DWORD fdwReason, LPVOID lpvReserved)
62 TRACE("%x,%lx,%p\n", hinstDLL, fdwReason, lpvReserved);
65 case DLL_PROCESS_ATTACH:
66 SERIALUI_hModule = hinstDLL;
68 case DLL_PROCESS_DETACH:
76 /***********************************************************************
77 * EnumPropPages (SERIALUI.2)
79 * Called by the device manager to add prop sheets in Control Panel ???
80 * Pointed to in Win98 registry by
81 * \System\CurrentControlSet\Services\Class\ports\0000\EnumPropPages =
82 * "serialui.dll,EnumPropPages"
84 typedef LPVOID LPDEVICE_INFO;
85 typedef LPVOID LPFNADDPROPSHEETPAGE;
86 BOOL WINAPI SERIALUI_EnumPropPages(LPDEVICE_INFO pdi, LPFNADDPROPSHEETPAGE pfnAdd, LPARAM lParam )
88 FIXME("(%p %p %lx)\n",pdi,pfnAdd,lParam);
93 * These data structures are convert from values used in fields of a DCB
94 * to strings used in the CommConfigDialog.
96 typedef struct tagPARAM2STRDATA
100 } PARAM2STRDATA, *LPPARAM2STRDATA;
102 typedef struct tagPARAM2STR
105 LPPARAM2STRDATA data;
106 } PARAM2STR, *LPPARAM2STR;
107 typedef const LPPARAM2STR LPCPARAM2STR;
109 #define SERIALUI_TABLESIZE(x) ((sizeof (x))/(sizeof (x[0])))
111 static PARAM2STRDATA SERIALUI_Baud2StrData[]={
112 {110, "110"}, {300, "300"}, {600, "600"}, {1200, "1200"},
113 {2400, "2400"}, {4800, "4800"}, {9600, "9600"}, {14400, "14400"},
114 {19200, "19200"}, {38400L, "38400"}, {56000L, "56000"}, {57600L, "57600"},
115 {115200L, "115200"}, {128000L, "128000"}, {256000L, "256000"}
117 static PARAM2STR SERIALUI_Baud2Str={ SERIALUI_TABLESIZE(SERIALUI_Baud2StrData),SERIALUI_Baud2StrData };
119 static PARAM2STRDATA SERIALUI_Parity2StrData[]={
120 {NOPARITY,"None"}, {ODDPARITY,"Odd"}, {EVENPARITY,"Even"}, {MARKPARITY,"Mark"},
121 {SPACEPARITY,"Space"}
123 static PARAM2STR SERIALUI_Parity2Str={ SERIALUI_TABLESIZE(SERIALUI_Parity2StrData),SERIALUI_Parity2StrData };
125 static PARAM2STRDATA SERIALUI_Stop2StrData[]={
126 {ONESTOPBIT,"1"}, {ONE5STOPBITS,"1.5"}, {TWOSTOPBITS,"2"}
128 static PARAM2STR SERIALUI_Stop2Str={ SERIALUI_TABLESIZE(SERIALUI_Stop2StrData),SERIALUI_Stop2StrData };
130 static PARAM2STRDATA SERIALUI_Data2StrData[]={
131 {5,"5"}, {6,"6"}, {7,"7"}, {8, "8"}, {16,"16"}
133 static PARAM2STR SERIALUI_Data2Str={ SERIALUI_TABLESIZE(SERIALUI_Data2StrData),SERIALUI_Data2StrData };
135 static PARAM2STRDATA SERIALUI_Flow2StrData[]={
136 {0,"None"}, {1,"Hardware (RTS/CTS)"}, {2,"Software (XON/XOFF)"}
138 static PARAM2STR SERIALUI_Flow2Str={ SERIALUI_TABLESIZE(SERIALUI_Flow2StrData),SERIALUI_Flow2StrData };
141 * Add all the fields to a combo box and highlight the current value
143 static void SERIALUI_AddConfItems(HWND hDlg, DWORD id, LPCPARAM2STR table, DWORD dwVal)
146 HWND hControl = GetDlgItem(hDlg,id);
151 for(i=0; i<table->dwSize; i++)
153 n = SendMessageA(hControl, CB_ADDSTRING, 0L, (LPARAM)table->data[i].name);
154 if(dwVal == table->data[i].val)
156 SendMessageA(hControl, CB_SETCURSEL, (WPARAM)n, (LPARAM)0);
162 * Get the current sellection of the given combo box and set a DCB field to
163 * the value matching that selection.
165 static BOOL SERIALUI_GetConfItems(HWND hDlg, DWORD id, LPCPARAM2STR table, LPDWORD lpdwVal)
169 HWND hControl = GetDlgItem(hDlg,id);
171 if( (!hControl) || (!lpdwVal))
173 TRACE("Couldn't get window handle for item %lx\n",id);
177 if(!GetWindowTextA(hControl, &lpEntry[0], sizeof lpEntry))
179 TRACE("Couldn't get window text for item %lx\n",id);
182 /* TRACE("%ld contains %s\n",id, lpEntry); */
184 for(i=0; i<table->dwSize; i++)
186 if(!lstrcmpA(table->data[i].name,lpEntry))
188 *lpdwVal = table->data[i].val;
197 * Both the enumerated values CBR_XXXX and integer baud rates are valid
198 * dcb.BaudRate. This code is to convert back and forth between CBR_ style
199 * and integers. The dialog box uses integer values.
201 static DWORD SERIALUI_BaudConvertTable[] = {
202 CBR_110, 110, CBR_300, 300, CBR_600, 600, CBR_1200, 1200,
203 CBR_2400, 2400, CBR_4800, 4800, CBR_9600, 9600, CBR_14400, 14400,
204 CBR_19200, 19200, CBR_38400, 38400, CBR_56000, 56000, CBR_57600, 57600,
205 CBR_115200, 115200, CBR_128000, 128000, CBR_256000, 256000
208 static BOOL SERIALUI_MakeBaudDword(LPDWORD lpdwBaudRate)
212 for(i=0; i<(sizeof(SERIALUI_BaudConvertTable)/sizeof(DWORD)); i+=2)
214 if(*lpdwBaudRate == SERIALUI_BaudConvertTable[i])
216 *lpdwBaudRate = SERIALUI_BaudConvertTable[i+1];
223 static BOOL SERIALUI_MakeBaudEnum(LPDWORD lpdwBaudRate)
227 for(i=0; i<(sizeof(SERIALUI_BaudConvertTable)/sizeof(DWORD)); i+=2)
229 if(*lpdwBaudRate == SERIALUI_BaudConvertTable[i+1])
231 *lpdwBaudRate = SERIALUI_BaudConvertTable[i];
238 typedef struct tagSERIALUI_DialogInfo
241 LPCOMMCONFIG lpCommConfig;
242 BOOL bConvert; /* baud rate was converted to a DWORD */
243 DWORD dwFlowControl; /* old flow control */
244 } SERIALUI_DialogInfo;
246 static void SERIALUI_DCBToDialogInfo(HWND hDlg, SERIALUI_DialogInfo *info)
248 DWORD dwBaudRate, dwStopBits, dwParity, dwByteSize, dwFlowControl;
249 LPDCB lpdcb = &info->lpCommConfig->dcb;
251 /* pass integer pointers to SERIALUI_ dialog config fns */
252 dwBaudRate = lpdcb->BaudRate;
253 dwStopBits = lpdcb->StopBits;
254 dwParity = lpdcb->Parity;
255 dwByteSize = lpdcb->ByteSize;
257 /* map flow control state, if it looks normal */
258 if((lpdcb->fRtsControl == RTS_CONTROL_HANDSHAKE) ||
259 (lpdcb->fOutxCtsFlow == TRUE)) {
261 } else if(lpdcb->fOutX || lpdcb->fInX) {
267 info->bConvert = SERIALUI_MakeBaudDword(&dwBaudRate);
269 SERIALUI_AddConfItems( hDlg, IDC_BAUD, &SERIALUI_Baud2Str ,dwBaudRate);
270 SERIALUI_AddConfItems( hDlg, IDC_STOP, &SERIALUI_Stop2Str ,dwStopBits);
271 SERIALUI_AddConfItems( hDlg, IDC_PARITY, &SERIALUI_Parity2Str ,dwParity);
272 SERIALUI_AddConfItems( hDlg, IDC_DATA, &SERIALUI_Data2Str ,dwByteSize);
273 SERIALUI_AddConfItems( hDlg, IDC_FLOW, &SERIALUI_Flow2Str, dwFlowControl );
275 info->dwFlowControl = dwFlowControl;
278 static void SERIALUI_DialogInfoToDCB(HWND hDlg, SERIALUI_DialogInfo *info)
280 DWORD dwBaudRate, dwStopBits, dwParity, dwByteSize, dwFlowControl;
281 LPDCB lpdcb = &info->lpCommConfig->dcb;
283 SERIALUI_GetConfItems( hDlg, IDC_BAUD, &SERIALUI_Baud2Str, &dwBaudRate);
284 SERIALUI_GetConfItems( hDlg, IDC_STOP, &SERIALUI_Stop2Str, &dwStopBits);
285 SERIALUI_GetConfItems( hDlg, IDC_PARITY, &SERIALUI_Parity2Str, &dwParity);
286 SERIALUI_GetConfItems( hDlg, IDC_DATA, &SERIALUI_Data2Str, &dwByteSize);
287 SERIALUI_GetConfItems( hDlg, IDC_FLOW, &SERIALUI_Flow2Str, &dwFlowControl );
289 TRACE("baud=%ld stop=%ld parity=%ld data=%ld flow=%ld\n",
290 dwBaudRate, dwStopBits, dwParity, dwByteSize, dwFlowControl);
292 lpdcb->BaudRate = dwBaudRate;
293 lpdcb->StopBits = dwStopBits;
294 lpdcb->Parity = dwParity;
295 lpdcb->ByteSize = dwByteSize;
297 /* try not to change flow control if the user didn't change it */
298 if(info->dwFlowControl != dwFlowControl)
300 switch(dwFlowControl)
303 lpdcb->fOutxCtsFlow = FALSE;
304 lpdcb->fOutxDsrFlow = FALSE;
305 lpdcb->fDtrControl = DTR_CONTROL_DISABLE;
306 lpdcb->fOutX = FALSE;
308 lpdcb->fRtsControl = RTS_CONTROL_DISABLE;
310 case 1: /* CTS/RTS */
311 lpdcb->fOutxCtsFlow = TRUE;
312 lpdcb->fOutxDsrFlow = FALSE;
313 lpdcb->fDtrControl = DTR_CONTROL_DISABLE;
314 lpdcb->fOutX = FALSE;
316 lpdcb->fRtsControl = RTS_CONTROL_HANDSHAKE;
319 lpdcb->fOutxCtsFlow = FALSE;
320 lpdcb->fOutxDsrFlow = FALSE;
321 lpdcb->fDtrControl = DTR_CONTROL_DISABLE;
324 lpdcb->fRtsControl = RTS_CONTROL_DISABLE;
330 SERIALUI_MakeBaudEnum(&lpdcb->BaudRate);
333 /***********************************************************************
334 * SERIALUI_ConfigDialogProc
336 * Shows a dialog for configuring a COMM port
338 BOOL WINAPI SERIALUI_ConfigDialogProc(HWND hWnd, UINT uMsg, WPARAM wParam, LPARAM lParam)
341 SERIALUI_DialogInfo *info;
346 info = (SERIALUI_DialogInfo*) lParam;
349 SetWindowLongA(hWnd, DWL_USER, lParam);
350 snprintf(szTitle, sizeof szTitle, "Settings for %s", info->lpszDevice);
351 SetWindowTextA(hWnd, szTitle);
352 SERIALUI_DCBToDialogInfo(hWnd, info);
357 WORD wID = LOWORD(wParam);
359 info = (SERIALUI_DialogInfo *) GetWindowLongA(hWnd, DWL_USER);
365 SERIALUI_DialogInfoToDCB(hWnd,info);
371 /* test code for Get/SetDefaultCommConfig begins */
374 DWORD r,dwConfSize = sizeof (COMMCONFIG);
375 r = GetDefaultCommConfigA(info->lpszDevice,
376 info->lpCommConfig, &dwConfSize);
378 MessageBoxA(hWnd,"Failed","GetDefaultCommConfig",MB_OK);
380 SERIALUI_DCBToDialogInfo(hWnd, info);
385 SERIALUI_DialogInfoToDCB(hWnd,info);
386 r = SetDefaultCommConfigA(info->lpszDevice,
387 info->lpCommConfig, sizeof (COMMCONFIG));
389 MessageBoxA(hWnd,"Failed","GetDefaultCommConfig",MB_OK);
392 /* test code for Get/SetDefaultCommConfig ends */
400 /***********************************************************************
401 * drvCommConfigDialog (SERIALUI.3)
403 * Used by Win9x KERNEL to show a dialog for configuring a COMM port.
405 BOOL WINAPI SERIALUI_CommConfigDialog(
408 LPCOMMCONFIG lpCommConfig
410 SERIALUI_DialogInfo info;
412 info.lpCommConfig = lpCommConfig;
413 info.lpszDevice = lpszName;
414 info.bConvert = FALSE;
415 info.dwFlowControl = 0;
420 return DialogBoxParamA(SERIALUI_hModule,
421 MAKEINTRESOURCEA(IDD_SERIALUICONFIG),
423 (DLGPROC) SERIALUI_ConfigDialogProc,
427 static LPCSTR lpszCommKey = "System\\CurrentControlSet\\Services\\Class\\Ports";
428 static LPCSTR lpszDCB = "DCB";
430 /***********************************************************************
431 * drvSetDefaultCommConfig (SERIALUI.4)
433 * Used by Win98 KERNEL to set the default config for a COMM port
434 * FIXME: uses the wrong registry key... should use a digit, not
435 * the comm port name.
437 BOOL WINAPI SERIALUI_SetDefaultCommConfig(
439 LPCOMMCONFIG lpCommConfig,
442 HKEY hKeyReg=0, hKeyPort=0;
446 TRACE("%p %p %lx\n",lpszDevice,lpCommConfig,dwSize);
451 if(dwSize < sizeof (COMMCONFIG))
454 r = RegConnectRegistryA(NULL, HKEY_LOCAL_MACHINE, &hKeyReg);
455 if(r != ERROR_SUCCESS)
458 snprintf(szKeyName, sizeof szKeyName, "%s\\%s", lpszCommKey ,lpszDevice);
459 r = RegCreateKeyA(hKeyReg, szKeyName, &hKeyPort);
460 if(r == ERROR_SUCCESS)
462 dwDCBSize = sizeof (DCB);
463 r = RegSetValueExA( hKeyPort, lpszDCB, 0, REG_BINARY,
464 (LPSTR)&lpCommConfig->dcb,dwDCBSize);
465 TRACE("write key r=%ld\n",r);
466 RegCloseKey(hKeyPort);
469 RegCloseKey(hKeyReg);
471 return (r==ERROR_SUCCESS);
474 /***********************************************************************
475 * drvGetDefaultCommConfig (SERIALUI.5)
477 * Used by Win9x KERNEL to get the default config for a COMM port
478 * FIXME: uses the wrong registry key... should use a digit, not
479 * the comm port name.
481 BOOL WINAPI SERIALUI_GetDefaultCommConfig(
483 LPCOMMCONFIG lpCommConfig,
486 HKEY hKeyReg, hKeyPort;
488 DWORD r,dwSize,dwType;
490 TRACE("%p %p %p\n",lpszDevice,lpCommConfig,lpdwSize);
498 if(*lpdwSize < sizeof (COMMCONFIG))
501 *lpdwSize = sizeof (COMMCONFIG);
502 memset(lpCommConfig, 0 , sizeof (COMMCONFIG));
503 lpCommConfig->dwSize = sizeof (COMMCONFIG);
504 lpCommConfig->wVersion = 1;
506 r = RegConnectRegistryA(NULL, HKEY_LOCAL_MACHINE, &hKeyReg);
507 if(r != ERROR_SUCCESS)
510 snprintf(szKeyName, sizeof szKeyName, "%s\\%s", lpszCommKey ,lpszDevice);
511 r = RegOpenKeyA(hKeyReg, szKeyName, &hKeyPort);
512 if(r == ERROR_SUCCESS)
514 dwSize = sizeof (DCB);
516 r = RegQueryValueExA( hKeyPort, lpszDCB, NULL,
517 &dwType, (LPSTR)&lpCommConfig->dcb,&dwSize);
518 if ((r==ERROR_SUCCESS) && (dwType != REG_BINARY))
520 if ((r==ERROR_SUCCESS) && (dwSize != sizeof(DCB)))
523 RegCloseKey(hKeyPort);
527 /* FIXME: default to a hardcoded commconfig */
529 lpCommConfig->dcb.DCBlength = sizeof(DCB);
530 lpCommConfig->dcb.BaudRate = 9600;
531 lpCommConfig->dcb.fBinary = TRUE;
532 lpCommConfig->dcb.fParity = FALSE;
533 lpCommConfig->dcb.ByteSize = 8;
534 lpCommConfig->dcb.Parity = NOPARITY;
535 lpCommConfig->dcb.StopBits = ONESTOPBIT;
539 RegCloseKey(hKeyReg);
541 return (r==ERROR_SUCCESS);