Load & Save Configuration Data

The SoarPilot settings can be saved to either a Palm Memo or DOC file 1), to a SD Card or exported to a text file on your desktop PC via serial or IrDA transfer using SPTerm on Windows or standard command line tools on Linux. Bluetooth is also supported, but I have no experience with BT, so please write that section if you know how.

Personally I always use the DOC transfer method for the configuration settings, but if your Palm supports SD Card that is the preferred method.

Procedure

  1. Make sure to use the Data Transfer Config to select the preferred transfer option first.
  2. Read this FAQ to find out what the name of the import/export file should/will be. For the configuration settings that name is defaulted config.scg
  3. Use the Home softkey to open the SoarPilot menu and then go to Settings → Transfer or use the shortcut X. This will show the Main Transfer screen.
  4. Pick your transfer method from the list, if you select the SD Card or DOC methods you can choose the filename, otherwise SoarPilot will use the default filenames.

SD Card Method

Confirm that the title of the screen shows Transfer - Card. If not, correct in the Data Transfer Config first.


Tap Configuration. The screen should look like the sample on the left.





To Save Tap Transmit to write your current SP settings to a file on the SD Card. This file will be written to /PALM/Programs/SoarPilot
To Load Tap Receive to load SP settings from the SD Card. The files are expected to be found on the SD Card in directory /PALM/Programs/SoarPilot. Your current settings will be overwritten by the settings in the file!

DOC Method

Confirm that the title of the transfer screen shows Transfer - DOC.
If not, correct in the Data Transfer Config first.


Tap Configuration. The screen should look like the sample on the left.





To Save Tap Transmit to write your current SP settings to a DOC file in Palm memory. You can then exit SP and Hotsync® to make a backup on your desktop PC.
To Load Tap Receive to load SP settings from a DOC file in Palm memory. Your current settings will be overwritten by the settings in this file!

MEMO Method

Confirm that the title of the screen shows Transfer - Memo. If not, correct in the Data Transfer Config first.


Tap Configuration. The screen should look like the sample on the left.





To Save Tap Transmit to write your current SP settings to a Memo called *config.scg in Palm memory. You can then exit SP and Hotsync® to make a backup on your desktop PC.
To Load Tap Receive to load SP settings from a Memo in Palm memory. A memo called *config.scg is expected to be found. Your current settings will be overwritten by the settings in this memo!

Serial Method

See Using SPTerm.

First make sure to disable overclocking hacks like Afterburner on your Palm

Confirm that the title of the transfer screen shows Transfer - Serial followed by the baudrate. If not, correct in the Data Transfer Config first.


Only use Hardware handshake if you use a fully wired serial cable.



Tap Configuration. The screen should look like the sample on the left.








Windows:
PC Side Make sure the serial port on the PC isn’t locked by f.i. your HotSync ® Manager Hotsync Manager





Then hook up your Palm via a serial cradle with a free COM port on the PC and start SPTerm. Use SPTerm menu command ConnectionProperties and match the COM port settings with the one on the Palm. Click OK and then the Open Port button in SPTerm.
To Save
















SPTerm: use the Download button, this will popup a file dialog where you must first select the Config Files(*.scg) file type using the combo box labeled ‘Files of type’. Then browse to an appropriate directory and provide a file name and click the ‘Open’ button.

Palm: Tap Transmit to transmit your current SP settings over the serial line to SPTerm:


screenshot of SPTerm after succesfull completion of the transfer.

Finally use the Dwnl Stop to close the config file on the PC. All done!
To Load Tap Receive to load SP settings over the serial line from a file transmitted by SPTerm. The label of the button will change into Stop.

In SPTerm, use the Upload button and in the ‘Select File to Upload to SoaringPilot’ file dialog browse for the desired config file you want to load into SP and click ‘Open’. The file should now be transfered to SP.



Linux:
PC Side Make sure the serial device on the PC isn’t used by other processes and you have read and write permission to the serial device

Then hook up your Palm via a serial cradle with a free serial device on the PC.

The following description of down- and uploads makes use of basic command line tools, which should be installed on all linux boxes. Run them from the command line in a terminal. Serial communication programms like minicom or kermit offer another approach.

Configure the serial device with stty. Match the serial device settings with those on the Palm. Hardware handshake on the first serial device and 19200bps can be set with:

$ stty -F /dev/ttyS0 19200 -clocal crtscts

If hardware handshake is doing fine, there is nothing wrong about using a transfer rate of 115200bps on the Palm- and on the PC-side. At least PalmOS-3.5.1 on my m105 has a bug and hardware handshake does not work! Uploads to the m105 are limited to 2400bps without hardware handshake. Palm offers a free upgrade to PalmOS-3.5.3 which cures the bug. But, this upgrade is not recommended for the m105 by Palm. I was brave and installed the upgrade anyhow and got a working hardware handshake.

You can display the major current settings of the first serial device with:

$ stty -F /dev/ttyS0

And you can display all settings of the first serial device with:

$ stty -F /dev/ttyS0 -a
To Save PC: Enter the directory where you want to save the data. Download the configuration data with cat from SP to a file on the PC. In this example it is named SP-config-file.txt.

$ cat /dev/ttyS0 > SP-config-file.txt

Palm: Tap Transmit to transmit your current SP settings over the serial line.

PC: Finally hit Ctrl-C in the linux terminal to stop cat. All done!
To Load Palm: Tap Receive to load SP settings over the serial line from a file on the PC. The label of the button will change into Stop.

PC: Enter the directory where you have the data file for upload. Upload for example the file SP-config-file.txt with the cat command:

$ cat SP-config-file.txt > /dev/ttyS0

Palm: Tap Stop to stop SP listening on the seriel line.

IrDA Method

Windows:

See Using SPTerm.

This method is basically identical to serial transfer. On the PC install IrCOMM2k if you have Win2K or WinXP. For Win9x IrDA may already be available as a generic serial port, but YMMV. Use Google. The idea is to assign the IrDA port to a (pseudo) serial COM port so SPTerm can be fooled to believe it’s talking to a serial port. Once you have that up and running, select IR in the Data Transfer Config and a suitable baudrate (don’t pick a too high baudrate!). You do not need a cradle, simply line up the IR port of the Palm with the IrDA of your PC/laptop. The Save and Load procedures are identical to the serial method.

Linux:

This method is basically identical to serial transfer. You need to have your IrDA hardware up and running at this point. The serial communication has to be enabled for IrDA. Every thing is fine, if the device /dev/ircomm0 is present and usable for the first IrDA interface. If not, loading the module ircomm_tty enables the serial communiction for IrDA or use your local configuration procedure for this purpose. Once you have /dev/ircomm0 up and running, select IR in the Data Transfer Config and a suitable baudrate. You do not need a cradle, simply line up the IR port of the Palm with the IrDA of your PC/laptop. The Save and Load procedures are identical to the Serial method. You just have to replace the serial device name /dev/ttyS0 by your seriel ir-device name like /dev/ircomm0 for the first IrDA interface.

Bluetooth Method

It’s assumed you have already paired the Palm and your computer. Do so before you continue following this guide!

See Using SPTerm.

  1. First you need to know exactly what COM port the Palm will use to establish a serial link with your computer. Right-click the Bluetooth icon in your System Tray, and select Advanced Configuration. Select the Local Services tab, and you’ll see a dialog like the one below. Take note of the value in the Bluetooth Serial Port service. In this case it’s COM9. You can close this dialog without changing any setting.

bt_config_win.jpg

  1. Configure SPTerm to use the same COM port.
  2. Select BT in the Data Transfer Config of SP.
  3. You do not need a cradle, simply hold the Palm in the ficinity of the your PC/laptop with Bluetooth enabled.
  4. The Save and Load procedures are identical to the serial method.

See also Tips & Tricks - Bluetooth.

Sample Config File

SoarPilot transfers the config data as a simple text file. Below a sample config text file, so you have an idea what it looks like:

** -------------------------------------------------------------
**       SOARINGPILOT Version 3.0.0 Configuration
**       Date: 30 Aug 2005
** -------------------------------------------------------------
CONFIG1,1.00,0.00,1148,2,2,2,2,2,2,4,37.25,30.23,20,1,1,12,2,2,5,0,0,1,1
CONFIG2,0,1,1,1,1,1,25,1,1,2,1,1,1,12,30,0,0,2,0,0,0.00,1,1,0,1,0
CONFIG3,1,0,0,1,0,1.0000,131,0,1,1,0.5000,0.2500,0,1.0000,131,0,1,0,1
CONFIG4,1,6561,786109,1,0,4,1,5.399,10.799,1,300,1,0,1,0,0,1,0,0,0
CONFIG5,0.988,498.687,0,0,2,0.330,0,0,20,43.19,1,0
CONFIG6,0,0,255,255,192,0,255,0,255,0,0,1,0,0,1,9842,2,1,0,1,30,0,10
CONFIGCAI,0.0000,1.0000,0.1000,5,1,0,0,0,1,255,1,1
POLAR1,Pegase,53.9,-1.450,75.5,-1.940,107.9,-4.850,1003.10,33.00
POLAR2,-0.001243,0.138177,-5.286169,55.575862,-1.446508
IGCHINFO1,Antoine Megens,,
IGCHINFO2,,,,
IGCHINFO3,GPS Companion,
LISTLINES,1,2

LISTLINES Feature

You can now configure horizontal and vertical lines in the waypoint list, active task, task list, SUA list, polar list and flight lists screens. This option is not available in a setup screen as the programming effort does not justify a new screen for an option that will be set very rarely. The procedure is:

  1. Once you load a new SoarPilot version, re-load your config settings, then transmit out again.
  2. Edit the config.scg file. This can be done on the Palm if you’ve used MEMO or DOC transfer. For editing DOC format, you need to install a DOC Reader/Editor, see Links page. For the other transfer methods you can use your favorite text editor. Make sure to use an editor that keeps EOL intact (CR+LF), specially if you edit on *NIX platform.
  3. You will see a line LISTLINES. The first number controls the vertical lines, the second number the horizontal lines. (0 = no line, 1 = gray line, 2 = solid line)
  4. Save changes and transfer modified config.sgc file back to Palm and SoarPilot. Repeat edit if you don’t like the result. Then stick to the line format you like most.

These screen shots were made using a Hi-Res Colour Palm, the results may look different on a Lo-Res B/W screen. These screenshots have also been resized a bit, which makes a bit harder to see the difference between the gray and solid line type. To only way to find out it to experiment with these settings.

LISTLINES Samples
LISTLINES,0,0
LISTLINES,0,1








LISTLINES,0,2
LISTLINES,1,0
LISTLINES,1,1








LISTLINES,1,2








LISTLINES,2,0
LISTLINES,2,1
LISTLINES,2,2

You get the idea...

LEFTACTION Feature

Configuation option to change the behaviour of the Left button on the 5-way navigator.

Like the “LISTLINES” feature above, it is not available in a setup screen as the programming effort does not justify a new screen for an option that will be set very rarely.

This is set by editting the configuration file directly by changing the line “LEFTACTION”.

The allowed values are:

  • 0 - Do nothing
  • 1 - Home button (default)
  • 2 - Move backwards in the screen order continously
  • 3 - Move backwards in the screen order but stop at either end of the list.

With LEFTACTION = 3 holding the left or right buttons will continue to move in the chain until you reach the end. The current action of the right button remains to move forward in the screen order.

MCBUTTON Feature

Controls how you change the MC value within SoarPilot

  • 0 - MC value changed with hardware buttons (default)
  • 1 - MC value changed by popup dialog either the ToDo or Memo buttons are pressed, or you tap MC field on the Final Glide screen

BTGPSADDR Feature

This is a new experimental feature in 4.6.2 that is used to store the bluetooth address of your preferred GPS source.

Example: BTGPSADDR,00:0B:0D:6C:BE:39

When the line is missing or the BT address is configured to all zeros, then the normal BT search dialog will show to select a BT GPS. Otherwise Soaring Pilot will automatically connect with the configured (preferred) BT address.

1) A Palm Memo or DOC file can of course be transfered to your desktop via Hotsync® on Windows or pilot-xfer on Linux
 
soarpilot/load_save_configuration.txt · Last modified: 2014/01/08 15:27 by amegens
 
Recent changes RSS feed Creative Commons License Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki