3 * Copyright © 2017 František Kučera (frantovo.cz)
5 * This program is free software: you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation, either version 3 of the License, or
8 * (at your option) any later version.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License
16 * along with this program. If not, see <http://www.gnu.org/licenses/>.
25 #include <chrono> // requires -std=c++11
28 * can not mix printf and wprintf
29 * see https://stackoverflow.com/questions/8681623/printf-and-wprintf-in-single-c-code
30 * > This is to be expected; your code is invoking undefined behavior.
31 * > Per the C standard, each FILE stream has associated with it an "orientation" (either "byte" or "wide)
32 * > which is set by the first operation performed on it, and which can be inspected with the fwide function.
33 * > Calling any function whose orientation conflicts with the orientation of the stream results in undefined behavior.
41 // run this program: make run
42 // depending on frequency and machine performance the total time will be more than given duration
43 // despite the real-time priority, because some additional time is spent in outb() functions
44 // so "duration" means total sleep time
47 //cout << "LPT!" << endl; // same as using printf → breaks all folllowing wprintf() calls, see note above
50 * if setlocale() is missing, unicode characters are replaced with ? or „→“ with „->“ because C/POSIX locale is used,
52 * > On startup of the main program, the portable "C" locale is selected as default.
53 * > If locale is an empty string, "", each part of the locale that should be modified is set according to the environment variables.
59 int addr = 0xe400; // parallel port address; first number of given port in: cat /proc/ioports | grep parport
60 int baseFreq = 10000; // base frequency in Hz, should be between 5 000 between 10 000 Hz; lower frequency leads to dashed/dotted lines instead of greyscale
61 int outputPower = 20; // duty cycle; 100 = 100 %
62 int duration = 1; // in seconds; total sleep time, see note above
66 int valueWidth = 10; // just for padding of printed values
67 int labelWidth = -15; // just for padding of printed labels
69 // ' = thousand separator
71 wprintf(L"%*ls %*x\n", labelWidth, L"Parallel port:", valueWidth, addr); // or %#*x – adds 0x prefix
72 wprintf(L"%*ls %'*d Hz\n", labelWidth, L"Base frequency:", valueWidth, baseFreq);
73 wprintf(L"%*ls %*d %% duty cycle\n", labelWidth, L"Output power:", valueWidth, outputPower);
74 wprintf(L"%*ls %'*d s\n", labelWidth, L"Duration:", valueWidth, duration);
77 int oneSecond = 1000 * 1000;
78 int timeOn = oneSecond * outputPower / 100 / baseFreq;
79 int timeOff = oneSecond * (100 - outputPower) / 100 / baseFreq;
81 int cycleCount = duration * baseFreq;
82 wprintf(L"%*ls %'*d ×\n", labelWidth, L"Cycle count:", valueWidth, cycleCount);
83 wprintf(L"%*ls %'*d μs 1× in each cycle\n", labelWidth, L"Time on:", valueWidth, timeOn);
84 wprintf(L"%*ls %'*d μs 1× in each cycle\n", labelWidth, L"Time off:", valueWidth, timeOff);
86 //wprintf(L"%*ls %*ls\n", labelWidth, L"unicode test:", valueWidth, L"čeština → …");
90 if (ioperm(addr,1,1)) { fwprintf(stderr, L"Access denied to port %#x\n", addr), exit(1); }
94 auto startTimestamp = chrono::high_resolution_clock::now();
95 auto calibrationCycles = 10000;
96 auto calibrationSleepTime = 10;
98 for (int i = 0; i < calibrationCycles; i++) {
99 outb(0b00000000, addr);
100 usleep(calibrationSleepTime);
101 outb(0b00000000, addr);
102 usleep(calibrationSleepTime);
105 auto finishTimestamp = chrono::high_resolution_clock::now();
106 auto measuredDuration = chrono::duration_cast<chrono::nanoseconds>(finishTimestamp - startTimestamp).count();
108 auto singleOutbCostNano = (measuredDuration - calibrationCycles*2*calibrationSleepTime*1000)/calibrationCycles/2;
109 auto singleOutbCostMicro = singleOutbCostNano/1000;
111 wprintf(L"%*ls %'*d μs 2× in each calibration cycle\n", labelWidth, L"Single outb():", valueWidth, singleOutbCostMicro);
112 wprintf(L"%*ls %'*d ns 2× in each calibration cycle\n", labelWidth, L"Single outb():", valueWidth, singleOutbCostNano);
114 auto minPower = 100*singleOutbCostNano/(1000*1000*1000/baseFreq);
115 auto maxPower = 100-minPower;
116 wprintf(L"%*ls %*d %% feasible duty cycle\n", labelWidth, L"Minimum power:", valueWidth, minPower);
117 wprintf(L"%*ls %*d %% feasible duty cycle\n", labelWidth, L"Maximum power:", valueWidth, maxPower);
119 if (singleOutbCostMicro < timeOn && singleOutbCostMicro < timeOff) {
120 wprintf(L"%*ls %*ls both frequency and duty cycle should be correct\n", labelWidth, L"Calibration:", valueWidth, L"OK");
121 timeOn -= singleOutbCostMicro;
122 timeOff -= singleOutbCostMicro;
123 } else if (2*singleOutbCostMicro < (timeOn + timeOff)) {
124 wprintf(L"%*ls %*ls frequency should be OK, but duty cycle is not feasible\n", labelWidth, L"Calibration:", valueWidth, L"WARNING");
125 timeOn -= singleOutbCostMicro;
126 timeOff -= singleOutbCostMicro;
136 wprintf(L"%*ls %*ls both frequency and duty cycle are not feasible\n", labelWidth, L"Calibration:", valueWidth, L"ERROR");
141 wprintf(L"%*ls %'*d μs 1× in each cycle\n", labelWidth, L"Sleep on:", valueWidth, timeOn);
142 wprintf(L"%*ls %'*d μs 1× in each cycle\n", labelWidth, L"Sleep off:", valueWidth, timeOff);
147 // actual signal generation
148 startTimestamp = chrono::high_resolution_clock::now();
150 for (int i = 0; i < cycleCount; i++) {
151 outb(0b00000001, addr); // first data out pin = data out 0 = pin 2 on DB-25 connector
153 outb(0b00000000, addr);
157 finishTimestamp = chrono::high_resolution_clock::now();
158 measuredDuration = chrono::duration_cast<chrono::nanoseconds>(finishTimestamp - startTimestamp).count();
160 wprintf(L"%*ls %'*d μs in total\n", labelWidth, L"Deviation:", valueWidth, (measuredDuration-duration*oneSecond*1000)/1000);
161 wprintf(L"%*ls %'*d ns in each cycle\n", labelWidth, L"Deviation:", valueWidth, (measuredDuration-duration*oneSecond*1000)/cycleCount);