summaryrefslogtreecommitdiff
path: root/misc/estic/files/README
blob: d4313e997fddf6a26c5130489410da8f2e05d533 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
.nf \" This file gets installed as .../man/man1/estic_freebsd.1

		NOTES ON ESTIC IN FREEBSD (/usr/ports/comms/estic/)
		By Julian Stacey <jhs@freebsd.org> November 1996
		 
INDEX
	1	EXAMPLE CONFIG FILE
	2	C++ & FreeBSD VERSIONS
	3	COPYING & USAGE RIGHTS
	4	WEB REFERENCES FOR ISTEC PROTOCOL etc
	5	SERIAL DC HANDSHAKING
	6	PEOPLE WHO MAY BE INTERESTED IN THIS PORT
	7	BUGS & PROBLEMS
--------------------------------------------------------------------------------
1   Example Config File
=======================
For /etc/pbx/estic.ini
	[ESTIC]
	SettingsFile    = "~/.estic-rc"
	[Port]
	PortName        = "/dev/istec"
	[Printing]
	Headline        = "Phone Bill"
	[Windows]
	ShowDateTime    = Minutes
	ShowInfoOnStartup = no
	[Call-Logs]
	LogFile1 = "/var/log/pbx/%Y.%m
	LogZeroCostCalls        = yes
	[Alias]
	AliasFile       = "/home/your_name/.estic-aliases"
	AutoReadAliases = on            ; on/off/yes/no/1/0 mvglich
	[Debug]
	WaitAfterCall   = 500
	DiagModeUpdate  = auto
	DebugLog        = "/var/log/pbx/debug"
	[Firmware]
--------------------------------------------------------------------------------
2   C++ & FreeBSD Versions
==========================
This package uses C++, which comes standard with FreeBSD.
	uz@ says it's ok with FreeBSD 2.1.0 with g++ 2.6.3
	jhs@ confirms it runs with src/ current (Oct 8 20:36 src-cur.2289.gz)
	with c++ --version 2.6.3
--------------------------------------------------------------------------------
3   Copying & Usage Rights
==========================
Ref. Makefile NO_CDROM & NO_PACKAGE...

There are somewhat restrictive conditions (in German) in the sources,
which I've duplicated & translated ...

  {--------
  * Generic Original by "Ullrich von Bassewitz" <uz@ibb.schwaben.com>
  + Generic Translation by "Julian H. Stacey"	<jhs@FreeBSD.org>
  
  Die ESTIC-Sourcen bzw. die ESTIC Binaries d�rfen unter folgenden
  Bedingungen weitergegeben werden:
  The ESTIC sources & binaries may be distributed under the following conditions
  
    * Die Weitergabe geschieht im kompletten Paket mit Dokumentation.
    + Distribution as complete package including documentation.
  
    * Die Weitergabe geschieht kostenlos. Dies bedeutet insbesondere,
      da� ESTIC nicht ohne meine vorherige, schriftliche Genehmigung auf
      CD-ROMS vertrieben werden darf, genauso sind Mailboxen/FTP-Server
      ausgeschlossen, bei denen der Zugang zu den Daten nicht frei f�r
      jedermann ist.
    + Distribution to be free of charge, This means in particular,
      that ESTIC may not without my prior written permission be sold on CD-ROMs,
      neither may it be provided on mailbox systems or FTP servers that only
      offer restricted non public access.
  
    * Es d�rfen keine ge�nderten Sourcen weitergegeben werden. Die Weitergabe
      von ge�nderten Binaries, sowie diffs zu den Sourcen ist hingegen
      zul�ssig. Das soll keine Schikane sein, sondern nur verhindern, da�
      mehrere verschiedene Versionen der Sourcen auf dem Netz verf�gbar
      sind, was zwangslaeufig mit unnoetigem Aufwand fuer mich verbunden ist.
    + No changed sources may be distributed.  The distribution of changed
      binaries & diffs to the sources is however allowed.
     This is not intended as chicanery, but to hinder multiple availability
     of multiple versions of source on the net, which would create excess work
     for me.
  
    * Binaries, die durch �nderungen an den Sourcen erstellt wurden
      unterliegen weiterhin den hier angegebenen Bedingungen, d.h. es ist
      keine kommerzielle Verwertung oder ein kommerzieller Vertrieb ohne
      meine vorherige, schriftliche(!) Zustimmung erlaubt.
    + Binaries produced from changed sources come under these conditions,
     .... no commercial value added ... sales ... allowed, without my prior
     written agreement.
  
  Ansonsten bin ich durchaus gespr�chsbereit, d.h. wer aus irgendwelchen
  Gr�nden gegen eine der hier angegebenen Bestimmungen verstossen will, der
  kann sich gerne an mich wenden.
  ... I'm open to discuss proposed breaches of these requirements.
  --------}

  So I wrote & got a release...

  {--------
  From: uz@wuschel.ibb.schwaben.com (Ullrich von Bassewitz)
  Subject: Re: FreeBSD Ports wrapper for Estic-1.30
  To: jhs@freebsd.org
  Date: Mon, 23 Sep 1996 19:15:16 +0100 (MET DST)
  
  > May we have your permission to put your unchanged generic distribution
  > sources (ie currently estic-1.30.zip on the FreeBSD CD-ROMs please ?
  > (FreeBSD is a non profit org. like X inc & FSF,
  > but Walnut Creek (who provide a free host for our co-ordination,
  > at http://www.freebsd.org 
  > (& others occasionally) take snaps & release of FreeBSD
  > & provide the whole sources + binaries of all src + ports
  
  No problem. You are allowed to do so. The paragraph you cited is thought to
  help control who earns money selling my code, but I've no problems with that
  in the case of freebsd cdroms.
  --------}

  {--------
  From: uz@wuschel.ibb.schwaben.com (Ullrich von Bassewitz)
  Subject: Re: istec 1008
  To: jhs@freebsd.org
  Date: Tue, 19 Nov 1996 09:41:14 +0100 (MET)
  
  > I lost (or filed obscurely) the earlier permission you gave me,
  > for FreeBSD to store your sources & a packaged binary on the FreeBSD CD-Roms,
  > maybe you could give me some words again please, which I'll embed straight
  > in the wrapper & not loose this time ;-)
  
  I will change that in the next version anyway. So, you may distribute ESTIC
  as you like, as long as you leave the archive files intact.
  --------}

--------------------------------------------------------------------------------
4   References
==============
http://africa.geomic.uni-oldenburg.de/~joey/Linux/istec-befehle
	Istec 1008 intern
	Da das Interesse gro_ ist (meines auch), hier der etwas
	aufbereitete Text. Vielen vielen Dank an Hergen Lehmann, der sich die  
	M|he des Reverse-Engineering gemacht hat. <p>
	From: HERGEN_LEHMANN@TBX.BerliNet.DE (Hergen Lehmann)

http://www.schwaben.de/home/uz/istecprot.html
	Urspr&uuml;ngliche Version des Textes von Hergen Lehmann.
	Kleinere Erweiterungen/Korrekturen von Ullrich von Bassewitz.
	Erweiterungen der Version 1.93/1.95 von Paul Barnard (Emmerich),
	deutsche &Uuml;bersetzung von Ullrich von Bassewitz.
	Weitere Tips und Hinweise von Norbert Richter (Autor von PMISTEC).

http://www.symmetrix.ch/Public/janti/isdnfaq.html
	Author: c.dura@atlantis.cl.sub.de
	Frequently Asked Questions zu ISDN
	Dieses FAQ versteht sich also Informationsquelle fuer ISDN Einsteiger

http://africa.geomic.uni-oldenburg.de/~joey/Linux/isdn-istec-befehle.html
	<h1>ISTEC 1008 intern</h1>
	Da das Interesse gro&szlig; ist (meines auch), hier der etwas
	aufbereitete Text. Vielen vielen Dank an <a 
	href="mailto:Hergen_Lehmann@TBX.BerliNet.DE">Hergen Lehmann</a>, 
	der sich die
	M&uuml;he des Reverse-Engineering gemacht hat. <p>

http://www.snafu.de/~drebert/istec.html
	<HTML><HEAD><TITLE>Istec Firmenware</TITLE></HEAD>^M

http://www.emmerich.com/telekom/links.htm
	<title>Links zu Interessanten Pages</title>

http://www.bestweb.com/intfun/jrs/euroinfo.html
	EuroISDN Telekom-Tarife+Technik
--------------------------------------------------------------------------------
5	Serial DC Handshaking
=============================

From: AmIstec (another package) / CE-Istec.LiesMich
  WICHTIGER HINWEIS ZU DEN NEUEN ISTEC-ANLAGEN MIT CE-ZEICHEN!!
  =============================================================
	 
  Die neuen Istec-Anlagen mit CE-Zeichen funktionieren leider
  nicht mehr ohne weiteres an Nicht-Dosen, weil Emmerich die
  serielle Schnittstelle galvanisch von der Anlage entkoppeln
  mu_te. Die f|r die Daten|bertragung erforderlichen Spannungen
  werden daher einfach von von den DTR- und RTS-Leitungen  
  bezogen. Dazu wird bei der Originalsoftware DTR auf logisch 1
  und RTS auf logisch 0 gesetzt um so die negative bzw. positive
  Spannung der Istec zur Verf|gung zu stellen.

  Leider ist das gezielte Setzen einzelner Signalleitungen im
  serial.device des Amiga nicht vorgesehen. Hier werden immer
  beide Leitungen auf logisch 1 gesetzt.

  Um die Spannungsversorgung trotzdem zu ermvglichen, kann man
  einen Schnittstellenadapter basteln, der die erforderlichen
  Spannungen von Pin 9 und 10 des Amiga-Ports auf die beiden
  Signalleitungen umlegt. Nach einiger \berlegung und durch die
  Mithilfe von Christian Buchner ist es mir aber gelungen zu
  ermvglichen, da_ mit AmIstec auch die neuen Istec-Anlagen
  ohne diesen Hardwarezusatz am Amiga betrieben werden kvnnen.
  Dazu wird die DTR-Leitung direkt |ber die Hardware gesetzt,
  soda_ die Istec genau das bekommt, was sie erwartet. Dieser
  Patch wird durch den Tooltype CEPATCH aktiviert bzw. bei
  einem CLI-Aufruf als Parameter mitgegeben. 

From: uz@wuschel.ibb.schwaben.com (Ullrich von Bassewitz)
To: jhs@freebsd.org
Date: Thu, 14 Nov 1996 14:44:52 +0100 (MET)

  Oliver von Bueren <ovb@swissmail.com> ... sent me changes a few days ago. His
  changes are relative to version 1.40 and they seem to work for him. The only
  change that was new for me, was a call to DTROff (a function of the serial
  port class). If this is really needed (and he stated that he checked the
  pins with a voltmeter), this means that there is an error in the serial
  module. The DTR pin should be inactive if there is no hardware handshaking
  enabled as is the case with ESTIC.
  
  
  The only thing that was really new for me was the call to DTROff. I will
  check the serial module, since this call cures a symptom and not the error
  itself (but you may use it anyway).
  
  If you make any changes (apart from those in Oliver's diffs), I would like
  to hear from it. I got a few mails from FreeBSD people and I would like to
  incorporate any changes that make ESTIC work for FreeBSD into the main
  release. This little work saves me lots of emails :-)
--------------------------------------------------------------------------------
6   People who may be interested in this port
=============================================
People who may be interested in this port as it evolves:
	"Ullrich von Bassewitz" <uz@ibb.schwaben.com>,
	"Oliver von Bueren"	<ovb@swissmail.com>,
	"Julian H. Stacey"	<jhs@FreeBSD.org>,
	"Peter Dieth"		<dieth@seicom.net>,
	"Terry Lambert" 	<terry@cs.weber.edu>,
	"Christian Kratzer"	<ck@toplink.de>,
	"Torsten Blum"		<torstenb@tlk.de>,
	"Greg Lehey"		<grog@lemis.de>,
	"Robert Eckardt"	<roberte@mep.ruhr-uni-bochum.de>

To give the FreeBSD `powers that be' confidence to commit this wrapper,
I append a quote: (which can be deleted once the port is committed).

> From: Robert Eckardt <roberte@mep.ruhr-uni-bochum.de>
> Subject: Re: your mail
> Date: Thu, 21 Nov 1996 01:51:23 +0100 (MET)
>
> ....
> No, as stated above, it works fine now.
> Just getting the 1.40 zip-file, applying the ports and changing the
> config file was sufficient. 
> Now you have another data point in the sets of working configurations.
------
> From: Robert Eckardt <roberte@mep.ruhr-uni-bochum.de>
> Subject: Re: ESTIC
> To: uz@ibb.schwaben.com
> Date: Thu, 21 Nov 1996 10:55:36 +0100 (MET)
> Cc: roberte@mep.ruhr-uni-bochum.de, jhs@freebsd.org, uz@ibb.schwaben.com
> 
> > /usr/X11 is usually a link to /usr/X11R6. I don't know if this is true with
> > FreeBSD but most Linux distributions have it.
> 
> FreeBSD does not have it by default.
> The X11 dir was changed in many other places in the makefiles, so may
> be it would be a good idea to change it in the last place too.
> In fact, one could use perhaps some make-var X11ROOT (don't know what's
> standard).
> 
> Nevertheless, it's a graet port for a very useful program.

--------------------------------------------------------------------------------
7	Bugs & Problems 
=======================
- I have to start it as 	xestic -display :0	else I get
  Internal error: ScrInit: Cannot open display, file xsrc/console.cc, line 898
- When it starts I (jhs) get
	Malloc warning: free(): junk pointer (too high)
  but after that it runs fine.
- Alt X does not exit properly.
- Strange error messages if a file does not exist, 
	First I get a nice error message:
		Cannot open the alias file!
	ESC
	only then do I get the nasty one I remembered
		Internal error: Call to abstract method (= 0)
		file strmable.cc
		line 46
	Source shows:
		void Streamable::Store (Stream&) const
		{
	  46	    ABSTRACT ();
		}
- Mouse cursor strangely converts to skull & crossbones.
- Alt X does not exit properly.
  UZ wrote:
  > This is usually because of a wrong setting for the modifier keys. ESTIC
  > uses Mod4 for Alt and Mod3 for Alt-Gr. Unfortunately, there is no standard
  > modifier key mapping, not even for the x86 unices, which use the same
  > keyboard layout.

--------------------------------------------------------------------------------