|
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjcontrol.system.Management
public class Management
Controls JControls system management functions.
This class provides some system properties, some are not present on some boards:
Key | Description of Associated Value | Provider |
---|---|---|
rs232.baudrate (int) | RS232 baudrate | RS232.setBaudrate(int) |
rs232.params (int) | RS232 parameters | RS232.setParams(int) |
io.adcchannels (r/o) | # of useable ADC channels | ADC |
display.contrast (int) | display contrast | Display |
display.dimensions (r/o) | display dimensions (pixels) | Display |
flash.format (r/o) | organisation of flash memory | Flash |
buzzer.keyboardbeep (boolean) | turns buzzer on for keyboard press | Keyboard |
io.gpiochannels (r/o) | # of useable portpins | GPIO |
io.pwmchannels (r/o) | # of useable PWM channels | PWM |
profile.name (r/o) | JControl board type | Management |
profile.date (r/o) | the build date of the JControl VM | Management |
buzzer.enable (boolean) | turns buzzer on for some actions | Management |
buzzer.systembeep (boolean) | turns buzzer on for some actions | Management |
system.standbytimer (int) | time for automatic turn off (seconds) | Management |
system.userbank (int) | flash bank to launch application | Management |
system.heapsize (r/o) | available memory for java | Management |
rtc.poweronbank (int) | flash bank to launch on alarm | RTC |
all |
Constructor Summary | |
---|---|
Management()
|
Method Summary | |
---|---|
static void |
arraycopy(Object src,
int srcPos,
Object dest,
int destPos,
int length)
Copies an array from the specified source array, beginning at the specified position, to the specified position of the destination array. |
static short |
currentTimeMillis()
Returns the current value of the virtual machines millisecond counter. |
static void |
gc()
Waits for completion of garbage collecton. |
static int |
getPowerStatus()
Get power (battery) status. |
static String |
getProperty(String key)
Returns the value of a JControl system property. |
static void |
halt()
Just stops the processor. |
static String |
nextKey(String previousKey)
Enumerates the system properties. |
static void |
powerOff()
Turn RTC equipped JControl modules off. |
static void |
powerOff(int time)
Turn RTC equipped JControl modules off. |
static void |
reboot(boolean reset)
Reboots the virtual machine. |
static void |
saveProperties()
Saves some properties to the persistent storage. |
static void |
setClassPersistence(boolean keep)
Marks the calling class not to be removed from the garbage collector. |
static void |
setLock(Object obj,
boolean lock)
Locks or unlocks an object in memory. |
static boolean |
setProperty(String key,
String value)
Sets the JControl system Property to the specified value. |
static void |
start(String clss,
String[] args,
boolean asThread)
Starts a Java application. |
static void |
switchBank()
Switches the flash bank to the bank specified by property . |
Methods inherited from class java.lang.Object |
---|
clone, equals, notifyAll, wait |
Constructor Detail |
---|
public Management()
Method Detail |
---|
public static void arraycopy(Object src, int srcPos, Object dest, int destPos, int length)
src
to the destination array
referenced by dest
. The number of components copied is
equal to the length
argument. The components at
positions srcPos
through
srcPos+length-1
in the source array are copied into
positions destPos
through
destPos+length-1
, respectively, of the destination
array.
If the src
and dest
arguments refer to the
same array object, then the copying is performed as if the
components at positions srcPos
through
srcPos+length-1
were first copied to a temporary
array with length
components and then the contents of
the temporary array were copied into positions
destPos
through destPos+length-1
of the
destination array.
If dest
is null
, then a
NullPointerException
is thrown.
If src
is null
, then a
NullPointerException
is thrown and the destination
array is not modified.
Otherwise, if any of the following is true, an
ArrayStoreException
is thrown and the destination is
not modified:
src
argument refers to an object that is not an
array.
dest
argument refers to an object that is not an
array.
src
argument and dest
argument refer
to arrays whose component types are different primitive types.
src
argument refers to an array with a primitive
component type and the dest
argument refers to an array
with a reference component type.
src
argument refers to an array with a reference
component type and the dest
argument refers to an array
with a primitive component type.
Otherwise, if any of the following is true, an
IndexOutOfBoundsException
is
thrown and the destination is not modified:
srcPos
argument is negative.
destPos
argument is negative.
length
argument is negative.
srcPos+length
is greater than
src.length
, the length of the source array.
destPos+length
is greater than
dest.length
, the length of the destination array.
Otherwise, if any actual component of the source array from
position srcPos
through
srcPos+length-1
cannot be converted to the component
type of the destination array by assignment conversion, an
ArrayStoreException
is thrown. In this case, let
k be the smallest nonnegative integer less than
length such that src[srcPos+
k]
cannot be converted to the component type of the destination
array; when the exception is thrown, source array components from
positions srcPos
through
srcPos+
k-1
will already have been copied to destination array positions
destPos
through
destPos+
k-1
and no other
positions of the destination array will have been modified.
(Because of the restrictions already itemized, this
paragraph effectively applies only to the situation where both
arrays have component types that are reference types.)
Arrays of type boolean[]
not supported.
src
- the source array.srcPos
- starting position in the source array.dest
- the destination array.destPos
- starting position in the destination data.length
- the number of array elements to be copied.
java.lang.IndexOutOfBoundsException
- if copying would cause
access of data outside array bounds.
UnsupportedArrayTypeException
- if an element in the src
array could not be stored into the dest
array
because of a type mismatch.
java.lang.NullPointerException
- if either src
or
dest
is null
.public static short currentTimeMillis()
public static void gc()
gc()
other threads may continue unaffected.
public static int getPowerStatus()
public static String getProperty(String key)
desciption
above.
key
- speciefies the property to get
null
if this property doesn't existpublic static void halt()
public static String nextKey(String previousKey)
previousKey
- some system property key, or null
previousKey
is null
,
the next key or null
if previousKey
is the last key in the list.public static void powerOff()
RTC
equipped JControl modules off. The module is shut down immediately.
public static void powerOff(int time)
RTC
equipped JControl modules off. If time
is set to a positive
value, the module is shut down after the specified time in seconds (use this method or
any keypress on the JControl module to reset this counter). Use time=0
to disable auto powering off.
time
- to delay powering offpublic static void reboot(boolean reset)
reset
- set to true
if a full reset has to be done, otherwise the VM is only restarted in the previously selected bankpublic static void saveProperties()
desciption
above.
setProperty(String, String)
public static void setClassPersistence(boolean keep)
keep
- true
sets the flag, false
removes itpublic static void setLock(Object obj, boolean lock)
Class
-, Thread
-
and String
-Objects cannot be locked.
obj
- the object to lock or unlocklock
- true
if the lock is to be set, false
to unsetpublic static boolean setProperty(String key, String value)
desciption
above.
key
- specifies the property to changevalue
- for the property to change to
true
if the property changed successfully,
false
if the property is read-only or the value is not validpublic static void start(String clss, String[] args, boolean asThread)
public static void main(String[] args)
-method of a class. The class
name could be determined at runtime. Class package names must be delemitered with '/'.
The method parameters are fixed to String[]
(like main(String[] args)
).
clss
- name of the the class to locateargs
- the args to be submitted to mainasThread
- set to true
to start the application in a new Thread
java.lang.NoClassDefFoundError
- if the class could not be found
java.lang.NoSuchMethodError
- if the method main(String[] args) isn't accessible in the classpublic static void switchBank()
system.userbank
.
Currently there are up to four banks supported (depends on hardware model), bank 0 is reserved for JControls
internal use the other banks are for user applications. After reset bank 0 is automatically selected
then JControl may switch to a user bank. If the current bank is already switched this
method returns normally otherwise the virtual machine is restarted in the new bank.
reboot(boolean)
|
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |