; $URL: http://subversion:8080/svn/gsc/trunk/drivers/LINUX/SIO4%20and%20SIO8/SIO4_Linux_2.x.x_GSC_DN/samples/sio4flash/README.txt $
; $Rev: 54425 $
; $Date: 2024-05-17 08:16:45 -0500 (Fri, 17 May 2024) $

SIO4: Sample Application: flash programming readme file



SIO4 LINUX DRIVER:

The sio4flash application works only with SIO4 Linux driver series 3.x.  The
application does not work with any other driver.



DESTINATION DIRECTORY:

The sio4flash application resides in the "sio4flash" samples subdirectory,
which should be the sio4/samples/sio4flash/ subdirectory.

   .../sio4/samples/sio4flash/



APPLICATION BUILD:

If the sio4flash sources are placed in the above specified location, then
the application can be built via either of the following options.

1. Change to the SIO4 root subdirectory and invoke the make_all script.

   cd .../sio4/
   ./make_all

2. Change to the sio4flash subdirectory and invoke make, as follows.

   cd .../sio4/samples/sio4flash
   make clean all



SAVE CURRENT FIRMWARE:

The current firmware can be saved to disk with the below command lines. The
application will read the current flash content and save it to a file whose
name includes the device's main model number, a timestamp and a .rpd file
extension.

   cd .../sio4/samples/sio4flash
   ./sio4flash -rx -save 0



UPDATE CURRENT FIRMWARE:

The current firmware can be updated from a .rpd file with the below command
line. Updating the firmware for an SIO4 or SIO8 requires a .rpd specific to the
SIO4 model being accessed. If the .rpd file provided is not intended for the
SIO4 being accessed, then, while the flash programming effort may pass, the
device will not likely function.

NOTE: .rpd files do not contain content that allows the sio4flash application
to verify the intended target device. If an incompatible .rpd file is supplied
then the SIO4 may have to be returned to General Standards.

   cd .../sio4/samples/sio4flash
   ./sio4flash -tx -src=XXXXXX.rpd 0

The updated firmware will take affect after the host is rebooted.



DEVICE INDEX:

For SIO4 model boards, the device index given on the command line is not
significant. The flash device is accessible from all four channels. For SIO8
model boards, the flash device is accessible from only four of the serial
channels. The application will reject use of the other four channels as the
flash device is not accessible from those channels. For both model boards, only
one flash programming effort is required per board as it updates the firmware
for all board channels.


