Script interface (ddcp-script) support for windows
[digitaldcpower] / README.htm
index 00e9973..c4027fd 100644 (file)
@@ -1,10 +1,16 @@
 <h2>Tuxgraphics Digital DC Power Supply Unit</h2>
+Software for version the version 3 hardware.
 <pre>
 
-Compile the software and program the microcontroller:
+Compiling the software and programming 
+the microcontroller (atmega8 or atmega8a):
+==========================================
 
 1) edit and adapt the file hardware_settings.h 
    (calibration and selection of the right hardware type).
+   You can as well just copy one of the pre-set versions
+   on top of hardware_settings.h. 
+   Example: cp hardware_settings.h-22V hardware_settings.h
 
 2) load and compile:
 make 
@@ -15,9 +21,9 @@ make fuse
 
 This should result in the following settings:
 
-avrdude: Device signature = 0x1e9307
-avrdude: safemode: lfuse reads as A4
-avrdude: safemode: hfuse reads as D9
+  Device signature = 0x1e9307
+   lfuse reads as A4
+   hfuse reads as D9
 
 Fuse Low Byte details
 
@@ -30,13 +36,13 @@ CKSEL2    Select Clock source              = 1
 CKSEL1    Select Clock source              = 0
 CKSEL0    Select Clock source              = 0
 
-The make fuse needs to be done only once
-unless you change the Atmega8 chip. make/make load
+The "make fuse" needs to be done only once
+unless you change the Atmega8/Atmega8a chip. make/make load
 need to be repeated everytime you change something
 in the software (e.g update of hardware_settings.h). 
 
 The poweresupply must be powered up during programming
-but nothing should be connected to the output. Make
+but nothing should be connected on the output. Make
 sure that you do not accidently press any button
 during the programming (loading the software into the uC).
 
@@ -57,7 +63,7 @@ on those batch files.
                  case you do not need to use this batch file.
 
  winsetfuse.bat -- set fuse bytes using avrdude, may also use
-                   some other means of loading the softare. In that
+                   some other means of changing the fuse bytes. In that
                    case you do not need to use this batch file.
 
 Calibration
@@ -76,16 +82,15 @@ A microncontroller controlled bench DC power supply unit.
 
 All of the control logic is implemented in software. This
 saves a lot of parts compared to conventional lab-power 
-supplies. This means it is cheaper, easier to build and
+supplies and means it is cheaper, easier to build and
 offers more functionallity.
 
 Note however that this means also that the short circuit
-protection is implemented in software. So be careful when
+protection is implemented in software. Be careful when
 you change something in the software. If the microcontroller 
 is not running properly due to a software fault then there
 might not be any short circuit protection.
 
-
 The software is prepared for 2 versions:
 - 0-22V 0-2.5A
 - 0-30V 0-2A
@@ -94,6 +99,8 @@ If you want to build a version that has a smaller output
 range than any of the two version then you can just
 modify the file hardware_settings.h.
 
+Remote control from your PC
+===========================
 The unit can be controlled remotely from a computer using
 a USB serial interface. An add-on card is available from
 http://shop.tuxgraphics.org which offers galvanic separation
@@ -118,11 +125,11 @@ Serial port settings for the terminal:
 
 port       : Virtual com port (e.g /dev/ttyUSB1 or /dev/ttyUSB0
              or COM5 under windows or ... whatever port the
-            virtual com-port maps to)
-            Under linux or Mac you can use the command dmesg
-            after you have plugged in the USB cable to see to 
-            which com-port/device the new virtual com port maps to.
-            
+             virtual com-port maps to)
+             Under linux or Mac you can use the command dmesg
+             after you have plugged in the USB cable to see to 
+             which com-port/device the new virtual com port maps to.
+             
 baudrate   : 9600
 parity     : none
 flowcontrol: none
@@ -132,29 +139,37 @@ databits   : 8
 </pre>
 <br>
 <img src=screenshot-cmd-interface.gif>
-<br>
-<br>
-At shop.tuxgraphics.org you can get an optically insulated
-USB to serial interface add-on kit such that your computer
-is galvanically separated from the power supply but still able
-to give commands. This enables you as well to use two power supplies
-to provide positive and negative supply voltages for e.g. an operational amplifier.
-
 <br>
 <br>
 <pre>
+Controling the power supply with scriptable commands
+====================================================
 You can control the digital power supply by commands. A number 
 of commands are provided for this purpose. They are at the moment
-available for Linux and Mac:
+available for Linux, Mac and Windows:
 
 
-ddcp-script-ttyinit   - initialize the COM port
+ddcp-script-ttyinit   - initialize the COM port (run this once at
+                        at the beginning)
 ddcp-script-getval    - get current values (same as you see on the LCD)
 ddcp-script-setval    - send a command to the power supply
 
-ddcp-script-example.sh  - an example shell script showing how to use 
+ddcp-script-example.sh  - an example unix shell script showing how to use 
                           the above commands
 
+To compile the ddcp-script commands under linux and on the mac
+use the command:
+
+make ddcp-script
+
+The windows versions of those commands are available in the
+sub-directory "ddcp-script-windows". The windows versions
+are compiled in that sub-directory with the command:
+
+make
+
+Pre-compiled binaries are available for winXP.
+
 -------------------------------------------------------------------
 Copyright: GPL V2
 Author: Guido Socher
@@ -162,19 +177,22 @@ Homepage: http://www.tuxgraphics.org/electronics/
 -------------------------------------------------------------------
 Change history:
 digitaldcpower-0.6.0 -- 2010-05-22 first version of the new power V3.
-                        This version is made for a new type of hardware
-                        and will not run on any previous hardware version.
+                         This version is made for a new type of hardware
+                         and will not run on any previous hardware version.
 
 digitaldcpower-0.6.1 -- 2010-06-06 Number conversion to display string
-                        improved.
-                     -- Basic uart interface prompt, no remote control yet
+                         improved.
+                         Basic uart interface prompt, no remote control yet
 
 digitaldcpower-0.6.2 -- 2010-06-26 Full UART command interface
+
 digitaldcpower-0.6.3 -- 2010-07-03 Accelerate UART command polling to
-                        not loose characters when copied/pasted at high speed.
-                       Line editing with backspace if terminal supports it.
-                       Set BOD (brown out detector enable) fuse.
-                       Script interface (ddcp-script)
-                        
+                         not loose characters when copied/pasted at high speed.
+                         Line editing with backspace if terminal supports it.
+                         Set BOD (brown out detector enable) fuse.
+                         Script interface (ddcp-script)
+digitaldcpower-0.6.4 -- 2010-07-11 added ddcp-script interface 
+                         commands for windows.
 -------------------------------------------------------------------
+ vim: set sw=8 ts=8 si et :
 </pre>