Logging Using the Log Button

The PwrPak7 Log button is used to start and stop log collection to a file on internal memory or a USB stick.

The actions performed when the Log button is pressed are determined by the configuration of the FILELOGBUTTON profile.

Press Log button to	Actions when the FILELOGBUTTON profile is not configured (Default)	Actions when the FILELOGBUTTON profile is configured
Start logging	The PwrPak7 opens a log file on the file media specified by the FILEMEDIACONFIG command. The PwrPak7 saves any logs configured to output to the FILE port in the open log file.	The PwrPak7 stops collecting any logs currently being sent to the FILE port. The PwrPak7 runs the commands configured in the FILELOGBUTTON profile.
Stop logging	The PwrPak7 stops saving logs in the log file. The PwrPak7 closes the log file.	The PwrPak7 stops collecting any logs currently being sent to the File port. The PwrPak7 closes the log file. If the file media was a USB stick, the USB stick is unmounted.

USB sticks used with the PwrPak7 must be formatted as FAT32. If the USB stick is formatted incorrectly, or corrupted, the TRANSFER LED will flash red for three seconds. To correct the issue, use a computer to reformat the USB stick as FAT32.

Before powering off the PwrPak7 or using the RESET command, use the FILECONFIG command, or press the Log button, to close the log file.

PwrPak7M variants do not have the Log button.

Logging using the Log Button – Default Profile

Use this procedure to start logging using the Log button when the FILELOGBUTTON profile has not be configured.

The file media to use must be available to the receiver when pressing the Log button.

1. Ensure that a computer is not connected to the TRANSFER port.

   If logging to a USB stick, insert the USB stick into the TRANSFER port on the PwrPak7.

2. Wait until the PwrPak7 mounts the file media.

   If logging to internal memory, ensure that the LOG LED is solid green.

   If logging to a USB stick, ensure that the TRANSFER LED is solid green.

   Alternatively, the mount status can be checked using the FILESYSTEMSTATUS log:

   LOG FILESYSTEMSTATUSA ONCHANGED

   #FILESYSTEMSTATUSA,COM2,0,22.0,UNKNOWN,0,4.893,02440020,143c,32768;
   2,INTERNAL_FLASH,MOUNTING,0,"",USBSTICK,UNMOUNTED,0,""

   #FILESYSTEMSTATUSA,COM2,0,18.0,UNKNOWN,0,4.893,02440020,143c,32768;
   2,INTERNAL_FLASH,MOUNTED,0,"", USBSTICK,UNMOUNTED,15471912,""

3. Press and release the Log button.

   The PwrPak7 starts saving any logs configured to use the FILE port into the log file.

4. Use the LOG command to add logs to save in the log file. The logs must be sent to the FILE port.

   For example, to add the BESTPOS and VERSION, enter the following commands.

   LOG FILE VERSIONA ONCE

   LOG FILE BESTPOSA ONTIME 1

5. When you are finished collecting logs, press and release the Log button.

   File logging stops and the log file is closed.

   If the file media is internal memory, the log file now available for access.

   If the file media is USB stick, the PwrPak7 unmounts the USB stick. Wait until the TRANSFER LED is off and then the USB stick can be removed from the PwrPak7.

After the button is pressed to deactivate logging to a USB stick, the USB stick must be removed and re-inserted in order to activate logging again.

Configuring the FILELOGBUTTON Profile

The configuration of the FILELOGBUTTON profile determines the file media used and the logs collected when the Log button is pressed.

When creating the FILELOGBUTTON profile, the first command in the profile must be a FILEMEDIACONFIG command and the second command must be FILECONFIG OPEN.

The FILELOGBUTTON profile is created using the PROFILE command. For information about using this command, see the PROFILE command.

To configure the FILELOGBUTTON profile:

1. Create the profile.

   PROFILE CREATE FILELOGBUTTON

2. Define the file media to use (internal or USB stick).

   PROFILE CREATEELEMENT FILELOGBUTTON "FILEMEDIACONFIG INTERNAL_FLASH"

   or

   PROFILE CREATEELEMENT FILELOGBUTTON "FILEMEDIACONFIG USBSTICK"

3. Open the log file.

   PROFILE CREATEELEMENT FILELOGBUTTON "FILECONFIG OPEN"

4. Configure the file rotation settings (optional).

   PROFILE CREATEELEMENT FILELOGBUTTON "FILEROTATECONFIG xx xxxx xxxx"

   Where xx xxxx xxxx are the desired options for the FILEROTATECONFIG command. For information about this command, refer to the FILEROTATECONFIG command.

5. Configure the logs to save to the log file.

   PROFILE CREATEELEMENT FILELOGBUTTON "LOG FILE xxxx"

   Where xxxx is the log to save and the log options.

   A PROFILE CREATEELEMENT command is needed for each log to collect.

Example 1

In the following example, the FILELOGBUTTON profile is configured to save the VERSION and BESTPOS logs to a file on internal memory.

PROFILE CREATE FILELOGBUTTON
PROFILE CREATEELEMENT FILELOGBUTTON "FILEMEDIACONFIG INTERNAL_FLASH"
PROFILE CREATEELEMENT FILELOGBUTTON "FILECONFIG OPEN"
PROFILE CREATEELEMENT FILELOGBUTTON "LOG FILE VERSIONA ONCE"
PROFILE CREATEELEMENT FILELOGBUTTON "LOG FILE BESTPOSA ONTIME 1"

Example 2

In the following example, the FILELOGBUTTON profile is configured to save the VERSION, RANGE, BESTPOS and INSPVA logs to a file on a USB stick. Also, the optional FILEROTATECONFIG command is added to a start a new file every two hours.

PROFILE CREATE FILELOGBUTTON
PROFILE CREATEELEMENT FILELOGBUTTON "FILEMEDIACONFIG USBSTICK"
PROFILE CREATEELEMENT FILELOGBUTTON "FILECONFIG OPEN"
PROFILE CREATEELEMENT FILELOGBUTTON "FILEROTATECONFIG 2 4096 STOP"
PROFILE CREATEELEMENT FILELOGBUTTON "LOG FILE VERSIONA ONCE"
PROFILE CREATEELEMENT FILELOGBUTTON "LOG FILE RANGEA ONTIME 1"
PROFILE CREATEELEMENT FILELOGBUTTON "LOG FILE BESTPOSA ONTIME 1"
PROFILE CREATEELEMENT FILELOGBUTTON "LOG FILE INSPVAA ONTIME 1"

Logging using the Log Button – Profile Configured

Use this procedure to start logging using the Log button when the FILELOGBUTTON profile has been configured.

The FILELOGBUTTON profile must be configured before pressing the Log button. See Configuring the FILELOGBUTTON Profile.

The file media configured in the profile must be available to the receiver when pressing the Log button.

1. Ensure that a computer is not connected to the TRANSFER port.

   If logging to a USB stick, insert the USB stick into the TRANSFER port on the PwrPak7.

2. Wait until the PwrPak7 mounts the file media.

   If logging to internal memory, ensure that the LOG LED is solid green.

   If logging to a USB stick, ensure that the TRANSFER LED is solid green.

   Alternatively, the mount status can be checked using the FILESYSTEMSTATUS log:

   LOG FILESYSTEMSTATUSA ONCHANGED

   #FILESYSTEMSTATUSA,COM2,0,22.0,UNKNOWN,0,4.893,02440020,143c,32768;
   2,INTERNAL_FLASH,MOUNTING,0,"",USBSTICK,UNMOUNTED,0,""

   #FILESYSTEMSTATUSA,COM2,0,18.0,UNKNOWN,0,4.893,02440020,143c,32768;
   2,INTERNAL_FLASH,MOUNTED,0,"", USBSTICK,UNMOUNTED,15471912,""

3. Press and release the Log button.

   The PwrPak7 stops collecting the logs currently being sent to the FILE port and starts collecting the logs configured in the FILELOGBUTTON profile.

4. When you are finished collecting logs, press and release the Log button.

   The FILELOGBUTTON profile is deactivated. This stops the file logging defined in the profile and closes the log file.

   If the file media is internal memory, the log file now available for access.

   If the file media is USB stick, the PwrPak7 unmounts the USB stick. Wait until the TRANSFER LED is off and then the USB stick can be removed from the PwrPak7.

After the button is pressed to deactivate logging to a USB stick, the USB stick must be removed and re-inserted in order to activate logging again.