MCU

DPYMCUTOOL                                         Linux Programmer's Manual                                         DPYMCUTOOL

DESCRIPTION
	dpymcutool : Tool used to read and configure values of the Microcontroller Unit.

SYNOPSIS
	dpymcutool [-h/ --help]
	dpymcutool [-tv / --toolversion]
	dpymcutool [-i/ --info]
	dpymcutool [-gi/ --getinfo]
	dpymcutool [-sbpv/ --setbatprotectvalues] <idle_voltage> <voltage_percentage> <hysteresis_percentage> <grace_period>
	dpymcutool [-gbpv/ --getbatprotectvalues]
	dpymcutool [-u/ --update]
	dpymcutool [-sls/ --setledstatus] <color> <period> <duty_cycle>
	dpymcutool [-gls/ --getledstatus]
	dpymcutool [-sgv / --setgpiovalue] <gpio> <value>
	dpymcutool [-ggv / --getgpiovalue] <gpio>
	dpymcutool [-gge / --gpioevents]
	dpymcutool [-siv / --seti2cvalue] <bus> <chipaddr> <memoryaddr> [value]
	dpymcutool [-giv / --geti2cvalue] <bus> <chipaddr> <memoryaddr> <lenght>
	dpymcutool [-gt/ --gettimers]
	dpymcutool [-gg/ --getGUID]
	dpymcutool [-geq/ --getEqVar]
	dpymcutool [-gwt/ --getworktime]
	dpymcutool [-gms/ --getmcustatus]
	dpymcutool [-gd/ --getdate]
	dpymcutool [-gv/ --getversion] <rfs>
    dpymcutool [-gcs/ --canstatus]
    dpymcutool [-epb/ --enablepb]
    dpymcutool [-dpb/ --disablepb]
    dpymcutool [-gpb/ --getpb]

OPTIONS
	-h / --help : Print help command information.
	-tv / --toolversion : Print tool version.
	-i / --info : Subscribe to battery levels, ignition position, overvoltage/overcurrent values, firmware version, battery protection alert and temperature.
	-gi / --getinfo : Get battery levels, ignition position, overvoltage/overcurrent values, firmware version, battery protection alert and temperature.
	-sbpv / --setbatprotectvalues <idle_voltage> <voltage_percentage> <hysteresis_percentage> <grace_period> : Set configuration values to battery protection mode.
	Description:
		<idle_voltage> : idle voltage identified by ignition position off, engine off and stationary vehicle (range: 0 - 40)
		<voltage_percentage> : voltage percentage threshold calculated over idle voltage (range: 80 - 100)
		<hysteresis_percentage> : hysteresis percentage calculated over idle voltage (range: 0 - 100)
		<grace_period> : grace period in minutes used to enter in halt mode irrevocably (range: 1 - 10)
		NOTE: With these values a low and a high threshold will be used to detect battery protection according next formula:
		-- low_voltage_threshold = (idle_voltage * voltage_percentage / 100) - (idle_voltage * hysteresis_percentage / 100)
		-- high_voltage_threshold = (idle_voltage * voltage_percentage / 100) + (idle_voltage * hysteresis_percentage / 100)
	-gbpv / --getbatprotectvalues : Get configuration values of battery protection mode.
	-u / --update : Update MCU Firmware with a right mcu_app.zip located in /lib/firmware/deepsy/mcu/ directory.
	-sls / --setledstatus <color> <period> <duty_cycle> : Set LEDs state.	
	Description:
		<color> : Possible values are: 
			red, blue, green, magenta, yellow, cyan
		<period> : Value in seconds (range: 0 - 40)
		<duty_cycle> : value in percentage (range: 1 - 100)
	-gls / --getledstatus : Get the LEDs state.
	-sgv / --setgpiovalue <gpio> <value> : Set GPIO value.	
	Description:
		<gpio> : Number of GPIO to set. Possible values are: 
			1, 2, 3, 4
		<value> : Possible values are 0 or 1
	-ggv / --getgpiovalue <gpio> : Get GPIO value.
	Description:
		<gpio> : Number of GPIO to get. Possible values are: 
			1, 2, 3, 4
	-gge / --gpioevents : Subscribe to GPIO events.
	-siv / --seti2cvalue <bus> <chipaddr> <memoryaddr> [value] : Set I2C values.
	Description:
		<bus>: Bus id (hexadecimal)
		<chipaddr> : Device address (hexadecimal)
		<memoryaddr> : Memory address (hexadecimal). It's just ONE value.
		[value] : Sequence of values to be written (hexadecimal)
	-giv / --geti2cvalue <bus> <chipaddr> <memoryaddr> <lenght> : Get I2C values.
	Description:
		<bus>: Bus id
		<chipaddr> : Device address (hexadecimal)
		<memoryaddr> : Memory address (hexadecimal)
		<lenght> : Number of bytes to read
	-gt / --gettimers : Get Standby and Halt Timers.
	-gg / --getGUID : Get Part Number, Serial Number and CIDL from the OBU.
	-geq/ --getEqVar : Get EQ and Variant.
	-gwt / --getworktime : Get Power-On, Standby and Halt state working hours time.
	-gms / --getmcustatus : Get MCU Status (Indicated by soft and hard exceptions since last time it was requested).
	-gd / --getdate : Get MCU Real Time Clock Date.
	-gv / --getversion <rfs> : Get MCU firmware version.
	Description:
        <rfs> : Possible values are:
            current, alternative
    -gcs / --canstatus : Get current CAN Bus status.
    -epb / --enablepb : Enables Power Button.
    -dpb / --disablepb : Disables Power Button.
    -gpb / --getpb : Gets Power Button state.


EXAMPLES
	dpymcutool -sbpv 12.3 84.2 2.5 2
	dpymcutool -sls blue 10 50
	dpymcutool -sgv 2 1
	dpymcutool -siv 1 A 150A 12 13
	dpymcutool -giv 1 0x50 1F 8
	
	dpymcutool --gettimers
	dpymcutool --getGUID
	dpymcutool -gwt
	
	
	
FILES
	JSON Configuration file : /mntSFS/gmvCNF/mcu_conf.json

BUGS

SEE ALSO

AUTHORS
	Deepsy Team