ESC configuration APP (AMC Manager v1.0.0)

circle-info

AMC Manager is an application for setting up, managing and testing the ESC. The application is built on the Qt platform, and communication with the ESC takes place via a serial port. AMC Manager runs on the host PC (Win/Linux).

Download and run the application

  • Downloadarrow-up-right the up-to-date application version according to your host PC operating system

  • Unpack archive

  • Run application

    • For Linux Host, open the terminal in the unpacked folder and execute ./AMC_Manager

    • For Windows PC, open the unpacked folder and run AMC_Manager.exe

Application manual


Control Panel

chevron-rightStatus areahashtag

Connection status

  • Disconnected - device is not connected to the app

  • Connected - device is in service mode (motor identification is possible)

  • Running - device is in operating mode

  • Flashing - device is being updated

COM port status

  • Select port - no connection to COM port

    • Manual selector

    • Auto select with AE Converter

  • Connecting - establishing communication with the COM port

  • COMx - connected to COM port (with number 'x')

Device status

  • No device - no device is connected

  • Device x - connected device with address 'x'

  • Non-init device - unconnected device in bootloader mode

  • FW version

    • x.y.z - 'x' - major version, 'y' - mid version, 'z' - minor version

    • Boot - bootloader mode

chevron-rightSetting areahashtag

Tabs with settings, control and update are located in this area.

ESC Params

  • Setting ESC params

Motor Params

  • Setting motor parameters and motor identification

Control

  • Verification of ESC control via the application

Firmware

  • ESC firmware update

chevron-rightSharing areahashtag

This area is used to import and export the overall ESC settings from/to the motor. This area is disabled when the device is disconnected.

Import params

  • Saving the image of the params of the ESC and the motor to a file

Export params

  • Upload the settings image (motor included) to the ESC

Operational Panel

ESC Params

chevron-rightPWM Inputhashtag

Setting the signal control ranges for ESC.

Pwm Type

  • One-way or two-way control

  • Value: Unipolar or bipolar

  • Predefined value = Unipolar

Low Level

  • The lower limit of the PWM control range

  • Value = <800; 1200> us, Step = 10 us

  • Predefined value = 1000

Center Level

  • With bipolar PWM, the value changes direction

  • Value = <1200; 1800>, Step = 10 us

  • Predefined value = 1500

High Level

  • The upper limit of the PWM control range

  • Value = <1800; 2200>, Step = 10 us

  • Predefined value = 2000

Dead Zone

  • Just above the lower limit, where the motor still does not run

  • Value = <50; 150>, Step = 10 us

  • Predefined value = 50

Control Type

  • Desired quantity for control

  • Value = Voltage or Speed (not supported)

  • Predefined value = Voltage

Speed Norm (not supported)

  • Number of motor revolutions at the upper PWM limit

  • Value = Auto (0) or RPM (<0), Step = 10 RPM

Scale (not supported)

  • Adjust the voltage range to the PWM range

  • Value = Auto (0.0) or (0.0; 1.0>, Step = 0.01

    • Auto - set according to bus voltage

    • Manual - example

      • Motor: KV = 800, MAx_V = 4S = 4.2_4 = 16.8V, Max_RPM = 800_16.8 = 13440 RPM

      • Power supply: V = 6S = 4.2_6 = 25.2V; Max_RPM = 800_25.2 = 20160 RPM => motor destruction

      • Scale: 16.8/25.2 = 0.67 - Power supply range = 0.67*25.2 = 16.8V

  • Predefined value = 1.0

Analog Control

  • Measurement of duty in a signal with a frequency of 50Hz

  • Communication method for using the App Control

  • Predefined value = False

Digital control

  • Duty in the form of proprietary communication protocol ADB Simple

  • Communication method for using the CAN bus

  • Predefined value = True

  • Graph

    • Displays the power according to the current PWM setting

chevron-rightMotion Parametershashtag

Setting parameters for adjusting the movement and dynamics of ESC

Acceleration (not supported)

  • Motor acceleration level

  • Value = Min, Mid or Max

Break (not supported)

  • Level of active braking of the motor generated by the control

  • Break Enable must be activated

  • Value = Min, Mid or Max

Break Enable (not supported)

  • Active breaking is allowed

Reverse Direction

  • Changing the direction of motor movement

  • Predefined value = False

Device Address

  • Address of the ESC device

  • Value = <0;3> or fixed (Determined by HW configuration)

Time to leave

  • The time during which, in the event of a signal failure, it holds the last setpoint

  • Value = <150; 2000>, Step = 50 ms

  • Predefined value = 150

Controller Kp

  • Setting the proportional component of controller

  • Value = <0.0; 65.353>, Step = 0.001

  • Predefined value = 0.7

Controller Ki

  • Setting the integral component of controller

  • Value = <0.0; 65.353>, Step = 0.001

  • Predefined value = 0.43

chevron-rightData and errorshashtag

Basic information from the ESC and handling errors of the ESC

Get Errors

  • Read structure of errors and warnings from device

    • All errors

      • Every error and warning since the last cleaning, regardless of the power cycle

      • Contains:

        • Errors with the hexadecimal code

        • List of individual errors

        • Warnings with the hexadecimal code

        • List of individual warnings

    • Previous Errors

      • Every error and warning from the previous power cycle

      • Contains:

        • Errors with the hexadecimal code

        • List of individual errors

        • Warnings with the hexadecimal code

        • List of individual warnings

    • Last Errors

      • Every error and warning in the current power cycle

      • Contains:

        • Errors with the hexadecimal code

        • List of individual errors

        • Warnings with the hexadecimal code

        • List of individual warnings

Clear Errors

  • Clear only the category All Errors from the device

Get Data

  • Information about currents and temperatures from the last run

    • Max Temp ESC - maximum temperature of the ESC

    • Max Temp Motor - maximum temperature of the motor

    • Avg current - average current during the run

    • Max current - maximum current during the run

Get Resist

  • Information about total resistance and phase resistance

    • Phase A - phase A resistance

    • Phase B - phase B resistance

    • Phase C - phase A resistance

    • Global - total resistance


Motor Params

chevron-rightMotor selectionhashtag
  • Motor control on the ESC is conditioned by motor identification

  • Identification must be performed for each motor type

  • Identified params can be applied to all motors of the same type

  • Identification must be performed when changing motor params (e.g., change of operating voltage)

Motor selection

  • New motor

    • New type of motor

      • Motor must be identified - Add motor

    • New piece of motor

      • Unknown motor type (new type of motor)

        • Motor must be identified - Add motor

      • Known motor type (motor type has already been identified)

        • Individual motors of the same type may have minimal differences in parameters

          • Normal use - Neglecting minimal params differences

            • Select from motor list - Motor list

          • Special use - Elimination of minimal params differences

            • Motor identification - Add motor

  • Used motor

    • Used locally (this computer)

      • Select from motor list - Motor list

    • Get from another place or restore

      • Load from file to motor list - Import motors

    • Share to another place or backup

      • Save to file from motor list - Export motors

chevron-rightIdentified motor listhashtag

Contains a list of user-identified motors and the management of this list.

Actual motor type

  • Selected name from the list

    • Sets the selected motor from the list to the ESC as the actual motor

    • Non-existent motor is named Unknown motor xx

Motor hours

  • Number of operating hours since the last motor change

Motor list

  • List of identified and imported motors with creation time

  • Motor name is local and user-defined

  • Click on the header to sort the list

Set motor

  • Setting a new actual engine from the list

Rename motor

  • Rename the selected motor in the list

Remove motor

  • Remove the selected motor from the list

Info Motor

  • Information on motor identification parameters

Import Motors

  • Imports motors from the file into the local database

  • Merging options

    • Overwrite - Delete all motors in the list and use the new ones

    • Append - Add new ones to the list and use new ones in case of a name conflict

  • File extension .ms (motor specification)

Export Motors

  • Exporting motor from the local database to a file

  • Options

    • All - Exports all motors from the list

    • Selected - Exports only a single selected motor (No selection = Disabled option)

  • Contains: Motor Name, Creation Time and Motor Parameters

  • File extension .ms (motor specification)

chevron-rightAdd motorhashtag

Setting motor parameters to identify and enable this process

Max current

  • Maximum continuous current in A according to the motor datasheet

Kv

  • Motor velocity constant in rpm/V according to the motor datasheet

LiPo cells

  • Motor operating voltage expressed in LiPo cells (Full cell voltage = 4.2V)

  • If the voltage is above the recommended range from the motor datasheet, it is necessary to use Scale in the PWM Input

  • Example - Battery type: 6S => LiPo cells: 6

Pole pairs

  • The number of pole pairs in the permanent magnet in the motor

  • Example - 12P14N => (use N number)/2 => Pole pairs: 7

  • Example - 10 poles => poles/2 => Pole pairs: 5

  • Example - 11 pole pairs => Pole pairs: 11

Identify motor

  • Start of the motor identification process with the parameters defined above


Identification process

1

Prepare identification

  • Fill motor params

  • Identify motor

2

Warning - Attention

The identification process must be under constant surveillance during its entire process.

3

Warning - No load motor

The motor must be unloaded during process identification. Remove propellers, shaft, ...

4

Warning - Steps of identification

  • Details of individual identification steps

5

Confirmation of readiness

  • Confirm previous warnings

    • Motor without load

    • Full concentration

    • Knowledge of all identification steps

  • Start identification

6

Identification interface

  • Current step - Name of current identification step

  • Help - Identification interruption in case of an error

  • Warning label (default hidden) - Detection of a possible problem during identification - Please interrupt identification

  • Progress bar - Progress in the current step

  • Right behaviour - Expected action in the current step

  • Errors - Errors that may occur in the current step

  • Next step - Information about the next step

  • Cancel - Identification interruption

7

No movement step

  • Accelerates the motor from zero to constant speed

  • Behavior

    • Stopped motor

    • Production of high-frequency noise

  • Error

    • Stopped motor

8

Acceleration step

  • Accelerates the motor from zero to constant speed

  • Behavior

    • Spinning motor

    • Motor speed increase

9

Variable speed step

  • Performs measurements while the motor is running, causing speed fluctuations

  • Behavior

    • Spinning motor

    • Change in motor speed (increase and decrease), but not zero

  • Error

    • Stopped motor

10

Deceleration step

  • Decelerates the motor from constant speed to zero

  • Behavior

    • Spinning motor

    • Motor speed decrease

    • Too short a stage

    • May not display

  • Errors

    • Stopped the motor on start

    • Spinning motor on end

11

Finish step

  • Identification is complete

  • Process

    • Stopped the motor

    • Completed identification

  • Error

    • Spinning motor

12

Save motor

  • Fill motor name

  • Save the motor list and set as the actual motor type

13

Error (in case of error)

Interrupt identification - no warning label

  • Interruption without cause

    • Cancel and update params

    • Repeat identification with the same params

  • Step Acceleration - without increasing speed

    • Probably bad params: Pole pairs or Kv

    • Cancel and update params

  • Step Variable speed - motor stops spinning

    • Probably bad params: Low value of Max current

    • Cancel and update params

Interrupt identification - with a warning label

  • Perform adjustment of internal params by self-diagnostics

    • Correction of identification

  • Step Acceleration - without increasing speed

    • Probably bad params: Pole pairs or Kv

    • Cancel and update params

  • Step Variable speed - motor stops spinning

    • Probably bad params: Low value of Max current

    • Cancel and update params


Control

Control is used to verify ESC control with the motor through the application.

  • Permitting conditions

    • PWM Input in Analog control

    • Allow the device to switch to status Running

chevron-rightTelemetryhashtag

Displays telemetry data from the device.

Telemetry quantities

  • Speed - Mechanical motor speed

  • Vs - Motor voltage

  • Vdc - Supply ESC voltage

  • Power - Motor power

  • Torque - Motor torque

  • Is - Motor current

  • Pwm - Pwm duty of control signal

  • Rs - Global resistance

  • Flux - Motor magnetic flux

  • Temp - ESC temperature

Graph

  • Displays two quantities simultaneously

  • The quantity is plotted continuously, but it can be stopped

chevron-rightControlhashtag

Motor control over the control range <-100%, 100%>

Enable control

  • Allows you to start motor control

Controller

  • Start point 0%

  • Boundary points - -100%, 100%

  • Increment - 1%

Dead band

  • Dead zone in the range around the starting point

  • Very low speeds can make the motor standstill


Firmware

Firmware update or upload via bootloader

Check this link for up-to-date firmware version for ESC: Download linkarrow-up-right


Update connected device

The firmware on the connected device is being updated

1

Check device status

Connected

  • Suitable condition for continuing the update

Running

  • Perform a power cycle on the device

  • Connect to the app

Disconnected

  • With firmware

    • Power on the device

    • Connect to the app

  • No firmware

    • Use Update via bootloader\

2

Select the firmware file

File with extension .bin

3

Start update

Press the Update button

4

Updating

Auto-connecting step

  • The device is restarted

  • Auto reconnect

Writing firmware step

  • Write new Firmware to the ESC flash

5

Successful update

Start the device with the new firmware


Update via bootloader

The device in bootloader mode is used for updating

1

Check the device state

  • Device must be powered off

  • Device controlled via esc_configuration_app in Jetson, the power off is achieved by the next (or first) step in the application

2

Connected to Alink

Connect the device via Alink (Serial link)

3

Select the firmware file

File with extension .bin

4

Start update

Press the Update button

5

Power on the device

  • Power on the device within 10 seconds

  • Device controlled via esc_configuration_app in Jetson, the power on is achieved by the next step in the application

  • Elapsed time is displayed by a progress bar

6

Updating

Writing firmware step

  • Write new Firmware to the ESC flash

7

Successful update

Start the device with the new firmware

Last updated