SDK Documentation?

mikeinwi

Hello,

Do you have any more documentation for the SDK? In particular the ASISetControlValue() function has several options for the control type - what are the ranges of valid values for each of these control types? If no value is set what default value does the camera use?

Thanks.

chad

HI，

I think we may not have the one you need now. And we will try to add it in the future.

For your question:

You can use ASIGetNumOfControls to get the number of control types supported by the camera.

Create an array of type ASI_CONTROL_CAPS in this number.

The name of the control type/name supported by each camera and the maximum and minimum values are then obtained by using ASIGetControlCaps.

Also you can get the default value.

Thanks

Chad

mikeinwi

Thanks!

That was easy enough to do. I wrote a c-program that dumps out the information.

One thing I noticed - if I first run another program that configures the camera (WB_R=55, WB_B=90, EXPOSURE=1234567) and does a snap shot (all based on the demo code) which completes successfully, then run my dump program the dump program reports correct current values (those set by the snap shot program) for WB_R and WB_B but not for EXPOSURE - the dump program reports 100000

control: Exposure, type 1 writeable: yes auto supported: yes minimum value: 32 maximum value: 2000000000 default value: 10000 current value: 100000 (auto enabled: no) description: Exposure Time(us) control: WB_R, type 3 writeable: yes auto supported: yes minimum value: 1 maximum value: 99 default value: 52 current value: 55 (auto enabled: no) description: White balance: Red component control: WB_B, type 4 writeable: yes auto supported: yes minimum value: 1 maximum value: 99 default value: 95 current value: 90 (auto enabled: no)

description: White balance: Blue component

If however, I set the EXPOSURE in the dump program to 1234567, then reading back the EXPOSURE reports 1234567 as expected.

Any reason why the EXPOSURE control parameter is treated differently?

The dump program does call ASICameraInit(), but since that doesn't appear to change WB_R and WB_B settigns, I would not have expected ASICameraInit() to reset the EXPOSURE value. I've even tied not calling ASICameraInit() in the dump program, but the results were the same.

#include <stdio.h>
#include <unistd.h>
#include "include/ASICamera2.h"

const char* bayer = {"RG","BG","GR","GB"};

int  main() {

    int numCams;
    int camNum;
    ASI_CAMERA_INFO ASICameraInfo;

    int numCtrls = 0;
    int ctrlNum;
    ASI_CONTROL_CAPS ControlCaps;

    ASI_BOOL bAuto = ASI_FALSE;
    long int value;

    if ((numCams = ASIGetNumOfConnectedCameras()) <= 0) {
        printf("no cameras connected\n");
        return -1;
    }

    for(camNum = 0; camNum < numCams; camNum++) {

        ASIGetCameraProperty(&ASICameraInfo, camNum);
        printf("%d %s\n",camNum, ASICameraInfo.Name);

        if(ASIOpenCamera(camNum) != ASI_SUCCESS) {
            printf("OpenCamera error,are you root?\n");
            continue;
        }

        ASIInitCamera(camNum);

        printf("%s information\n",ASICameraInfo.Name);

        printf("\tresolution: %ld x %ld\n", ASICameraInfo.MaxWidth, ASICameraInfo.MaxHeight);
        if(ASICameraInfo.IsColorCam)
            printf("\ttype: color (bayer pattern:%s)\n",bayer);
        else
            printf("\ttype: mono\n");

        ASIGetNumOfControls(camNum, &numCtrls);

        for( ctrlNum = 0; ctrlNum < numCtrls; ctrlNum++)
        {
            ASIGetControlCaps(camNum, ctrlNum, &ControlCaps);
            printf("\tcontrol: %s, type %d\n", ControlCaps.Name, ControlCaps.ControlType);
            printf("\t\twriteable: %s\n", (ControlCaps.IsWritable) ? "yes" : "no");
            printf("\t\tauto supported: %s\n", (ControlCaps.IsAutoSupported) ? "yes" : "no");
            printf("\t\tminimum value: %ld\n", ControlCaps.MinValue);
            printf("\t\tmaximum value: %ld\n", ControlCaps.MaxValue);
            printf("\t\tdefault value: %ld\n", ControlCaps.DefaultValue);
            printf("\t\tcurrent value: ");

            if (ASIGetControlValue(camNum, ControlCaps.ControlType, &value, &bAuto) == ASI_SUCCESS)
                printf("%ld (auto enabled: %s)\n", value, (bAuto) ? "yes" : "no");
            else
                printf("error!\n");

            printf("\t\tdescription: %s\n", ControlCaps.Description);
        }

        ASICloseCamera(camNum);
    }

    return 1;
}

chad

Hi，

The reason is this.

If you open a camera, we will set the current exp time to 100000.

We found that if the camera was configured for a long exposure time during the initializing, it could cause the camera to crash. So we set a short exposure. Make sure the camera is properly initialized.

When you open the camera and take a picture with another program, and then dump it, your camera is reopened. So it was re-initialized, so the value you're reading is the initial value.

And you use dump to open the camera, set the exposure time, and then check it. You only initialize the camera once, and the exposure time set will override the initial value.

Thanks

Chad