2c:null 2d:["$","title",null,{"children":"Mōvi Pro Pan/Tilt Limits - Beta Firmware User Documentation | Nikolai Nekrutenko | Observable"}] 32:T4ae,--- ## Firmware Flashing There are two zip files in your email: - **Movi_Pro_v2.3.180_BETA.zip** - Pan/Tilt Limits Firmware for Mōvi Pro - **MOVI_Controller_v4.4.111_BETA.zip** - Pan/Tilt Limits Firmware for Mōvi Controller [Mōvi Pro firmware flashing instructions](https://docs.google.com/presentation/d/14GxkVSKb-3CIB2DHrLXp2NIKerkC3NvzYTxioVgccBQ/edit?usp=sharing)². Version number **v2.3.152** should appear on the version screen after a successful flash. [Mōvi Controller firmware flashing instructions](https://freeflysystems.com/wp-content/uploads/2016/10/MoVI-Controller_FirmwareUpdate_UpdateGuide_v1.1.2.0.pdf). Version number **v4.4.111** should appear on the home screen after a successful flash. If you would like to revert to production firmware for any reason, here are links to download the latest production firmware: - Latest Mōvi Pro v2.1.0 Firmware: [Dropbox Download Link](https://www.dropbox.com/scl/fi/0u3rato4dsnqiesrdxixf/Movi_Pro_v2.1.0.zip?rlkey=uzpwpeuxi4rnpusw5hzujrjjs&dl=0) - Latest Mōvi Controller v4.3.0 Firmware: https://freeflysystems.com/support/movi-controller-support _²A MicroSD Card is required to flash the Mōvi Pro_33:T15ed,### Navigating the Pan/Tilt Limits Menu: From the Mōvi Controller home screen, find the **MōVI Expert** menu, once inside the menu scroll down until you see **P/T Limits:** and voilà, you have arrived! Note: The _Max Tilt_, _Min Tilt_, and _Max Roll_ menu items near the start of the Mōvi Expert Menu have nothing to do with the _Min Pan Lim_, _Max Pan Lim_, _Min Tilt Lim_, and _Max Tilt Lim_ menu items from the Pan/Tilt Limits. Now, let's dive into what each of the settings does: - **P/T Limits** - Selects the mode of operation from the three options below - _None_ - Pan/Tilt Limits are disabled - _In & Out_ - Pan/Tilt Limits act when both entering and exiting a limit meaning your pan or tilt input is slowed down until you hit the limit when going towards the limits, or emerging from it going in the opposite direction - _In_ - Pan/Tilt Limits act only when entering a limit meaning your pan or tilt input is slowed down until you hit the limit when going towards the limits. When emerging from it going in the opposite direction, there is no slowing down, it defaults back to your inputs When the _In & Out_ mode is selected, when exiting a limit, the motion is essentially replayed in reverse, i.e. the gimbal accelerates out of the limit until the input rate is matched, as per the _Pan Curve/Tilt Curve_ and _Pan Smooth/Tilt Smooth_ parameters. - **Timer [m:s]**³ - Counts down from the first time a limit is hit when Armed, then disables Pan/Tilt Limits entirely when time runs out. - _m:s_ - The timer value seconds can be incremented by rotating the **MENU SET** knob, and pressed to increment the value in minutes. - _Disarm/Arm_ - Can be toggled with the **USER 3** switch. This switch operates using rising-edge logic, meaning that the switch is moved from the down position to the up position in order to toggle from _Disarm_ to _Arm_ or vice-versa. - _Disarm_ - The timer is disarmed, thus the Pan/Tilt Limits are applied according to the mode of operation with no time limit - _Arm_ - The timer is armed. As soon as the Mōvi Pro enters a limit, the timer starts to count down. Once the timer runs out, the Pan/Tilt Limits are deactivated entirely ⁴. - **Min Pan Lim/Min Tilt Lim [°]** - Defines the angle in degrees where the minimum limit is. This is the value where the gimbal will slow down and come to complete stop as rate is continually inputted in that direction. - The angle in degrees can be changed by either rotating the **MENU SET** knob, or moving the gimbal to the desired position and pressing down on the **MENU SET** knob to record of where the gimbal is. This value can be set from -180° to _Max Pan Lim/Max Tilt Lim_. - **Max Pan Lim/Max Tilt Lim [°]** - Defines the angle in degrees where the maximum limit is. This is the value where the gimbal will slow down and come to complete stop as rate is continually inputted in that direction. - The angle in degrees can be changed by either rotating the **MENU SET** knob, or moving the gimbal to the desired position and pressing down on the **MENU SET** knob to record of where the gimbal is. This value can be set from _Min Pan Lim/Min Tilt Lim_ to 180°. - **Pan Curve/Tilt Curve [%]** - Defines how much of the angle range between the minimum and maximum limits is used for slowing down. For instance, if the _Min Pan Lim_ is set to -30°, and the _Max Pan Lim_ is set to 60°, setting this value to 40% will mean that 40% of the available 90° between the limits will be used for the curve. In our case, this would be from -12° to -30° and from 48° to 60°. In other words, the gimbal will operate at the inputted rate for the middle 60% of the range, and slowed for the 20% on either side. A lower curve percentage means that the shot will be more snappy than that of a higher percentage for a given input rate, as the gimbal will come to a stop quicker. - The percentage can be set from 0% to 100% by rotating the **MENU SET** knob. Smaller values, especially for high input rates are not recommended with this version of firmware, as they may lead to unexpected oscillations - **Pan Smooth/Tilt Smooth [%]** - Defines how strongly the _Pan Curve/Tilt Curve_ is quadratically smoothed. When this value is at 0%, there is no quadratic smoothing, meaning that the gimbal slows down at a constant rate up until stopping at the limit. When this value is at 100%, the gimbal slows down at a slow rate initially (once the curve region is entered, as discussed in the _Pan Curve/Tilt Curve_ section), and then slows down at a linearly increasing rate as the limit is approached, until the limit is reached. For values between these two extremes, a mix of both cases happen, where the constant rate dominates when these percentages are small (< 50%), and the linearly increasing rate dominates as the percentages are large (> 50%). A higher percentage leads to a more snappy shot as instead of slowing down at a constant rate, the rate of slowing down increases up until the limit is reached. - The percentage can be set from 0% to 100% by rotating the **MENU SET** knob. A combination of fine-tuning both the _Pan Curve/Tilt Curve_ and _Pan Smooth/Tilt Smooth_ is recommended to achieve the desired result for a specific shot. *³ Note: The USER 3 Function must be configured properly to allow the timer to be armed* *⁴ This could be useful for filming a shot with fixed limits and then transitioning to operating freely after a certain time, such as a talking scene between two subjects and follow them as they leave the scene.* 34:T434,function pt_limits(lim_max, lim_min, c_st_pct, c_sm_pct, x) { let d_lim_max = 0; let d_lim_min = 0; let stop_dist = 0; let s_start_angle = 0; let lim_acc = 0; let lim_angle = 0; let adj_rate = 1; let c_st = c_st_pct / 100; let c_sm = c_sm_pct / 100; d_lim_max = (lim_max * Math.PI) / 180 - (x * Math.PI) / 180; d_lim_min = (x * Math.PI) / 180 - (lim_min * Math.PI) / 180; stop_dist = (((lim_max * Math.PI) / 180 - (lim_min * Math.PI) / 180) * c_st) / 2; s_start_angle = ((1 - c_sm) / (1 + c_sm)) * stop_dist; lim_acc = (1 + c_sm) / (2 * stop_dist); lim_angle = lim_angle_func(stop_dist, d_lim_max, d_lim_min); let radical = 0; let rate = 1; if (lim_angle != 0) { radical = 1 - 2 * lim_angle * lim_acc; if (lim_angle < s_start_angle && radical >= 0) { rate = Math.sqrt(radical); } radical += ((lim_acc * lim_acc) / c_sm) * (lim_angle - s_start_angle) * (lim_angle - s_start_angle); if (lim_angle >= s_start_angle && radical >= 0) { rate = Math.sqrt(radical); } } return rate; }35:[] 30:{"id":"2b2149d8f6355702","slug":null,"title":"Mōvi Pro Pan/Tilt Limits - Beta Firmware User Documentation","thumbnail":"8318b53acb6a2197b5fd14a3ea681050ca6291434d6bf50a34b1b91ba6fa7547","access_level":"public","create_time":"$D2023-11-09T13:54:07.686Z","update_time":"$D2023-11-21T06:13:06.066Z","view_time":null,"first_public_time":"$D2023-11-09T13:54:07.686Z","has_unpublished_edits":null,"fork":{"id":"6463e485785aabff","slug":"ptlimits","title":"Mōvi Pro Pan/Tilt Limits - Beta Firmware","owner":{"id":"abfd2a4c021d66ca","login":"nikolaiteslovich","name":"Nikolai Nekrutenko"}},"stars":0,"starred":false,"owner":{"type":"team","id":"abfd2a4c021d66ca","login":"nikolaiteslovich","name":"Nikolai Nekrutenko","avatar_url":"https://avatars-next.observableusercontent.com/0bafa58e62c1f685eb831aeb2f011622aa0bb254e8e7c84fff49f040b5a58b1c","tier":"starter_2024"},"version":982,"publish_version":null,"role":null,"authored":false,"authors":[{"type":"individual","id":"cf28f71ca8e6a61b","login":"nikolaiteslovich","name":"Nikolai Nekrutenko","avatar_url":"https://avatars-next.observableusercontent.com/0bafa58e62c1f685eb831aeb2f011622aa0bb254e8e7c84fff49f040b5a58b1c","tier":null}],"members":[{"type":"individual","id":"cf28f71ca8e6a61b","login":"nikolaiteslovich","name":"Nikolai Nekrutenko","avatar_url":"https://avatars-next.observableusercontent.com/0bafa58e62c1f685eb831aeb2f011622aa0bb254e8e7c84fff49f040b5a58b1c","tier":null,"role":"editor"}],"comments":[],"custom_thumbnail":false,"trashed":false,"lapsed":null,"subscribed":null,"forks":0,"collection":null,"type":"notebook","body":{"title":"Mōvi Pro Pan/Tilt Limits - Beta Firmware User Documentation","cells":[{"id":0,"value":"# Mōvi Pro Pan/Tilt Limits - Beta Firmware User Documentation\n\n_Nikolai Nekrutenko - Freefly Systems - November 21st, 2023_\n\nAdjustable limits for your Mōvi Pro that are as ***silky smooth*** or as ***scarily snappy*** as you need them to be!\n\nHere is a short video explanation and demo¹:\nhttps://youtu.be/7P_ka9fk7zw\n\n_¹The counter feature was removed due to reliability issues._","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","output":"","database":"$undefined"},{"id":576,"value":"$32","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","output":"","database":"$undefined"},{"id":831,"value":"---\n\n\n## How to use Pan/Tilt Limits\n\n### Enabling USER 3 Switch Functionality:\n\nFrom the Mōvi Controller home screen, navigate to the **TX Config** menu, once inside the menu scroll down to **USER 3 Function:** and select **PT Limits** by rotating the **MENU SET** (right) knob. Within the same menu, scroll up to **Tx Action:**, ensure that **Save** is selected, and press the **MENU SET** button to save the setting to be turned on by default for future use.","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","output":"","database":"$undefined"},{"id":910,"value":"example_photo = html`

`","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":906,"value":"$33","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","output":"","database":"$undefined"},{"id":968,"value":"## Graph of Input Rate Multiplier vs Gimbal Position\n\nBelow is an interactive graph to help visualize the menu parameters described and how they lead to the input rate multiplier curve below with respect to position. \n\nYour input rate is multiplied by the input rate multiplier to bring the gimbal to a stop following a curve that you define with the _Min Pan Lim/Min Tilt Lim_, _Max Pan Lim/Max Tilt Lim_, _Pan Curve/Tilt Curve_, _Pan Smooth/Tilt Smooth_ parameters as discussed above. ","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","output":"","database":"$undefined"},{"id":931,"value":"Plot.plot({\n width: 600,\n height: 300,\n y: {\n domain: [-0.01, 1.05],\n grid: true,\n label: \"rate multiplier\"\n },\n x: { domain: [lim_min, lim_max], grid: true, label: \"gimbal angle (°)\" },\n marks: [\n Plot.line(\n build_samples(\n (x) => pt_limits(lim_max, lim_min, c_st_pct, c_sm_pct, x),\n lim_min + 0.001,\n lim_max - 0.001,\n { N: parseInt((lim_max - lim_min) * 10) }\n ),\n {\n strokeWidth: 3,\n stroke: \"steelblue\"\n }\n ),\n // Plot.dot(\n // [\n // [1 / Math.sqrt(2), Math.exp(-1 / 2)],\n // [-1 / Math.sqrt(2), Math.exp(-1 / 2)]\n // ],\n // { fill: \"black\", r: 5 }\n // ),\n Plot.ruleX([0]),\n Plot.ruleX([lim_min]),\n Plot.ruleY([0]),\n Plot.axisY({ x: lim_min })\n ]\n})","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":956,"value":"**Maximum Limit:**","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","output":"","database":"$undefined"},{"id":935,"value":"viewof lim_max = Inputs.range([-175, 180], {\n value: 45,\n step: 5,\n label: tex`lim_{max}:`\n})","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":958,"value":"**Minimum Limit:**","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","output":"","database":"$undefined"},{"id":937,"value":"viewof lim_min = Inputs.range([-180, lim_max - 5], {\n value: -45,\n step: 5,\n label: tex`lim_{min}:`\n})","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":960,"value":"**Curve Percentage:**","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","output":"","database":"$undefined"},{"id":939,"value":"viewof c_st_pct = Inputs.range([0, 100], {\n value: 50,\n step: 5,\n label: tex`c_{st}:`\n})","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":962,"value":"**Smooth Percentage:**","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","output":"","database":"$undefined"},{"id":940,"value":"viewof c_sm_pct = Inputs.range([0, 100], {\n value: 50,\n step: 5,\n label: tex`c_{sm}:`\n})","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":780,"value":"---\n\n## Asks\n**Please:**\n- Ensure data logging stays on. Data logging should be on by default. You may double-check with the Movi App. Connect to your gimbal. Go to General. Then Expert. Double check data logging is on.\n- Send photos of your setups. We want to know how you’re rigging Movi.\n- Revert to the original FW before taking it on any real jobs, and perform a quick function test before your next job.\n- Send your criticism. We’re big kids. We can handle it.\n- Let us know what you love about it.\n - What new shots does this enable?\n - How much more do you smile?\n","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","output":"","database":"$undefined"},{"id":770,"value":"---\n\n## Caution\n\n**This is still in Beta:**\n- While we have done significant internal testing before allowing it in your hands, we would not recommend taking this on jobs just yet.\n\nThings to keep in mind with the current beta implementation:\n- If **Pan/Tilt Curve [%]** or **Pan/Tilt Smoothing [%]** is set too low, the gimbal will overshoot the limit and start oscillating\n - The motor does not have enough torque to stop in such a short window, software to calculate the minimum stopping window is underway³\n\n_³All of these will be addressed in future firmwares_\n","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","output":"","database":"$undefined"},{"id":788,"value":"---\n\n## Having Issues?\nCall, text, or email us anytime. We’ve included a link to the current Mōvi Pro production firmware above if you need to revert.\n","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","output":"","database":"$undefined"},{"id":790,"value":"---\n\n## Damage to your Mōvi Pro \nIf the FW upgrades cause any damage to your Mōvi Pro, we will replace or repair it. Your choice. Thank you for testing!\n","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","output":"","database":"$undefined"},{"id":974,"value":"---","pinned":false,"hidden":false,"mode":"md","author":"$undefined","summary":"$undefined","output":"","database":"$undefined"},{"id":947,"value":"import { build_samples } from \"@mcmcclur/adaptive-plotter\"","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":949,"value":"function lim_angle_func(stop_dist, d_lim_max, d_lim_min) {\n let angle = 0;\n if (d_lim_max <= stop_dist) {\n angle = stop_dist - d_lim_max;\n } else if (d_lim_min <= stop_dist) {\n angle = stop_dist - d_lim_min;\n }\n return angle;\n}","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"},{"id":952,"value":"$34","pinned":false,"hidden":false,"mode":"ojs","author":"$undefined","summary":"$undefined","output":"$undefined","database":"$undefined"}],"files":"$W35","stdlib":"1","titling":"auto"}} 31:"$30:body"