diff --git a/doc/en/circuits.docbook b/doc/en/circuits.docbook index 6f72d393..2fcf4097 100644 --- a/doc/en/circuits.docbook +++ b/doc/en/circuits.docbook @@ -1,84 +1,84 @@ Circuits Placing components - On the left, you'll find the Components tab. + On the left, you'll find the Components tab. Dragging a component from the sidebar into the circuit will place it under the mouse cursor. Alternatively, you can double click on an item in the Components sidebar to repeatedly add it to the circuit. In this mode, a copy of the selected component will be placed repeatedly on mouse left-clicking until either Escape is pressed, or the mouse is right-clicked. To reposition a component, left-click and drag. You'll find it snapping to the underlying grid. If you drag the component out of the right or bottom edges of the workarea, the workarea will resize itself to accommodate. All components have a notion of orientation; 0, 90, 180 and 270 degrees. Those that aren't symmetrical about an axis can also be flipped. To rotate a selection of components, either right click and select from the Orientation menu, or click on the rotate buttons in the toolbar. The latter can also be accessed by pressing the "[" and "]" keys (familiar to Inkscape users). The Item sidebar (on the right) provides a powerful method of setting the orientation by providing previews of the components. Flipping components is also only possibly via the Item sidebar. Connecting Components - There are two modes for creating connections (wires): automatic, and manual. These modes are selected via the "Connection Routing Mode" pulldown menu in the toolbar. Experiment with both - automatic routing is often better for small circuits, whereas more complex circuits may need manual routing. + There are two modes for creating connections (wires): automatic, and manual. These modes are selected via the Connection Routing Mode pulldown menu in the toolbar. Experiment with both - automatic routing is often better for small circuits, whereas more complex circuits may need manual routing. In automatic mode, create a connection by dragging from either a component pin or an existing connection, and releasing the mouse over the desired pin or connection. You'll see the straight-line being drawn turn orange when a valid connection will be created on mouse release. If the line you're drawing is black, it's either because there's nothing beneath the mouse cursor, or you're attempting to connect together two items which are already connected. When flowcharting, the criteria for a valid connection are more complex - but we'll get to that later. The best way to get a feel for manual connection routing is by experimenting with it. Click on the starting pin or connection, and then extend the proto-connector by moving the mouse away from where you clicked. To place a corner, left-click. To cancel drawing the connection, either press escape, or right-click the mouse. - &kappname; tries its best to maintain the routes your connections take. However, if dragging a component results in the end points of a connection moving relative to each other, &kappname; will be forced to redraw the connection using auto-routing. Before moving a component, you can see which connectors will have to be rerouted - as they will turn grey on clicking. + &ktechlab; tries its best to maintain the routes your connections take. However, if dragging a component results in the end points of a connection moving relative to each other, &ktechlab; will be forced to redraw the connection using auto-routing. Before moving a component, you can see which connectors will have to be rerouted - as they will turn grey on clicking. To remove an existing connection, select it by drawing a small select-rectangle over part of the connector, and hit delete. Component Attributes Most components will have editable attributes, such as the resistance for resistors. By default, you can edit simple attributes in the toolbar, when a group of the same type of components are selected. If your selection contains a mixture of different types of components (such as resistors and capacitors), then no attributes will be displayed for editing. Some components have more advanced attributes which are not accessible via the toolbar. These are found in the Item sidebar on the right. The diode, for example, has a variety of behavioural characteristics that you can edit here. If your selection of components have different values for their attributes (for example, different resistances for a selection of resistors), the Item sidebar will have the disagreeing attributes greyed-out. You can enable these by clicking the "Merge properties" button. The "Defaults" button will reset the component attributes to the ones it had on creation. There is one type of attribute that cannot be editable by either the toolbar or Item sidebar - multiline text. Double clicking on the item will bring up a dialog box where the text can be entered. Simulation By default, the simulation will be running when you create a new circuit. The status of the simulation is displayed in the lower right of a circuit view, and can be changed via the Tools menu. Firstly - a little explanation on how the Simulator works. This should allow you to make the most out of it. When a circuit is created or modified, the affected areas are partitioned up into groups of pins and connections that can be considered independent. Each group is then simulated as a separate entity (although still interacting via the components), with the simulation provided dependent on the group's complexity. Complex groups, such as those involving nonlinear components like LEDs, are slow to simulate. Groups that contain only logic pins, of which only one controls the value on those pins, are the fastest to simulate. The results of the simulation are provided through several graphical means. The pins on the components will display voltage sidebars. These are coloured orange for positive voltage, and blue for negative voltage. Their length depends on the voltage level, and their width on the amount of current flowing through the pin. These can be turned off in the Work Area tab of the Configuration dialog. Hovering the mouse over a pin or connection will display a small tooltip showing the voltage and current at that point in the circuit. Several components also provide graphical feedback - for example, LEDs and voltmeters or ammeters. Lastly, there is the oscilloscope, discussed in the next section. Oscilloscope The oscilloscope can record logic, voltage and current data. The logic probe is optimized for storing boolean samples, and so should be used instead of the voltage probe when measuring logic. To collect data, create a new probe component, and attach it to an appropriate point in the circuit. You'll see the output immediately drawn in the oscilloscope. Adding more probes will squash the outputs next to each other - you can reposition these by dragging the arrows on the left of the oscilloscope view, and change their colours via the probe's attributes. For voltage and current probes, the range of input values can be adjusted in the "Item Editor" sidebar on the right. - Zooming is controlled by a slider. The scaling is logarithmic; for every few pixels that the slider moves along, the zoom factor will be multiplied by a constant. &kappname; simulates logic to a maximum precision of 1 microsecond, and at maximum zoom level, one microsecond is represented by 8 pixels. + Zooming is controlled by a slider. The scaling is logarithmic; for every few pixels that the slider moves along, the zoom factor will be multiplied by a constant. &ktechlab; simulates logic to a maximum precision of 1 microsecond, and at maximum zoom level, one microsecond is represented by 8 pixels. When the scrollbar is dragged to the end, it will remain there as new data is recorded. Otherwise, the position of the scrollbar remains fixed in time. The oscilloscope view can also be moved forwards and backwards by left-clicking and dragging the view. Due to limitations of the underlying widget system, scrolling will be very granular at maximum zoom. Right-clicking on the oscilloscope view brings up a menu where you can control the number of times the oscilloscope view is updated. This allows for either a smoother display, or reducing CPU usage. Subcircuits Subcircuits offer a reusable and tidy way of using a circuit, when you're only interested in interacting with external connections to the circuit. The subcircuit is creating as an IC, with the pins acting as the interaction with the internal circuit. First, the circuit to be used in as a template for creating a subcircuit from must be constructed. The points of interaction are defined via "External Connection" components. These must be connected up, and positioned where you want the pin to be positioned on the subcircuit IC. Next, select the group of components and external connections to be turned into a subcircuit, and select "Create Subcircuit" from the right-click menu. You'll be offered to enter a name for the subcircuit. Once created, the name will popup in the Component selector under the Subcircuits selection. This can be treated as any normal component - with the additional option of removing it by right-clicking on the item and selecting Remove. diff --git a/doc/en/faq.docbook b/doc/en/faq.docbook index be8b354d..da64a982 100644 --- a/doc/en/faq.docbook +++ b/doc/en/faq.docbook @@ -1,68 +1,51 @@ FAQ - Configure can't find gpsim + CMake cannot find gpsim - Configure will attempt to compile several files to test for gpsim presence; testing for versions 0.21.4, 0.21.11 and 0.21.12. These files uses part of the gpsim API, that is also used by &kappname;, and was introduced in the respective gpsim versions. If it fails in compiling this program, it will display the warning to the user, and PIC simulation support will not be compiled into &kappname;. There are a number of possibly reasons for finding gpsim to fail: + CMake will attempt to compile several files to test for gpsim presence; testing for versions 0.21.4, 0.21.11 and 0.26. These files uses part of the gpsim API, that is also used by &ktechlab;, and was introduced in the respective gpsim versions. If it fails in compiling this program, it will display the warning to the user, and PIC simulation support will not be compiled into &ktechlab;. There are a number of possibly reasons for finding gpsim to fail: - gpsim >= 0.21.4 is not installed. &kappname; does not support gpsim-0.21.2 or gpsim-0.20.14 (or any earlier versions). Later versions may work; but this cannot be tested before they are released. The latest gpsim can be obtained from the gpsim website. - Gpsim is installed, but the header files could not be found. If gpsim is installed in a non-standard location, you may need to specify the location of the header files with "./configure --with-extra-includes=DIR". It is also likely you'll need to specify a library location with the configure option "--with-extra-lib" if the includes are in a non-standard location. - Gpsim is installed and the headers are somewhere where configure can find them, but there is some other glib craziness occurring. + gpsim >= 0.21.4 is not installed. &ktechlab; does not support gpsim-0.21.2 or gpsim-0.20.14 (or any earlier versions). Later versions may work; but this cannot be tested before they are released. The latest gpsim can be obtained from the gpsim website. + Gpsim is installed, but the header files could not be found. If gpsim is installed in a non-standard location, you may need to specify the location of the header files with cmake . It is also likely you'll need to specify a library location with the CMake option GPSim_INCLUDE_DIR if the includes are in a non-standard location. + Gpsim is installed and the headers are somewhere where CMake can find them, but there is some other glib craziness occurring. - Configure generates the file config.log which will contain details of exactly what went wrong. Searching for gpsim in this log should help you decide what's happened. As an example, here is part of the config.log file where one of the gpsim header files is missing: + CMake generates the file CMakeError.log which will contain details of exactly what went wrong. Searching for gpsim in this log should help you decide what's happened. As an example, here is part of the CMakeError.log file where one of the gpsim header files is missing: - Possible config.log output where gpsim detection failed + Possible CMakeError.log output where gpsim detection failed -configure:30956: checking for gpsim 0.21.4 availability -configure:31009: g++ -c -I/usr/include/glib-2.0 -I/usr/lib/glib-2.0/include --DQT_THREAD_SUPPORT -O3 -march=athlon-xp -mcpu=athlon-xp -D_REENTRANT -conftest.cc >&5 -conftest.cc:48:35: gpsim/gpsim_interface.h: No such file or directory +Building CXX object CMakeFiles/cmTryCompileExec4251549203.dir/src.cxx.o +/usr/share/colorgcc/c++ -DHAVE_GPSIM_0_26 -fexceptions -I/usr/lib64/glib-2.0/include -o CMakeFiles/cmTryCompileExec4251549203.dir/src.cxx.o +-c /home/user/playground-devtools/ktechlab/build/CMakeFiles/CMakeTmp/src.cxx +/home/user/playground-devtools/ktechlab/build/CMakeFiles/CMakeTmp/src.cxx:1:33: fatal error: gpsim/pic-processor.h: No such file or directory + #include <gpsim/pic-processor.h> + ^ +compilation terminated. - If the config.log doesn't help, please contact the &kappname; developers with the relevant parts of config.log attached. - - - - - &kappname; crashes when running a PIC program - - - - Version 0.21.11 of gpsim contains a bug that may cause &kappname; to crash on the second running of a PIC program. This bug has since been fixed in gpsim-cvs. The &kappname; website provides a patched version of the stable release of gpsim that fixes this bug. - - - - - - High Level Language (HLL) debugging does not work - - - - Version 0.21.11 of gpsim contains a bug preventing HLL debugging from working. This bug has since been fixed in gpsim-cvs. The &kappname; website provides a patched version of the stable release of gpsim that fixes this bug. + If the CMakeError.log does not help, please contact the &ktechlab; developers with the relevant parts of CMakeError.log attached. - &kappname; uses lots of CPU + &ktechlab; uses lots of CPU - There are several possible causes. Simulation of circuits that contain both reactive and nonlinear components (such as capacitors and transistors) take a lot of CPU time to simulate. You can pause and resume the simulation via the Tools menu. + There are several possible causes. Simulation of circuits that contain both reactive and nonlinear components (such as capacitors and transistors) take a lot of CPU time to simulate. You can pause and resume the simulation via the Tools menu. - Drawing of the work area (in particular, redrawing lots of rapidly updating voltage bars on pins) is also CPU intensive. You can reduce the refresh rate or turn off the voltage bars via the Settings dialog. The refresh rate of the Oscilloscope can also be reduced by right clicking on its display. + Drawing of the work area (in particular, redrawing lots of rapidly updating voltage bars on pins) is also CPU intensive. You can reduce the refresh rate or turn off the voltage bars via the Settings dialog. The refresh rate of the Oscilloscope can also be reduced by right clicking on its display. - Note that the next major release of &kappname; will be a lot faster in both displaying the work area and simulating reactive and nonlinear components. + Note that the next major release of &ktechlab; can be a lot faster in both displaying the work area and simulating reactive and nonlinear components. diff --git a/doc/en/flowcode.docbook b/doc/en/flowcode.docbook index 6f74dbb0..dbef18e0 100644 --- a/doc/en/flowcode.docbook +++ b/doc/en/flowcode.docbook @@ -1,52 +1,52 @@ &flowcode; Introduction - &flowcode; allows for very quick and easy construction of a PIC program. After the user has constructed a flowchart from the program parts available, &kappname; can then convert the flowchart into a number of formats. To output hex, for example, the following chain of conversions takes place: + &flowcode; allows for very quick and easy construction of a PIC program. After the user has constructed a flowchart from the program parts available, &ktechlab; can then convert the flowchart into a number of formats. To output hex, for example, the following chain of conversions takes place: - The &flowcode; is converted to µbe;; a high-level language whose compiler is distributed with &kappname;. + The &flowcode; is converted to µbe;; a high-level language whose compiler is distributed with &ktechlab;. The microbe executable then compiles the µbe; file to PIC assembly. Finally, gpasm takes the PIC assembly file, and outputs the hex for the program. Of course, if you don't have gputils installed - with which gpasm is distributed - then the last step can't be performed. Creating a Program - Every &flowcode; program needs a unique starting point - this is the place where your program will be run from on PIC startup. To define this point, open up the FlowParts sidebar on the left, and drag across the Start part. &kappname; will only allow you to use one of these. + Every &flowcode; program needs a unique starting point - this is the place where your program will be run from on PIC startup. To define this point, open up the FlowParts sidebar on the left, and drag across the Start part. &ktechlab; will only allow you to use one of these. You can then construct your program by using the predefined parts on the left - or insert code of your own (in assembly or µbe; format) via the Embed part. The flow of the program is controlled via the connections between the FlowParts - offers more detail on creating connections. &flowcode; imposes limitations in addition to those of Circuits on what can be connected. For example, each FlowPart can only have one output connection. Additional limitations are described in . PIC Settings When you create a new &flowcode; document, you'll notice a picture of the PIC you're using in the top-left corner of the work area. This represents the initial settings of the PIC. Each pin shown on the picture of the PIC shows the initial type of pin (input or output), and its initial state (high or low). You can change these by dragging the pin to set the type, and clicking on it to toggle its state. The Settings dialog, invoked by clicking on the Settings button, also allows you to edit the initial pin types and states - in this case, by editing the binary values written to the PORT and TRIS registers. As well as pin settings though, the dialog allows editing of the initial values of variables in the PIC program. At the bottom, there is a list of currently defined pin maps, as well as buttons to manipulate them. Pin maps are used to specify how a seven segment or a keypad is connected to a PIC. To use the Seven Segment or the Keypad &flowcode; parts, you will need to define a pin map here first. Nestling &flowcode; Many FlowParts, such as subroutines and loops, can contain code of their own. After creating such a container, FlowParts can be added by either dragging or dropping them into the container. The container will be highlighted to indicate that it will become the new parent of the FlowPart. The container takes responsibility for FlowParts nestled inside. If the expand button is unclicked, all contained FlowParts will be hidden - and likewise, the contents will be shown when the expand button is clicked again. Connections cannot be made between FlowParts in different containers, and the contents of a container will be moved about along with the container. diff --git a/doc/en/index.docbook b/doc/en/index.docbook index db8f7e2d..4f0d6336 100644 --- a/doc/en/index.docbook +++ b/doc/en/index.docbook @@ -1,56 +1,55 @@ + - ]> - + - The KTechlab Handbook + The &ktechlab; Handbook David Saxton
david@bluehaze.org
 Daniel Clarke - 2005-12-27 - 0.3 + 2017-01-01 + 0.3.6 KTechlab is an IDE for microcontrollers and electronics. KTechlab KDE Development Electronics Simulation PICs Microbe - + &ktechlab-quick; &ktechlab-pic-programs; &ktechlab-circuits; &ktechlab-flowcode; &ktechlab-microbe; &ktechlab-debugging; &ktechlab-faq; diff --git a/doc/en/microbe.docbook b/doc/en/microbe.docbook index 203ceb88..853d2b82 100644 --- a/doc/en/microbe.docbook +++ b/doc/en/microbe.docbook @@ -1,426 +1,426 @@ µbe; Introduction and General Syntax - Microbe compiles programs written in the custom language for PICs, as a companion program to &kappname;. The syntax has been designed to suit a &flowcode; program. + Microbe compiles programs written in the custom language for PICs, as a companion program to &ktechlab;. The syntax has been designed to suit a &flowcode; program. The syntax for running microbe from the commandline is: microbe [options] [input.microbe] [output.asm] where options are: --show-source - Puts each line of µbe; source code as a comment in the assembly output before the assembly instructions themselves for that line. --no-optimize - Prevent optimization of the instructions generated from the source. Optimization is usually safe, and so this option is mainly used for debugging. The .microbe input file must identify the target PIC by inserting the PIC name at the top of the .microbe file; e.g. the name of a PIC16F84 is "P16F84". Simple complete µbe; program P16F84 a = 0 repeat { PORTA = a a = a + 1 } until a == 5 end Naming conventions The following rules apply to variable names and labels: They can only contain alphanumerical characters [a..z][A..Z][0..9] and the underscore "_". They are case-sensitive. They cannot start with a number. They should not start with "__" (double underscore), as this is reserved for use by the compiler. Bracing conventions Curly braces, {}, indicate the start and end of a code block. They can appear anywhere before the start and after the end of the code block. Examples of acceptable code blocks: statement1 { some code } statement2 { other code } statement3 { other code } statement5 { code block } statement6 Commenting Commenting is similar to C. // comments out the rest of the line. /* and */ denote a multiline comment. // This is a comment x = 2 /* As is this multiline comment */ Program Structure The PIC id must be inserted at the top of the program. The end of the main program is denoted with "end". Subroutines must placed after "end". Subroutines A subroutine can be called from anywhere in the code. Syntax: sub SubName { // Code... } The subroutine is called with "call SubName". µbe; language reference if Conditional branching. Syntax: if [expression] then [statement] or if [expression] then { [statement block] } Similarly for else: else [statement] or else { [statement block] } if if porta.0 is high then { delay 200 } else { delay 300 } alias Aliases one string to another. Syntax: alias [from] [to] repeat Executes the statement block repeatedly until expression evaluates to true. The evaluation of the expression is performed after the statement block, so the statement block will always be executed at least once. Syntax: repeat { [statement block] } until [expression] while Similar to repeat, this repeatedly executes the statement block. However, the expression is evaluated before execution, not after. So if the expression evaluates to false on the first pass, then the statement block will not get executed. Syntax: while [expression] { [statement block] } goto This causes execution of the code to continue at the next statement after the label specified. Goto syntax: goto [labelname] Label syntax: labelname: It is often considered good programming practice to avoid the use of goto. Use of control statements and subroutines will result in a much more readable program. goto goto MyLabel ... [MyLabel]: // Code will continue at this point call Calls a subroutine. Syntax: call [SubName] where SubName is the name of the subroutine to be called. delay This causes the code execution to stop for the given period of time. The interval is in milliseconds. Syntax: delay [interval] At present, µbe; assumes that the PIC is operating at a frequency of 4Mhz - i.e. each instruction takes 1 microsecond to execute. If this is not the case, the interval must be adjusted proportionately. sevenseg This is used to define the pin mapping for a (common cathode) seven segment display connected to the PIC. Syntax: sevenseg [name] [a] [b] [c] [d] [e] [f] [g] where [a]...[g] are the PIC pins to which the respective segments of the seven segment display are attached. The pins can be written either as PORTX.N or RXN. To display a number on the seven segment, the pin mapping is treated as a write only variable. Defining and outputting to a seven segment sevenseg seg1 RB0 RB1 RB2 RB3 RB4 RB5 RB6 seg1 = x + 2 keypad This is used to define the pin mapping for a keypad connected to the PIC. Syntax: keypad [name] [row 1] ... [row 4] [column 1] ... [column n] where [row 1] ... [row 4] and [column 1] ... [column n] are the PIC pins to which the respective rows and columns of the keypad are attached (at the moment, the number of rows is not changeable). See (above) for more information on pin mappings. The columns of the keypad should be pulled down via 100k resistors to ground. The row pins must be configured as outputs and the column pins as inputs. Once the keypad has been defined, it is treated as a read only variable. Defining and reading from a keypad keypad keypad1 RB0 RB1 RB2 RB3 RB4 RB5 RB6 x = keypad1 By default, the values returned for a keypad are: The value of the number if it is a numeric key (1 to 3 along top row; hexadecimal A to D down the fourth column and continuing for each extra column). 253 for the key in row 4, column 1. 254 for the key in row 4, column 3. These values can be redefined by using the alias command, where the name of the key in row x, column y (rows and columns starting at 1), is Keypad_x_y. For example, to give the star key on a 4x3 keypad the value zero, the following alias would be used: Aliasing a keypad key to a value alias Keypad_4_1 0 PIC I/O Port Direction The port direction is set by assigning a value to TRIS*, where * is the port letter. For example: Setting port directions TRISB = b'01111001' The above sets pins RB1, RB2 and RB7 on PORTB as outputs, and the other pins on PORTB as inputs. In this example, b'01111001' is a binary representation of the output type. The 1 on the right represents an output on RB0, and the 0 on the left represents an input on RB7. Port I/O The port can be treated as a variable. For example: Writing to a port x = PORTA The above assigns the value of PORTA to the variable x. Pin I/O Each pin on a port is obtained by prefixing the pin number by the port name; e.g. Pin 2 (starting from Pin 0) on PORTA is known as PORTA.0. The syntax to set a pin state is: PORTX.N = STATE where STATE can be high or low. The syntax to test a pin state is: if PORTX.N is STATE then Combining these examples, we have: Setting and testing pin state TRISA = 0 TRISB = 255 if PORTA.3 is high then { PORTB.5 = low } else { PORTB = PORTA + 15 } Variables All variables are 8-bit unsigned integers, giving a range from 0 to 255. µbe; supports the typical unary operations (acting on one variable) and binary operations (acting on two variables) that are supported by the PIC. In addition, µbe; also supports division and multiplication. Unary Operations rotateleft x - Rotates the variable x left through carry. rotateright x - Rotates the variable x right through carry. increment x - Increments the variable x. If x has a value of 255, then x wraps round to 0. decrement x - Decrements the variable x. If x has a value of 0, then x wraps round to 255. Arithmetic Supported operations: Addition: x + y Subtraction: x - y Multiplication: x * y Division: x / y Binary XOR: x XOR y Binary AND: x AND y Binary OR: x OR y Comparison Supported operations: Equals: x == y Does not equal: x != y Is greater than: x > y Is less than: x < y Is greater than or equal to: x >= y Is less than or equal to: x <= y For example: Comparison if PORTA >= 5 then { ... } diff --git a/doc/en/picprograms.docbook b/doc/en/picprograms.docbook index 858e75a7..03ab43a6 100644 --- a/doc/en/picprograms.docbook +++ b/doc/en/picprograms.docbook @@ -1,44 +1,44 @@ PIC Programs Manipulation When you create a FlowCode or a Text document, you'll notice a drop down menu in the toolbar with a rocket icon. From here, you can manipulate your PIC program; changing it to different forms. Convert to µbe; - This is used only in &flowcode; documents. This is explained further in . - Convert to Assembly - This can be used in four contexts. When a &flowcode; document is open, it will output the &flowcode; as assembly instructions. When a µbe; document is open, it will invoke the microbe program distributed with &kappname; to compile the program. Similarly, if a C program is open, it will attempt to compile it via SDCC. When a text document containing PIC hex is open, it will invoke gpdasm to disassemble the hex. + Convert to Assembly - This can be used in four contexts. When a &flowcode; document is open, it will output the &flowcode; as assembly instructions. When a µbe; document is open, it will invoke the microbe program distributed with &ktechlab; to compile the program. Similarly, if a C program is open, it will attempt to compile it via SDCC. When a text document containing PIC hex is open, it will invoke gpdasm to disassemble the hex. Convert to Hex - This can also be used in four contexts. As with Convert to Assembly, this can be used with &flowcode;, µbe; and C documents. It will also be enabled when an assembly document is open to assemble it via gpasm. Upload to PIC - This assembles the PIC program currently being edited, and uploads it using the programmer that the user has selected. None of these actions require the current document to be saved - very useful for when a quick program is required. For non-PIC targets, the Output Dialog invoked on clicking on one of these actions can either output the result (always text in the above three cases) to a fresh document, or to a file. If the output is saved to file, it also provides options to load the file after creation, and adding the newly created file to the open project (if one is open). - Note that you can make &kappname; always use the same view for displaying the outputted content by selecting the option under General Settings. + Note that you can make &ktechlab; always use the same view for displaying the outputted content by selecting the option under General Settings. Uploading - &kappname; uses third-party programmers to upload programs to PICs. A variety of common programmers come predefined. Others can be added via the Settings dialog. See the &kappname; website for more information. + &ktechlab; uses third-party programmers to upload programs to PICs. A variety of common programmers come predefined. Others can be added via the Settings dialog. See the &ktechlab; website for more information. The list of ports is obtained from scanning for serial and parallel ports that are readable and writable. Serial ports are looked for in: /dev/ttyS[0..7] /dev/tts/[0..7] /dev/ttyUSB[0..7] /dev/usb/tts/[0..7] Parallel ports are looked for in: /dev/usb/parport[0..7] /dev/usb/parports/[0..7] diff --git a/doc/en/quick.docbook b/doc/en/quick.docbook index 0cf7f293..d13e4a69 100644 --- a/doc/en/quick.docbook +++ b/doc/en/quick.docbook @@ -1,42 +1,42 @@ Quick Tour Introduction - &kappname; is an IDE for electronic circuits and microcontrollers. It can perform simulation a variety of components (logic, integrated, linear, nonlinear and reactive), simulation and debugging of PIC microcontrollers via gpsim, and comes with its own closely-linked and complementary high level languages: &flowcode; and µbe;. + &ktechlab; is an IDE for electronic circuits and microcontrollers. It can perform simulation a variety of components (logic, integrated, linear, nonlinear and reactive), simulation and debugging of PIC microcontrollers via gpsim, and comes with its own closely-linked and complementary high level languages: &flowcode; and µbe;. It has been designed to be as easy to use and unintrusive as possible; all components and FlowParts have context sensitive help, and simulating electronics is as simple as dragging components onto the work area and creating connectors that autoroute themselves between their pins. &flowcode; allows users new to PICs to instantly create their own programs, while the electronic simulation allows stepping through a PIC's assembly program inside a circuit. Documents - To get started in &kappname;, you will need to create a new document, whose type will depend on your task: + To get started in &ktechlab;, you will need to create a new document, whose type will depend on your task: &flowcode; Document - Construct a PIC program via flowcharting. Circuit Document - Simulate electronics circuits and microcontrollers. µbe; Document - High level language for PICs, also used by &flowcode; to generate assembly. Assembly Document - Start writing a PIC assembly program. - &kappname; uses a Document-View model, in that the Document logic is completely separate from open views of the document. This allows several views of the same file. + &ktechlab; uses a Document-View model, in that the Document logic is completely separate from open views of the document. This allows several views of the same file. On creating a new document, the view is created in a separate tab. Each tab can support any number of views, tiled in any arbitrary pattern. This allows, for example, simulating a PIC program in circuit, while stepping through the program in an assembly document in the same tab. The contents of tabs can be duplicated by dragging the tab to an empty area on the tab bar. They can be inserted into an existing tab by dragging it onto that tab. Detailed instructions on the above documents can be found in their own respective chapters. Drawing In Circuit and &flowcode; documents, there are several drawing tools available, including text. These are available by clicking on the paintbrush icon in the toolbar. To draw, drag the mouse to form either a shape or a line appropriate to the drawing tool in use. When a drawing is selected, it can be resized by dragging its handles. Holding down shift while dragging will snap the handle to the underlying grid. Each tool has basic options accessible from the toolbar, such as colours. There are also more advanced options found in the Item sidebar, such as line and cap styles. \ No newline at end of file