background image

 
 

Command Reference Manual 

TSAT 3000 Command Line Interpreter  

January 2013 

Page 2 of 41 

 

 

 

Document Status 

 

Product description: TSAT3000 Command Line Interface Command Reference 

 

Document 

Revision 

Date 

Bundle 

Release 

Description 

1.0.0 

2008.02.15 

2.0.0 

Initial revision 

1.0.1 

2008.03.13 

2.0.0 

Word and grammer corrections. 

1.1.0 

2008.11.27 

3.1.0 

Adding/updating commands for Release 3.1.0. 

1.1.1 

2008.12.01 

3.1.0 

Modified command description layout. 

1.2.0 

2008.12.09 

3.2.0 

Added commands for Release 3.2.0. 

1.3.0 

2009.07.02 

3.6.0 

Modified for Release 3.6.0 

1.4.0 

2009.12.09 

4.0.0 

Modified for Release 4.0.0 

1.5.0 

2011.06.24 

4.3.0 

Changed “net ping” 

1.6.0 

2011.10.20 

4.4.1 

New “sys rf tx level cal” 
New “sys rf tx calibrate” 
Changed “rf info” 

1.6.1 

2012.01.09 

4.4.3 

Changed “net ping”: Add [-I ifname] [-S srcAddr]. 
Described “net ifconfig”: [bits] 

1.6.2 

2012.10.12 

4.7.2 

New RIP [3.3.5] options: 

nosplithorizon

 + 

noinvalidate

New RIP [3.3.5] command: “net rip debug [0-9]”. 

1.6.3 

2013.01.28 

4.8.0 

Changed RIP [3.3.5] options: 

noinvalidate

New RoHC [3.3.4] command: “net sat hcmode [enable | disable | rx-only]”. 

 

 

 
 

Summary of Contents for TSAT 3000

Page 1: ...Product DOC3010 Revision 1 6 3 January 2013 Telemetry and data transfer via SATellite TSAT 3000 Command Line Interpreter Command Reference Manual 1 6 3 ...

Page 2: ...cription layout 1 2 0 2008 12 09 3 2 0 Added commands for Release 3 2 0 1 3 0 2009 07 02 3 6 0 Modified for Release 3 6 0 1 4 0 2009 12 09 4 0 0 Modified for Release 4 0 0 1 5 0 2011 06 24 4 3 0 Changed net ping 1 6 0 2011 10 20 4 4 1 New sys rf tx level cal New sys rf tx calibrate Changed rf info 1 6 1 2012 01 09 4 4 3 Changed net ping Add I ifname S srcAddr Described net ifconfig bits 1 6 2 2012...

Page 3: ...___________________________________ Phone ________ ________________________________________________________ Further information about TSAT 3000 can be obtained from AV SatCom AS P O Box 1 1330 Fornebu NORWAY Telephone 47 66 77 44 40 Fax 47 66 77 44 41 AV SatCom AS makes no warranty of any kind with regard to this material including but not limited to the implied warranties of merchantability and f...

Page 4: ...3 4 OPERATING SYSTEM OS 19 3 5 FILE SYSTEM FILE 23 3 6 PARAMETER DATABASE DB 26 3 7 SOFTWARE UPGRADE SW 27 3 8 LOGS LOG 28 3 9 RF COMMANDS RF 29 3 10 SYSTEM COMMANDS SYS 30 3 10 1 DSP 30 3 10 2 Date Time 30 3 10 3 Analog to Digital Digital to Analog converter control 31 3 10 4 RF Synthesizer control 32 3 10 5 RX TX Switch control 32 3 10 6 Automatic Gain Control AGC Control 33 3 10 7 Receive RX an...

Page 5: ...ork with dotted lines just for illustration The executable command syntax you shall use on the command line is written first Usage field Then a short text describing the result of the command when executed Release Limits the availability of this command to the bundle releases written here Commands with no Release field works for all releases Parameter s Parameter name Function or value description...

Page 6: ...ots modem The reboot command attempts a graceful reboot by allowing tasks to shut down properly before a system reboot Release 3 0 x and earlier The reset command will directly activate the reset circuitry and should only be used in the event that reboot fails history Lists the previous executed commands cmdstat Displays debugging information resulting from the last command executed by the CLI ...

Page 7: ... and password user who Displays login information for the current user user list Displays login information for all registered users user pwdgen pwd This command is used to generate a clear text encrypted password The takes a desired password as input pwd and creates an encrypted password string This password string is needed when a new user is to be added to the system Details on how this is done...

Page 8: ...10 0 2 1 2010803 0 0 1 0 sat0 192 168 16 8 29 10 0 2 1 2010803 0 0 1 0 sat0 192 168 16 16 29 10 0 2 1 2010803 0 0 1 0 sat0 192 168 16 24 29 10 0 2 1 2010803 0 0 1 0 sat0 192 168 16 32 29 192 168 16 33 2000101 0 0 2 0 motfcc0 192 168 16 40 29 192 168 16 41 2000101 0 0 2 0 motfcc1 OSLO RT2 Example R3 x x OSLO RT3 net route INET route table vr 0 table 254 Destination Gateway Flags Use If Metric 127 0...

Page 9: ...0 2 1 0xFFFFFF00 ROUTE ADD IP Addr 192 168 16 32 Gateway 10 0 2 1 Mask 0xFFFFFF00 Type of service 0x0 Route flags 0x800 OSLO RT1 net route add destination bitcount_mask gateway addr options net route add destination netmask addr gateway addr options This command adds a network route to the routing table The route only exists until the power of the main unit is cycled Routes are added to the routin...

Page 10: ...x x Assume the following route table entry Destination Pfx Gateway Flags RefCnt Use Proto Tos I f 192 168 16 0 29 10 0 3 1 3010803 0 0 1 0 sat0 The route can be removed by issuing the following CLI command OSLO RT1 net route delete 192 168 16 32 0xFFFFFF00 ROUTE DELETE IP Addr 192 168 16 32 Mask 0xFFFFFF00 TOS 0x0 Flags 0x0 OSLO RT1 If Tos is different from 0 you will have to add the correct optio...

Page 11: ...ot notation ex 192 168 0 1 bits Number of bits in network mask ex 24 net if up down ifName Mark an interface as ready to send and receive or as unresponsive If you omit the parameters you will get a list of information for all the network interfaces including the local loopback interface lo0 Replaced by net ifconfig Release R1 0 0 R3 0 2 Parameters up down up means interface is set to be ready to ...

Page 12: ...arameters host IP address of device you want to reach numPackets Number of ping requests options silent Suppress output dontroute Do not route packets past the local network nohost Suppress host lookup debug Enables debug output w ms Millisec timout Default 3000 ms l size Size of ping packet Default 64 bytes n count Number of ping requests Default 4 RELEASE 4 5 0 net ping host options w ms l size ...

Page 13: ...level ARP table Parameter flush Empties the ARP table R2 x x only net host Lists the host table net ipstat DEBUG Displays IP statistics Release R1 0 0 R2 x x net inetstat DEBUG Displays active internet connections information net poolstat DEBUG Displays statistics for the network stack s data and system memory pool ...

Page 14: ...s off debug For debug purposes net ip forward state DEBUG Turn IP forwarding on off Display current setting if state is omitted Add permanent setting to the configuration file Release R3 x x Parameters state on off IP forwarding is enabled Default IP forwarding is disabled net ip icmp redirect param value interface name DEBUG Test ICMP redirect settings Add permanent setting to the configuration f...

Page 15: ...er Satellite status net sat estatus Display internal IPSAT statistics net sat hcstatus Display RoHC statistics for IP over Satellite Release R4 0 0 net sat hcmode mode Get or Set RoHC mode for IP over Satellite Release R4 8 0 Parameter mode enable RoHC is enabled disable RoHC is disabled rx only Receive RoHC but don t transmit RoHC packets net sat linkstate Display satellite link state net sat rou...

Page 16: ...DEBUG Get or set debug level for IP over Satellite module Parameter 0 9 Select degree of output 0 min 9 max net sat compmode mode protocol list Get set compression mode Parameters mode global Compression is enabled for all routes perroute Compression can be enabled disabled per route disable Compression is disabled protocol list ip General IP packet compression net sat compstat Display compression...

Page 17: ... Display the RIP routing table for dynamic routes only Release R4 0 0 net rip start DEBUG Starts RIP task Release R4 0 0 net rip stop DEBUG Stops RIP task Release R4 0 0 net rip config update DEBUG Update the RIP configuration based on the internal parameter database Release R4 0 0 net rip config display Display the current RIP parameter set Release R4 0 0 ...

Page 18: ... metric value nopoison Use simple split horizon instead of poisonous RIP nosplithorizon Release R4 7 2 Disable split horizon Disable at HUB sat0 interface if RTs should learn other RT routes noinvalidate Release R4 7 2 Do not invalidate route on HUB set metric INFINITE when link to RT is DOWN This function is by default enabled applicable for HUB sat0 interface only RT switchover between two HUBs ...

Page 19: ...you want to use it os task delete tName tID DEBUG Delete a task USE WITH CAUTION The deleted task will not be back before modem is rebooted Parameter tName tID Task name or task ID can be found by using command os task list Task names are listed under the Name column ID s are listed under the TID column The numbers in the TID column is hexadecimal values so prefix the value by 0x if you want to us...

Page 20: ... 0 2 os system module DEBUG Displays module memory placement information os kernel ver Displays kernel version information os file chkdsk Use this command to scan the disk for errors This test will also tell you the number of files and folders currently in the file system free and used space in the file system etc Release R3 2 0 Example TSAT RT1 os file chkdsk flashdisk disk check in progress flas...

Page 21: ...AT entry size FAT16 of sectors per FAT copy 52 of FAT table copies 2 of hidden sectors 4 first cluster is in sector 120 Update last access date for open read close FALSE directory structure VFAT file name format 8 bit extended ASCII root dir start sector 105 of sectors per root 15 max of entries in root 240 FAT handler information allocation group size 2 clusters free space on volume 5 263 360 byt...

Page 22: ...AT 3000 Command Line Interpreter January 2013 Page 22 of 41 os int phy clear pend DEBUG Displays statistics for Ethernet PHY interrupts Parameter clear pend clear Erase all interrupt statistics pend Erase only pending statistics ...

Page 23: ...uding subfolders directory Display file contents in this directory file chdir directory Change file system directory Parameter directory New directory file delete file Delete a file from the file system USE WITH CAUTION Parameter file Path and file name from your current directory to the file you want to delete file rename oldName newName Change file name Parameters oldName Path and file name to r...

Page 24: ...fs stop Stop BOOTFS access file bootfs list List files in the BOOTFS file system file bootfs status Display extended BOOTFS information file bootfs store Store the BOOTFS file system to flash file bootfs format DEBUG Format the BOOTFS file system NB Erases all kernel files System will not boot beyond System Manager without kernel file ...

Page 25: ...el file system to the BOOTFS file system Parameters file Path and name for the file to copy BOOTFS file Name of the copied file file bootfs delete file DEBUG Delete a file from the BOOTFS file system USE WITH CAUTION Parameter file Name of the file to delete file bootfs attr BOOTFS file ceBb Set file attributes Parameters BOOTFS file File name ceBb Attributes c compress e executable B boot b boot ...

Page 26: ...nd Line Interpreter January 2013 Page 26 of 41 3 6 Parameter database db db list List database contents db status Display status of database db debug 0 9 DEBUG Get set debug level for database Parameter 0 9 Select degree of output 0 min 9 max ...

Page 27: ...info Displays version build time and date for all software and firmware modules in the TSAT3000 modem Example Registered SW FW modules 1 Module Name Version Build Time Date KERNEL 2 0 4 480 14 08 09 Feb 11 2008 sw sysman upgrade file name DEBUG Manually upgrade the System Manager software required to boot up the modem Release R2 1 2 Parameter file name Name of System Manager file normally sysman s...

Page 28: ...ay log messages for the processor system Parameter no Number of messages to display log cpu loop Display log messages continuously Ctrl a to abort log dsp list no DEBUG Display log messages received from the DSP Parameter no Number of messages to display log dsp loop DEBUG Display log messages continuously Ctrl a to abort ...

Page 29: ...Display status for the RF system A BUC voltage current and power consumption B LNB voltage current and power consumption C TX L band output level calibration value s Release 4 4 0 One calibration value TXLevelCal Release 4 4 1 Four calibration values TXLevelCal_ freq _ dBm D RX L band input level calibration value ...

Page 30: ...demstate log sys dsp load dev file verbose DEBUG Load and execute a DSP program Parameters dev 0 DSP A 1 DSP B file Path and file name verbose Displays additional information when verbose is added sys dsp reset dev DEBUG Reset a DSP Parameter dev 0 DSP A 1 DSP B 3 10 2 Date Time sys time hh mm ss Display or set system time Parameter hh mm ss Set hour minute and seconds sys date dd mm yy Display or...

Page 31: ...bers 0 7 on the AD converter verbose Set debug output ON Example Get all 8 channels on the AD Converter represented as voltages CLI sys adc get 8 volt 0 1 2 3 4 5 6 7 0 1483 0 3204 1 2347 0 0665 0 5145 0 5518 0 3650 0 0458 CLI sys adc status Display LNB and BUC current power usage sys dac set dev channel value powerdown latchdac DEBUG Set Digital to Analog Converter values Parameters dev Device nu...

Page 32: ...meters dev Device number 0 3 TX synths are 0 1 RX synths are 2 3 reg Register number 0 8 sys synth default DEBUG Set default configuration to all synths sys synth range dev synth type rfx extend decimal DEBUG Display TX RX synth frequency range Parameters dev Device number 0 3 TX synths are 0 1 RX synths are 2 3 synth type rfx Choose rf1 or rf2 extend Display extended statistics decimal Display th...

Page 33: ... DAC Word 3 10 7 Receive RX and transmit TX Level Control sys rf rx level adjust Displays current RX level in dBm If adjust is used the RX signal level will be adjusted to match 1 1V out and the necessary DAC word is returned The adjust option is used by TSAT AS during preconfiguration and the DAC word is added to the configuration file hw conf under the ModemConfig section Parameter adjust Factor...

Page 34: ...ys rf tx cal 5 and sys rf tx cal 25 at specific frequency 2 Measure both TX levels on SA add cable loss and include the measured values in hw conf Set 1450 calibration values equal the 950 calibration values Release R4 4 1 Parameter value New TX level in dBm sys rf tx calibrate 950 5 950 25 1450 5 1450 25 Apply new TX level calibration values as measured in command above or just display the curren...

Page 35: ...nal on off sys rx ref on off sys tx ref on off sys rx power on off sys tx power on off sys tx reset on off DEBUG Displays or sets the signal reference power enable to on or off Parameter on off on Enables the output for RX TX chain off Disables the output for RX TX chain sys rx status sys tx status Displays current signal reference power enable settings ...

Page 36: ...controls BUC state sys buc status Display information about the BUC sys buc ptest avgCount vlimit climit boe volt curr DEBUG Factory test command 3 10 10 Low Noise Block LNB Control sys lnb state Override the current setting and force the LNB power ON or OFF Parameter state on Turns LNB power ON off Turns LNB power OFF auto Override disable System controls LNB state sys lnb status Display informat...

Page 37: ...Path Control sys bootpath get DEBUG Displays current bootpath if any sys bootpath set path DEBUG Override default boot path with new path Modem will use path during next reboot Parameter path Path from flashdisk root path to bin and exec directories to boot from sys bootpath clear DEBUG Remove override path ...

Page 38: ... state params DEBUG Sets modem in a specified state Parameters state Valid states normal on off altcw cw mod params Parameter list specify all txFreqInMHz symbolRate rolloff debug sys boardinfo DEBUG Lists board information stored in board EEPROMs Release R2 1 4 R3 0 0 R3 5 0 sys boardinfo assembly DEBUG Lists board information stored in board EEPROMs Release R2 2 0 R2 x x R3 6 0 sys boardinfo sta...

Page 39: ... ifconfig ifName state R3 1 0 3 3 3 net ping host numPackets options w ms l size n count 3 3 3 net arp flush 3 3 3 net host 3 3 3 net ipstat R1 0 0 R2 x x 3 3 3 net inetstat 3 3 3 net poolstat 3 3 3 net ethconfig ifName autoneg on off speed 100 10 duplex full half debug 3 3 3 net ip forward state R3 x x 3 3 3 net ip icmp redirect param value interface name R3 x x 3 3 4 net sat config 3 3 4 net sat...

Page 40: ...ache info debug R4 0 0 3 4 os int phy clear pend 3 5 file ls r directory 3 5 file chdir directory 3 5 file delete file 3 5 file rename oldName newName 3 5 file bootfs start 3 5 file bootfs stop 3 5 file bootfs list 3 5 file bootfs status 3 5 file bootfs store 3 5 file bootfs format 3 5 file bootfs get BOOTFS file file 3 5 file bootfs put file BOOTFS file 3 5 file bootfs delete file 3 5 file bootfs...

Page 41: ...t 3 10 7 sys rf tx level value 3 10 7 sys rf tx level cal value R4 4 1 3 10 7 sys rf tx calibrate 950 5 950 25 1450 5 1450 25 R4 4 1 3 10 8 sys rx signal on off 3 10 8 sys rx ref on off 3 10 8 sys rx power on off 3 10 8 sys rx status 3 10 8 sys tx signal on off 3 10 8 sys tx ref on off 3 10 8 sys tx power on off 3 10 8 sys tx reset on off 3 10 8 sys tx status 3 10 9 sys buc state 3 10 9 sys buc st...

Reviews: