PyPI 官网下载 | python-samsung-mdc-1.6.4.tar.gz

# Samsung-MDC This is implementation of Samsung MDC (Multiple Display Control) protocol on **python3.7+** and **asyncio** with most comprehensive CLI (command line interface). It allows you to control a variety of different sources (TV, Monitor) through the built-in RS-232C or Ethernet interface. [MDC Protocol specification - v15.0 2020-11-06](https://vgavro.github.io/samsung-mdc/MDC-Protocol.pdf) * Implemented *65* commands * Easy to extend using simple declarative API - see [samsung_mdc/commands.py](https://github.com/vgavro/samsung-mdc/blob/master/samsung_mdc/commands.py) * Detailed [CLI](#usage) help and parameters validation * Run commands async on numerous targets (using asyncio) * TCP and SERIAL mode (for RJ45 and RS232C connection types) * TCP over TLS mode ("Secured Protocol" using PIN) * [script](#script) command for advanced usage * [Python example](#python-example) Not implemented: some more commands (PRs are welcome) Also see: [Samsung MDC Unified](http://www.samsung-mcloud.com/02_Software/04_Tools/MDC/v1235/) - Reference Application (GUI, Windows) with partially implemented functionality. ## Install<a id="install"></a> ``` # global install/upgrade sudo pip3 install --upgrade python-samsung-mdc samsung-mdc --help # local git clone https://github.com/vgavro/samsung-mdc cd ./samsung-mdc python3 -m venv venv ./venv/bin/pip3 install -e ./ ./venv/bin/samsung-mdc --help ``` ### Windows install<a id="windows-install"></a> 1. Install Git && Git Bash: https://git-scm.com/download/win 2. Install Python 3 latest release (tested with 3.9): https://www.python.org/downloads/windows/ 3. Run "Git Bash", type in console: ``` pip3 install --upgrade python-samsung-mdc # NOTE: python "Scripts" folder is not in %PATH% in Windows by default, # so you may want to create alias for Git Bash echo alias samsung-mdc=\'python3 -m samsung_mdc\' >> ~/.bash_profile source ~/.bash_profile # test it samsung-mdc --help ``` ## Usage<a id="usage"></a> ``` Usage: samsung-mdc [OPTIONS] TARGET COMMAND [ARGS]... Try 'samsung-mdc --help COMMAND' for command info For multiple targets commands will be running async, so result order may differ. TARGET may be: DISPLAY_ID@IP[:PORT] (default port: 1515, example: 0@192.168.0.10:1515) FILENAME with target list (separated by newline) For serial port connection: DISPLAY_ID@PORT_NAME for Windows (example: 1@COM1) DISPLAY_ID@PORT_PATH (example: 1@/dev/ttyUSB0) We're trying to make autodetection of connection mode by port name, but you may want to use --mode option. Options: --version Show the version and exit. -v, --verbose -m, --mode [auto|tcp|serial] default: auto -p, --pin INTEGER 4-digit PIN for secured TLS connection. If PIN provided, "Secured Protocol" must be enabled on remote device. -t, --timeout FLOAT read/write/connect timeout in seconds (default: 5) (connect can be overridden with separate option) --connect-timeout FLOAT -h, --help Show this message and exit. ``` ### Commands: * [status](#status) `(POWER_STATE VOLUME MUTE_STATE INPUT_SOURCE_STATE PICTURE_ASPECT_STATE N_TIME_NF F_TIME_NF)` * [video](#video) `(CONTRAST BRIGHTNESS SHARPNESS COLOR TINT COLOR_TONE_STATE COLOR_TEMPERATURE _IGNORE)` * [rgb](#rgb) `(CONTRAST BRIGHTNESS COLOR_TONE_STATE COLOR_TEMPERATURE _IGNORE RED_GAIN GREEN_GAIN BLUE_GAIN)` * [serial_number](#serial_number) `(SERIAL_NUMBER)` * [error_status](#error_status) `(LAMP_ERROR_STATE TEMPERATURE_ERROR_STATE BRIGHTNESS_SENSOR_ERROR_STATE INPUT_SOURCE_ERROR_STATE TEMPERATURE FAN_ERROR_STATE)` * [software_version](#software_version) `(SOFTWARE_VERSION)` * [model_number](#model_number) `(MODEL_SPECIES MODEL_CODE TV_SUPPORT)` * [power](#power) `[POWER_STATE]` * [volume](#volume) `[VOLUME]` * [mute](#mute) `[MUTE_STATE]` * [input_source](#input_source) `[INPUT_SOURCE_STATE]` * [picture_aspect](#picture_aspect) `[PICTURE_ASPECT_STATE]` * [screen_mode](#screen_mode) `[SCREEN_MODE_STATE]` * [screen_size](#screen_size) `(INCHES)` * [network_configuration](#network_configuration) `[IP_ADDRESS SUBNET_MASK GATEWAY_ADDRESS DNS_SERVER_ADDRESS]` * [network_mode](#network_mode) `[NETWORK_MODE_STATE]` * [weekly_restart](#weekly_restart) `[WEEKDAY TIME]` * [magicinfo_server](#magicinfo_server) `[MAGICINFO_SERVER_URL]` * [mdc_connection](#mdc_connection) `[MDC_CONNECTION_TYPE]` * [contrast](#contrast) `[CONTRAST]` * [brightness](#brightness) `[BRIGHTNESS]` * [sharpness](#sharpness) `[SHARPNESS]` * [color](#color) `[COLOR]` * [tint](#tint) `[TINT]` * [h_position](#h_position) `H_POSITION_MOVE_TO` * [v_position](#v_position) `V_POSITION_MOVE_TO` * [auto_power](#auto_power) `[AUTO_POWER_STATE]` * [clear_menu](#clear_menu) * [ir_state](#ir_state) `[IR_STATE]` * [rgb_contrast](#rgb_contrast) `[CONTRAST]` * [rgb_brightness](#rgb_brightness) `[BRIGHTNESS]` * [auto_adjustment_on](#auto_adjustment_on) * [color_tone](#color_tone) `[COLOR_TONE_STATE]` * [color_temperature](#color_temperature) `[HECTO_KELVIN]` * [standby](#standby) `[STANDBY_STATE]` * [auto_lamp](#auto_lamp) `[MAX_TIME MAX_LAMP_VALUE MIN_TIME MIN_LAMP_VALUE]` * [manual_lamp](#manual_lamp) `[LAMP_VALUE]` * [inverse](#inverse) `[INVERSE_STATE]` * [safety_lock](#safety_lock) `[LOCK_STATE]` * [panel_lock](#panel_lock) `[LOCK_STATE]` * [channel_change](#channel_change) `CHANGE_TO` * [volume_change](#volume_change) `CHANGE_TO` * [device_name](#device_name) `(DEVICE_NAME)` * [osd](#osd) `[OSD_ENABLED]` * [all_keys_lock](#all_keys_lock) `[LOCK_STATE]` * [model_name](#model_name) `(MODEL_NAME)` * [energy_saving](#energy_saving) `[ENERGY_SAVING_STATE]` * [reset](#reset) `RESET_TARGET` * [osd_type](#osd_type) `[OSD_TYPE OSD_ENABLED]` * [timer_13](#timer_13) `TIMER_ID [ON_TIME ON_ENABLED OFF_TIME OFF_ENABLED REPEAT MANUAL_WEEKDAY VOLUME INPUT_SOURCE_STATE HOLIDAY_APPLY]` * [timer_15](#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](#clock_m) `[DATETIME]` * [virtual_remote](#virtual_remote) `KEY_CODE` * [network_standby](#network_standby) `[NETWORK_STANDBY_STATE]` * [dst](#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) `[AUTO_ID_SETTING_STATE]` * [display_id](#display_id) `DISPLAY_ID_STATE` * [clock_s](#clock_s) `[DATETIME]` * [launcher_play_via](#launcher_play_via) `[PLAY_VIA_MODE]` * [launcher_url_address](#launcher_url_address) `[URL_ADDRESS]` * [auto_source_switch](#auto_source_switch) `[AUTO_SOURCE_SWITCH_STATE]` * [auto_source](#auto_source) `[PRIMARY_SOURCE_RECOVERY PRIMARY_SOURCE SECONDARY_SOURCE]` * [panel](#panel) `[PANEL_STATE]` * [script](#script) `[OPTIONS] SCRIPT_FILE` * [raw](#raw) `[OPTIONS] COMMAND [DATA]` #### status<a id="status"></a> ``` Usage: samsung-mdc [OPTIONS] TARGET status Data: POWER_STATE OFF | ON | REBOOT VOLUME int (0-100) MUTE_STATE OFF | ON INPUT_SOURCE_STATE NONE | S_VIDEO | COMPONENT | AV | AV2 | SCART1 | DVI | PC | BNC | DVI_VIDEO | MAGIC_INFO | HDMI1 | HDMI1_PC | HDMI2 | HDMI2_PC | DISPLAY_PORT_1 | DISPLAY_PORT_2 | DISPLAY_PORT_3 | RF_TV | HDMI3 | HDMI3_PC | HDMI4 | HDMI4_PC | TV_DTV | PLUG_IN_MODE | HD_BASE_T | MEDIA_MAGIC_INFO_S | WIDI_SCREEN_MIRRORING | INTERNAL_USB | URL_LAUNCHER | IWB PICTURE_ASPECT_STATE PC_16_9 | PC_4_3 | PC_ORIGINAL_RATIO | PC_21_9 | VIDEO_AUTO_WIDE | VIDEO_16_9 | VIDEO_ZOOM | VIDEO_ZOOM_1 | VIDEO_ZOOM_2 | VIDEO_SCREEN_FIT | VIDEO_4_3 | VIDEO_WIDE_FIT | VIDEO_CUSTOM |