Email.txt Driver File Contents (M40_V45.exe)

E-mail Program
For Braille Lite M20,
Braille Lite M40,
And Type Lite


Version 2.0


User's Manual


Freedom Scientific BLV Group, LLC
March 2004


PUBLISHED BY
Freedom Scientific BLV Group, LLC
11800 31stst Court North
St. Petersburg, Florida 33716-1805
USA
http://www.FreedomScientific.com
Information in this document is subject to change without notice. No part of this publication may be reproduced or transmitted in any form or any means electronic or mechanical, for any purpose, without the express written permission of Freedom Scientific.
Copyright © 2004 Freedom Scientific BLV Group, LLC, All Rights Reserved.
CompactFlash™ is a trademark of the CompactFlash Association in the United States and/or other countries


Table of Contents

Introduction	
System Requirements	
Application Files	
Installing the Email.bns Application	
Online Help	
Configuration Wizard	
Working with E-mail	
Sending and Receiving E-mail	
Viewing the Inbox	
Reading a Message	
Viewing and Saving Attachments	
Replying to a Message	
Forwarding a message	
Composing a New Message	
Attaching Files	
The Context Menu	
Using the Address Book	
Copying, Cutting, and Pasting	
Managing Your Messages	
Working with Folders	
Creating, Renaming, and Deleting Mail Folders	
Moving Messages	
Basic Message Filtering	
Configuring the Program	
Configuration Explained	
Understanding User Profiles	
Log settings	
Mail Settings	
Modem Settings	
Login Settings	
POP3 Settings	
SMTP Settings	
Filter Settings	
Mailbox Settings	
Frequently Asked Questions	
Appendix A: Email Command Summary	


Documentation of Keystrokes

Throughout this document, the keystrokes for the Braille Lite will be given. It was felt that to give both the Braille Lite and Type Lite keystrokes every time a key sequence was provided would be difficult and possibly confusing. A complete listing of all keystroke sequences for both the Braille Lite and Type Lite is found at the end of the document in Appendix A.

Introduction

Your Freedom Scientific notetaker comes with a powerful and flexible E-mail program. It allows you to connect to the Internet, send and receive mail, organize messages in folders, maintain a list of contacts, and much more. This e-mail program combines ease of use with flexibility and configurability.

System Requirements

To use this E-mail program, you will need:

* A Braille Lite M20, Braille Lite M40, or Type Lite running firmware revision 4.5 or later.

Note: using earlier firmware versions with this latest build of the Email.bns program will result in degraded functionality.

* At least 90 RAM or Flash pages to load the two programs that make up the application.
* Additional RAM memory for temporary files created and maintained by the program.

Note: if you receive a large number of messages, your Inbox will quickly increase in size.

* A telephone line and an Internet Service Provider (ISP) that supports POP3 (Post Office Protocol version 3) and SMTP (Simple Mail Transfer Protocol) e-mail.

Application Files

This application consists of two executable files:

Mailer.bns - an external program that establishes the connection and sends and receives e-mail. This is the program you run to go online.

Email.bns - the actual mail reader. You will run this for most of your e-mail tasks.

When you run Email.bns for the first time, it will create a text file called Email.cfg. This is where all your configuration settings are stored. While the Email.bns program includes a powerful configuration editor, you can also edit Email.cfg directly if you wish, using the file edit function of the device.

Another file is called Mailbox. This file is also created by Email.bns in order to store your incoming and outgoing messages. Do not edit this file manually, or it may be corrupted and made unusable.

As you use the Email program, you may also come across a file called Email.$$$. This is a temporary file created by Email.bns. Under normal circumstances, it should be automatically deleted when you exit the application. However, you should not be concerned if this file actually shows up, as the program will process it as soon as it can.

Installing the Email.bns Application

If you received your notetaker from Freedom Scientific, the application should be installed. Otherwise, the procedure is quite straightforward. Copy both Email.bns and Mailer.bns into your device's RAM or Flash. You can do so by any means appropriate for copying binary files. If you are upgrading from an earlier version of this program, there is no need to be concerned about your Mailbox and Configuration files - the new Email program will make use of existing files.

Online Help

This e-mail program features online help. Whenever you need assistance, press H-CHORD and a brief help message will be spoken and displayed. You may want to use this feature to get more information about various areas of the program.

Configuration Wizard

Before doing anything else, you must provide some basic information about your e-mail connection. To do so, start Email.bns by pressing O-CHORD, X; type "Email" and press ENTER. The Configuration Wizard will walk you through the setup process.

Whenever the Configuration Wizard asks you for information, you can type it and press E-CHORD. Enter all information in Computer Braille. The program will ask you to confirm each entry by pressing "y" for Yes. At any time, you can press Z-CHORD to abort the process. To hear a question again, press H-CHORD. You can review the information with regular text navigation commands. You can also move back through the list of questions by pressing DOT 1 CHORD.

Here is a summary of all questions asked by the Configuration Wizard:

* Please enter your full name, which will appear in the "From:" field of your outgoing message.
* Please enter your email address.

Note: if you have multiple e-mail accounts, you will be able to configure all of them at a later time. For now, just enter the address of your primary e-mail account.

* Please enter Tone or Pulse dialing: press T or P.

Note: unless you have a reason to do otherwise, press T for tone dialing.

* Please enter phone number for dial-up access.

Note: this is the modem access number of your Internet Service Provider. If you use any special prefixes, such as 9 for an outside line or *72 to disable Call Waiting, you should enter the prefixes before the number. To cause the modem to pause for two seconds, enter a comma (,). For example, if you type 9,5551234, the modem will dial 9, wait for two seconds, and then dial 5551234.

* Enter the login name given by your Internet Service Provider for dial-up access.

Note: sometimes, your login name may be different from your e-mail account name.

* Please enter the password given by your Internet Service Provider for dial-up access.

Note: passwords are case-sensitive. Also note that this password may be different from your e-mail account password.

* Please enter your outgoing SMTP server.

Note: This server is used to send your e-mail. In the future, should you have any problems sending e-mail, please make sure this information is entered correctly. Your ISP should have provided you with the server name to use.

* Please enter your incoming POP3 mail server.

Note: This is a server where your e-mail is delivered. In the future, if you have problems receiving e-mail, check to ensure that the server information is entered correctly.

* Please enter the login name given by your Internet Service Provider to access mail.

Note: you should re-enter this information, even if this is the same as your login name for the Internet connection.

* Please enter the password given by your Internet Service Provider to access mail.

Note: passwords are case-sensitive.

At this point, you are advised that "Mail configuration file has been successfully created." You can now start using the Email.bns program.

Note: in some cases, adjustments to the configuration may be required. Please refer to Configuring the Program, below, for more information.

Working with E-mail

Sending and Receiving E-mail

You have already run the Email.bns program in order to configure your E-mail settings. You will use Email.bns for most of your e-mail tasks. However, you will need another program, called Mailer.bns, in order to send and receive your e-mail messages.

To send and receive e-mail, do the following:

1. Connect a telephone line to the modem jack on your unit. The modem jack is located on the back of your M20 or on the left of your M40.
2. Run Mailer.bns by pressing O-CHORD, X; typing "Mailer" and pressing Enter. You can also run this program by pressing P-CHORD followed by DOTS 1-3-4-8 (that is, the letter m with DOT 8 added).
3. In a few seconds, you will hear your modem dialing the ISP access number. The display will show connection progress messages. The program will send and receive your messages and then disconnect from the ISP.
4. If you have any problems at this point, please refer to Frequently Asked Questions, below.

Viewing the Inbox

From this point on, we will use Email.bns for all e-mail-related tasks, so please run Email.bns on your unit. The program says, "Starting, please wait. Filtering Inbox." It will then display the number of messages in your Inbox.

Note: see Basic Message Filtering, below, for more information on message filtering.

You are now in the list view of your Inbox. Your messages are sorted by date—the newest ones appear at the top of the list. Press DOT 1 CHORD to go to the previous message, DOT 4 CHORD for the next message, DOT 1-4 CHORD to hear the header details of the current message, DOTS 1-2-3 CHORD to move to the top or DOTS 4-5-6 CHORD to move to the bottom of your inbox. You can also navigate through your Inbox using the Whiz Wheels or the Advance Bars. Press DOTS 5-6 CHORD or DOTS 2-3 CHORD (PAGE DOWN or PAGE UP) to navigate between folders (such as Inbox, Sentbox, Drafts, Deleted, etc.).

By default, the program will display the "From:" field in your message list. That is, you will see the name and e-mail address of the message sender. However, you can cycle between available header fields by pressing DOT 6 CHORD or DOT 3 CHORD. You can display the subject, date and size of your messages. In fact, if you choose the Subject field, and then navigate up and down through the message list, the messages will actually be presented by subject.

To read the currently selected message, press E-CHORD. To reply to a message, press "R." To forward a message, press "f." To delete a message, press "d." To save a message to a file, press "s." To see the message header, press "h."

Reading a Message

To read a message, navigate to it with the ARROW KEYS and press E-CHORD. The message will be opened for viewing, and you can use standard text review commands to read it. You can also press F-CHORD to find text within the message, or press M-CHORD to set mark, or press DOTS 1-2-6 CHORD to copy information to the Clipboard, just as you do in any other file.

Viewing and Saving Attachments

The program will let you know if a message contains attachments. If it does, you can view the attachment list by pressing O-CHORD, A from within the Message Viewer. Note that O-CHORD brings up the Context Menu, which we will discuss in detail later. The first item on the menu is "Attachments List" (the shortcut is "a"). From the Attachments List, press E-CHORD on the attachment you want to view. If the attachment is a text file, it will be opened for viewing. Otherwise, the program will offer to save the file. You will be asked, "Enter the file name:. To accept the original file name of the attachment, just press E-CHORD. The attachment will then be decoded and saved to a RAM folder on your notetaker.

Replying to a Message

To reply to a message, just select it from within the message list and type "r." The unit asks, "Reply all?" If you type "y," the reply will be sent to the sender and all recipients of the original message. Otherwise, the reply will go to the sender only.

You will then be able to edit the header of your reply. If you have multiple profiles, you will land in the "From:" field. Use DOT 1 CHORD and dot 4 CHORD to select the sender's address, then press E-CHORD. This will take you to the "To:" field. Notice that, if you have a single user profile, you will be taken here immediately. This field will be populated with the addresses of people you are replying to. You may want to edit these addresses or press E-CHORD (or dot 4 CHORD) to go to the "Subject:" field. An alternative way to enter a recipient's address is by looking it up in the Address Book. The command to bring up the Address Book is DOTS 2-5-6 CHORD.

As expected, the "Subject:" field will be populated with the subject of the message to which you are replying, including the "Re:" prefix. Since you may want to change the subject line, this field is also available for editing.

Press E-CHORD (or DOT 4 CHORD) to move to the "CC:" field. "CC" stands for Carbon Copy. You may want to insert more recipients' addresses here, and then proceed to the "BCC:" field. "BCC" stands for Blind Carbon Copy. This is similar to "CC:"; however, addresses placed here will be invisible to other recipients (a good practice if you want to prevent people from harvesting someone else's addresses from your e-mail messages.

Press E-CHORD again. The unit will ask you if you want to include the original message in your reply. Respond by typing "y" or "n."

You will now be in the Message Editor. This is similar to your regular text editor. You can enter text as you ordinarily do on the notetaker; you have the same navigation commands, as well as find and replace functions, at your disposal. You can delete, insert or move text as usual. In fact, editing a message is like editing a regular file.

By default, you should write in Computer Braille. However, Grade II entry is also available. See The Context Menu in this document for more information.

When you are done composing your message, press Z-CHORD. The program will give you three options: press E-CHORD to send the message, "S" to save the message to the Drafts folder, or "Z" to cancel the message. If you choose "Send", the message will be placed in the Outbox and will be sent the next time you connect to the Internet. If you choose "Save", the message will be placed in the Drafts folder. If you choose "Cancel", the message will be discarded. At this point you can press Z-CHORD again to return to the Message Editor.

Forwarding a message

To forward a message, type "f" from within the Message List. You will be placed in the header of your new message. Unlike replying to an existing message, the "To:" field will not be populated, so you will need to enter an address or an alias from the Address Book. To enter multiple addresses, separate them with the comma.

The "Subject:" field will be populated with the subject of the original message, preceded by the "Fw:" prefix. In the Message Editor, you will also see the text of the original message, formatted for forwarding.

The rest of the procedure is similar to replying to a message.

Composing a New Message

To compose a new message, press DOTS 3-4-6 CHORD from anywhere in the message folders. You will be placed in the message header. Just fill out the "To:" and "Subject:" fields. You can also fill the other fields if needed. Of course, none of the fields will be pre-filled. You can also press DOTS 2-5-6 CHORD to choose the recipients' addresses from the Address Book. Remember to use E-CHORD, DOT 4 CHORD or dot 1 CHORD to navigate between the fields.

After you fill in the header fields, you will be in the familiar Message Editor. Compose your message and press Z-CHORD when you are done. You will get the same options to send, save or cancel your message as were described in Replying to a Message, above.

  Attaching Files

You can attach up to 5 files to an outgoing message. To do so, while in the Message Editor, press O-CHORD, A. The unit says: "Attachment list empty." You are now in the list of attachments. Press DOTS 3-4-6 CHORD to add an attachment. The program will display the list of files available in your notetaker. Navigate through the list until you have selected the file you want to attach, and then press E-CHORD. To attach multiple files, mark each file by pressing the SPACEBAR. When you are done, press E-CHORD. The files will now appear in the list of attachments. Press Z-CHORD to return to the Message Editor.

Note: the files will be encoded and attached to the message only when you press Z-CHORD, and then choose to send or save the message.

The Context Menu

A powerful feature of the Email.bns Program is its Context Menu, accessed by pressing O-CHORD. Use DOT 4 CHORD or dot 1 CHORD to navigate through the menu, or DOTS 1-4 CHORD to repeat the currently highlighted item. To select an item, press E-CHORD. If an item can be On or Off, you can toggle its state by pressing the SPACEBAR. Note that most items on the Context Menu have corresponding shortcut keys, so you can press O-CHORD followed by the shortcut key to access the item directly. To close the menu, press Z-CHORD.

This menu is context-sensitive. That is, it will include only those items that are relevant in the particular area of the program.

Configuration changes made through the context menu will remain in effect only for your current e-mail session. To make a permanent change, you must specifically edit the e-mail configuration. Refer to Configuring the Program, below, for more information.

Here are brief descriptions of each menu item:.

* Grade 2 Display. This determines whether the program will display information in Computer Braille or in Grade 2. The default setting is off, meaning that everything will be displayed in Computer Braille. The shortcut key is G.
* Braille Translator. This determines whether or not you want to input information in Grade 2. If so, then you should turn this option on. The shortcut key is T.
* Braille Message. This item is available only in the Message List. If you reply to or forward a message written in Grade II, you must turn this option on to make sure the Braille Translator knows how to handle the message. There is no shortcut key.
* Reset Message Status. This item is available in the Message List only. It allows you to reset any message flags. For example, if an outgoing message could not be sent, it is automatically marked as containing errors. To reset this flag and attempt sending again, you should reset its message status. Similarly, if you've read a message but want to mark it as "new", you can do so with this menu option. The shortcut is EQUALS-CHORD (DOTS 1-2-3-4-5-6 CHORD).
* Shell Out. This feature allows you to leave the program temporarily in order to perform other tasks with the unit, while keeping the application running. You can press S-CHORD from anywhere in the program to shell out to the unit. To return to the program from Shell, press Z-CHORD. When you return to the program, you will be placed at the point you were at earlier. Most notetaker functions are available from Shell Mode. However, you will be unable to run other external programs while in Shell.

Important: do not power off the unit while in Shell.

* Spellcheck. This item is available only in the Message Editor. It allows you to spellcheck outgoing messages. The shortcut is DOTS 1-6. To enter the Spell Checker, press O-CHORD, followed by DOTS 1-6 (* or asterisk). This is the same command as in the standard Editor. On the Type Lite, to spellcheck a message you can press F6 directly, without opening the options menu.
* Edit Header. This item is available only in the Message Editor. It allows you to edit the header of an outgoing message. The shortcut key is H. To return to the Message Text, press Z-CHORD, or press DOT 4 CHORD several times, until you hear "Enter message."
* Attachments List. This item appears in Message Editor and Message Viewer. It allows you to add or view attachments to a message. See Viewing and Saving Attachments and Attaching Files, below. The shortcut key is A.
* Address Book. This item appears only in the Message Editor. It activates the Address Book feature. There is no shortcut key, but you can activate the Address Book from almost anywhere in the program by pressing DOTS 2-5-6 CHORD. The Address Book feature will be discussed in detail in Using the Address Book, below.
* Append Text. This item is available only in the message editor. It allows you to insert a text file into a message. When you select this option, you will be presented with a view of your notetaker's file system. Select the file you want to insert and its contents will be placed at the cursor position in your current e-mail message. The shortcut is I-CHORD.
* Edit Email Configuration. This item is available only from the Message List. It activates the program's Configuration Editor. The shortcut is C. This feature will be discussed in detail in Configuring the Program, below.

Using the Address Book

To help you keep track of your e-mail contacts, this program includes a powerful Address Book. You can access it in one of two ways. Press DOTS 2-5-6 CHORD from almost anywhere in the program. Alternatively, choose "Address Book" from the Context Menu.

To add a contact, press "A" or DOTS 3-4-6 CHORD from within the Address Book. The program responds with: "Enter nickname." This is the nickname you would like to use for the current contact. You will be able to enter this nickname into the "To:", "CC:" and "BCC:" fields instead of the full e-mail address, and the message will be addressed properly. Press E-CHORD to go to the next field, which says "Enter full name." Enter this information and press E-CHORD again. The program will ask you to enter the contact's e-mail address. When that is done, press E-CHORD again, and the contact is saved. From now on, to address a message to this contact, you can simply type his or her nickname, and the program will do the rest. If you type a nickname that is not found in the Address Book, the program will advise you of the error. Alternatively, press DOTS 2-5-6 CHORD while in the "To:", "CC:" or "BCC:" field, and then press E-CHORD on the desired entry, and that person's address will be pasted into the field.

To delete a nickname, press D-CHORD. The program will ask you for a confirmation.

Press Z-CHORD to close the address book.

Copying, Cutting, and Pasting

The Email.bns program allows you to share information with other functions of your notetaker. The usual commands to mark, copy, and paste are available almost anywhere in the program. You can copy text to the Clipboard and paste it as needed.

Here are some examples:

Suppose you are reading an e-mail message, and you want to save some information from that message to a file in your notetaker. To do this, mark the beginning of the block you want to save with M-CHORD. Then, move to the end of this block and press DOTS 1-2-6 CHORD. The unit will prompt "Copy or Append?" Press "C" to copy this text to the Clipboard. Now, press S-CHORD to shell out from the application. Open the file where you want this information inserted or create a new file. Press DOTS 3-4-6 CHORD. The unit asks, "Paste what?" Press C for Clipboard. The information will be pasted into the file. Finally, press Z-CHORD to return to the program, and you will be located where you left off.

Suppose you need to look up a recipient's address for an e-mail message, and it is stored in a file on your unit. Press S-CHORD to shell out, find the address, copy it to the Clipboard, press Z-CHORD to return to the program, and then DOTS 3-4-6 CHORD to paste the address.

These two examples illustrate how easy it is to share information between Email.bns and the rest of your notetaker.

Managing Your Messages

Working with Folders

By default, all your incoming messages are stored in the Inbox. However, several other mailboxes (or folders) are also available to you. To see the list of available mailboxes, press "L" and then use DOT 4 CHORD or dot 1 CHORD to navigate through the list. The folder names are fairly self-descriptive. Outbox is the folder for your outgoing messages. In fact, while a message is in Outbox, you can still edit it to your liking. After a message has been sent, it is automatically moved to Sentbox. When you delete a message, it is actually moved to Deleted box. Finally, if you would like to save a message without sending it, it is moved to Drafts. You can then resume working on that message at a later time.

In a Message View, you can switch between available folders by pressing DOTS 5-6 CHORD and 2-3 CHORD.

Creating, Renaming, and Deleting Mail Folders

You can easily create a new mail folder. To do so, type L to bring up the list of folders, and then press DOTS 3-4-6 CHORD. At the prompt, enter the name of the folder you want to create and press E-CHORD. You will then be able to move messages to that folder or use message filtering to sort your correspondence automatically. Refer to Basic Message Filtering, below, for more information on message filtering.

To delete the selected folder, press D-CHORD. The program will ask you for confirmation. You can delete only those folders you have created. You cannot delete system folders, such as Inbox, Outbox, Drafts, Sentbox, or Deleted. However, you can rename any of these folders if you like.

Important: as described earlier in this manual, your messages are stored in a file named Mailbox. If you ever delete this file, all of the non-default folders you created will be gone.

Moving Messages

To move a message, select it in the Message List and press "M". The device will display the list of available folders. Choose the desired folder and press E-CHORD. The message will be moved to that folder.

Note: undeleting messages is somewhat of a special case. If you delete a message, it is first moved to the Deleted folder. On exiting the program, you will be asked if you want to empty the deleted items. If you say yes, then the messages will be removed completely. Otherwise, they will remain in your Deleted folder. If you want to undelete a message, just open the Deleted folder, find the appropriate message, press "M" and choose the folder where you want the message to reside.

Note that it is not possible to move messages to outbox because of its special purpose.

Basic Message Filtering

The program can automatically put messages into folders based on the sender's address, the recipient's address or the message subject. This allows you to have your messages organized. For example, you could direct all mailing list correspondence to a separate folder and process it as time permits.

Before you set up message filtering, it is helpful to do some preliminary planning. Decide how you will filter messages and which folders they will go to. You may need to create additional folders. Refer to Creating, Renaming, and Deleting Mail Folders, above, for more information on creating folders.

To set up basic message filtering, press T-CHORD from within the Message List. This operation is not allowed with messages from Outbox or Deleted items. In any other folder, you will get a menu with two options. The first lets you add a filter for the currently open folder. The second allows you to delete an existing filter.

After choosing to create a filter from this menu, you will be presented with the list of fields to be used when filtering messages. If you choose to filter based on the "From:", "To:" or "CC:" fields, the next display will be populated with addresses from the respective fields for the currently selected message. You can edit the entry and type any address you desire, and press E-CHORD. If multiple addresses are present in the field, the program will allow you to choose which should be used for filtering. To choose a single address, select it and press ENTER. To choose multiple addresses, mark each by pressing the SPACEBAR, and then press ENTER.

You can also choose to filter based on the "Subject:" field. In this case, the display will be pre-filled, but you can enter your own data, as above.

After you select the field for filtering, you will be presented with the list of available folders. To route messages with the criteria you have specified to a particular folder, press E-CHORD while that folder is selected.

The next time you start the program, your messages will be sorted according to your criteria.

If you would like to initiate the sorting manually, press F-CHORD.

Deleting a filter is even easier. Press T-CHORD from within the desired folder. On the menu that appears, select Delete a Filter. You will see a list of all filters you created for current (source) folder into first valid destination folder. To change the destination folder press DOT 3 CHORD (LEFT ARROW) or dot 6 CHORD (RIGHT ARROW). Press "D" or D-CHORD on the filter you want to delete.

Note: Besides this basic filtering, the application also features some advanced filtering tools. These are described in Filter Settings, below.

Configuring the Program

Configuration Explained

This program is highly customizable to meet your needs and preferences. Your personal settings are saved in a text file named Email.cfg. You can either edit this file manually or utilize the configuration editor. If you ever need to reinstall your Email.bns client, you can copy your existing Email.cfg file to restore your configuration. In fact, it is advisable to perform periodic backups of both your Email.cfg and Mailbox files.

For a technically-minded user, editing the configuration file directly may be the best option. However, the configuration editor provides a menu-driven interface, which allows you to complete most tasks quickly and efficiently. To open the Configuration Editor, press O-CHORD for Context Menu from within the Message List, and then use the DOWN ARROW to move to Edit Email Configuration (the shortcut is C).

Understanding User Profiles

A user profile is a group of e-mail settings associated with a single e-mail account. You cam have multiple e-mail accounts, with specific settings for each account. For example, you may have a profile named "Home," another one named "Work," and so on.

When you set up your system initially, one profile was already created for you. This is the Main Profile. Notice that some settings can be saved only within the main profile and will be unavailable from other profiles. This includes your modem settings, log settings, login settings, and PPP settings.

To create another profile, bring up the e-mail configuration editor (O-CHORD C from within the message list). The unit will say: "Main profile". Press DOTS 3-4-6 CHORD to create another profile. In response to the unit's prompt, give that profile a name and press E-CHORD. You will then be asked some of the questions that should be familiar to you from the Configuration Wizard (see Online Help, above). Fill in the appropriate answers and confirm them as requested. This completes creating a new profile. When you select "Edit Email Configuration", you will see two profiles. You can press E-CHORD to edit settings specific to a profile.

To delete a profile, press D-CHORD when it is selected and then confirm the operation. You can also disable a profile temporarily, without deleting it. To do so, press the SPACEBAR. Notice that the Main Profile cannot be deleted or disabled.

Log settings

The log settings determine how much of the program's activity will be logged for you in a special file and how much will be announced or displayed. The log file is named Email.log. The program automatically creates and maintains this file. Note that your Log file may be needed for troubleshooting. Also note that your Log file may contain your passwords in plain text, so exercise caution when sharing this file with others.

The Log Settings submenu is available only in the Main Profile. An explanation of each setting follows:

* File=Email.log. Determines the name of your Log file.
* Level=2. How much activity should be logged. 0=no logging at all; 1=normal; 2=verbose; 3=complete. Unless required for troubleshooting, there is no reason to change this setting from the default value of 2.
* Mode. This item has a submenu, which can be accessed by pressing E-CHORD. If you turn Say Log-Events on, then the unit will announce each event as it is written to the log file. This may cause excessive verbosity if your log level is high. Display Log Events works similarly, but this determines whether the log messages are presented on the Braille display. For practical purposes, it is a good idea to have the Log events displayed in order to be aware of what the program is doing.
* Size=9. Maximum size, in kilobytes, of your Log file. When that limit is reached, old information is deleted from the top of the file as new events are added. The default value is 9KB.

Mail Settings

This menu defines the basic settings for reading and composing e-mail messages. It is available only from the Main Profile, but it affects overall functionality of the program. This menu includes the following items:

* Quote=>. Defines which character will precede each line of replied-to or forwarded message. By default, it is the > (Greater Than) sign. If you want to have the original text indented, put three or four blank spaces into this field. If this field is empty, the original text will be indistinguishable from your reply, and your messages may be confusing or difficult to read.
* Signature. In this field, you can put the text of your signature to be appended to outgoing messages. If your signature spans several lines, put \n to represent a line break. For example: "Best Regards\nJane Doe." By default, this field is blank.
* Full Name. Put here your name as it should appear on your outgoing messages.
* Message mode. This parameter defines whether you will write your outgoing messages in Computer Braille or in Grade II. The default setting is "Text", meaning that you will need to compose your messages in Computer Braille. If you press E-CHORD on this item, and then move up and down with DOT 1 CHORD and dot 4 CHORD, you will see other available options. Grade2 means that you will compose messages in Grade II Braille. Autodetect means that the program will attempt to detect whether your message is in Computer Braille or in Grade II. Finally, Interactive means that the program will ask you each time you start a new message, whether you want to write in Grade 2. Obviously, these four options are mutually exclusive—only one of them can be selected at a time.
* Grade2Display=off. This specifies whether you want all program output displayed in Grade II. The default setting is Off, meaning that the program will display its output in Computer Braille.
* Braille Translator=off. This option determines if the Braille translator should be available. The default is Off.

Finally, several mail parameters are grouped together under Other Mail Settings. They are:

* Empty Deleted Box. This specifies whether you want the program to purge all messages from the Deleted folder upon exit. The default setting is On. Note that the program will still ask for your confirmation before proceeding with the deletion.
* Show Mailbox Status. This determines if you want to hear the number of e-mail messages, as well as other statistics, while viewing a mail folder. The default value is On.
* Apply rules. This determines if basic filtering rules will be applied on startup. See Basic Message Filtering, above, for information. The default value is On.
* Edit in Insert Mode. By default, when you compose a message, the device is in Append Mode. This means that newly written text is appended to the bottom of the message. Sometimes, this is not desirable. For example, if you reply to a message, your comments will appear under the original text. The solution is to use Insert Mode to edit e-mail messages. To activate this feature, just set Edit in Insert Mode On. When you compose a message or reply to a message, the unit will be in Insert Mode, similar to what is available with PC Edit. Instead of being appended at the bottom of the message, your text will be inserted at the cursor position.
* Progress Percent. This determines whether you want the device to display the progress percentage while receiving e-mail messages. By default, this setting is On.
* Progress clicks. Similarly to the "Progress Clicks" item in the notetaker Status Menu, this determines if you want the unit to click periodically to let you know that it's still busy. By default, this option is on.

Modem Settings

These settings determine the operation of your modem. They are available only in the Main Profile. The settings are as follows:

* Baud=38400. This is the baud rate of the modem. The default setting should be optimal for most situations.
* Internal Modem=on. Your M20 or M40 comes with an internal 56K modem, so this setting is on by default. If you do not have an internal modem, or if for some reason you must use an external modem, toggle this setting off. Note: you will need to connect the external modem to your unit's serial port via a Null-Modem cable or by using a Null-Modem adaptor.
* Init. This is the initialization string required by your modem. By default, this field is left blank. Should you encounter connection problems, you may want to troubleshoot them by supplying an appropriate initialization string.
* Dial=ATDT. This is the dial prefix used by your modem. A dial prefix is the string sent to the modem in order for it to dial a number. For tone dialing, the string is ATDT. For pulse dialing, it is ATDP.
* Phone=. This is where you enter the telephone number of your Internet Service Provider. You can use numbers from 0 to 9, as well as the following symbols: * and # for the Star and the Pound key; , (comma) for a 2-second pause; W to have the modem wait for dial tone; T to force tone dialing; P to force pulse dialing.

Tip: you can enter up to 255 phone numbers and allow the program to cycle between them if a connection fails. To do this, you must edit Email.cfg manually. Here is an example with three phone numbers for an ISP:

[modem]
phone=5551234
phone=5552345
phone=5553456

* Tries=5. The number of retries the modem should attempt if connection fails.

Login Settings

These settings allow you to log on to a network. You will most likely never need to use these settings, so they are left blank by default. This submenu is available only in the Default Profile. The options are:

* UserName. Your username on the network.

Note: this is different from your Internet Provider and e-mail user names, discussed elsewhere.

* Password. This is your network password. The field is blank by default.

Note: this is different from your Internet or e-mail password. It is unlikely that you would need to change this setting.

* Tries=3. The number of times the program should attempt to log on to your server.

PPP Settings

This is a very important group of settings. Incorrect parameters will result in failure to connect. Most of these settings were entered for you automatically when you ran Configuration Wizard. This submenu is available only in the Main Profile. The settings are as follows:

* UserName=. This is the User Name issued by your Internet Service Provider. This may be the same as, or different from, your e-mail username. Failure to supply this information correctly will result in failed connection attempts.
* Password=. This is the password issued by your Internet Service Provider. This may be the same as, or different from, your e-mail password. Failure to supply the correct password will result in failed connection attempts.
* Local IP=. This is the IP address of your local computer. Unless you were issued a static IP address by your Internet Service Provider, you should keep the default setting.
* Server IP=0.0.0.0. This is your provider's server IP address. Unless your provider tells you otherwise, keep the default value.
* Other PPP settings. This submenu includes advanced PPP settings that can be used by Internet communication professionals for troubleshooting purposes. There should be no need to modify these settings under normal circumstances.

POP3 Settings

These settings determine how the program connects to your POP3 server to retrieve incoming mail. They are available in all profiles and must be set up for each profile individually.

* UserName=. This is the user name issued to you by your Internet Service Provider for e-mail access. It may or may not be the same as your Internet user name. Failure to set this parameter correctly will result in an inability to establish a POP3 connection.
* Password=. This is the password issued to you by your Internet Service Provider for e-mail access. It may or may not be the same as your Internet logon password. Passwords are usually case-sensitive. Failure to set this parameter correctly will result in an inability to establish a POP3 connection.
* ServerName=. This is the name or IP address of your POP3 (incoming mail) server. You should have received this information from your Internet or e-mail provider.
* Size=0. The maximum message size (in kilobytes) the program should retrieve. The default value of 0 means that no size limit will be enforced. To conserve memory and prevent the program from downloading large messages, you may want to set this to a moderate level.
* Limit=0. The maximum number of messages the program should download in a single session. The default value is 0, which means that the program will attempt to download all messages. If your mailbox gets crowded, and you experience problems with the download, you may want to set a limit on the number of downloaded messages.

Several advanced settings are grouped together on the "Other POP3 Settings" submenu. They are:

* Leave Messages on Server by Date. By default, the program will retrieve messages and remove them from the server. However, if you normally receive your e-mail with your computer, and yet occasionally use the notetaker for e-mail access, you may want to leave the messages on the server and then download them to your computer as well. To do do, toggle this setting to "On".
* Filter Incoming Messages. This option controls advanced filtering and should be used along with the settings described in Filter Settings, below. Once this filtering is enabled, the messages which match advanced filtering criteria will not be retrieved (that is, they will be filtered out). If you also enable deleting filtered out messages then such messages will be deleted from the server. Alternatively, if "filter incoming messages" is off, then "delete filtered out messages on the server" will not be honored by the program.
* Delete Filtered Out Messages on the Server. This setting allows you to delete certain messages from the mail server without even retrieving them, based on just the header information. For example, suppose you do not want to see messages with certain text in the Subject Line, or messages from a certain sender. Rather than retrieving them and automatically directing them to a certain mailbox, you may have the program delete these messages immediately. To achieve this, toggle Delete Filtered Out Messages on the Server On, and then set the advanced filtering options as described in Filter Settings, below.
* Interactive Mode for Oversized Messages. This option works in tandem with the Size= setting described earlier. If the message size exceeds the maximum and this option is turned on, the program will ask you whether you want to download this message. If you keep this option off, then messages that exceed the maximum will not be downloaded.

SMTP Settings

These settings determine the interaction with your provider's SMTP (outgoing mail) server. This submenu is available in all profiles, and correct options must be set for each profile individually. The menu items are as follows:

* Email=. This is your complete e-mail address.
* Server Name=. This is the name or IP address of your provider's SMTP (outgoing mail) server.
* Port=. This is the port that should be used to send e-mail. Unless your provider tells you to use a specific port for SMTP, you should keep the default setting.
* UserName=. If you use your Internet Service Provider's SMTP server, this setting is probably not required. However, many SMTP servers require authentication. That is, the program should supply the user name and password before it is allowed to connect to the server. Usually, these are the same as your POP3 user name and password. So, if your server requires authentication, or if you have persistent problems sending mail, you should supply this information.
* Password=. If required, this is usually the same as your POP3 password. See explanation under the previous item.

Filter Settings

This e-mail client features advanced filtering. It is designed to remove unwanted messages from the server without downloading them to the notetaker. By default, advanced filtering options are disabled. You can turn them up on the Filter Settings submenu. This menu is available on all profiles and can be set individually for each profile.

Messages can be filtered based on one or more of the following four criteria: "From:" field, "To:" field, "CC:" field, or "Subject:" field. For example, you can enter "XXX" under Subject, and you will never see messages that contain this string in their subject lines.

Warning: exercise caution with this function. It is possible to filter out legitimate mail if it happens to contain the offending string.

Mailbox Settings

This submenu allows you to have personalized names for system mailboxes (mail folders). It also allows you to establish names to be used when a new Mailbox file is automatically created by the program. That is, if you set your folder names through this submenu, and then for some reason you must delete your existing Mailbox file, the program will create a new Mailbox file with folder names specified here.

Note: deleting the Mailbox file is not recommended, as this will cause you to lose your messages.

FREQUENTLY ASKED QUESTIONS

This section contains answers to most frequently asked questions about the Email.bns program.

Q. 	Can I run the program from Flash or from a CompactFlash card?
A. 	Yes you can. However, remember that you must still have enough RAM memory to hold the program while it is running. This is because, even though you run the program from Flash, a temporary copy still resides in RAM. The unit will give you an error message if there is not enough RAM for this operation. Also, remember that the program still needs RAM to create and maintain its own files, such as Email.cfg, Mailbox and Email.$$$.

Q.	Why do I receive a message that the configuration file was not found when I run Mailer.BNS?
A. 	This means that Mailer could not find the configuration file, Email.cfg. You should run Email.bns to create the file. The Configuration Wizard will guide you through the process. Alternatively, if you have a backup of your Email.cfg, then you can copy this file to your notetaker, and the program will use it.

Q. Why doesn't the modem connect when I run Mailer.bns?
A.	To troubleshoot this issue, answer the following questions:

* Are you connecting to a working telephone line?
* Is this a regular telephone line, as opposed to ISDN? Your notetaker is not designed to support ISDN.
* Is the telephone cable firmly connected to the modem jack of the notetaker?
* Does the telephone service support tone dialing? If not, change the dialing method to Pulse. See Modem Settings, above, for instructions.
* Are you dialing the correct telephone number for your Internet Service Provider? Dial the same number from a regular telephone line and verify that you are connecting to a modem on the other end.
* Do you need to dial anything to get an outside line? If so, then you should prefix that to the access number.

Q.	Why doesn't anything happen after the unit displays, "Establishing PPP Connection"?
A.	Make sure your PPP UserName and Password are set correctly. Note that passwords are case-sensitive. Also, make sure that your account with the Internet provider is in good standing. You may have problems establishing a PPP connection if your account with the provider is blocked.

Q.	Why can't the program connect to my POP3 or SMTP server?
A.	Check your POP3 or SMTP user name and password. Most of the time, this is the root of problems connecting with mail servers. It is also possible that you entered the server name incorrectly. Finally, your server may be temporarily down, so it makes sense to try the connection again in a few minutes.

Q.	Why does my unit sometimes lock up while downloading mail?
A.	First of all, are you sure it really locks up? If you receive a large message, it may take quite awhile to download it. Even so, the percentage of the download will keep updating on the Braille display.

If you are sure this is a legitimate lockup, try setting the limit on the number and size of downloaded messages. Refer to Log Settings, above.

Q.	Why does the person receiving my message tell me it looks like gibberish when I've composed it in Grade II?
A.	Even though you composed your message in contracted Braille, the program might not know about it, and so your message could not be translated into uncontracted Braille. If you want to be able to compose messages in contracted as well as in uncontracted Braille, open the Context Menu by pressing O-CHORD, then press "C" to edit the email configuration, then E-CHORD to access Main Profile, then press DOWN ARROW until you reach Mail Settings, and press EMTER. Then press DOWN ARROW three times to get to Message Mode, and press E-CHORD. Use your ARROW KEYS to choose "Interactive", and then press Z-CHORD 4 times to leave the menu. Now, whenever you begin a new message, you will be asked whether you want to compose in contracted Braille.

Q.	Why does my text always appear below the messages I am replying to?
A.	By default, the editor works in Append Mode. Anything you type is appended to existing text (in your case, to the messages you work with). To make sure your text is inserted at the cursor position, turn on Insert Mode. See Mail Settings, above, for details.

Q.	What is the file Email.$$$ that I noticed in my unit?
A.	It is a temporary file created and maintained by the Email program. Under normal circumstances, it should have been removed automatically. Still, if you ever see this file, there is no need to worry—the program will process it next time it is run.

Appendix A: Email Command Summary

Command Description Braille Lite Keystroke Type Lite Keystroke

Message List Commands
Top of List DOTS 1-2-3 CHORD HOME
Bottom of List DOTS 4-5-6 CHORD END
Move to Previous Mailbox DOTS 2-3 CHORD PAGE UP or Shift+F6
Move to Next Mailbox DOTS 5-6 CHORD PAGE DOWN or F6
Move to Previous Message DOT 1 CHORD UP ARROW
Move to Next Message DOT 4 CHORD DOWN ARROW
Toggle Header Display DOT 6 CHORD or DOT 3 CHORD RIGHT ARROW or LEFT ARROW
Say Current Message Info DOTS 1-4 CHORD ALT+C
Open Message for Reading or Editing E-CHORD ENTER
Reply to Message R R
Forward Message F F
Move Message M M
Delete Message D or D-CHORD D or ALT+D
Save Message S S
Compose New MessageA or DOTS 3-4-6 CHORD A or ALT+PLUS
Open Address Book DOTS 2-5-6 CHORD ALT+4
Go to Folder List L L
Open Context Menu O-CHORD ALT+O
Set Filter Rules T-CHORD ALT+T
Apply Filter Rules Manually F-CHORD ALT+F
Shell Out S-CHORD ALT+S
Close Email Program Z-CHORD ESCAPE

Message Viewer and Editor Commands
Note: most of the regular text navigation and editing commands are available.
Navigate between Message Headers DOT 4 CHORD, E-CHORD or DOT 1 CHORD DOWN ARROW, UP ARROW or ENTER
Open Address Book DOTS 2-5-6 CHORD ALT+4
Context Menu O-CHORD  ALT+O
Exit from Message Editor Z-CHORD ESCAPE
Shell Out S-CHORD ALT+S

Folder View Commands
Previous Folder DOT 1 CHORD UP ARROW
Next Folder DOT 4 CHORD DOWN ARROW
Open Current Folder E-CHORD ENTER
Create New Folder DOTS 3-4-6 CHORD  ALT+PLUS
Rename Folder R-CHORD ALT+R
Delete a Non-System Folder D-CHORD ALT+D

Menu System Commands
Move through Menus DOT 1 CHORD or DOT 4 CHORD UP ARROW or DOWN ARROW
Open a Menu Item E-CHORD ENTER
Toggle a Menu Item SPACEBAR SPACEBAR
Exit a Menu or a Submenu Z-CHORD ESCAPE
Exit Email Program Z-CHORD ESCAPE

Download Driver Pack

How To Update Drivers Manually

After your driver has been downloaded, follow these simple steps to install it.

  • Expand the archive file (if the download file is in zip or rar format).

  • If the expanded file has an .exe extension, double click it and follow the installation instructions.

  • Otherwise, open Device Manager by right-clicking the Start menu and selecting Device Manager.

  • Find the device and model you want to update in the device list.

  • Double-click on it to open the Properties dialog box.

  • From the Properties dialog box, select the Driver tab.

  • Click the Update Driver button, then follow the instructions.

Very important: You must reboot your system to ensure that any driver updates have taken effect.

For more help, visit our Driver Support section for step-by-step videos on how to install drivers for every file type.

server: web5, load: 1.18