{"id":959,"date":"2016-07-30T11:14:38","date_gmt":"2016-07-30T11:14:38","guid":{"rendered":"http:\/\/avitech.com.au\/?page_id=959"},"modified":"2017-06-05T00:49:29","modified_gmt":"2017-06-05T00:49:29","slug":"ked-mini-how-to-guide","status":"publish","type":"page","link":"https:\/\/avitech.com.au\/?page_id=959","title":{"rendered":"KED Mini How-To Guide"},"content":{"rendered":"<h4>Introduction<\/h4>\n<p>This is a short guide to using the text editor called &#8220;KED&#8221; in RT-11 on the PDP-11.<\/p>\n<p>KED is a full-screen editor that comes with RT-11.  It is intended to be used with a VT100 or later model DEC serial terminal. A similar editor called K52 is for use with VT52 and VT55 terminals.<\/p>\n<p>For the sake of simplifying this guide, I am going to be focussing on VT100 (and VT100 compatible) terminals. So I will not be discussing the differences between K52 and KED here.<\/p>\n<p>My main interest in KED is using it to create and edit PDP-11 assembly language source code files and plain-text files, both on real VT100 terminals, and on a PC-keyboard under SIMH.<\/p>\n<h4>Starting KED<\/h4>\n<p>There are several ways to start KED (KED.SAV) and load your existing text file (or create a new text file).<\/p>\n<p>The method I prefer is to type <em>&#8220;KED [filename] &lt;CR&gt;&#8221;<\/em> at the RT-11 prompt.<\/p>\n<p>If the file does not exist, you will be asked to confirm that it should be created.<\/p>\n<p>Here is an example of starting KED and creating a new file:<\/p>\n<pre>\r\n.<span class=\"crt-input\">KED MYDOC.TXT \u2936<\/span>\r\n ?KED-W-File not found - Create it (Y,N)? <span class=\"crt-input\">Y \u2936<\/span>\r\n<\/pre>\n<p>KED will then start and your file will be displayed. If you are creating a new file, the screen will be blank except for a flashing cursor in the top left corner.<\/p>\n<h4>VT100 Keyboard<\/h4>\n<p><a href=\"https:\/\/i0.wp.com\/avitech.com.au\/wp-content\/uploads\/2016\/07\/keypad-vt100-1293.jpg?ssl=1\"><img data-recalc-dims=\"1\" loading=\"lazy\" decoding=\"async\" data-attachment-id=\"964\" data-permalink=\"https:\/\/avitech.com.au\/?attachment_id=964\" data-orig-file=\"https:\/\/i0.wp.com\/avitech.com.au\/wp-content\/uploads\/2016\/07\/keypad-vt100-1293.jpg?fit=1293%2C1550&amp;ssl=1\" data-orig-size=\"1293,1550\" data-comments-opened=\"1\" data-image-title=\"keypad-vt100-1293\" data-image-description=\"\" data-image-caption=\"\" data-large-file=\"https:\/\/i0.wp.com\/avitech.com.au\/wp-content\/uploads\/2016\/07\/keypad-vt100-1293.jpg?fit=854%2C1024&amp;ssl=1\" src=\"https:\/\/i0.wp.com\/avitech.com.au\/wp-content\/uploads\/2016\/07\/keypad-vt100-1293.jpg?resize=250%2C300&#038;ssl=1\" alt=\"keypad-vt100-1293\" width=\"250\" height=\"300\" class=\"alignright size-medium wp-image-964\" srcset=\"https:\/\/i0.wp.com\/avitech.com.au\/wp-content\/uploads\/2016\/07\/keypad-vt100-1293.jpg?resize=250%2C300&amp;ssl=1 250w, https:\/\/i0.wp.com\/avitech.com.au\/wp-content\/uploads\/2016\/07\/keypad-vt100-1293.jpg?resize=768%2C921&amp;ssl=1 768w, https:\/\/i0.wp.com\/avitech.com.au\/wp-content\/uploads\/2016\/07\/keypad-vt100-1293.jpg?resize=854%2C1024&amp;ssl=1 854w, https:\/\/i0.wp.com\/avitech.com.au\/wp-content\/uploads\/2016\/07\/keypad-vt100-1293.jpg?resize=125%2C150&amp;ssl=1 125w, https:\/\/i0.wp.com\/avitech.com.au\/wp-content\/uploads\/2016\/07\/keypad-vt100-1293.jpg?resize=300%2C360&amp;ssl=1 300w, https:\/\/i0.wp.com\/avitech.com.au\/wp-content\/uploads\/2016\/07\/keypad-vt100-1293.jpg?w=1293&amp;ssl=1 1293w\" sizes=\"auto, (max-width: 250px) 100vw, 250px\" \/><\/a><\/p>\n<p>KED relies heavily on special functions that are accessible only via the terminal&#8217;s numeric keypad. So getting familiar with the numeric keypad, and the commands that are accessible via the numeric keypad, is a necessary first step to editing and saving files.<\/p>\n<p>The KED numeric keyboard configuration for the VT100 is shown to the right. Click on the picture, to see a larger version of it.<\/p>\n<p>The text at the lower-right corner of the key shows the key name.<\/p>\n<p>Keys PF1 and PF2 have a special purpose. PF1 is the &#8220;Gold&#8221; key, and PF2 is the &#8220;Help&#8221; key.<\/p>\n<p>All other keys have two functions. The text on the top row of the key shows the function that the key will perform if pressed alone. The text on the bottom row shows the function that the key will perform if the PF1 (&#8220;Gold&#8221;) key is pressed first. It may be helpful to think of PF1 as being a &#8220;Shift&#8221; key for the numeric keypad.<\/p>\n<h4>PuTTY Keyboard<\/h4>\n<p>I use PuTTY as a VT100 emulator on the PC when running RT-11 under SIMH.<\/p>\n<p>Configuring PuTTY to work properly as a VT100 emulator and to talk to SIMH involves a few steps.  I will sometime put together a separate How-to Guide for that. But just be aware that if the display or keyboard are not responding under KED as expected, you may need to change some configuration settings in PuTTY. This is necessary sometimes to enable the PC&#8217;s numeric keypad to emulate the VT100 keypad, and for the VT100&#8217;s escape codes (sent to the display) and text scrolling to work properly.<\/p>\n<p>In particular, your .INI file in SIMH will need to include the following lines><\/p>\n<pre>\r\nset tti 8b\r\nset tto 8b\r\n<\/pre>\n<p>You should also look the terminal size (in PuTTY) to 24 lines of 80 characters. Otherwise you will get odd behaviour when scrolling up or down.<\/p>\n<p>One thing to be aware of: For the PC&#8217;s numeric keypad to function correctly in KED under PuTTY, you will need to go into PUTTY&#8217;s <em>Change Settings<\/em> -> <em>Terminal<\/em> -> <em>Features<\/em> panel and check that <em>&#8220;Disable application keypad mode&#8221;<\/em> is <strong>unticked<\/strong>. If it is ticked, the keypad will return the ASCII code corresponding to the numeric key pressed (such as 0x37 for the &#8216;7&#8217; key) rather than the special sequence that signifies a numeric key press. The result will be that you won&#8217;t be able to access any of the KED numeric keyboard functions (such as GOLD -> 7, which is necessary to enter a Command, such as EXIT, SAVE or QUIT).<\/p>\n<p>Once PuTTY and SIMH are configured, you will notice the following differences when attempting to use the PC&#8217;s keyboard to emulate a VT100 keyboard:<\/p>\n<ol>\n<li>The top row of the PC&#8217;s numeric keypad (Numlock, \/, * and -) does not emulate the top row of the VT100 numeric keypad. Ignore the top row on the PC. You won&#8217;t need it.<\/li>\n<li>The first four function keys on the PC (F1, F2, F3 and F4) are instead used to emulate the top row of the VT100 numeric keypad. Of these, the two you will use the most are F1 (equals the PF1 &#8220;Gold&#8221; key) and F2 (equals the PF2 &#8220;Help&#8221; key).<\/li>\n<li>The PC&#8217;s numeric keypad has a large (double-size) &#8220;+&#8221; key above the Enter key. This emulates the DELCHAR\/UNDELCHAR key in KED (marked as a comma key on the VT100). Because of the size of this key on the PC, there is no DELWORD\/UNDELWORD KED key on the PC (this is the minus key on the VT100).<\/li>\n<\/ol>\n<h4>Functions and Commands<\/h4>\n<p>KED is a fairly powerful editor. It can (for example) perform search-and-replace and cut-and-paste operations. However, this How-to Guide is only concerned with using KED for the simplest operations. You&#8217;ll need to consult the KED documentation for information about its more advanced commands.<\/p>\n<p>Here is a list of the basic functions and commands that are useful when getting started with KED:<\/p>\n<table style=\"width:90%;margin-left:5%;\">\n<tr class=\"bb\">\n<th style=\"width:40%;text-align:left;\">Function or Command<\/th>\n<th style=\"width:30%;text-align:left;\">Real VT100<\/th>\n<th style=\"width:30%;text-align:left;\">PuTTY in VT100 mode<\/th>\n<\/tr>\n<tr class=\"topjust\">\n<td>Move cursor within file<\/td>\n<td>Arrow keys<\/td>\n<td>Arrow keys<\/td>\n<\/tr>\n<tr class=\"topjust\">\n<td>Move to top of file<\/td>\n<td>PF1-5<\/td>\n<td>F1-5<\/td>\n<\/tr>\n<tr class=\"topjust\">\n<td>Move to bottom of file<\/td>\n<td>PF1-4<\/td>\n<td>F1-4<\/td>\n<\/tr>\n<tr class=\"topjust\">\n<td>Delete character to left of cursor<\/td>\n<td><em>Delete<\/em> (on main keyboard)<\/td>\n<td><em>Backspace<\/em> (on main keyboard)<\/td>\n<\/tr>\n<tr class=\"topjust\">\n<td>Delete character under cursor<\/td>\n<td>DELCHAR<\/td>\n<td>+<\/td>\n<\/tr>\n<tr class=\"topjust\">\n<td>Delete to end of line<\/td>\n<td>PF1-2<\/td>\n<td>F1-2<\/td>\n<\/tr>\n<tr class=\"topjust\">\n<td>Paste last deleted character<\/td>\n<td>PF1-UNDELCHAR<\/td>\n<td>F1 then +<\/td>\n<\/tr>\n<tr class=\"topjust\">\n<td>Advance forwards through file<\/td>\n<td>4<\/td>\n<td>4<\/td>\n<\/tr>\n<tr class=\"topjust\">\n<td>Backup through file<\/td>\n<td>5<\/td>\n<td>5<\/td>\n<\/tr>\n<tr class=\"topjust\">\n<td>Advance\/Backup by one character<\/td>\n<td>3<\/td>\n<td>3<\/td>\n<\/tr>\n<tr class=\"topjust\">\n<td>Advance\/Backup by one word<\/td>\n<td>1<\/td>\n<td>1<\/td>\n<\/tr>\n<tr class=\"topjust\">\n<td>Advance\/Backup to end of line<\/td>\n<td>2<\/td>\n<td>2<\/td>\n<\/tr>\n<tr class=\"topjust\">\n<td>Advance\/Backup by one &#8220;section&#8221;<\/td>\n<td>8<\/td>\n<td>8<\/td>\n<\/tr>\n<tr class=\"topjust\">\n<td>Update the display<\/td>\n<td><em>CTRL-W<\/em><\/td>\n<td><em>CTRL-W<\/em><\/td>\n<\/tr>\n<tr class=\"topjust\">\n<td>Save file and exit<\/td>\n<td>PF1-7-<em>EXIT<\/em>-ENTER<\/td>\n<td>F1-7-<em>EXIT<\/em>-ENTER<\/td>\n<\/tr>\n<tr class=\"topjust\">\n<td>Abandon changes and exit<\/td>\n<td>PF1-7-<em>QUIT<\/em>-ENTER<\/td>\n<td>F1-7-<em>QUIT<\/em>-ENTER<\/td>\n<\/tr>\n<\/table>\n<p>A few things to note about the table above:<\/p>\n<ol>\n<li><em>Text in italics<\/em> represents text that needs to be typed on the main keyboard. All other text represents the key of that name (usually on the numeric keypad).<\/li>\n<li>ENTER means the Enter key on the numeric keyboard (the Return key on the main keyboard is not an acceptable alternative).<\/li>\n<li>By default a &#8220;section&#8221; is 16 lines, but this can be changed.<\/li>\n<li>On a real VT100, the DELCHAR\/UNDELCHAR key is the comma key on the numeric keypad. It is immediately above the Enter key.<\/li>\n<\/ol>\n<p>A concise summary of major KED commands can be found in Chapter 1 of the <em>RT-11 Quick Reference Manual<\/em> (DEC Order Number AA-M241D-TC).  See the links section below for access to the full document.  Alternatively, <a href=\"https:\/\/avitech.com.au\/wp-content\/uploads\/2016\/07\/rt11-qrm-ch-1.pdf\">click here<\/a> to access a local copy of Chapter 1.<\/p>\n<h4>Brief guide to compiling PDP-11 assembly-language programs<\/h4>\n<p>Source files have the suffix &#8220;.MAC&#8221;.<\/p>\n<p>To compile the source file MYFILE.MAC:<\/p>\n<pre>\r\n.MACRO MYFILE\/LIST\r\n<\/pre>\n<p>To link the resulting object file:<\/p>\n<pre>\r\n.LINK MYFILE\r\n<\/pre>\n<p>To run the resulting executable file:<\/p>\n<pre>\r\n.R MYFILE\r\n<\/pre>\n<h4>Revision History<\/h4>\n<p>16 September 2015:<\/p>\n<ul>\n<li>Posted initial version<\/li>\n<\/ul>\n<p>22 December 2015:<\/p>\n<ul>\n<li>Added link to the RT-11 Quick Reference Manual, and a local copy of Chapter 1<\/li>\n<li>Explained the significance of the PuTTY <em>&#8220;Disable application keypad mode&#8221;<\/em> setting<\/li>\n<\/ul>\n<p>30 July 2016:<\/p>\n<ul>\n<li>Ported this page across to WordPress. Made formatting changes to suit.<\/li>\n<\/ul>\n<p>5 June 2017:<\/p>\n<ul>\n<li>Updated the &#8220;PuTTY Keyboard&#8221; section to include some speicifc information about configuring PuTTY and configuring the SIMH .INI file.<\/li>\n<li>Added the new section titled &#8220;Brief guide to compiling PDP-11 assembly-language programs&#8221;.<\/li>\n<\/ul>\n<h4>Links<\/h4>\n<p><span style=\"padding-left: 30px;\"><a href=\"http:\/\/bitsavers.informatik.uni-stuttgart.de\/pdf\/dec\/pdp11\/rt11\/v4.0_Mar80\/2b\/AA-H853A-TC_PDP-11_Keypad_Editor_Users_Guide_Mar80.pdf\">Keypad Editor Users Guide (for RT-11 V4) on Bitsavers<\/a><\/span><\/p>\n<p><span style=\"padding-left: 30px;\"><a href=\"http:\/\/bitsavers.trailing-edge.com\/pdf\/dec\/pdp11\/rt11\/v5.6_Aug91\/AA-M241D-TC_RT-11_Quick_Reference_Manual_Aug91.pdf\">RT-11 Quick Reference Manual (for RT-11 V5.6) on Bitsavers<\/a><\/span><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Introduction This is a short guide to using the text editor called &#8220;KED&#8221; in RT-11 on the PDP-11. KED is a full-screen editor that comes with RT-11. It is intended to be used with a VT100 or later model DEC serial terminal. A similar editor called K52 is for use with VT52 and VT55 terminals. ..<\/p>\n<div class=\"clear-fix\"><\/div>\n<p><a href=\"https:\/\/avitech.com.au\/?page_id=959\" title=\"read more...\">Read more<\/a><\/p>\n","protected":false},"author":2,"featured_media":0,"parent":0,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-959","page","type-page","status-publish","hentry"],"jetpack_sharing_enabled":true,"jetpack_shortlink":"https:\/\/wp.me\/P7xTsk-ft","jetpack-related-posts":[{"id":914,"url":"https:\/\/avitech.com.au\/?page_id=914","url_meta":{"origin":959,"position":0},"title":"RT-11 boot floppy","author":"malcolm","date":"26-July-2016","format":false,"excerpt":"This page steps through the process of building an RT-11 floppy disk that can be used to boot a PDP-11. You will need a floppy disk that has already been low-level formatted to suit the drive you are using (eg RX01, RX02, RX50, RX33, etc). The process for formatting your\u2026","rel":"","context":"Similar post","block_context":{"text":"Similar post","link":""},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":2036,"url":"https:\/\/avitech.com.au\/?page_id=2036","url_meta":{"origin":959,"position":1},"title":"Links &#8211; DEC related","author":"malcolm","date":"24-May-2017","format":false,"excerpt":"This page is just a collection of links relevant to DEC computers and equipment. Identifying DEC Boards www.pdp-8.org's \"list of 8\/10\/11 M-series cards\" www.pdp-8.org's \"Index to mostly OMNIBUS cards\" DEC Option List and Module List (on the Internet Archive: 232 Pages) Bitsaver's directory containing Options List and Modules Lists Doug\u2026","rel":"","context":"Similar post","block_context":{"text":"Similar post","link":""},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":2149,"url":"https:\/\/avitech.com.au\/?page_id=2149","url_meta":{"origin":959,"position":2},"title":"Current Loop: Design Notes","author":"malcolm","date":"13-June-2017","format":false,"excerpt":"This page has notes of things I've discovered in relation to the current-loop interface as used on PDP-8 and PDP-11 computers. DEC Current loop cable DEC's main interface cable for OMNIBUS PDP-8's and PDP-11's is the KL8, which is shown on page 51 of the PDP-8\/e Engineering Drawings on Bitsavers.\u2026","rel":"","context":"Similar post","block_context":{"text":"Similar post","link":""},"img":{"alt_text":"","src":"https:\/\/i0.wp.com\/avitech.com.au\/wp-content\/uploads\/2017\/06\/vt100-tech-manual-extract-page-3-6-1024x430.jpg?resize=350%2C200","width":350,"height":200,"srcset":"https:\/\/i0.wp.com\/avitech.com.au\/wp-content\/uploads\/2017\/06\/vt100-tech-manual-extract-page-3-6-1024x430.jpg?resize=350%2C200 1x, https:\/\/i0.wp.com\/avitech.com.au\/wp-content\/uploads\/2017\/06\/vt100-tech-manual-extract-page-3-6-1024x430.jpg?resize=525%2C300 1.5x, https:\/\/i0.wp.com\/avitech.com.au\/wp-content\/uploads\/2017\/06\/vt100-tech-manual-extract-page-3-6-1024x430.jpg?resize=700%2C400 2x"},"classes":[]},{"id":3801,"url":"https:\/\/avitech.com.au\/?page_id=3801","url_meta":{"origin":959,"position":3},"title":"DEC VT180 (aka &#8220;Robin&#8221;)","author":"malcolm","date":"4-April-2020","format":false,"excerpt":"This webpage has some notes about a few aspects of the DEC VT180. It is mostly focussed on Kermit, and the processing of making bootable floppy disks from images that already exist online. Note: To reset the VT180, press SETUP then 0. Using Kermit on the VT180 The \"VTKERMIT.P75\" disk\u2026","rel":"","context":"Similar post","block_context":{"text":"Similar post","link":""},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":796,"url":"https:\/\/avitech.com.au\/?page_id=796","url_meta":{"origin":959,"position":4},"title":"RT-11 Logical Disks","author":"malcolm","date":"22-July-2016","format":false,"excerpt":"RT-11 has a flat directory structure. So all your files (operating system, applications, data etc) are stored in that one directory. On a large hard drive, you can literally end up with hundreds of files, all stored in the one directory. This of course can make it quite difficult to\u2026","rel":"","context":"Similar post","block_context":{"text":"Similar post","link":""},"img":{"alt_text":"","src":"","width":0,"height":0},"classes":[]},{"id":2031,"url":"https:\/\/avitech.com.au\/?page_id=2031","url_meta":{"origin":959,"position":5},"title":"Arduino Notes","author":"malcolm","date":"24-May-2017","format":false,"excerpt":"This is just a collection of notes and links that I have found useful in getting to know the Arduino products. Using the Nano with CH340 USB adapter Getting a Nano with CH340 USB-to-RS232 chip working with the Arudino IDE is fairly straightforward. Here are the traps to work out\u2026","rel":"","context":"Similar post","block_context":{"text":"Similar post","link":""},"img":{"alt_text":"","src":"https:\/\/i0.wp.com\/avitech.com.au\/wp-content\/uploads\/2017\/05\/240x320-lcd-touch-screen-for-arduinoImageMain-515-300x300.jpg?resize=350%2C200","width":350,"height":200},"classes":[]}],"_links":{"self":[{"href":"https:\/\/avitech.com.au\/index.php?rest_route=\/wp\/v2\/pages\/959","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/avitech.com.au\/index.php?rest_route=\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/avitech.com.au\/index.php?rest_route=\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/avitech.com.au\/index.php?rest_route=\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/avitech.com.au\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=959"}],"version-history":[{"count":14,"href":"https:\/\/avitech.com.au\/index.php?rest_route=\/wp\/v2\/pages\/959\/revisions"}],"predecessor-version":[{"id":969,"href":"https:\/\/avitech.com.au\/index.php?rest_route=\/wp\/v2\/pages\/959\/revisions\/969"}],"wp:attachment":[{"href":"https:\/\/avitech.com.au\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=959"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}