$  Copyright(c) 2000 Sun Microsystems, Inc.
$  All rights reserved.

$  #ident  @(#)fwcamtest.msg 1.9 09/04/02 Copyright (c) 2000 Sun MicroSystems Inc."


$ --------------------------------------------------
$ DEBUG:	0
$ --------------------------------------------------

$ --------------------------------------------------
$ VERBOSE:	1-1999
$ --------------------------------------------------

$ USAGE
1 "%s specific arguments [defaults]:\n\
    dev=<device name>           (ex: dev=/dev/dcam<N>)\n\
    dcamparam[=Enable|Disable]  (Dcam Parameter Test)\n\
    framercv[=Enable|Disable]   (Frame Receive Test)\n\
    display[=Enable|Disable]    (Display Test)\n\
    T[=30|<seconds>]    (Display period)\n"

$ V_OPTIONS_LIST
3 "fwcamtest:  called with options: %s"
$ BUS_FOUND
4 "1394 bus found at %s:devctl."
$ CALLBACK_FUNC
5 "Callback function %s invoked"
$ DCAM_PATH_VB
6 "/dev/dcam%s"
$ DCAMCTLR_PATH_VB
7 "/dev/dcamctl%s"
$ OPENFILE_VB
8 "Open file %s, File descriptor= %d"
$ VIDEOMODE1_EXP_ERR_VB
9 "%s expected error, occured while setting video mode."
$ RINGBUF_EXP_ERR_VB
10 "%s: expected error, occured while setting ring buffer capacity."
$ BRIGTHNESS_EXP_ERR_VB
11 "%s: unexpected error, occured while setting brightness value."
$ VIDEOMODE5_EXP_ERR_VB
12 "%s: expected error, set video mode to 5"
$ RINGBUF10_EXP_ERR_VB
13 "%s: expected error, set ring buffer capacity to 10"
$ BRIGTHNESS210_EXP_ERR_VB
14 "%s: expected error, set brightness to 210"
$ VIDEOMODE_TRACE_VB
15 "%s: video mode observed= 5, (expected= %d)"
$ RINGBUF_TRACE_VB
16 "%s: ring buffer capacity observed= %d (expected= %d)"
$ BRIGHTNESS_TRACE_VB
17 "%s: brightness value observed= %d, (expected= %d)"
$ STOP_RCVFRM_VB
18 "%s: Stopped receipt of frames"
$ RESET_CAM_VB
19 "Resetting camera..."
$ PARAM_SET_VB
20 "%s: Setting parameter..."
$ START_CAPFRM_VB
21 "%s: Setting frame capture..."
$ START_RCVFRM_VB
22 "%s: Start receiving frames..."
$ FRM_BUFFER_AT_VB
23 "frames buffer at  0x%lX"
$ FRM_TRACE_VB
24 "frame.vid_mode = %d, frame.seq_num = %d, frame.time_stamp = 0x%llX, frame.buff = 0x%lX"
$ BYTES_PREAD_VB
25 "play_video(): pread() read %d bytes; expected %d bytes"
$ ENV_DISPLAY_VB
26 "Environment DISPLAY = %s"

$ --------------------------------------------------
$ INFO:		2000 - 3999
$ --------------------------------------------------

$ START_RCVFRM_FAIL_INFO
2000 "Error occurred: unable to start receipt of frames"
$ STOP_RCVFRM_FAIL_INFO
2001 "Error occurred: unable to stop receipt of frames"

$ --------------------------------------------------
$ WARNING:	4000 - 5999
$ --------------------------------------------------


$ NOCAMINST
4000 "No camera [0 ... n] specified"
$ VIDEOMODE1_WARNING
4001 "%s: unexpected: set video mode to 1"
$ RINGBUFCAP_TO_5_WARNING
4002 "%s: unexpected:  set ring buffer capacity to 5"
$ BRIGHNESS_100_WARNING
4003 "%s: expected:  set brightness to 100"
$ VIDEOMODE5_WARNING
4004 "%s: unexpected error occured while setting video mode to 5"
$ RINGBUFCAP_TO_10_WARNING
4005 "%s: unexpected error occured while setting ring buffer capacity to 10"
$ BRIGHNESS_210_WARNING
4006 "%s: unexpected error occured while setting brightness value to 210"
$ DISPLAY_WARNING
4007 "Attempt to display on remote hosts (%s)"
$ LOCAL_DISPLAY_WARNING
4008 "Set display on local hosts (%s)"
$ CANT_FIND_RGB_WARNING
4009 "No matching XVisualInfo reported. Cannot determine RGB mask"
$ FRAME_RCV_START_RETRY_WARNING
4010 "frame_rcv_start returns ENXIO retry%d out of max %d in %d sec"
$ FRAME_RCV_STOP_RETRY_WARNING
4011 "frame_rcv_stop returns ENXIO retry%d out of max %d in %d sec"


$ --------------------------------------------------
$ ERROR:	6000 - 7999
$ --------------------------------------------------

$ NO_BUS_FOUND
6000 "No 1394 bus found on the system."

$ DEV_OUT_OF_RANGE
6001 "No device detected for fw%d."

$ BAD_ARGS
6002 "Error parsing command line options." \
Probable_Cause(s): <Wrong cmnd line arguments> <system software> \
Recommended_Actions: <Check and re-enter command line> \
<if the problem persists, contact authorized Sun service provider>

$ SYSTEM_CHANGED
6003 "Can not associate physical device with %s." \
Probable_Cause(s): <Hardware changed since VTS probe> \
<Wrong cmnd line arguments> <system software> \
Recommended_Actions: <Stop all testing and re-probe> \
<Check and re-enter command line> \
<if the problem persists, contact authorized Sun service provider>

$ NO_CAMERA_FOUND
6004 "No 1394 camera found on this system." \
Probable_Cause(s): <Hardware changed since VTS probe> \
<Wrong cmnd line arguments> <system software> \
Recommended_Actions: <Stop all testing and re-probe> \
<Check and re-enter command line> \
<if the problem persists, contact authorized Sun service provider>

$ SELFID_TOO_BIG
6005 "selfidcount too big."

$ CLOSE_UNABLE
6006 "unable to close '%s'"

$ TIME_OUT_RNG
6007 "User specified time %i for camera is out of range" \
Probable_Cause(s): <Wrong cmnd line arguments> <system software> \
Recommended_Actions: <Check and re-enter command line> \
<if the problem persists, contact authorized Sun service provider>

$ OPEN_ERROR
6008 "%s : Can't open %s; error is %s"

$ IOCTL_ERROR
6009 "%s : ioctl %s failed; error is %s"

$ NO_VIDEOMODE_ERROR
6010 "%s: no video mode, not set"
$ VIDEOMODE5_MISCOMPARED
6011 "%s: video mode observed= %d (expected= %d)"
$ NO_RINGBUF_ERROR
6012 "%s: buffer capacity not set"
$ RINGBUF_MISCOMPARED
6013 "%s: ring buffer capacity observed= %d (expected= %d)"
$ BRIGHTNESS_GET_ERROR
6014 "%s: error occured while getting brightness value"
$ BRIGHTNESS_MISCOMPARED
6015 "%s: brightness value observed= %d (expected= %d)"
$ VIDEOMODE_SET_ERROR
6016 "%s: error occured while setting video mode"
$ FRAMERATE_SET_ERROR
6017 "%s: error occured while setting frame rate"
$ RINGBUFCAP_SET_ERROR
6018 "%s: error occured while setting ring buff capacity"
$ PREAD_ERROR
6019 "%s: pread failed, %s"

$ --------------------------------------------------
$ FATAL:	8000 - 9998
$ --------------------------------------------------
 
$ ER_DEVICE_OPEN
8000 "Unable to open device %s : <%s>" \
Probable_Cause(s): \
<Device name is wrong or driver is not loaded.> \
<Device Busy> \
Recommended_Action(s): \
<Check device name if entered or load driver.> \
<Kill all other processes accessing driver.>

$ BAD_DEVICE_NAME
8001 "Bad device name passed to test: %s" \
Probable_Cause(s): <Wrong entry on command line> \
Recommended_Actions: <Check and retype command line>

$ NO_INSTANCE_FILE
8002 "Open of /etc/path_to_inst file Failed; %s." \
Probable_Cause(s): <system software> \
Recommended_Actions: <Contact your system admin for assistance> \
<if the problem persists, contact authorized Sun service provider>

$ NO_ASSOCIATION
8003 "Cannot associate a 1394 device with %s."

$ CAM_NO_RESPOND
8004 "Camera not responding." \
Probable_Cause(s): \
<Driver is not loaded.> \
<Device Busy> \
Recommended_Action(s): \
<Check to see if driver is loaded.> \
<Kill all other processes accessing driver.>

$ VIDEO_INIT_FAIL
8005 "fwcc_video_init() failed." \
Probable_Cause(s): \
<Camera is broken.> \
<Device Busy> \
Recommended_Action(s): \
<Check to see if driver is loaded.> \
<Kill all other processes accessing driver.>

$ THREAD_FAIL
8006 "Couldn't create thread - %d" \
ProbableCause(s): \
<System software error.> \
Recommended_Action(s): 

$ VIDEO_STOP_FAIL
8007 "fwcc_video_stop() failed" \
ProbableCause(s): \
<System software error.> \
Recommended_Action(s): 

$ VIDEO_FINI_FAIL
8008 "fwcc_video_fini() failed." \
ProbableCause(s): \
<System software error.> \
Recommended_Action(s): 

$ CLOSE_FAIL
8009 "Unable to close '%s'" \
ProbableCause(s): \
<System software error.> \
Recommended_Action(s): 

$ GET_FRAME_FAIL
8010 "fwcc_get_frame_size() failed." \
ProbableCause(s): \
<System software error.> \
Recommended_Action(s): 

$ ER_READ_REG
8011 "read_reg() failed." \
Probable_Cause(s): \
<Register bad> \
<Bad Address> \
Recommended_Action(s): \
<Check the address used in the read>

$ ER_READ_PCI
8012 "read_pci() failed." \
Probable_Cause(s): \
<Register bad> \
<Bad Address> \
Recommended_Action(s): \
<Check the address used in the read>

$ ER_BUSRESET_CNT
8013 "busreset_cnt() failed." \
Probable_Cause(s): \
<Bus not responding> \
Recommended_Action(s): \
<Restart test> \
<Reinitialize driver>

$ ER_SELFID_CNT
8014 "selfid_cnt() failed." \
Probable_Cause(s): \
<Bus not responding> \
Recommended_Action(s): \
<Restart test> \
<Reinitialize driver>

$ ER_BUSRESET
8015 "reset_bus() failed." \
Probable_Cause(s): \
<Bus not responding> \
Recommended_Action(s): \
<Restart test> \
<Reinitialize driver>

$ ER_WRITE_REG
8016 "write_reg() failed." \
Probable_Cause(s): \
<Register bad> \
<Bad Address> \
Recommended_Action(s): \
<Check the address used in the write>

$ ER_READ_PHY
8017 "read_phy() failed." \
Probable_Cause(s): \
<Bad Address> \
Recommended_Action(s): \
<Check the address used in the read>

$ WRITE_PHY
8018 "write_phy() failed." \
Probable_Cause(s): \
<Bad Address> \
Recommended_Action(s): \
<Check the address used in the write>

$ ER_SELFID_BUF
8019 "selfid_buf() failed." \
Probable_Cause(s): \
<Bus not responding> \
Recommended_Action(s): \
<Restart test> \
<Reinitialize driver>

$ ER_BUSRESET_CNT_NGREATER
8020 "busreset_cnt not incremented." \
Probable_Cause(s): \
<Bus not responding> \
Recommended_Action(s): \
<Restart test> \
<Reinitialize driver>

$ ER_SELFID_CNT_NGREATER
8021 "selfid_cnt not incremented." \
Probable_Cause(s): \
<Bus not responding> \
Recommended_Action(s): \
<Restart test> \
<Reinitialize driver>

$ ER_BUSGEN_CNT_NGREATER
8022 "busgen_cnt not incremented." \
Probable_Cause(s): \
<Bus not responding> \
Recommended_Action(s): \
<Restart test> \
<Reinitialize driver>

$ ER_BUSGEN_CNT
8023 "busgen_cnt() failed." \
Probable_Cause(s): \
<Bus not responding> \
Recommended_Action(s): \
<Restart test> \
<Reinitialize driver>

$ ER_BAD_OPTIONS
8025 "Illegal options passed to fwcamtest %s." \
Probable_Cause(s): \
<User error.> \
Recommended_Action(s): \
< Check usage by typing fwcamtest -u>

$ MALLOC_FAIL
8026 "malloc failed." \
ProbableCause(s): \
<System software error.> \
<System out of memory> \
Recommended_Action(s): 

$ YUV_INIT_FAIL
8027 "yuv_init failed." \
ProbableCause(s): <CDE/Openwin not in 24bit depth> \
<System software error.> \
Recommended_Action(s): <Run window system in 24bit depth>
 

$ ER_INIT_CAM_INFO
8028 "cam_info.initialized failed." \
ProbableCause(s): \
<System software error.> \
Recommended_Action(s): 

$ MALLOC_FATAL
8030 ""%s: malloc() failed."\
ProbableCause(s): \
<Out of Memory.> \
<System software error.> \
Recommended_Action(s):\
<Contact sunvts support>

$ ER_SYSINFO_HOSTNAME
8031 "Can't get sysinfo hostname"\
ProbableCause(s): \
<System software error.> \
Recommended_Action(s):\
<Contact sunvts support>

$ ER_PUTENV
8031 "Can't set DISPLAY env variable"\
ProbableCause(s): \
<System software error.> \
Recommended_Action(s):\
<Contact sunvts support>
