CS100A

To import CS100A, you can either use:

from psychopy_minolta.minolta import CS100A

or, any time after psychopy.plugins.activatePlugins has been called:

from psychopy.hardware.minolta import CS100A
class psychopy_minolta.minolta.CS100A(port, maxAttempts=1)[source]

A class to define a Minolta CS100A photometer

You need to connect a CS100A to the serial (RS232) port and when you turn it on press the F key on the device. This will put it into the correct mode to communicate with the serial port.

usage:

from psychopy.hardware import minolta
phot = minolta.CS100A(port)
if phot.OK:  # then we successfully made a connection
    print(phot.getLum())
Parameters:

port: string

the serial port that should be checked

maxAttempts: int

If the device doesn’t respond first time how many attempts should be made? If you’re certain that this is the correct port and the device is on and correctly configured then this could be set high. If not then set this low.

Troubleshooting:

Various messages are printed to the log regarding the function of this device, but to see them you need to set the printing of the log to the correct level:

from psychopy import logging
logging.console.setLevel(logging.ERROR)  # error messages only
logging.console.setLevel(logging.INFO)  # more info
logging.console.setLevel(logging.DEBUG)  # log all communications

If you’re using a keyspan adapter (at least on macOS) be aware that it needs a driver installed. Otherwise no ports will be found.

Error messages:

ERROR: Couldn't connect to Minolta CS100A on ____:

This likely means that the device is not connected to that port (although the port has been found and opened). Check that the device has the [ in the bottom right of the display; if not turn off and on again holding the F key.

ERROR: No reply from CS100A:

The port was found, the connection was made and an initial command worked, but then the device stopped communating. If the first measurement taken with the device after connecting does not yield a reasonable intensity the device can sulk (not a technical term!). The “[” on the display will disappear and you can no longer communicate with the device. Turn it off and on again (with F depressed) and use a reasonably bright screen for your first measurement. Subsequent measurements can be dark (or we really would be in trouble!!).

checkOK(msg)[source]

Check that the message from the photometer is OK. If there’s an error show it (printed).

Then return True (OK) or False.

clearMemory()[source]

Clear the memory of the device from previous measurements

driverFor = ['cs100a']
getLum()[source]

Makes a measurement and returns the luminance value

get_xyY()[source]
longName = 'Minolta CS100A'
measure()[source]

Measure the current luminance and set .lastLum to this value

sendMessage(message, timeout=5.0)[source]

Send a command to the photometer and wait an allotted timeout for a response.

The message can be in either bytes or unicode but the returned string will always be utf-encoded.

setMaxAttempts(maxAttempts)[source]

Changes the number of attempts to send a message and read the output. Typically this should be low initially, if you aren’t sure that the device is setup correctly but then, after the first successful reading, set it higher.

setMode(mode='04')[source]

Set the mode for measurements. Returns True (success) or False

‘04’ means absolute measurements. ‘08’ = peak ‘09’ = cont

See user manual for other modes


Back to top