NAME
Samsung-MDC - Samsung Multiple Display Control Protocol
SYNOPSIS
samsung-mdc [OPTIONS] TARGET COMMAND [ARGS]...
Try 'samsung-mdc --help COMMAND' for help on individual commands.
TARGET may be:
- •
-
DISPLAY_ID@IP[:PORT]
(default port: 1515, example: [email protected]:1515)
- •
-
FILENAME with target list, separated by newline.
Commands run asynchronously, so the order of results may differ when working with multiple targets.
To connect via serial port, use:
- •
-
DISPLAY_ID@PORT_NAME for Windows (example: 1@COM1)
- •
-
DISPLAY_ID@PORT_PATH for Linux (example: 1@/dev/ttyUSB0).
Samsung-MDC tries to determine the connection mode from the port name, but you may want to specify the mode using --mode.
DESCRIPTION
Samsung-MDC is an implementation of the Samsung Multiple Display Control Protocol using python and asyncio.
Samsung-MDC allows users to control compatible Samsung displays through the built-in RS-232C or Ethernet interface.
Command-line options
- --version
-
Show program version and exit.
- -v, --verbose
-
Enable verbose output.
- -m, --mode [auto|tcp|serial]
-
Connection mode (default: auto)
- -p, --pin INTEGER
-
4-digit PIN for secure TLS connection. If a PIN is provided, "Secured Protocol" must be enabled on the remote device.
- -t, --timeout FLOAT
-
Read/Write/Connect timeout in seconds (default: 5).
Connect can be overridden with a separate option.
- --connect-timeout FLOAT
-
Connect timeout in seconds.
- -h, --help
-
Show this message and exit.
OPTIONS
- status
-
(POWER_STATE VOLUME MUTE_STATE INPUT_SOURCE_STATE PICTURE_ASPECT_STATE N_TIME_NF F_TIME_NF)
- video
-
(CONTRAST BRIGHTNESS SHARPNESS COLOR TINT COLOR_TONE_STATE COLOR_TEMPERATURE _IGNORE)
- rgb
-
(CONTRAST BRIGHTNESS COLOR_TONE_STATE COLOR_TEMPERATURE _IGNORE RED_GAIN GREEN_GAIN BLUE_GAIN)
- serial_number
-
(SERIAL_NUMBER)
- error_status
-
(LAMP_ERROR_STATE TEMPERATURE_ERROR_STATE BRIGHTNESS_SENSOR_ERROR_STATE INPUT_SOURCE_ERROR_STATE TEMPERATURE FAN_ERROR_STATE)
- software_version
-
(SOFTWARE_VERSION)
- model_number
-
(MODEL_SPECIES MODEL_CODE TV_SUPPORT)
- power
-
[POWER_STATE]
- volume
-
[VOLUME]
- mute
-
[MUTE_STATE]
- input_source
-
[INPUT_SOURCE_STATE]
- picture_aspect
-
[PICTURE_ASPECT_STATE]
- screen_mode
-
[SCREEN_MODE_STATE]
- screen_size
-
(INCHES)
- network_configuration
-
[IP_ADDRESS SUBNET_MASK GATEWAY_ADDRESS DNS_SERVER_ADDRESS]
- network_mode
-
[NETWORK_MODE_STATE]
- network_ap_config
-
SSID PASSWORD
- weekly_restart
-
[WEEKDAY TIME]
- magicinfo_channel
-
CHANNEL_NUMBER
- magicinfo_server
-
[MAGICINFO_SERVER_URL]
- magicinfo_content_orientation
-
[ORIENTATION_MODE_STATE]
- mdc_connection
-
[MDC_CONNECTION_TYPE]
- contrast
-
[CONTRAST]
- brightness
-
[BRIGHTNESS]
- sharpness
-
[SHARPNESS]
- color
-
[COLOR]
- tint
-
[TINT]
- h_position
-
H_POSITION_MOVE_TO
- v_position
-
V_POSITION_MOVE_TO
- auto_power
-
[AUTO_POWER_STATE]
- clear_menu
- ir_state
-
[IR_STATE]
- rgb_contrast
-
[CONTRAST]
- rgb_brightness
-
[BRIGHTNESS]
- auto_adjustment_on
- color_tone
-
[COLOR_TONE_STATE]
- color_temperature
-
[HECTO_KELVIN]
- standby
-
[STANDBY_STATE]
- auto_lamp
-
[MAX_TIME MAX_LAMP_VALUE MIN_TIME MIN_LAMP_VALUE]
- manual_lamp
-
[LAMP_VALUE]
- inverse
-
[INVERSE_STATE]
- video_wall_mode
-
[VIDEO_WALL_MODE]
- safety_lock
-
[LOCK_STATE]
- panel_lock
-
[LOCK_STATE]
- channel_change
-
CHANGE_TO
- volume_change
-
CHANGE_TO
- ticker
-
[ON_OFF START_TIME END_TIME POS_HORIZ POS_VERTI MOTION_ON_OFF MOTION_DIR MOTION_SPEED FONT_SIZE FOREGROUND_COLOR BACKGROUND_COLOR FOREGROUND_OPACITY BACKGROUND_OPACITY MESSAGE]
- device_name
-
(DEVICE_NAME)
- osd
-
[OSD_ENABLED]
- picture_mode
-
[PICTURE_MODE_STATE]
- sound_mode
-
[SOUND_MODE_STATE]
- all_keys_lock
-
[LOCK_STATE]
- panel_on_time
-
(MIN10)
- video_wall_state
-
[VIDEO_WALL_STATE]
- video_wall_model
-
[MODEL SERIAL]
- model_name
-
(MODEL_NAME)
- energy_saving
-
[ENERGY_SAVING_STATE]
- reset
-
RESET_TARGET
- osd_type
-
[OSD_TYPE OSD_ENABLED]
- timer_13
-
TIMER_ID [ON_TIME ON_ENABLED OFF_TIME OFF_ENABLED REPEAT MANUAL_WEEKDAY VOLUME INPUT_SOURCE_STATE HOLIDAY_APPLY]
- timer_15
-
TIMER_ID [ON_TIME ON_ENABLED OFF_TIME OFF_ENABLED ON_REPEAT ON_MANUAL_WEEKDAY OFF_REPEAT OFF_MANUAL_WEEKDAY VOLUME INPUT_SOURCE_STATE HOLIDAY_APPLY]
- clock_m
-
[DATETIME]
- holiday_set
-
HOLIDAY_MANAGE START_MONTH START_DAY END_MONTH END_DAY
- holiday_get
-
[INDEX]
- virtual_remote
-
KEY_CODE
- network_standby
-
[NETWORK_STANDBY_STATE]
- dst
-
[DST_STATE START_MONTH START_WEEK START_WEEKDAY START_TIME END_MONTH END_WEEK END_WEEKDAY END_TIME OFFSET]
- auto_id_setting
-
[AUTO_ID_SETTING_STATE]
- display_id
-
DISPLAY_ID_STATE
- clock_s
-
[DATETIME]
- launcher_play_via
-
[PLAY_VIA_MODE]
- launcher_url_address
-
[URL_ADDRESS]
- osd_menu_orientation
-
[ORIENTATION_MODE_STATE]
- osd_source_content_orientation
-
[ORIENTATION_MODE_STATE]
- osd_aspect_ratio
-
[ASPECT_RATIO_STATE]
- osd_pip_orientation
-
[ORIENTATION_MODE_STATE]
- osd_menu_size
-
[MENU_SIZE_STATE]
- auto_source_switch
-
[AUTO_SOURCE_SWITCH_STATE]
- auto_source
-
[PRIMARY_SOURCE_RECOVERY PRIMARY_SOURCE SECONDARY_SOURCE]
- panel
-
[PANEL_STATE]
- screen_mute
-
[SCREEN_MUTE_STATUS]
- script
-
[OPTIONS] SCRIPT_FILE
- raw
-
[OPTIONS] COMMAND [DATA]
REPORTING BUGS
Samsung-MDC is maintained on GitHub. Please report all bugs to the issue tracker at https://github.com/vgavro/samsung-mdc/issues