This guide is based on TianshanOS 0.6.3. For other versions, check the corresponding version-specific instructions.
This guide covers routine functions in Part I and terminal access, remote commands, Automation, and configuration backup in Part II. Root operations can affect the device and remote hosts; check the target and active tasks before proceeding. See the separate Security Guide for security management.
Use the controls shown on your device. Some need specific hardware or configuration. On a computer, hover over an icon button to see its name. On a phone, swipe within a wide table to view its other columns.
Open the device’s web interface (WebUI) using the address provided by your administrator.
Select “Login” in the upper-right corner.
Enter root and the root password supplied with the device.
Select “Login.” After a successful login, the current username appears in the upper-right corner.
Logging in with the default password opens a “Security Reminder.” Enter the current password, then enter the new password twice and select “Change Now.” Both new-password entries must match. Select “Later” to close the reminder.
When you have finished, select “Logout” in the upper-right corner. You will need to sign in again to use the device.
“System Overview” shows the chip, firmware version, ESP-IDF version, and uptime. For routine use, check the firmware version. ESP-IDF is the version of the system framework used by the device.
The right side of the card shows input voltage, internal voltage, current, power, and protection status.
System settings such as networking, fans, temperature, and lighting are saved inside the device. Inserting an old SD card does not restore them. Automation configuration is managed separately; its emergency backup is not a full-device backup.
The switch beside the protection status enables or disables low-voltage protection. When enabled, the device uses the saved voltages and delays to shut down at low voltage and restart after power recovers.
A reboot temporarily interrupts the WebUI and device management. Finish active operations, then select “Reboot” and confirm. Wait for the device to recover, then reopen the WebUI.
Restarting a service temporarily interrupts the function it provides. Open “Service Status,” find the affected service, and select “Reboot” on that row. Check its status again when the operation finishes.
These settings control when the device shuts down after a voltage drop and when it starts again after power recovers. Use values that match your device’s power requirements.
Select “Shutdown Settings” to change:
“Low Voltage Threshold”: Starts the shutdown countdown below this voltage.
“Recovery voltage threshold”: Starts recovery above this voltage.
“Shutdown Countdown”: Sets the delay before shutdown after low voltage is detected.
“Recovery hold time”: Sets the wait time used to confirm stable power recovery.
“Fan Stop Delay”: Sets the delay before fans stop after shutdown.
Save the form to apply the updated protection settings.
Switching the USB target may temporarily disconnect an attached device. Confirm the target and finish active work before continuing.
Devices that support USB switching show a “USB” button. Each click switches the top USB port to the next target: ESP, AGX, then LPMU. Check the target shown on the button and the page message to confirm the result.
Save work on the module and complete its normal shutdown process before removing power. Forced power-off can cause loss of unsaved data.
“AGX Power” shows the power-control state. Select it to switch power on or off, then wait for confirmation.
“LPMU Power” shows “Online,” “Offline,” or “Unknown.” These states come from a network check. Online means the module is reachable; offline means it is not. Neither state alone confirms whether the module is powered on or off.
Selecting the LPMU button triggers the same action as pressing its physical power button. Wait for the check and the displayed result. If the result is unknown, check the module and network before pressing the button again.
A root user configures Quick Action cards. Card visibility and manual execution are separate settings. Seeing a card does not mean you can start its task.
Read the card name and description to identify the task.
Select the card and read the result. Do not start it again while processing.
An executed or queued message still needs an actual result check on the target device or task. Use “Background runs” to verify, view logs, or stop a background service (Chapter 11).
If starting is blocked, follow the reason shown. Do not keep selecting start:
Rule disabled or manual triggering not allowed: Check the rule settings on “Automation” (Chapter 12). A visible card is not permission to run it.
A task or background operation is in progress: Wait for its result. Do not start it again.
A background run record already exists for the task: Verify the original task in “Background runs” and confirm that it has ended before starting again.
Configuration not loaded, a required item missing, or Automation paused: Check the configuration and enable state on “Automation” (Chapters 12 and 13).
Press and hold a card until the reorder indicator appears, then drag it to change the display order.
If no cards appear, read the explanation. Wait if configuration is loading. If loading failed, keep the reason and check “System Logs” on Terminal. If no Quick Actions are configured, select “Open Automation” and check the rules’ “Show on panel” setting.
Do not restart a device providing active services just to restore a card.
Data widgets continuously display device data in the “Device Panel.”
Select “Widget Manager.”
Choose a refresh interval or disable automatic refresh.
Add a preset widget, or choose a component style and data source offered by the page.
Edit its label, display style, and unit as needed, then save.
Existing widgets can be edited, deleted, and reordered. You can also select a widget card to edit it. Press and hold a widget, then drag it to a new position.
The status bar shows “Effective Temp” and “Current output.” The large percentage is the control setting confirmed by the device, not the measured speed. RPM is the measured speed in revolutions per minute and is hidden without a valid reading. A large -- means the current output is unconfirmed.
While you drag the manual slider, the value beside it shows the proposed setting. The large percentage continues to show the current output. Release the slider, then check the message and updated reading to confirm the change. If a requested setting differs from the current output, do not assume it has already taken effect.
Smart mode shows its operating state, such as “Smart Mode,” “Following curve,” protection, or an invalid temperature. It also provides a safety reference, a 45-second forecast, and the rate of temperature change.
If the temperature becomes invalid, check that its source is still updating. The device switches to protective control for temperature loss. Select “TTI” for an explanation of Smart thermal control.
Use the refresh button in the section header to fetch the current state. If adjustment fails or the output is unconfirmed, check the device before deciding whether to retry.
Uses a fixed control percentage set with the 0-100% slider.
“Curve”
Follows the configured temperature-to-control-percentage curve.
“Smart”
Uses the base curve, temperature trends, and past adjustments to control cooling. Uses protective control when needed.
Stopping a fan or setting a low manual value reduces cooling. Check the load and temperature first, and keep monitoring them. The slider is available only in Manual mode when the current output is confirmed.
Select “Curve” in the Fan Control section header to open “Fan Curve Management.” The “Curve” button inside a card only changes the operating mode.
Under “Fan,” choose the number to adjust and check it against the System page.
Under “Temperature variable binding,” add temperature variables and assign weights.
Select “Bind.” The temperature source is shared by fans in Curve and Smart modes, so changing it affects the fans using that source.
Add or edit “Curve nodes.” Each curve needs at least 2 nodes and supports up to 10.
Set “Minimum speed” and “Maximum speed” as control percentages. The minimum must not exceed the maximum.
Set “Temperature hysteresis” and “Minimum interval.” Hysteresis accepts 0-20°C and reduces frequent adjustments caused by small temperature changes. The interval accepts 500-30000 ms; 1000 ms is 1 second.
Select “Save curve.” After a successful save, the selected fan switches to Curve mode. To use Smart thermal control, return to the card and select “Smart.”
If saving fails, read the message and check the current state before retrying. After unbinding temperature variables, check the effective temperature and fan state as well.
Select “Import Config” and choose a curve JSON file. JSON is the file format used to store curve data. Review the nodes, limits, and fan number, then select “Save curve” to apply them.
Select “Export Config” to download the current curve. The page also attempts to save a copy under /sdcard/config on the SD card. Check the browser download and the reported SD-card result separately.
Matrix cards provide icons for the available features. Open one, then switch between these groups in “LED Settings”:
“Programmatic Animation”: Select and run an animation.
“Image/QR Code”: Choose an image from the SD card or enter content for a QR code.
“Text Display”: Set text, font, alignment, scrolling, foreground, and background.
“Post-processing Filter”: Choose a filter and parameters, then apply or stop it.
“Color Correction”: Adjust the display and use the available reset, import, or export controls.
Check the actual light or matrix display after applying a change. Use only the features shown. If a setting fails, follow the message to check the file, input, or device state.
The top of the page shows the state of Ethernet, the WiFi client, and the WiFi AP. Open the related panel to view IP address, subnet mask, gateway, DNS, MAC address, SSID, signal, and connected-device counts when available.
The Ethernet panel displays the current link and address information. It does not provide address editing controls.
DHCP automatically assigns network addresses to connected devices. Select “Clients,” choose “WiFi AP” or “Ethernet,” and view the current leases. Use the refresh button to reload the list.
NAT forwards network traffic between the device's network interfaces. Enable or disable NAT, then select “Save” to retain the setting. Check the WiFi and Ethernet status afterward.
Under “Upstream Network Access,” select “Access via LPMU.”
Enter the LPMU sudo password and select the access button. The password is used only for this run and is not saved; enter it again for a later run.
Wait for the operation to finish. Do not start it again while processing.
Access is confirmed only when the result reports both an internet connection and completed network configuration.
If it fails or the result is unconfirmed, read the reason first. Expand “Execution Log” for more detail. Check the password for a password error, or the cabling and upstream network if no internet connection is found.
A failed status request does not mean the script has stopped. Use the available “Refresh Status” control to check the current run before deciding whether to try again.
Select “Files” in the top navigation to open “File Manager.”
The SD Card is removable storage, and SPIFFS is internal device file storage. Select “SD Card” or “SPIFFS” to switch locations. The path at the top shows your current folder. Select a folder name in the path to go back to it.
Files can only be uploaded to the SD Card, not SPIFFS. Confirm that the SD Card is mounted first.
Select “SD Card” and open the folder where you want to upload the files.
Select “Upload Files.”
Select one or more files, or drag files into the upload area.
Review the upload list and remove unwanted files.
Select “Upload” and wait for each file to show completion.
Uploading a .tscfg package opens verification and application steps. However, this file-upload page does not yet apply the package's settings. Successful upload or verification does not mean the settings are in effect.
Import rule packages on Automation, as described in Chapter 12. Ordinary file upload is not a substitute for rule import. See the Security Guide for source and signature guidance for other packages.
Deletion cannot be undone in the WebUI. Deleting a folder also deletes all of its contents. Confirm the name and path before selecting “Delete” or “Batch Delete” and approving the prompt.
Files managed by Automation are protected. Uploading or overwriting files in /sdcard/config/automation, or deleting or renaming that folder or a parent containing it, may be refused. If the message says that Automation manages the file, use “Configuration & backup” on Automation or the relevant list. Do not use Terminal to bypass the restriction.
Unmounting makes SD files temporarily unavailable. Finish uploads, downloads, and other file operations, then select “Unmount SD.”
Unmounting or replacing the card may switch Automation to its internal emergency configuration. That copy may be older, and enabled automatic rules may still run. Without a usable copy, Automation may be unavailable. Review the emergency configuration and tasks before unmounting (Chapter 13). Card-based images, fonts, and logs become unavailable.
When the SD Card is not mounted, the page shows “Mount SD.” Select it, wait for the state to change to “Mounted,” then open the SD Card directory again.
Mounting the card does not mean Automation has switched to its configuration. After reinserting a card, choose which configuration to use as described in Chapter 13. Nothing is overwritten or merged automatically.
The first upgrade from an older storage layout, such as 0.6.2, needs a matched USB / serial package approved by the publisher. Uploading only the firmware or WebUI cannot complete this upgrade. Ask the device administrator or provider to follow the package instructions. Do not erase the whole flash or use an old partition table.
Save important files and keep the original SD card installed. The first startup migrates existing configuration; keep power connected. Afterward, check login, networking, fans, lighting, SSH hosts, and Automation rules. Review rules before testing any task that controls power, restarts a device, or runs remote commands.
The matched package updates both application slots. Do not assume that the other slot still contains the old version. If the root password is lost, use only a recovery method confirmed by the provider to match the 0.6.3 layout. Do not flash an old password-reset image.
The web update methods below apply only to versions the publisher has approved for OTA. They do not replace the first layout upgrade.
Enter the OTA server address supplied by an administrator or publisher.
Select “Save,” then select “Check Update.”
The page reports “Update Available,” “Already up to date,” an older server version, or an error.
Confirm the target version, then select “Upgrade Now” or the upgrade control shown by the page.
Wait for download, installation, and reboot to finish. To cancel, use the “Abort” button when it is available. Not every stage supports cancellation.
Wait for the page to confirm the firmware after the upgrade. Reconnect to the WebUI and check “Current Version” and device status.
“Upgrade Progress” shows the current stage in its own section. A 100% reading or a message that files were written does not confirm a completed restart and version check. If the result is unconfirmed or the running firmware differs from the target, keep the message and check the current version. Do not repeat the upgrade without checking. Check System Logs and contact the provider if needed.
When “Also upgrade www” is enabled, the firmware and WebUI are updated in sequence. Use matched firmware and WebUI resources from the same release. If the old interface remains after upgrading, force-refresh the browser and check the version and page again.
Expand “Manual Upgrade” and choose one of these methods:
“Upgrade from URL”: Enter the firmware URL, set “Also upgrade www” according to the release instructions, then select “Upgrade.” Here, www refers to the device’s web-interface resources.
“Upgrade from SD Card”: Enter a firmware path such as /sdcard/firmware.bin. If “Also upgrade www” is enabled, ensure that www.bin from the same release is in that directory.
For an upgrade from a URL, “Skip certificate check” skips verification of the HTTPS server certificate. This removes the certificate check used to confirm the download server’s identity. Leave it unchecked for routine updates. If you see a certificate error, ask your administrator to check the server address and certificate.
“Partition Management” shows the running partition and other available partitions.
“Mark Valid” confirms the running version and disables automatic rollback protection for that version. Use it after confirming that the current version operates correctly.
“Rollback to This Version” selects another bootable version and switches through a reboot. Rollback interrupts current services. Confirm the target version and data compatibility first.
After the operation and reboot complete, reopen the WebUI and verify the current version and device state.
Version 0.6.3 changes configuration storage and the device partition layout. Do not return directly to incompatible old firmware. If a downgrade is needed, ask the device provider to confirm a complete firmware, layout, and configuration recovery procedure.
Rollback does not restore the old configuration format or guarantee that old rules will work.
Select “Security” in the top navigation to open security management. Use the TianshanOS Security Guide for SSH keys, remote hosts, known-host fingerprints, HTTPS certificates, configuration packages, and account management. These procedures are not repeated here.
A red field error tells you what to correct. Fix it, then save. A cleared error mark does not confirm a successful save; check the message and list.
Check which operation failed, then read the reason and next step. If the message gives no reason, do not guess.
Select “Details” when available. Select “Hide” to hide the details. If a × button is shown, select it to dismiss the message. For further checks, keep a record of the message and details, then open “System Logs” on Terminal to investigate.
If the result is unconfirmed, refresh and check the device, file, or task state. A timeout or lost connection does not mean the operation failed to run. Do not immediately repeat power, delete, task-start, or upgrade operations. If the result remains unclear, open “System Logs” on Terminal to investigate.
Check successful, failed, and unconfirmed batch results separately. Confirm saved files in the browser’s download list.
“Terminal” is shown only to root. It can run device console commands directly and display device logs. A command may change device state immediately. Confirm its source, parameters, and impact before entering it.
Wait for “Connected to device” and the tianshan> prompt.
Enter help to view the commands provided by the current firmware.
Enter a command and press Enter. Wait for its output to finish and the prompt to return.
Input is not executed while the page shows “Not connected to device.” After a disconnect, wait for the reconnection message before submitting a command again to avoid duplicate execution.
Terminal supports these keyboard controls:
Control
Purpose
Ctrl+C
Clear the current input and request an interrupt. The command must support interruption for it to stop.
Ctrl+L
Clear the screen.
↑ / ↓
Browse command history from the current page session.
← / →
Move the cursor within the current input.
“Clear” at the top of the page only clears the display. It does not undo commands that have already run. “Disconnect” ends the current Terminal connection.
An SSH Shell sends subsequent keyboard input to a remote host. Confirm the target address, user, and authentication method, and complete the SSH preparation described in the Security Guide before connecting.
Enter ssh --help to view the SSH command options.
Enter ssh --host <host> --user <user> --shell, replacing each placeholder, including its angle brackets, with the actual value. To specify a port, add --port <port> before --shell.
Wait for the remote connection confirmation before entering remote commands.
Press Ctrl+\ to leave the SSH Shell and return to the tianshan> prompt.
Do not enter plaintext credentials while the terminal is being shared, recorded, or viewed by another person.
For a command-line check, enter auto --config status to view the current configuration location and backup status. Use auto --help for the available options. The old config --sync option has been removed. Use the web steps in Chapter 13 for routine backup and recovery.
“Commands” stores reusable SSH commands and runs them on a selected remote host. Remote hosts and their authentication information are managed on the “Security” page. See the Security Guide for those procedures.
A fingerprint helps identify the host you are connecting to. These steps apply to SSH host tests on the web “Security” page, not to the Terminal SSH Shell confirmation flow. If the message says that the fingerprint is unregistered or has changed, do not keep executing the command. Open “Security,” find the target SSH host, and select “Test.”
For a first connection, the confirmation dialog shows the host address and fingerprint. Check them with the host administrator through a trusted channel. Select “Trust & connect” only after confirming a match.
If the fingerprint has changed, the dialog shows both the stored and current fingerprints, with “Cancel” selected by default. Reinstalling the host can change its fingerprint, but a change may also mean that you have reached another host or an impersonator.
Check the address and confirm the reason through a trusted channel. Select “Cancel” if you cannot confirm it. Do not delete the old fingerprint to skip this check. Select “Update Host Key” only after confirming that the new fingerprint is trusted.
Choose a host currently shown under “Select Host.”
Review its saved items under “Command List.”
“Orphan Commands” reference hosts that no longer exist and cannot run. Check the host configuration. To keep the task, recreate the command under a valid host, update the templates and rules that use it, and check the result before removing the orphan.
Select a host, then select “New Command.” Use the edit button on an existing command to change it.
Enter a unique “Command ID.” It may contain letters, numbers, underscores, and hyphens, and cannot begin or end with an underscore or hyphen.
Enter “Command Name” and “Command.” Put each command on a separate line when using multiple lines.
Add a description and choose an icon or an image from the SD Card if needed.
Review the run mode and output-matching options, then select “Save.”
The name helps you recognize a command; Automation uses its ID to find it. You cannot change an existing command's ID. To use a new ID, create a command and update the templates and sources that use it.
Watch the output and status under “Execution Result.”
When “Cancel” is shown, use it to request interruption of the current session. Check the state and output to confirm whether it stopped. Completed remote operations are not undone.
Select “Clear” to remove the current result display.
“Clear” does not undo work already completed on the remote host. Success, failure, extracted content, and final status depend on the command's matching settings.
Result matching converts remote output into a status that is easier to use.
“Expected match”: Marks the result successful when the output contains the configured text.
“Fail Match”: Marks the result failed when the output contains the configured text.
“Extract regex”: Uses one (.*) capture group to save selected output.
“Stop on match”: Ends a continuing command after a successful match.
“Timeout (s)”: Sets how long to wait for a match, in seconds. It applies only when a success or failure pattern is set, or “Stop on match” is enabled.
“Variable Name”: Saves status and extracted output for use on the Automation page.
Choose stable, specific success and failure text. Broad text can produce incorrect matches. Execute the command once and review “Match Results” before using its variables in a rule.
nohup means a command continues to run in the remote host's background after the SSH connection closes. Closing the WebUI does not stop a background task.
Background runs require SSH key authentication. Deploy the public key on “Security,” then select the associated host. Do not save plaintext passwords in background commands. The same key must remain available to stop or verify the original task.
After enabling “Run in background (nohup)” and executing the command, select “Background runs” on Commands. The root-only control on System and the control on Automation open the same list.
Find the original task by its name, user, host address, and port.
Select “Verify remote state” to check this run on the original host. “Refresh” only reads known records; it does not replace verification.
Select “View Log” to read the last 100 lines from the original host. Select “Follow log” for updates. “Stop following” stops only the page updates.
To end the task, select “Stop” on its record and confirm. Wait for the result, then verify that it has stopped. Do not start it again without checking.
After a device restart, old records show “Not checked.” “Remote state unconfirmed” means it is not known whether the task is stopped or running. “Last result” describes the last confirmed result, not a guarantee of the current state.
A failed read does not mean the log is empty or the process has exited. Check the original host connection, log path, and SSH key. Verify again after resolving the issue; do not restart a task just because its status check failed.
Deleting a command, changing its host configuration, or switching Automation configurations does not end a remote process. Manage the original task from “Background runs.” Recreating a command with the same name or ID does not take over the original task. Keep any key still needed to control it.
“Service Mode” watches a background task until it becomes available. Provide “Ready match” and “Variable Name.” Adjust the optional failure pattern and timing settings as needed:
“Ready match”: Marks the service ready when the configured text appears. Use | to separate multiple patterns.
“Fail Match”: Marks the service failed when the configured text appears.
“Ready timeout (s)”: Sets the longest wait for the ready state, in seconds.
“Check interval (ms)”: Sets how often the log is checked, in milliseconds; 1000 ms is 1 second.
“Variable Name”: Stores states such as checking, ready, and timeout.
Use the export button on a command to export it and, when selected, include its dependent host configuration.
Select “Import Command,” choose a .tscfg configuration package, preview its contents, and decide whether to overwrite existing configuration.
Import may include a remote host and replace configuration with the same ID. Review the command, host, and replacements in the preview before confirming. Saving updates the current configuration without a restart. Existing remote processes do not stop or move to the new host.
New imports check the source, signature, signing permission, and target device. A successful export does not guarantee a later import. A device certificate intended only for HTTPS may lack permission to sign configuration packages. Ask the configuration provider to resolve this; do not disable verification.
After selecting delete, review the linked templates and rules. Choose an available replacement command, or unlink the affected configuration and disable its rules. See Chapter 12 for the steps. Deletion changes only the configuration in use; it does not update the other emergency copy.
Deleting configuration and stopping a remote service are separate operations. Deleting does not stop the service or undo completed operations. To end a remote task, stop it from “Background runs” and confirm the result.
“Automation” connects data and operations into repeatable workflows. Create data sources and action templates, then use rules to decide when to run them.
Sources read data, variables hold values, rules evaluate conditions, and templates define tasks. Showing a rule on the panel and allowing manual execution are separate settings. Automatic rules can also appear on the panel.
The top of the page shows the engine state, rule, variable, and source counts, trigger count, and runtime.
Control
Effect
“Start”
Starts a stopped engine. Enabled rules run only if the current configuration permits execution.
“Pause”
Pauses further automatic evaluation. Existing actions may continue. To resume through the page, stop the engine, then start it.
“Stop”
Attempts to stop rule checks, data reading, and scheduling later actions, while keeping configuration. Wait for confirmation; a timeout does not mean the engine has stopped.
“Reload”
Reads configuration again from the location in use. Save edits and check the result. An existing configuration pause remains in place.
Check whether cooling, alerts, or other ongoing tasks depend on Automation. Stopping the engine does not stop a remote background process. Stop remote tasks from “Background runs” and confirm the result.
“Disable automation” under “Configuration & backup” is separate from the engine's “Pause” control. If the configuration is paused, review it before selecting “Enable automation.” Restarting the device, reloading, or stopping and starting the engine does not clear this configuration pause. See Chapter 13.
Select “Add” under “Data Sources” and choose a type:
Type
Purpose
“REST API”
Periodically reads data from an HTTP address.
“WebSocket”
Receives data pushed over a persistent connection.
“Socket.IO”
Receives events from a Socket.IO service.
“Command Variable”
Reads the results of a configured remote command.
Enter a unique ID, display label, and the required connection information.
Use the test to check the connection. Obtain addresses, authentication details, and field information from the data provider.
For the first three types, select fields from the test response. Leaving a Socket.IO event name blank lets the test attempt event discovery.
For a Command Variable, select the host and a command with a configured variable name, then set the polling interval.
Check the enable switch in the form, save, and use “View Variables” on its row to check the result.
Source rows provide an enable switch, variable viewer, export, and delete controls. Check which rules use a source before disabling or deleting it, so you do not disrupt their tasks.
Import and export use configuration packages. Preview IDs, types, and replacements before import, and follow the Security Guide for source and trust requirements.
Select the eye-shaped “View Variables” icon on a source row. The window shows names, types, values, and update times. Remote-command variables can also be viewed from the command’s variable control.
Confirm the names and source, and check that values and types suit the rule’s comparisons.
Check whether update times match the expected data frequency.
If no data is available, check that the source is enabled, then test the connection and fields. For command variables, check the command’s execution result too.
Select “Add” under “Action Templates” and choose a task type:
Type
Purpose
“CLI Command”
Runs a local device-console command.
“SSH Command”
Runs a remote command saved on the Commands page.
“LED Control”
Controls LED colors, effects, or matrix content.
“Log”
Writes a message at the selected level.
“Set Variable”
Assigns a value to an Automation variable.
“Webhook”
The option remains visible, but action execution is not implemented. It cannot currently send a request.
Enter a unique ID, a name, and the type-specific parameters. Set a delay or “Async Execution” if needed. An asynchronous action continues in the background; check its final result through logs, variables, or the target device.
CLI: Enter the command, with an optional result variable and timeout.
SSH: Choose a configured host and command, and check the preview.
LED: Choose a device and supported color, effect, brightness, text, image, QR-code, or filter operation.
Log: Choose a level and message; the message can reference variables.
Set Variable: Enter the variable name and value.
Webhook: Currently unavailable. Choose a supported action instead. Rule packages containing Webhook actions cannot be imported either.
“Test” runs the action. Check the effect of power, reboot, remote-command, or external-request operations before testing. A queued message means the task was accepted, not that it succeeded. Check System Logs and the target device too.
After editing, save and check the parameters. If saving fails, keep the draft and correct the reported issue. Imports may replace templates; review the deletion impact before removing one. If an image or font is missing, insert the original SD card or select an available resource. The emergency backup does not save these files.
Deleting a rule, template, SSH command, or host can affect other configuration. Save an emergency backup first if you will need it. Deletion cannot be undone from the page.
Select delete in the relevant list. Review the target name and affected items.
Confirm deletion if there are no links. Otherwise, choose an available replacement or “Unlink and disable affected rules.”
Refresh the list afterward. Confirm removal and check the linked templates, rules, and enable states.
Unlinking a deleted template removes its action from affected rules and disables those rules. Deleting an SSH command leaves linked templates as disabled drafts with the command reference cleared; affected rules are unlinked and disabled. Before choosing a replacement, check its target and action, not just a similar name.
When deleting a host, also review affected commands and sources. A command without a host cannot run. Recreate needed commands under a valid host and update their links, then check them before use. Deleting local host configuration is separate from revoking a remote public key; see the Security Guide.
If ordinary deletion cannot complete, select “Force delete.” Read the explanation before confirming. It deletes the target, clears links it can identify, and disables affected rules. It does not stop remote background services.
If the full impact cannot be confirmed, the page asks you to check “I agree to pause automation and continue deleting.” Automation stays paused afterward. Review and repair the remaining configuration, then select “Enable automation” in “Configuration & backup.” Do not rely on a restart to resume it.
If configuration changes during confirmation, select “Review deletion impact,” review the new list, and confirm again. Force delete cannot guarantee completion when storage writes fail. Read the list again to check; a disappearing card does not prove the deletion was saved.
Select “Add” under “Rules” and enter a unique ID, name, and icon.
Choose “Logic”: AND requires all conditions; OR requires any condition.
Set the cooldown for automatic triggers. Values are in ms; 1000 ms is 1 second.
Add conditions and choose a variable, comparison, and value. Comparisons include equal, not equal, greater than, greater or equal, less than, less or equal, value changed, and contains. Match the value type to the variable.
Add templates and set any action delays, repetition, and action-level conditions.
Set “Show on panel” and “Allow manual trigger.” The first controls card visibility on System; the second controls manual execution.
Review, save, and then enable the rule. Leave “Enable immediately” off while configuring it for the first time.
Saving, enabling, or disabling a rule updates the current configuration without a restart. If Automation is paused, saving does not resume it. Refresh the list and check the result. Update the emergency backup after important changes, as described in Chapter 13.
Repeats while the action’s condition holds, up to 100 times per run.
“Fixed count”
Repeats for the configured count and interval, checking the action condition before each execution.
Action conditions are separate from rule-trigger conditions. Without an action condition, “Repeat while true” continues to the per-run limit. The rule may trigger another run later.
Disabling a rule prevents new triggers; a run already started may continue. To stop scheduling later actions, select the engine's “Stop” control and wait for confirmation. Check actions already sent and remote processes separately. Completed operations are not undone.
“Manual Trigger Only,” “Show on panel,” and “Allow manual trigger” control whether a rule runs only manually, whether its card is visible, and whether users may execute it.
Enter the ID, name, and icon, then enable “Manual Trigger Only.” Such a rule needs no automatic trigger conditions.
Add templates and review delays, repetition, and action conditions.
Enable “Show on panel” and “Allow manual trigger,” then save and enable the rule.
Return to the System Device Panel. Check the card’s name and state, run it once, and review the result.
Automatic rules can also appear on the panel. Showing a card does not make its rule manual-only. A disabled rule may remain visible but cannot start. Give admin-facing actions names that explain their effect, and tell users whom to contact to verify or stop background tasks. Root users view logs, verify, and stop services from “Background runs.”
Import rule packages on Automation, not through Security's “Verify Only” or file upload. This control checks the signer, target device, and required configuration. Verify each package through its own import control; another package's result does not apply.
Before importing, prepare:
Confirm whether the SD card or internal emergency configuration is in use, and that it can be saved. See Chapter 13.
The device has a valid certificate, its matching private key, and a CA chain; its time is verified. A CA chain checks certificate origins. See the Security Guide for installation steps.
The deployment administrator has selected a trusted signer. Root login or installing HTTPS certificates does not complete this setting. Ask the deployment administrator to configure it if it is missing.
The rule's templates, commands, and hosts are ready. Import does not install these for you. Add any missing configuration first. If the rule is enabled, also check the enable state of the configuration it uses.
Saving an import updates the current configuration without a restart. Before confirming, check the enable state, conditions, actions, and targets, and confirm that execution is safe. An existing configuration pause remains in place. To prevent execution, disable Automation first or ask the provider for a disabled version.
Select the import icon under “Rules” to open “Import Rule Configuration,” then choose the .tscfg file. Verification starts and the page displays a preview.
Wait for “Signing trust, target device and rule content verified.” Check the name, rule ID, and “Rule summary.” Expand “View rule content” to review conditions, actions, targets, and enable state; do not rely on the filename.
If the same ID exists, review what will be replaced. Select “Overwrite existing configuration” only if you intend to replace it. If the file, credentials, or configuration change after preview, select “Check package again.” Close and reopen the editor if the page asks you to, then verify again.
Select “Confirm Import” and wait for the save result. Check the rule list, enable state, and required variables. A successful save does not prove successful task execution.
If the rule permits a safe manual check, run it once and check the device or host. For other rules, watch the logs and results after a normal trigger. To clear a configuration pause, review the configuration before selecting “Enable automation.”
Imported rules can be edited, enabled, disabled, and deleted. Check the current configuration after edits and update the emergency backup if needed. A later import still requires signature verification; permission to edit locally does not bypass it.
A certificate intended only for HTTPS may not authorize configuration signing. A successful local export may still be rejected on import. Ask the provider to resolve the certificate-purpose issue; do not disable verification or repeat the import.
Imports and edits do not undo completed actions or stop remote background processes. End those tasks separately from “Background runs” and confirm the result.
Signing root not selected, signer untrusted, or signer unauthorized
Ask the deployment administrator or configuration provider to check the signing source and certificate permissions. Do not substitute Security's “Verify Only” or disable verification.
Package targets another device
Ask the provider to export it using this device's certificate; do not change the name inside the package. Arrange matching replacement packages before changing this device's certificate too.
Device time is unverified
Check and synchronize time under “Network & Time” on System, then verify the file again.
Configuration loading
Wait for it to finish, then verify the package again.
Configuration failed to load
Check System Logs, resolve the cause, and restore configuration before verifying again.
Required configuration missing
Add the template, command, or host named by the page, then verify again.
Required configuration disabled
Check whether it should be enabled. Once it is safe to run, enable it and verify again.
Unsupported action
Ask the provider to revise the package. Rule-package import currently rejects Webhook actions; their presence in the template selector does not mean the package can be imported.
File, credentials, or configuration changed after preview
Select “Check package again.” Reopen the editor or select the file as instructed, then review and confirm.
Check the location in “Configuration & backup.” Resolve the storage issue or reduce unneeded content, then verify again.
Current configuration or save location changed
Keep and copy the draft. Reopen the editor, review the latest configuration, and submit again. Do not keep selecting save.
Save outcome unconfirmed
Refresh and check the rule content and enable state. If still unclear, inspect System Logs. Keep the original package and do not repeat the import.
A condition variable without a sample is not necessarily missing configuration; check when it will update. If configuration cannot be read, keep the original files and check System Logs. Do not overwrite damaged content as though it were empty.
Manual execution requires an enabled rule that permits manual triggers, with no run of the same rule already in progress. It bypasses automatic trigger conditions and cooldown, but still applies action conditions, delays, and repetition.
Disabling does not undo completed actions. Deletion cannot be undone from the page.
Before editing sources, templates, or commands, check which rules use them. Configuration edits do not stop existing remote tasks. Verify and stop those tasks separately if needed.
Import each package through its relevant list and review the preview. See the Security Guide for full signature and account procedures.
If saving fails, read the message and retain the draft. If saving succeeded but refreshing failed, refresh and check the list before creating another item.
System settings such as networking, fans, temperature, and lighting
Saved inside the device. An Automation backup restore does not change them.
Current Automation configuration
Additions, edits, and deletions go to the SD card during normal SD use, or to internal storage in emergency mode.
Internal emergency backup
While using the SD card, it updates only when you select “Save emergency backup.” Emergency-mode edits update this internal configuration directly.
The emergency backup saves rules, action templates, SSH commands, associated hosts, sources, and initial definitions of user variables together. It does not save private keys, images, fonts, logs, or remote run states. Host settings only remember which key to use; the key itself is not copied.
This is not a full-device backup. Keep important files and keys through their own backup methods. A restore does not mean remote services have stopped or that every file needed by a rule is available.
Confirm that “Currently using” shows “SD card configuration,” then review the current rules and tasks.
Select “Save emergency backup” and wait for completion.
Check “Last internal save” and “Backup status.” “Includes the current changes” means the internal copy matches the current configuration.
Saving replaces the previous emergency backup. Later SD-card edits do not update it. If it does not include the latest changes, review the current content before deciding whether to save again.
While using “Internal emergency configuration,” edits are saved internally. You do not need to select “Save emergency backup” again.
A restore replaces the current SD-card configuration with the internal copy, which may be older. Export any current configuration and files you need first. Do not save an emergency backup first; that would overwrite the old copy you intend to restore.
While using the SD-card configuration, select “Restore emergency backup.”
Review added, changed, and removed items, and whether Automation will stay paused.
Confirm and wait for completion. The lists update without a device restart.
Check rules, hosts, variables, enable states, and task results. If still paused, review the configuration before selecting “Enable automation.”
A restore does not change networking, fans, or keys. It does not end running remote services. Manage them from “Background runs” if needed.
If a usable internal configuration exists, the device switches to it. Enabled automatic rules still follow their conditions; manual rules still need a click. The internal copy may be older, so check which tasks may run before a planned switch.
Emergency mode permits additions, edits, and deletions. Saves go directly to internal storage. If no usable internal configuration exists, read the reason first. You can start with a valid new configuration, but do not overwrite damaged files as though they were empty.
Networking, fans, and other system settings still load from internal storage. Emergency configuration does not restore SD-card images, fonts, or logs. Insert the original card or select available files if resources are missing. A missing card does not mean all functions stop, or that every task can continue.
Insert a usable SD card and select “Check SD card,” then review the two choices below. Insertion does not switch or merge configurations. Close the panel to keep using internal configuration. Restarting does not make the choice for you.
Button
What happens
“Use SD card configuration”
Reads and switches to the card's configuration. Internal configuration is kept, not copied to the card.
“Save current configuration to SD card and use it”
Replaces the card's configuration with the current internal configuration, then switches to the card. The old card configuration is overwritten.
Check the current location and decide which configuration to keep.
Select the relevant button and review the replacement and enable-state notice. Before writing to the card, check the added, changed, and removed items.
Confirm and wait. Check that “Currently using” shows “SD card configuration,” then review the lists and task results.
Missing or empty card configuration is not filled from internal storage automatically. Confirm that an empty configuration is what you want before choosing it. If the card or configuration changes after preview, check again as instructed; do not reuse the old confirmation.
Internal configuration is still in use. Select “Use SD card configuration” to finish switching. Do not overwrite the card again.
Configuration saved, Automation still paused
Review the configuration, then select “Enable automation.” Do not save again or rely on a restart to clear the pause.
Deletion not saved, Automation paused
Check whether the target is still present and storage is available. Repair and review the configuration before deciding whether to enable it.
Save outcome unconfirmed
Read the location and content again. Check System Logs if needed. Do not submit the same change again without checking.
Current input differs from the latest configuration
Copy any draft you need before closing and reopening the editor. Review the latest content and enter your edits. The page does not merge drafts for you.
After a successful switch, restore, or save, check whether tasks are allowed to run and whether they finish. A configuration pause remains in place; review and select “Enable automation” to resume. A pause caused by “Disable automation” or force deletion is not cleared by restarting or switching configurations.
빠른 작업 카드는 root 사용자가 설정합니다. 카드 표시와 수동 실행 허용은 별도의 설정입니다. 카드가 보여도 작업을 실행할 수 없는 경우가 있습니다.
카드 이름과 설명을 읽고 작업을 식별하세요.
카드를 선택하고 결과를 읽어보세요. 처리하는 동안 다시 시작하지 마십시오.
실행되거나 대기 중인 메시지에는 여전히 대상 장치 또는 작업에 대한 실제 결과 확인이 필요합니다.“Background runs”를 사용하여 로그를 확인하고 보거나 백그라운드 서비스를 중지합니다(11장).
시작할 수 없으면 표시된 이유에 따라 처리하세요. 시작 버튼을 반복해서 누르지 마세요:
규칙 비활성화 또는 수동 트리거링이 허용되지 않음: “Automation”(12장)의 규칙 설정을 확인하세요. 눈에 보이는 카드는 실행 권한이 없습니다.
작업 또는 백그라운드 작업이 진행 중입니다. 결과를 기다립니다. 다시 시작하지 마십시오.
작업에 대한 백그라운드 실행 기록이 이미 존재합니다. “Background runs”에서 원래 작업을 확인하고 다시 시작하기 전에 종료되었는지 확인하세요.
구성이 로드되지 않았거나 필수 항목이 누락되었거나 자동화가 일시 중지되었습니다. “Automation”의 구성 및 활성화 상태를 확인하십시오(12장 및 13장).
하나의 작업을 실행한 후 다른 작업을 시작하기 전에 몇 초 정도 기다리십시오. 페이지를 닫거나, 카드를 삭제하거나, TianshanOS를 다시 시작해도 원격 호스트의 백그라운드 서비스가 중지되지 않습니다.
재정렬 표시가 나타날 때까지 카드를 길게 누른 다음 끌어서 표시 순서를 변경합니다.
카드가 나타나지 않으면 설명을 읽어보세요. 구성이 로드되는 동안 기다리십시오. 로딩에 실패한 경우 원인을 유지하고 터미널에서 “System Logs”를 확인하세요. 빠른 작업이 구성되지 않은 경우 “Open Automation”를 선택하고 규칙의 “Show on panel” 설정을 확인하세요.
규칙을 편집하거나 가져오면 현재 구성이 업데이트됩니다. 규칙을 전환하기 위해 다시 시작할 필요는 없습니다. 카드의 작업이 변경된 경우 실행하기 전에 조건, 작업 및 대상을 검토하세요.
상태 표시줄에는 “유효 온도”와 “현재 출력”이 표시됩니다. 큰 백분율은 장치가 설정을 확인한 팬 조절값이며, 측정된 회전수가 아닙니다. RPM은 1분 동안의 실제 회전수입니다. 유효한 측정값이 없으면 표시되지 않습니다. 큰 표시가 --이면 현재 출력이 확인되지 않은 상태입니다.
수동 슬라이더를 움직이면 옆에 설정하려는 값이 표시됩니다. 큰 백분율은 현재 출력을 계속 보여줍니다. 슬라이더를 놓은 뒤 메시지와 갱신된 값을 확인하세요. 요청한 값과 현재 출력이 다르면 설정이 적용됐다고 판단하지 마세요.
스마트 모드는 “스마트 모드”, “곡선에 따라 작동”, 보호 상태, 유효하지 않은 온도 등의 상태를 표시합니다. 안전 기준 온도, 45초 후 예상 온도, 온도 변화 속도도 확인할 수 있습니다.
온도가 유효하지 않게 되면 소스가 계속 업데이트되고 있는지 확인하세요. 장치는 온도 손실에 대한 보호 제어로 전환됩니다. 스마트 열 제어에 대한 설명을 보려면 “TTI”를 선택하세요.
현재 상태를 가져오려면 섹션 헤더의 새로 고침 버튼을 사용하세요. 조정이 실패하거나 출력이 확인되지 않는 경우, 재시도 여부를 결정하기 전에 장치를 확인하십시오.
이 작업은 구성된 LPMU 호스트를 사용하여 네트워크 액세스를 설정합니다. 시작하기 전에 LPMU에 연결할 수 있고 네트워크 케이블이 연결되어 있는지 확인하세요. 해당 호스트의 SSH 계정에 대한 sudo 비밀번호를 얻습니다. 이 비밀번호는 시스템 변경을 승인하며 WebUI 비밀번호와 다를 수 있습니다.
"업스트림 네트워크 액세스"에서 "LPMU를 통한 액세스"를 선택합니다.
LPMU sudo 비밀번호를 입력하고 접속 버튼을 선택하세요. 비밀번호는 이 실행에만 사용되며 저장되지 않습니다. 나중에 실행하려면 다시 입력하세요.
작업이 완료될 때까지 기다립니다. 처리하는 동안 다시 시작하지 마십시오.
결과가 인터넷 연결과 완료된 네트워크 구성을 모두 보고하는 경우에만 액세스가 확인됩니다.
실패하거나 결과가 확인되지 않는 경우 먼저 이유를 읽어보세요. 자세한 내용을 보려면 "실행 로그"를 확장하세요. 비밀번호 오류가 있는 경우 비밀번호를 확인하고, 인터넷에 연결되지 않은 경우 케이블링 및 업스트림 네트워크를 확인하세요.
실패한 상태 요청은 스크립트가 중지되었음을 의미하지 않습니다. 다시 시도할지 여부를 결정하기 전에 사용 가능한 "새로 고침 상태" 컨트롤을 사용하여 현재 실행을 확인하십시오.
삭제는 WebUI에서 취소할 수 없습니다. 폴더를 삭제하면 해당 내용도 모두 삭제됩니다. "삭제" 또는 "일괄 삭제"를 선택하고 프롬프트를 승인하기 전에 이름과 경로를 확인하세요.
자동화로 관리되는 파일은 보호됩니다./sdcard/config/automation에 파일을 업로드하거나 덮어쓰거나 해당 폴더 또는 해당 폴더가 포함된 상위 폴더를 삭제하거나 이름을 바꾸는 것은 거부될 수 있습니다. 자동화가 파일을 관리한다는 메시지가 나타나면 자동화의 “Configuration & backup” 또는 관련 목록을 사용하십시오. 제한을 우회하기 위해 터미널을 사용하지 마십시오.
마운트 해제하면 SD 파일을 일시적으로 사용할 수 없게 됩니다. 업로드, 다운로드 및 기타 파일 작업을 마친 다음 “SD 마운트 해제”를 선택하세요.
카드를 마운트 해제하거나 교체하면 자동화가 내부 비상 구성으로 전환될 수 있습니다. 해당 복사본은 오래되었을 수 있으며 활성화된 자동 규칙이 계속 실행될 수 있습니다. 사용 가능한 사본이 없으면 자동화를 사용할 수 없습니다. 마운트 해제하기 전에 비상 구성 및 작업을 검토하십시오(13장). 카드 기반 이미지, 글꼴, 로그를 사용할 수 없게 됩니다.
SD 카드가 장착되지 않은 경우 페이지에 "SD 장착"이 표시됩니다. 이를 선택하고 상태가 "Mounted"로 변경될 때까지 기다린 다음 SD 카드 디렉터리를 다시 엽니다.
카드를 장착한다고 해서 자동화가 해당 구성으로 전환되었다는 의미는 아닙니다. 카드를 다시 삽입한 후 13장에 설명된 대로 사용할 구성을 선택하십시오. 아무것도 자동으로 덮어쓰거나 병합되지 않습니다.
0.6.2와 같은 이전 스토리지 레이아웃의 첫 번째 업그레이드에는 배포자가 승인한 호환 USB/시리얼 패키지가 필요합니다. 펌웨어 또는 WebUI만 업로드하면 이 업그레이드를 완료할 수 없습니다. 장치 관리자나 공급자에게 패키지 지침을 따르도록 요청하세요. 전체 플래시를 지우거나 오래된 파티션 테이블을 사용하지 마십시오.
중요한 파일을 저장하고 원래 SD 카드를 설치된 상태로 유지하십시오. 처음 시작하면 기존 구성이 마이그레이션됩니다. 전원을 연결해 두세요. 그런 다음 로그인, 네트워킹, 팬, 조명, SSH 호스트 및 자동화 규칙을 확인하세요. 전원을 제어하거나 장치를 다시 시작하거나 원격 명령을 실행하는 작업을 테스트하기 전에 규칙을 검토하세요.
일치하는 패키지는 두 애플리케이션 슬롯을 모두 업데이트합니다. 다른 슬롯에 여전히 이전 버전이 포함되어 있다고 가정하지 마십시오. root 비밀번호를 분실한 경우 0.6.3 레이아웃과 일치하도록 공급자가 확인한 복구 방법만 사용하세요. 이전 비밀번호 재설정 이미지를 플래시하지 마세요.
아래 웹 업데이트 방법은 게시자가 OTA에 대해 승인한 버전에만 적용됩니다. 첫 번째 레이아웃 업그레이드를 대체하지 않습니다.
페이지에서는 “Update Available” “Already up to date” 이전 서버 버전 또는 오류를 보고합니다.
대상 버전을 확인한 다음 “Upgrade Now” 또는 페이지에 표시된 업그레이드 제어를 선택하십시오.
다운로드, 설치, 재부팅이 완료될 때까지 기다립니다. 취소하려면 사용 가능한 경우 “Abort” 버튼을 사용하십시오. 모든 단계에서 취소가 지원되는 것은 아닙니다.
업그레이드 후 펌웨어를 확인하는 페이지를 기다립니다. WebUI에 다시 연결하여 “Current Version” 및 장치 상태를 확인하세요.
“Upgrade Progress”는 자체 섹션에 현재 단계를 표시합니다.100% 읽거나 파일이 작성되었다는 메시지는 재시작 및 버전 확인이 완료되었음을 확인하지 않습니다. 결과가 확인되지 않거나 실행 중인 펌웨어가 대상과 다른 경우 메시지를 유지하고 현재 버전을 확인하십시오. 확인하지 않고 업그레이드를 반복하지 마십시오. 시스템 로그를 확인하고 필요한 경우 공급자에게 문의하세요.
“Also upgrade www”가 활성화되면 펌웨어와 WebUI가 순차적으로 업데이트됩니다. 동일한 릴리스의 일치하는 펌웨어 및 WebUI 리소스를 사용하십시오. 업그레이드 후에도 이전 인터페이스가 남아 있는 경우 브라우저를 강제 새로 고침한 후 버전과 페이지를 다시 확인하세요.
"URL에서 업그레이드": 펌웨어 URL을 입력하고 릴리스 지침에 따라 "www도 업그레이드"를 설정한 다음 "업그레이드"를 선택합니다. 여기서 www는 장치의 웹 인터페이스 리소스를 나타냅니다.
"SD 카드에서 업그레이드": /sdcard/firmware.bin와 같은 펌웨어 경로를 입력합니다. "www도 업그레이드"가 활성화된 경우 동일한 릴리스의 www.bin가 해당 디렉터리에 있는지 확인하십시오.
URL에서 업그레이드하는 경우 "인증서 확인 건너뛰기"는 HTTPS 서버 인증서 확인을 건너뜁니다. 그러면 다운로드 서버의 신원을 확인하는 데 사용되는 인증서 검사가 제거됩니다. 정기적인 업데이트를 위해서는 선택하지 않은 상태로 두세요. 인증서 오류가 표시되면 관리자에게 서버 주소와 인증서를 확인하도록 요청하세요.
빨간색 필드 오류는 수정해야 할 사항을 알려줍니다. 수정한 후 저장하세요. 오류 표시가 지워졌다고 해서 성공적으로 저장되었다는 의미는 아닙니다. 메시지와 목록을 확인하세요.
어떤 작업이 실패했는지 확인한 뒤 이유와 다음 조치를 읽으세요. 이유가 표시되지 않으면 추측하지 마세요.
사용 가능한 경우 “Details”를 선택합니다. 세부정보를 숨기려면 “Hide”를 선택하세요. × 버튼이 표시되면 이를 선택하여 메시지를 닫습니다. 추가 확인을 위해 메시지와 세부 정보를 기록해 둔 다음 터미널에서 “System Logs”를 열어 조사하세요.
결과가 확인되지 않으면 새로고침하고 장치·파일·작업 상태를 확인하세요. 시간 초과나 연결 끊김은 작업이 실행되지 않았다는 뜻이 아닙니다. 전원 제어·삭제·작업 시작·업그레이드를 곧바로 반복하지 마세요. 계속 확인할 수 없으면 “터미널”의 “시스템 로그”에서 원인을 확인하세요.
성공, 실패, 미확인 배치 결과를 별도로 확인하세요. 브라우저의 다운로드 목록에서 저장된 파일을 확인하세요.
명령줄 확인의 경우 auto --config status를 입력하여 현재 구성 위치와 백업 상태를 확인합니다. 사용 가능한 옵션은 auto --help를 사용하세요. 이전 config --sync 옵션이 제거되었습니다. 일상적인 백업 및 복구를 위해서는 13장의 웹 단계를 사용하십시오.
지문은 연결 대상 호스트를 확인하는 데 쓰입니다. 이 절차는 웹 “보안” 페이지의 SSH 호스트 테스트에 해당하며, 터미널 SSH Shell의 확인 절차가 아닙니다. 지문이 등록되지 않았거나 바뀌었다는 메시지가 나오면 명령을 반복 실행하지 마세요. “보안”에서 대상 SSH 호스트를 찾아 “테스트”를 선택하세요.
처음 연결할 때 확인 창에 호스트 주소와 지문이 표시됩니다. 신뢰할 수 있는 경로로 호스트 관리자에게 확인하세요. 일치하는 것을 확인한 뒤에만 “신뢰하고 연결”을 선택하세요.
지문이 바뀌면 저장된 지문과 현재 지문이 함께 표시되며, 기본으로 “취소”가 선택됩니다. 호스트를 재설치하면 지문이 바뀔 수 있지만, 다른 호스트에 연결됐거나 누군가 호스트를 사칭하는 경우도 있습니다.
주소를 확인하고 신뢰할 수 있는 경로로 변경 이유를 확인하세요. 확인할 수 없으면 “취소”를 선택하세요. 확인을 건너뛰려고 기존 지문을 삭제하지 마세요. 새 지문을 신뢰할 수 있다고 확인한 뒤에만 “호스트 키 업데이트”를 선택하세요.
nohup은 SSH 연결이 닫힌 후에도 명령이 원격 호스트의 백그라운드에서 계속 실행됨을 의미합니다. WebUI를 닫아도 백그라운드 작업은 중지되지 않습니다.
백그라운드 실행에는 SSH 키 인증이 필요합니다.“Security”에 공개 키를 배포한 다음 연결된 호스트를 선택합니다. 백그라운드 명령에 일반 텍스트 비밀번호를 저장하지 마세요. 원래 작업을 중지하거나 확인하려면 동일한 키를 계속 사용할 수 있어야 합니다.
“Run in background (nohup)”를 활성화하고 명령을 실행한 후 명령에서 “Background runs”를 선택합니다. 시스템의 root 전용 컨트롤과 자동화의 컨트롤은 동일한 목록을 엽니다.
이름, 사용자, 호스트 주소 및 포트로 원래 작업을 찾으십시오.
원래 호스트에서 이 실행을 확인하려면 “Verify remote state”를 선택합니다.“Refresh”는 알려진 레코드만 읽습니다. 이는 확인을 대체하지 않습니다.
원래 호스트에서 마지막 100줄을 읽으려면 “View Log”를 선택합니다. 업데이트하려면 “Follow log”를 선택하세요.“Stop following”는 페이지 업데이트만 중지합니다.
작업을 종료하려면 해당 기록에서 “Stop”를 선택하고 확인하세요. 결과를 기다린 후 중지되었는지 확인하십시오. 확인하지 않고 다시 시작하지 마십시오.
기기를 다시 시작하면 이전 기록에 “Not checked”가 표시됩니다. “Remote state unconfirmed”는 중지 여부나 실행 여부가 확인되지 않았다는 뜻입니다. “Last result”는 마지막으로 확인된 결과이며 현재 상태를 보장하지 않습니다.
읽기 실패는 로그가 비어 있거나 프로세스가 종료되었음을 의미하지 않습니다. 원래 호스트 연결, 로그 경로, SSH 키를 확인하세요. 문제를 해결한 후 다시 확인하세요. 상태 확인이 실패했다는 이유만으로 작업을 다시 시작하지 마세요.
명령을 삭제하거나 호스트 구성을 변경하거나 자동화 구성을 전환해도 원격 프로세스는 종료되지 않습니다.“Background runs”에서 원래 작업을 관리합니다. 동일한 이름이나 ID를 가진 명령을 다시 생성해도 원래 작업이 이어지지 않습니다. 제어하는 데 필요한 키는 그대로 유지하세요.
"서비스 모드"는 사용 가능해질 때까지 백그라운드 작업을 감시합니다. "Ready match" 및 "Variable Name"을 제공합니다. 필요에 따라 선택적 오류 패턴 및 타이밍 설정을 조정합니다.
“Ready match”: 구성된 텍스트가 나타날 때 서비스가 준비된 것으로 표시합니다. 여러 패턴을 분리하려면 |를 사용하세요.
"실패 일치": 구성된 텍스트가 나타날 때 서비스가 실패했다고 표시합니다.
"준비 시간 초과(초)": 준비 상태에 대한 가장 긴 대기 시간(초)을 설정합니다.
"확인 간격(ms)": 로그 확인 빈도를 밀리초 단위로 설정합니다. 1000 ms는 1초입니다.
"변수 이름": 확인, 준비 및 시간 초과와 같은 상태를 저장합니다.
서비스 모드 작업은 시작, 확인, 중지 또는 확인되지 않을 수 있습니다. 요청이 수락된 후 최종 결과를 기다립니다. 백그라운드 실행 기록이 이미 존재하는 경우 원래 실행을 확인하고 다시 시작하기 전에 종료되었는지 확인하세요. 활성화된 자동 규칙으로 인해 서비스가 다시 시작될 수 있습니다. 서비스를 중지 상태로 유지해야 하는 경우 먼저 해당 규칙을 비활성화하세요.
“Import Command” 선택 .tscfg 구성 패키지를 선택하고 해당 내용을 미리 본 후 기존 구성을 덮어쓸지 여부를 결정합니다.
가져오기에는 원격 호스트가 포함될 수 있으며 구성을 동일한 ID로 바꿀 수 있습니다. 확인하기 전에 미리보기에서 명령, 호스트 및 대체 항목을 검토하세요. 저장하면 다시 시작하지 않고도 현재 구성이 업데이트됩니다. 기존 원격 프로세스는 중지되거나 새 호스트로 이동되지 않습니다.
새로운 가져오기는 소스, 서명, 서명 권한 및 대상 장치를 확인합니다. 성공적인 내보내기가 나중에 가져오기를 보장하지는 않습니다. HTTPS 전용 장치 인증서에는 구성 패키지에 서명할 수 있는 권한이 부족할 수 있습니다. 이 문제를 해결하려면 구성 공급자에게 문의하세요. 확인을 비활성화하지 마십시오.
정지된 엔진을 시동합니다. 활성화된 규칙은 현재 구성이 실행을 허용하는 경우에만 실행됩니다.
“Pause”
추가 자동 평가를 일시 중지합니다. 기존 작업이 계속될 수 있습니다. 페이지를 계속 진행하려면 엔진을 멈췄다가 다시 시작하세요.
“Stop”
구성을 유지하면서 규칙 확인, 데이터 읽기 및 이후 작업 예약을 중지하려고 시도합니다. 확인을 기다리십시오. 시간 초과가 엔진이 정지했다는 의미는 아닙니다.
“Reload”
사용 중인 위치에서 구성을 다시 읽습니다. 편집 내용을 저장하고 결과를 확인하세요. 기존 구성 일시 중지는 그대로 유지됩니다.
냉각, 경고 또는 기타 진행 중인 작업이 자동화에 의존하는지 확인하세요. 엔진을 중지해도 원격 백그라운드 프로세스는 중지되지 않습니다.“Background runs”에서 원격 작업을 중지하고 결과를 확인합니다.
“Configuration & backup” 아래의 “Disable automation”는 엔진의 “Pause” 제어와 별개입니다. 구성이 일시 중지된 경우 “Enable automation”를 선택하기 전에 검토하십시오. 장치를 다시 시작하거나 다시 로드하거나 엔진을 중지하고 시작해도 이 구성 일시 중지가 지워지지 않습니다.13장을 참조하세요.
규칙, 템플릿, SSH 명령 또는 호스트를 삭제하면 다른 구성에 영향을 미칠 수 있습니다. 필요한 경우 먼저 응급 백업을 저장하십시오. 페이지에서 삭제를 취소할 수 없습니다.
해당 목록에서 삭제를 선택하세요. 대상 이름과 영향을 받는 항목을 검토하세요.
링크가 없으면 삭제를 확인하세요. 그렇지 않으면 사용 가능한 대체품 또는 “Unlink and disable affected rules”를 선택하세요.
나중에 목록을 새로 고치세요. 제거를 확인하고 연결된 템플릿, 규칙 및 활성화 상태를 확인하세요.
삭제된 템플릿의 연결을 해제하면 영향을 받는 규칙에서 해당 작업이 제거되고 해당 규칙이 비활성화됩니다. SSH 명령을 삭제하면 연결된 템플릿이 명령 참조가 지워진 비활성화된 초안으로 남습니다. 영향을 받는 규칙은 연결이 해제되고 비활성화됩니다. 대체품을 선택하기 전에 단순히 유사한 이름만 확인하지 말고 대상과 동작을 확인하세요.
호스트를 삭제할 때 영향을 받는 명령과 소스도 검토하세요. 호스트가 없는 명령은 실행할 수 없습니다. 유효한 호스트에서 필요한 명령을 다시 생성하고 해당 링크를 업데이트한 다음 사용하기 전에 확인하십시오. 로컬 호스트 구성을 삭제하는 것은 원격 공개 키를 취소하는 것과 별개입니다. 보안 가이드를 참조하세요.
일반 삭제를 완료할 수 없으면 “Force delete”를 선택하고 설명을 읽은 후 확인하세요. 대상이 삭제되고 확인 가능한 연결이 해제되며 영향을 받는 규칙이 비활성화됩니다. 원격 백그라운드 서비스는 중지되지 않습니다.
영향 범위 전체를 확인할 수 없으면 “I agree to pause automation and continue deleting”에 동의하도록 요청합니다. 삭제 후에도 자동화는 일시 중지된 상태로 유지됩니다. 남은 설정을 검토하고 복구한 다음 “Configuration & backup”에서 “Enable automation”을 선택하세요. 재시작으로 일시 중지를 해제할 수는 없습니다.
확인하는 동안 설정이 변경되면 “Review deletion impact”를 선택하고 새 목록을 검토한 후 다시 확인하세요. 저장소 쓰기에 실패하면 강제 삭제가 완료된다고 보장할 수 없습니다. 목록을 다시 확인하세요. 카드가 사라졌다고 해서 삭제가 저장된 것은 아닙니다.
“Logic”을 선택합니다. AND는 모든 조건을 충족해야 하고, OR는 하나 이상의 조건을 충족하면 됩니다.
자동 트리거의 쿨다운을 설정합니다. 값은 ms 단위입니다. 1000 ms는 1초입니다.
조건을 추가하고 변수, 비교 및 값을 선택합니다. 비교에는 같음, 같지 않음, 초과, 크거나 같음, 미만, 작거나 같음, 변경된 값 및 포함이 포함됩니다. 값 유형을 변수와 일치시킵니다.
템플릿을 추가하고 작업 지연, 반복 및 작업 수준 조건을 설정합니다.
"패널에 표시" 및 "수동 트리거 허용"을 설정합니다. 첫 번째는 시스템의 카드 가시성을 제어합니다. 두 번째는 수동 실행을 제어합니다.
규칙을 검토하고 저장한 후 활성화합니다. 처음 구성하는 동안 "즉시 활성화"를 꺼진 상태로 두십시오.
규칙을 저장, 활성화 또는 비활성화하면 다시 시작하지 않고도 현재 구성이 업데이트됩니다. 자동화가 일시 중지되면 저장이 재개되지 않습니다. 목록을 새로 고치고 결과를 확인하세요.13장에 설명된 대로 중요한 변경 후 비상 백업을 업데이트합니다.
최대 64개의 규칙을 저장할 수 있습니다. 이는 64개의 작업이 동시에 실행될 수 있다는 것을 보장하지 않습니다. 명령 길이와 조건 및 작업의 수 역시 저장 공간과 메모리에 영향을 미칩니다. 용량이 부족할 경우 불필요한 구성을 제거하거나 내용을 줄여 저장하세요.
선택한 유형에 값을 일치시킵니다. 숫자의 경우 무한대나 NaN(잘못된 숫자)이 아닌 특정 값을 입력하세요. 다른 유형의 경우 텍스트, 부울(true 또는 false) 또는 null을 입력하십시오. 전체 JSON 개체나 배열을 입력하지 마세요. 페이지에 오류가 보고되면 다시 저장하기 전에 변수, 비교, 값을 확인하세요.
"수동 트리거만", "패널에 표시" 및 "수동 트리거 허용"은 규칙이 수동으로만 실행되는지, 해당 카드가 표시되는지, 사용자가 규칙을 실행할 수 있는지 여부를 제어합니다.
ID, 이름, 아이콘을 입력한 후 "수동 트리거 전용"을 활성화합니다. 이러한 규칙에는 자동 트리거 조건이 필요하지 않습니다.
템플릿을 추가하고 지연, 반복 및 작업 조건을 검토합니다.
"패널에 표시" 및 "수동 트리거 허용"을 활성화한 다음 규칙을 저장하고 활성화합니다.
시스템 장치 패널로 돌아갑니다. 카드의 이름과 상태를 확인하고 한 번 실행한 후 결과를 검토해 보세요.
패널에 자동 규칙이 나타날 수도 있습니다. 카드를 표시한다고 해서 해당 규칙이 수동 전용이 되는 것은 아닙니다. 비활성화된 규칙은 계속 표시될 수 있지만 시작할 수는 없습니다. 효과를 설명하는 admin 관련 작업 이름을 제공하고 사용자에게 백그라운드 작업을 확인하거나 중지하기 위해 연락할 사람을 알려줍니다. Root 사용자는 “Background runs”에서 로그를 보고, 확인하고, 서비스를 중지합니다.
Security의 “Verify Only” 또는 파일 업로드를 통하지 않고 자동화에서 규칙 패키지를 가져옵니다. 이 컨트롤은 서명자, 대상 장치 및 필수 구성을 확인합니다. 자체 가져오기 제어를 통해 각 패키지를 확인합니다. 다른 패키지의 결과는 적용되지 않습니다.
가져오기 전에 다음을 준비하십시오.
SD 카드 또는 내부 비상 구성이 사용 중인지, 저장할 수 있는지 확인하세요.13장을 참조하세요.
장치에는 유효한 인증서, 일치하는 개인 키 및 CA 체인이 있습니다. 시간이 확인되었습니다. CA 체인은 인증서 출처를 확인합니다. 설치 단계는 보안 가이드를 참조하세요.
배포 관리자가 신뢰할 수 있는 서명자를 선택했습니다. Root 로그인 또는 HTTPS 인증서 설치로는 이 설정이 완료되지 않습니다. 누락된 경우 배포 관리자에게 구성을 요청하세요.
규칙의 템플릿, 명령 및 호스트가 준비되었습니다. 가져오기는 이러한 항목을 설치하지 않습니다. 누락된 구성을 먼저 추가하세요. 규칙이 활성화된 경우 규칙이 사용하는 구성의 활성화 상태도 확인하세요.
가져오기를 저장하면 다시 시작하지 않고도 현재 구성이 업데이트됩니다. 확인하기 전에 활성화 상태, 조건, 동작 및 대상을 확인하고 실행이 안전한지 확인하십시오. 기존 구성 일시 중지는 그대로 유지됩니다. 실행을 방지하려면 먼저 자동화를 비활성화하거나 공급자에게 비활성화된 버전을 요청하세요.
“Rules” 아래의 가져오기 아이콘을 선택하여 “Import Rule Configuration”를 연 다음 .tscfg 파일을 선택합니다. 확인이 시작되고 페이지에 미리보기가 표시됩니다.
“Signing trust, target device and rule content verified”를 기다립니다. 이름, 규칙 ID 및 “Rule summary”를 확인합니다. “View rule content”를 확장하여 조건, 작업, 대상 및 활성화 상태를 검토합니다. 파일 이름에 의존하지 마십시오.
동일한 ID가 존재하는 경우 무엇을 대체할지 검토하세요. 교체하려는 경우에만 “Overwrite existing configuration”를 선택하십시오. 미리보기 후 파일, 자격 증명 또는 구성이 변경되면 “Check package again”를 선택하고 페이지에서 메시지가 표시되면 편집기를 다시 열고 다시 확인하세요.
“Confirm Import”를 선택하고 저장 결과를 기다립니다. 규칙 목록, 활성화 상태, 필수 변수를 확인하세요. 성공적인 저장이 성공적인 작업 실행을 증명하지는 않습니다.
규칙이 안전한 수동 검사를 허용하는 경우 한 번 실행하고 장치나 호스트를 확인하십시오. 다른 규칙의 경우 일반 트리거 후 로그와 결과를 살펴보세요. 구성 일시 중지를 지우려면 “Enable automation”를 선택하기 전에 구성을 검토하십시오.
가져온 규칙은 편집, 활성화, 비활성화 및 삭제할 수 있습니다. 편집 후 현재 구성을 확인하고 필요한 경우 긴급 백업을 업데이트하세요. 나중에 가져오려면 여전히 서명 확인이 필요합니다. 로컬에서 편집할 수 있는 권한은 이를 우회하지 않습니다.
HTTPS 전용 인증서는 구성 서명을 승인하지 않을 수 있습니다. 성공적인 현지 수출이 수입 시 거부될 수 있습니다. 공급자에게 인증서 목적 문제를 해결하도록 요청하세요. 확인을 비활성화하거나 가져오기를 반복하지 마십시오.
가져오기 및 편집은 완료된 작업을 실행 취소하거나 원격 백그라운드 프로세스를 중지하지 않습니다.“Background runs”와 별도로 해당 작업을 종료하고 결과를 확인하십시오.
사용 가능한 내부 구성이 있으면 장치가 해당 구성으로 전환됩니다. 활성화된 자동 규칙은 여전히 해당 조건을 따릅니다. 수동 규칙에는 여전히 클릭이 필요합니다. 내부 복사본은 오래되었을 수 있으므로 계획된 전환 전에 어떤 작업이 실행될 수 있는지 확인하세요.
비상 모드에서는 추가, 편집 및 삭제가 허용됩니다. 저장 내용은 내부 저장소로 직접 이동됩니다. 사용 가능한 내부 구성이 없으면 먼저 이유를 읽어보십시오. 유효한 새 구성으로 시작할 수 있지만 손상된 파일이 비어 있는 것처럼 덮어쓰지 마십시오.
네트워킹, 팬 및 기타 시스템 설정은 여전히 내부 저장소에서 로드됩니다. 긴급 구성은 SD 카드 이미지, 글꼴 또는 로그를 복원하지 않습니다. 원본 카드를 삽입하거나 리소스가 누락된 경우 사용 가능한 파일을 선택하세요. 카드가 없어졌다고 해서 모든 기능이 정지되거나 모든 작업이 계속될 수 있다는 의미는 아닙니다.
내부 구성이 아직 사용 중입니다. 전환을 완료하려면 “Use SD card configuration”를 선택하세요. 카드를 다시 덮어쓰지 마십시오.
설정은 저장되었지만 자동화는 여전히 일시 중지됨
설정을 검토한 다음 “Enable automation”을 선택하세요. 다시 저장하거나 재시작으로 일시 중지를 해제하려 하지 마세요.
삭제 내용이 저장되지 않았으며 자동화가 일시중지되었습니다.
대상이 여전히 존재하고 스토리지를 사용할 수 있는지 확인하십시오. 활성화 여부를 결정하기 전에 구성을 복구하고 검토하십시오.
확인되지 않은 결과 저장
위치와 내용을 다시 읽어보세요. 필요한 경우 시스템 로그를 확인하세요. 확인하지 않고 동일한 변경사항을 다시 제출하지 마세요.
현재 입력이 최신 구성과 다릅니다.
편집기를 닫았다가 다시 열기 전에 필요한 초안을 복사하세요. 최신 콘텐츠를 검토하고 수정사항을 입력하세요. 페이지에서는 초안을 병합하지 않습니다.
성공적인 전환, 복원 또는 저장 후에는 작업 실행이 허용되는지와 작업이 완료되는지 확인하세요. 구성 일시 중지가 그대로 유지됩니다. 검토하고 “Enable automation”를 선택하여 재개하세요.“Disable automation”로 인한 일시 중지 또는 강제 삭제는 구성을 다시 시작하거나 전환해도 지워지지 않습니다.
Esta guía está basada en TianshanOS 0.6.3. Para otras versiones, consulte las instrucciones específicas de la versión correspondiente.
Esta guía cubre las funciones de rutina en la Parte I y el acceso al terminal, los comandos remotos, la automatización y la copia de seguridad de la configuración en la Parte II. Las operaciones Root pueden afectar el dispositivo y los hosts remotos; Verifique las tareas objetivo y activas antes de continuar. Consulte la Guía de seguridad separada para conocer la gestión de la seguridad.
Utilice los controles que se muestran en su dispositivo. Algunos necesitan hardware o configuración específicos. En una computadora, coloque el cursor sobre un botón con un ícono para ver su nombre. En un teléfono, deslícese dentro de una tabla amplia para ver sus otras columnas.
Abra la interfaz web del dispositivo (WebUI) utilizando la dirección proporcionada por su administrador.
Seleccione "Iniciar sesión" en la esquina superior derecha.
Ingrese root y la contraseña root proporcionada con el dispositivo.
Seleccione "Iniciar sesión". Después de iniciar sesión correctamente, el nombre de usuario actual aparece en la esquina superior derecha.
Al iniciar sesión con la contraseña predeterminada se abre un "Recordatorio de seguridad". Ingrese la contraseña actual, luego ingrese la nueva contraseña dos veces y seleccione "Cambiar ahora". Ambas entradas de nueva contraseña deben coincidir. Seleccione "Más tarde" para cerrar el recordatorio.
Cuando haya terminado, seleccione "Cerrar sesión" en la esquina superior derecha. Deberá iniciar sesión nuevamente para usar el dispositivo.
Seleccione el botón de idioma en la parte superior de la página, luego elija chino o inglés. El contenido de la página y las etiquetas de control cambian inmediatamente.
«Vista general del sistema» muestra el chip, la versión del firmware, la versión de ESP-IDF y el tiempo de funcionamiento. Para el uso diario, compruebe la versión del firmware. ESP-IDF es el marco de software que utiliza el dispositivo.
El lado derecho de la tarjeta muestra el voltaje de entrada, el voltaje interno, la corriente, la potencia y el estado de protección.
Las configuraciones del sistema, como redes, ventiladores, temperatura e iluminación, se guardan dentro del dispositivo. Insertar una tarjeta SD antigua no los restaura. La configuración de la automatización se gestiona por separado; su copia de seguridad de emergencia no es una copia de seguridad completa del dispositivo.
El interruptor al lado del estado de protección habilita o deshabilita la protección de bajo voltaje. Cuando está habilitado, el dispositivo utiliza los voltajes y retrasos guardados para apagarse a bajo voltaje y reiniciarse después de que se recupera la energía.
Un reinicio interrumpe temporalmente la WebUI y la administración del dispositivo. Finalice las operaciones activas, luego seleccione "Reiniciar" y confirme. Espere a que el dispositivo se recupere y luego vuelva a abrir la WebUI.
Reiniciar un servicio interrumpe temporalmente la función que proporciona. Abra "Estado del servicio", busque el servicio afectado y seleccione "Reiniciar" en esa fila. Verifique su estado nuevamente cuando finalice la operación.
Estas configuraciones controlan cuándo el dispositivo se apaga después de una caída de voltaje y cuándo se reinicia después de que se recupera la energía. Utilice valores que coincidan con los requisitos de energía de su dispositivo.
Seleccione "Configuración de apagado" para cambiar:
“Umbral de Bajo Voltaje”: Inicia la cuenta regresiva de apagado por debajo de este voltaje.
“Umbral de voltaje de recuperación”: Inicia la recuperación por encima de este voltaje.
“Cuenta regresiva de apagado”: establece el retraso antes del apagado después de que se detecta bajo voltaje.
“Tiempo de espera de recuperación”: establece el tiempo de espera utilizado para confirmar la recuperación de energía estable.
“Retraso de parada del ventilador”: establece el retraso antes de que los ventiladores se detengan después del apagado.
Guarde el formulario para aplicar la configuración de protección actualizada.
Cambiar el objetivo USB puede desconectar temporalmente un dispositivo conectado. Confirme el objetivo y finalice el trabajo activo antes de continuar.
Los dispositivos que admiten la conmutación USB muestran un botón "USB". Cada clic cambia el puerto USB superior al siguiente destino: ESP, AGX y luego LPMU. Verifique el objetivo que se muestra en el botón y el mensaje de la página para confirmar el resultado.
Guarde el trabajo en el módulo y complete su proceso de apagado normal antes de desconectar la alimentación. El apagado forzado puede provocar la pérdida de datos no guardados.
“AGX Power” muestra el estado de control de energía. Selecciónelo para encender o apagar, luego espere la confirmación.
“LPMU Power” muestra “En línea”, “Fuera de línea” o “Desconocido”. Estos estados provienen de una verificación de red. En línea significa que se puede acceder al módulo; fuera de línea significa que no lo es. Ninguno de los estados por sí solo confirma si el módulo está encendido o apagado.
Seleccionar el botón LPMU desencadena la misma acción que presionar su botón de encendido físico. Espere la verificación y el resultado mostrado. Si desconoce el resultado, verifique el módulo y la red antes de presionar el botón nuevamente.
Un usuario root configura las tarjetas de acciones rápidas. Mostrar una tarjeta y permitir su ejecución manual son ajustes distintos. Una tarjeta visible puede no permitir iniciar la tarea.
Lea el nombre de la tarjeta y la descripción para identificar la tarea.
Selecciona la tarjeta y lee el resultado. No lo inicie nuevamente mientras procesa.
Un mensaje ejecutado o en cola aún necesita una verificación de resultados real en el dispositivo o tarea de destino. Utilice “Background runs” para verificar, ver registros o detener un servicio en segundo plano (Capítulo 11).
Si no puede iniciar la tarea, siga las indicaciones del mensaje. No pulse Inicio repetidamente:
Regla deshabilitada o activación manual no permitida: verifique la configuración de la regla en “Automation” (Capítulo 12). Una tarjeta visible no es permiso para ejecutarla.
Una tarea u operación en segundo plano está en progreso: espere su resultado. No lo empieces de nuevo.
Ya existe un registro de ejecución en segundo plano para la tarea: verifique la tarea original en “Background runs” y confirme que finalizó antes de comenzar de nuevo.
Configuración no cargada, falta un elemento requerido o Automatización en pausa: verifique la configuración y habilite el estado en “Automation” (Capítulos 12 y 13).
Mantenga presionada una tarjeta hasta que aparezca el indicador de reorden, luego arrástrela para cambiar el orden de visualización.
Si no aparecen tarjetas, lea la explicación. Espere si se está cargando la configuración. Si la carga falla, conserve el motivo y verifique “System Logs” en la Terminal. Si no hay acciones rápidas configuradas, seleccione “Open Automation” y verifique la configuración “Show on panel” de las reglas.
No reinicie un dispositivo que proporciona servicios activos solo para restaurar una tarjeta.
Los widgets de datos muestran los datos del dispositivo en el «Panel de dispositivos» y los actualizan durante el uso.
Seleccione "Administrador de widgets".
Elija un intervalo de actualización o desactive la actualización automática.
Agregue un widget preestablecido o elija un estilo de componente y fuente de datos ofrecidos por la página.
Edite su etiqueta, estilo de visualización y unidad según sea necesario y luego guárdelo.
Los widgets existentes se pueden editar, eliminar y reordenar. También puede seleccionar una tarjeta de widget para editarla. Mantenga presionado un widget y luego arrástrelo a una nueva posición.
La barra de estado muestra «Temperatura efectiva» y «Salida actual». El porcentaje grande es el ajuste de regulación confirmado por el dispositivo, no la velocidad medida. RPM indica las revoluciones por minuto medidas y no aparece si no hay una lectura válida. Si el porcentaje muestra --, la salida actual no está confirmada.
Al mover el deslizador manual, el valor situado a su lado muestra el ajuste que va a solicitar. El porcentaje grande sigue mostrando la salida actual. Suelte el deslizador y compruebe el mensaje y el valor actualizado. Si el valor solicitado no coincide con la salida actual, no dé el ajuste por aplicado.
El modo inteligente muestra su estado: «Modo inteligente», «Siguiendo la curva», protección o temperatura no válida. También muestra la temperatura de referencia de seguridad, la prevista dentro de 45 segundos y la velocidad de cambio de temperatura.
Si la temperatura deja de ser válida, verifique que su fuente aún se esté actualizando. El dispositivo cambia al control de protección en caso de pérdida de temperatura. Seleccione “TTI” para obtener una explicación del control térmico inteligente.
Utilice el botón de actualización en el encabezado de la sección para obtener el estado actual. Si el ajuste falla o la salida no está confirmada, verifique el dispositivo antes de decidir si desea volver a intentarlo.
Utiliza un porcentaje de control fijo establecido con el control deslizante 0-100%.
“Curva”
Sigue la curva de porcentaje de temperatura a control configurada.
“inteligente”
Utiliza la curva base, las tendencias de temperatura y los ajustes anteriores para controlar el enfriamiento. Utiliza control protector cuando es necesario.
Detener un ventilador o establecer un valor manual bajo reduce la refrigeración. Primero verifique la carga y la temperatura y siga monitoreándolas. El control deslizante solo está disponible en el modo Manual cuando se confirma la salida actual.
Seleccione "Curva" en el encabezado de la sección Control del ventilador para abrir "Gestión de la curva del ventilador". El botón “Curva” dentro de una tarjeta solo cambia el modo de funcionamiento.
En "Ventilador", elija el número que desea ajustar y compárelo con la página Sistema.
En “Enlace de variable de temperatura”, agregue variables de temperatura y asigne pesos.
Seleccione "Enlazar". La fuente de temperatura es compartida por los ventiladores en los modos Curva e Inteligente, por lo que cambiarla afecta a los ventiladores que usan esa fuente.
Agregue o edite “Nodos de curva”. Cada curva necesita al menos nodos 2 y admite hasta 10.
Establezca “Velocidad mínima” y “Velocidad máxima” como porcentajes de control. El mínimo no debe exceder el máximo.
Ajuste «Histéresis de temperatura» e «Intervalo mínimo». La histéresis admite 0-20°C y evita ajustes frecuentes ante pequeños cambios de temperatura. El intervalo admite 500-30000 ms. 1000 ms equivalen a 1 segundo.
Seleccione "Guardar curva". Después de guardar correctamente, el ventilador seleccionado cambia al modo Curva. Para utilizar el control térmico inteligente, regrese a la tarjeta y seleccione "Inteligente".
Si falla el guardado, lea el mensaje y verifique el estado actual antes de volver a intentarlo. Después de desvincular las variables de temperatura, verifique también la temperatura efectiva y el estado del ventilador.
Seleccione "Importar configuración" y elija un archivo de curva JSON. JSON es el formato de archivo utilizado para almacenar datos de curvas. Revise los nodos, los límites y el número de ventilador, luego seleccione "Guardar curva" para aplicarlos.
Seleccione "Exportar configuración" para descargar la curva actual. La página también intenta guardar una copia en /sdcard/config en la tarjeta SD. Verifique la descarga del navegador y el resultado informado de la tarjeta SD por separado.
Una temperatura de prueba reemplaza temporalmente la fuente normal y afecta el control Curve o Smart. Supervise el ventilador y el dispositivo durante toda la prueba.
Ingrese 0-100°C en "Temperatura de prueba".
Seleccione "Prueba" y observe la salida actual, el estado y la respuesta del ventilador.
Al terminar, seleccione «Borrar prueba». Compruebe que la temperatura efectiva vuelva a obtenerse de la fuente habitual.
Utilice el botón de la bombilla en la parte inferior de una tarjeta para encender o apagar el LED.
Mueva el control deslizante "Brillo" o elija un color o ajuste preestablecido.
Utilice el botón de animación para abrir "Configuración de LED". Seleccione una animación en "Animación programática" y luego use su control de reproducción o detención.
Seleccione el icono de guardar en la parte inferior derecha de la tarjeta para guardar la configuración de LED actual.
Seleccione "Todo apagado" para apagar todos los LED y verificar el resultado informado. Si algunos fallan, verifique esos dispositivos.
Las tarjetas de la matriz tienen iconos para las funciones disponibles. Abra una función y cambie de grupo en «Ajustes LED»:
“Animación programática”: seleccione y ejecute una animación.
“Imagen/Código QR”: elija una imagen de la tarjeta SD o ingrese el contenido para un código QR.
“Visualización de texto”: establece texto, fuente, alineación, desplazamiento, primer plano y fondo.
“Filtro de posprocesamiento”: elija un filtro y parámetros, luego aplíquelos o deténgalos.
“Corrección de color”: ajuste la pantalla y utilice los controles de reinicio, importación o exportación disponibles.
Verifique la luz real o la visualización de la matriz después de aplicar un cambio. Utilice únicamente las funciones que se muestran. Si falla una configuración, siga el mensaje para verificar el archivo, la entrada o el estado del dispositivo.
La parte superior de la página muestra el estado de Ethernet, el cliente WiFi y el AP WiFi. Abra el panel relacionado para ver la dirección IP, la máscara de subred, la puerta de enlace, DNS, la dirección MAC, SSID, la señal y los recuentos de dispositivos conectados cuando estén disponibles.
El panel Ethernet muestra el enlace actual y la información de la dirección. No proporciona controles de edición de direcciones.
Ingrese un nuevo nombre en la sección "Nombre de host" en "Servicios de red", luego seleccione "Establecer". La página muestra el nombre de host actual después de actualizarse.
DHCP asigna automáticamente direcciones de red a los dispositivos conectados. Seleccione "Clientes", elija "WiFi AP" o "Ethernet" y vea los arrendamientos actuales. Utilice el botón de actualización para recargar la lista.
NAT reenvía el tráfico de red entre las interfaces de red del dispositivo. Habilite o deshabilite NAT, luego seleccione "Guardar" para conservar la configuración. Verifique el estado del WiFi y de Ethernet luego.
En "Acceso a la red ascendente", seleccione "Acceso a través de LPMU".
Ingrese la contraseña sudo LPMU y seleccione el botón de acceso. La contraseña se utiliza sólo para esta ejecución y no se guarda; ingréselo nuevamente para una ejecución posterior.
Espere a que finalice la operación. No lo inicie nuevamente mientras procesa.
El acceso se confirma solo cuando el resultado informa tanto una conexión a Internet como una configuración de red completa.
Si falla o el resultado no está confirmado, lea primero el motivo. Expanda "Registro de ejecución" para obtener más detalles. Verifique la contraseña para ver si hay un error de contraseña, o el cableado y la red ascendente si no se encuentra una conexión a Internet.
Una solicitud de estado fallida no significa que el script se haya detenido. Utilice el control "Actualizar estado" disponible para verificar la ejecución actual antes de decidir si desea volver a intentarlo.
Seleccione "Archivos" en la navegación superior para abrir el "Administrador de archivos".
La tarjeta SD es un almacenamiento extraíble y SPIFFS es un almacenamiento de archivos interno del dispositivo. Seleccione “Tarjeta SD” o “SPIFFS” para cambiar de ubicación. La ruta en la parte superior muestra su carpeta actual. Seleccione un nombre de carpeta en la ruta para volver a ella.
Los archivos solo se pueden subir a la tarjeta SD, no a SPIFFS. Compruebe primero que la tarjeta SD esté montada.
Seleccione «Tarjeta SD» y abra la carpeta donde desea subir los archivos.
Seleccione "Cargar archivos".
Seleccione uno o más archivos o arrastre archivos al área de carga.
Revise la lista de carga y elimine archivos no deseados.
Seleccione "Cargar" y espere a que cada archivo muestre su finalización.
Al subir un paquete .tscfg, se abren los pasos de verificación y aplicación. Esta página de archivos todavía no aplica los ajustes del paquete. Que la carga o la verificación se complete no significa que los ajustes estén activos.
Importe paquetes de reglas en Automatización, como se describe en el Capítulo 12. La carga normal de archivos no sustituye a la importación de reglas. Consulte la Guía de seguridad para obtener orientación sobre fuentes y firmas para otros paquetes.
La eliminación no se puede deshacer en la WebUI. Al eliminar una carpeta también elimina su contenido. Compruebe el nombre y la ruta antes de seleccionar «Eliminar» o «Eliminar por lotes» y confirmar.
Los archivos administrados por Automatización están protegidos. Es posible que se rechace la carga o sobrescritura de archivos en /sdcard/config/automation, o la eliminación o cambio de nombre de esa carpeta o de una carpeta principal que la contenga. Si el mensaje dice que Automation administra el archivo, use “Configuration & backup” en Automation o la lista correspondiente. No utilice la Terminal para evitar la restricción.
Al desmontar la tarjeta SD, sus archivos dejan de estar disponibles hasta volver a montarla. Termine las cargas, descargas y otras operaciones de archivos antes de seleccionar «Desmontar SD».
Desmontar o reemplazar la tarjeta puede cambiar la automatización a su configuración de emergencia interna. Es posible que esa copia sea más antigua y es posible que aún se ejecuten las reglas automáticas habilitadas. Sin una copia utilizable, es posible que la automatización no esté disponible. Revise la configuración y las tareas de emergencia antes de desmontar (Capítulo 13). Las imágenes, fuentes y registros de la tarjeta dejan de estar disponibles.
Cuando la tarjeta SD no está montada, la página muestra "Montar SD". Selecciónelo, espere a que el estado cambie a "Montado" y luego abra nuevamente el directorio de la tarjeta SD.
Montar la tarjeta no significa que Automatización haya cambiado a su configuración. Después de reinsertar una tarjeta, elija qué configuración usar como se describe en el Capítulo 13. Nada se sobrescribe ni se fusiona automáticamente.
La primera actualización desde una estructura de almacenamiento anterior, como 0.6.2, necesita un paquete USB/serial compatible aprobado por el proveedor. Cargar solo el firmware o WebUI no puede completar esta actualización. Pídale al administrador o proveedor del dispositivo que siga las instrucciones del paquete. No borre toda la memoria flash ni utilice una tabla de particiones antigua.
Guarde los archivos importantes y mantenga instalada la tarjeta SD original. El primer inicio migra la configuración existente; mantenga la energía conectada. Luego, verifique el inicio de sesión, las redes, los ventiladores, la iluminación, los hosts SSH y las reglas de automatización. Revise las reglas antes de probar cualquier tarea que controle la energía, reinicie un dispositivo o ejecute comandos remotos.
El paquete compatible actualiza ambas ranuras de aplicaciones. No asuma que la otra ranura todavía contiene la versión anterior. Si se pierde la contraseña root, utilice únicamente un método de recuperación confirmado por el proveedor para que coincida con la estructura de 0.6.3. No instale una imagen antigua para restablecer la contraseña.
Los métodos de actualización web que aparecen a continuación se aplican únicamente a las versiones que el proveedor ha aprobado para OTA. No sustituyen la primera actualización de la estructura de almacenamiento.
Introduzca la dirección del servidor OTA proporcionada por un administrador o proveedor.
Seleccione “Save” y luego seleccione “Check Update”.
La página informa “Update Available” “Already up to date” de una versión anterior del servidor o de un error.
Confirme la versión de destino, luego seleccione “Upgrade Now” o el control de actualización que se muestra en la página.
Espere a que finalice la descarga, la instalación y el reinicio. Para cancelar utilice el botón “Abort” cuando esté disponible. No todas las etapas admiten la cancelación.
Espere a que la página confirme el firmware después de la actualización. Vuelva a conectarse al WebUI y verifique el “Current Version” y el estado del dispositivo.
“Upgrade Progress” muestra la etapa actual en su propia sección. Una lectura del 100% o un mensaje de que se escribieron archivos no confirma que se haya completado el reinicio y la verificación de la versión. Si el resultado no está confirmado o el firmware en ejecución difiere del objetivo, conserve el mensaje y verifique la versión actual. No repita la actualización sin verificar. Verifique los registros del sistema y comuníquese con el proveedor si es necesario.
Cuando “Also upgrade www” está habilitado, el firmware y WebUI se actualizan en secuencia. Utilice firmware coincidente y recursos WebUI de la misma versión. Si la interfaz anterior permanece después de la actualización, fuerce la actualización del navegador y verifique la versión y la página nuevamente.
Expanda “Actualización manual” y elija uno de estos métodos:
“Actualizar desde URL”: Ingrese la URL del firmware, configure “Actualizar también www” de acuerdo con las instrucciones de la versión y luego seleccione “Actualizar”. Aquí, www se refiere a los recursos de la interfaz web del dispositivo.
“Actualización desde tarjeta SD”: Ingrese una ruta de firmware como /sdcard/firmware.bin. Si está habilitado "Actualizar también www", asegúrese de que www.bin de la misma versión esté en ese directorio.
Para una actualización desde una URL, "Omitir verificación de certificado" omite la verificación del certificado del servidor HTTPS. Esto elimina la verificación del certificado utilizada para confirmar la identidad del servidor de descarga. Déjelo sin marcar para actualizaciones de rutina. Si ve un error de certificado, solicite a su administrador que verifique la dirección del servidor y el certificado.
“Administración de particiones” muestra la partición en ejecución y otras particiones disponibles.
“Marcar válido” confirma la versión en ejecución y deshabilita la protección de reversión automática para esa versión. Úselo después de confirmar que la versión actual funciona correctamente.
“Revertir a esta versión” selecciona otra versión de arranque y cambia mediante un reinicio. La reversión interrumpe los servicios actuales. Primero confirme la versión de destino y la compatibilidad de datos.
Una vez completada la operación y el reinicio, vuelva a abrir la WebUI y verifique la versión actual y el estado del dispositivo.
La versión 0.6.3 cambia el almacenamiento de configuración y el diseño de la partición del dispositivo. No vuelva directamente a una versión anterior de firmware incompatible. Si necesita volver a una versión anterior, solicite al proveedor del dispositivo que confirme un procedimiento completo de recuperación de firmware, diseño y configuración.
La reversión no restaura el formato de configuración anterior ni garantiza que las reglas antiguas funcionen.
Seleccione "Seguridad" en la navegación superior para abrir la administración de seguridad. Utilice la Guía de seguridad TianshanOS para claves SSH, hosts remotos, huellas digitales de host conocidos, certificados HTTPS, paquetes de configuración y administración de cuentas. Estos procedimientos no se repiten aquí.
Un error en el campo rojo le indica qué corregir. Arréglelo y luego guárdelo. Una marca de error borrada no confirma que se haya guardado correctamente; revisa el mensaje y la lista.
Compruebe qué operación falló y lea el motivo y el siguiente paso. Si el mensaje no da un motivo, no lo suponga.
Seleccione “Details” cuando esté disponible. Seleccione “Hide” para ocultar los detalles. Si se muestra un botón ×, selecciónelo para descartar el mensaje. Para verificaciones adicionales, mantenga un registro del mensaje y los detalles, luego abra “System Logs” en la Terminal para investigar.
Si el resultado no está confirmado, actualice y compruebe el estado del dispositivo, archivo o tarea. Un tiempo de espera agotado o una desconexión no significa que la operación no se haya ejecutado. No repita de inmediato las operaciones de alimentación, eliminación, inicio de tareas o actualización. Si sigue sin poder confirmarlo, abra «Registros del sistema» en Terminal para investigar.
Verifique los resultados de los lotes exitosos, fallidos y no confirmados por separado. Confirme los archivos guardados en la lista de descargas del navegador.
“Terminal” se muestra únicamente a root. Puede ejecutar comandos de la consola del dispositivo directamente y mostrar registros del dispositivo. Un comando puede cambiar el estado del dispositivo inmediatamente. Confirme su fuente, parámetros e impacto antes de ingresar.
Espere "Conectado al dispositivo" y el mensaje tianshan>.
Ingrese help para ver los comandos proporcionados por el firmware actual.
Ingrese un comando y presione Enter. Espere a que finalice su salida y regrese el mensaje.
Los comandos no se ejecutan mientras la página muestra «Sin conexión al dispositivo». Tras una desconexión, espere el mensaje de reconexión antes de enviar otra vez el comando. Así evita ejecutarlo dos veces.
El terminal admite estos controles de teclado:
Control
Función
Ctrl+C
Borra la entrada actual y solicita una interrupción. El comando debe soportar la interrupción para que se detenga.
Ctrl+L
Borra la pantalla.
↑ / ↓
Explora el historial de comandos desde la sesión de la página actual.
← / →
Mueve el cursor dentro de la entrada actual.
“Borrar” en la parte superior de la página solo borra la pantalla. No deshace los comandos que ya se han ejecutado. “Desconectar” finaliza la conexión actual del Terminal.
Un Shell SSH envía entradas de teclado posteriores a un host remoto. Confirme la dirección de destino, el usuario y el método de autenticación, y complete la preparación de SSH descrita en la Guía de seguridad antes de conectarse.
Ingrese ssh --help para ver las opciones del comando SSH.
Ingrese ssh --host <host> --user <user> --shell, reemplazando cada marcador de posición, incluidos sus corchetes angulares, con el valor real. Para especificar un puerto, agregue --port <port> antes de --shell.
Espere la confirmación de la conexión remota antes de ingresar comandos remotos.
Presione Ctrl+\ para salir del shell SSH y regresar al indicador tianshan>.
No ingrese credenciales en texto sin formato mientras otra persona comparte, graba o ve el terminal.
Seleccione "Registros del sistema" en la parte superior de la Terminal para abrir la ventana de registro.
“Nivel” establece el nivel mínimo mostrado. Utilice ERROR, WARN+, INFO+ o DEBUG+ para limitar la salida.
Filtros “TAG” por fuente de registro.
“Buscar” filtra los registros actuales por palabra clave.
“Desplazamiento automático” sigue las nuevas entradas de registro cuando está habilitado.
El botón de actualización recarga los registros históricos.
El botón borrar borra solo los registros que se muestran actualmente en la ventana.
Si el filtrado no produce resultados, borre TAG y Buscar primero, luego cambie el Nivel. Cerrar la ventana de registro no detiene los servicios del dispositivo.
Para una verificación de la línea de comandos, ingrese auto --config status para ver la ubicación de la configuración actual y el estado de la copia de seguridad. Utilice auto --help para conocer las opciones disponibles. Se eliminó la antigua opción config --sync. Utilice los pasos web del Capítulo 13 para realizar copias de seguridad y recuperación de rutina.
«Comandos» guarda comandos SSH reutilizables y los ejecuta en el host remoto seleccionado. Los hosts y sus datos de autenticación se gestionan en «Seguridad». Consulte la guía de seguridad para esos pasos.
La huella ayuda a identificar el host al que se conecta. Estos pasos corresponden a las pruebas de hosts SSH en la página web «Seguridad», no al flujo de confirmación de SSH Shell en Terminal. Si la huella no está registrada o ha cambiado, no siga ejecutando el comando. Abra «Seguridad», busque el host SSH y seleccione «Probar».
En la primera conexión, el diálogo muestra la dirección y la huella del host. Contrástelas con el administrador por un canal de confianza. Seleccione «Confiar y conectar» solo después de confirmar que coinciden.
Si la huella ha cambiado, el diálogo muestra la guardada y la actual, con «Cancelar» seleccionado. Reinstalar el host puede cambiar su huella, pero también puede tratarse de otro host o de una suplantación.
Compruebe la dirección y confirme el motivo del cambio por un canal de confianza. Si no puede confirmarlo, seleccione «Cancelar». No elimine la huella antigua para saltarse la comprobación. Seleccione «Actualizar clave del host» solo cuando haya confirmado que la nueva huella es fiable.
Elija un host que se muestra actualmente en "Seleccionar host".
Revise sus elementos guardados en "Lista de comandos".
“Orphan Commands” hace referencia a hosts que ya no existen y no se pueden ejecutar. Verifique la configuración del host. Para conservar la tarea, vuelva a crear el comando en un host válido, actualice las plantillas y reglas que lo utilizan y verifique el resultado antes de eliminar el huérfano.
Seleccione un host, luego seleccione "Nuevo comando". Utilice el botón de edición en un comando existente para cambiarlo.
Ingrese un "ID de comando" único. Puede contener letras, números, guiones bajos y guiones, y no puede comenzar ni terminar con un guión bajo o un guión.
Ingrese "Nombre del comando" y "Comando". Coloque cada comando en una línea separada cuando utilice varias líneas.
Agregue una descripción y elija un ícono o una imagen de la tarjeta SD si es necesario.
Revise el modo de ejecución y las opciones de coincidencia de salida, luego seleccione "Guardar".
El nombre le ayuda a reconocer un comando; La automatización usa su ID para encontrarlo. No puede cambiar el ID de un comando existente. Para usar una nueva ID, cree un comando y actualice las plantillas y fuentes que lo usan.
Seleccione el control de ejecución en una tarjeta de comando.
Observe el resultado y el estado en "Resultado de la ejecución".
Cuando se muestre “Cancelar”, utilícelo para solicitar la interrupción de la sesión actual. Verifique el estado y la salida para confirmar si se detuvo. Las operaciones remotas completadas no se deshacen.
Seleccione “Borrar” para eliminar la visualización del resultado actual.
«Borrar» no deshace lo que ya se ha ejecutado en el host remoto. La clasificación como éxito o fallo, el contenido extraído y el estado final dependen de los criterios configurados para el comando.
La coincidencia de resultados convierte la salida remota en un estado que es más fácil de usar.
“Coincidencia esperada”: Marca el resultado exitoso cuando la salida contiene el texto configurado.
“Fail Match”: Marca el resultado fallido cuando la salida contiene el texto configurado.
“Extraer expresión regular”: utiliza un grupo de captura (.*) para guardar la salida seleccionada.
“Detener en la coincidencia”: finaliza un comando continuo después de una coincidencia exitosa.
“Tiempo de espera (s)”: Establece cuánto tiempo esperar para una coincidencia, en segundos. Se aplica solo cuando se establece un patrón de éxito o fracaso, o cuando está habilitado "Detener al coincidir".
“Nombre de variable”: guarda el estado y la salida extraída para usar en la página de Automatización.
Elija texto estable y específico de éxito y fracaso. El texto amplio puede producir coincidencias incorrectas. Ejecute el comando una vez y revise "Resultados de la coincidencia" antes de usar sus variables en una regla.
nohup significa que un comando continúa ejecutándose en segundo plano del host remoto después de que se cierra la conexión SSH. Cerrar la WebUI no detiene una tarea en segundo plano.
Las ejecuciones en segundo plano requieren autenticación de clave SSH. Implemente la clave pública en “Security” y luego seleccione el host asociado. No guarde contraseñas en texto plano en comandos en segundo plano. La misma clave debe permanecer disponible para detener o verificar la tarea original.
Después de habilitar “Run in background (nohup)” y ejecutar el comando, seleccione “Background runs” en Comandos. El control exclusivo root en Sistema y el control en Automatización abren la misma lista.
Busque la tarea original por su nombre, usuario, dirección de host y puerto.
Seleccione “Verify remote state” para verificar esta ejecución en el host original.“Refresh” sólo lee registros conocidos; no reemplaza la verificación.
Seleccione “View Log” para leer las últimas 100 líneas del host original. Seleccione “Follow log” para obtener actualizaciones.“Stop following” detiene solo las actualizaciones de la página.
Para finalizar la tarea, seleccione “Stop” en su registro y confirme. Espere el resultado, luego verifique que se haya detenido. No lo vuelvas a iniciar sin comprobarlo.
Tras reiniciar el dispositivo, los registros anteriores muestran “Not checked”. “Remote state unconfirmed” indica que no se ha confirmado si la tarea está detenida o en ejecución. “Last result” describe el último resultado confirmado y no garantiza el estado actual.
Una lectura fallida no significa que el registro esté vacío o que el proceso haya salido. Verifique la conexión del host original, la ruta del registro y la clave SSH. Verifique nuevamente después de resolver el problema; No reinicie una tarea sólo porque falló su verificación de estado.
Eliminar un comando, cambiar su configuración de host o cambiar las configuraciones de automatización no finaliza un proceso remoto. Administre la tarea original desde “Background runs”. La recreación de un comando con el mismo nombre o ID no se hace cargo de la tarea original. Guarde cualquier llave que aún necesite para controlarlo.
«Modo servicio» supervisa una tarea en segundo plano hasta que está disponible. Complete «Criterio de disponibilidad» y «Nombre de variable». Ajuste el patrón de fallo y los tiempos si lo necesita:
“Ready match”: Marca el servicio listo cuando aparece el texto configurado. Utilice | para separar varios patrones.
“Fail Match”: Marca el servicio fallido cuando aparece el texto configurado.
“Tiempo de espera(s) de listo”: Establece la espera más larga para el estado listo, en segundos.
“Intervalo de verificación (ms)”: establece con qué frecuencia se verifica el registro, en milisegundos; 1000 ms equivale a 1 segundo.
“Nombre de variable”: almacena estados como comprobación, listo y tiempo de espera.
Utilice el botón exportar en un comando para exportarlo y, cuando esté seleccionado, incluya su configuración de host dependiente.
Seleccione “Import Command”, elija un paquete de configuración .tscfg, obtenga una vista previa de su contenido y decida si desea sobrescribir la configuración existente.
La importación puede incluir un host remoto y reemplazar la configuración con la misma ID. Revise el comando, el host y los reemplazos en la vista previa antes de confirmar. Al guardar se actualiza la configuración actual sin reiniciar. Los procesos remotos existentes no se detienen ni se trasladan al nuevo host.
Las nuevas importaciones verifican el origen, la firma, el permiso de firma y el dispositivo de destino. Una exportación exitosa no garantiza una importación posterior. Un certificado de dispositivo destinado únicamente a HTTPS puede carecer de permiso para firmar paquetes de configuración. Pídale al proveedor de configuración que resuelva esto; no desactive la verificación.
Después de seleccionar eliminar, revise las plantillas y reglas vinculadas. Elija un comando de reemplazo disponible o desvincule la configuración afectada y deshabilite sus reglas. Consulte el Capítulo 12 para conocer los pasos. La eliminación cambia sólo la configuración en uso; no actualiza la otra copia de emergencia.
Eliminar la configuración y detener un servicio remoto son operaciones independientes. La eliminación no detiene el servicio ni deshace las operaciones completadas. Para finalizar una tarea remota, deténgala desde “Background runs” y confirme el resultado.
"Automatización" conecta datos y operaciones en flujos de trabajo repetibles. Cree fuentes de datos y plantillas de acciones, luego use reglas para decidir cuándo ejecutarlas.
Automático: fuente de datos → variable → evaluación de reglas → acciones
Manual: acción rápida de la página Sistema → acciones
Las fuentes leen datos, las variables contienen valores, las reglas evalúan condiciones y las plantillas definen tareas. Mostrar una regla en el panel y permitir la ejecución manual son configuraciones independientes. Las reglas automáticas también pueden aparecer en el panel.
La parte superior de la página muestra el estado del motor, las reglas, las variables y los recuentos de fuentes, el recuento de activadores y el tiempo de ejecución.
controlar
Efecto
“Start”
Arranca un motor parado. Las reglas habilitadas se ejecutan solo si la configuración actual permite la ejecución.
“Pause”
Detiene la evaluación automática adicional. Las acciones existentes pueden continuar. Para continuar a través de la página, pare el motor y luego enciéndalo.
“Stop”
Intenta detener las comprobaciones de reglas, la lectura de datos y la programación de acciones posteriores, manteniendo la configuración. Espere la confirmación; un tiempo de espera no significa que el motor se haya parado.
“Reload”
Lee la configuración nuevamente desde la ubicación en uso. Guarde las ediciones y compruebe el resultado. Se mantiene una pausa de configuración existente.
Compruebe si la refrigeración, las alertas u otras tareas en curso dependen de la automatización. Detener el motor no detiene un proceso remoto en segundo plano. Detenga las tareas remotas desde “Background runs” y confirme el resultado.
“Disable automation” debajo de “Configuration & backup” está separado del control “Pause” del motor. Si la configuración está en pausa, revísela antes de seleccionar “Enable automation”. Reiniciar el dispositivo, recargar o detener y arrancar el motor no borra esta pausa de configuración. Consulte el Capítulo 13.
Cree una fuente y use su prueba para verificar la conexión y los campos seleccionados.
Habilítelo, luego use el ícono “Ver variables” de la fila para verificar los valores y actualizar los tiempos.
Cree una plantilla, revise sus parámetros y seleccione "Probar". Las pruebas ejecutan la acción inmediatamente; confirme que el dispositivo y el host puedan aceptarlo.
Cree una regla con "Habilitar inmediatamente" desactivado. Establece condiciones, tiempo de reutilización, orden de acción, retrasos y repetición.
Configure “Mostrar en panel” y “Permitir activación manual” según sea necesario.
Guarde y luego habilite la regla. Verifique las variables, los recuentos de activadores y los resultados reales.
Seleccione "Agregar" en "Fuentes de datos" y elija un tipo: Tipo
Tipo
Función
“API DE RESTO”
Lee periódicamente datos de una dirección HTTP.
“WebSocket”
Recibe datos enviados a través de una conexión persistente.
“Socket. IO”
Recibe eventos de un servicio Socket. IO.
“Variable de comando”
Lee los resultados de un comando remoto configurado.
Ingrese una identificación única, una etiqueta para mostrar y la información de conexión requerida.
Utilice la prueba para comprobar la conexión. Obtenga direcciones, detalles de autenticación e información de campo del proveedor de datos.
Para los primeros tres tipos, seleccione campos de la respuesta de la prueba. Dejar el nombre de un evento Socket. IO en blanco permite que la prueba intente descubrir el evento.
Para una variable de comando, seleccione el host y un comando con un nombre de variable configurado, luego configure el intervalo de sondeo.
Verifique el interruptor de habilitación en el formulario, guárdelo y use “View Variables” en su fila para verificar el resultado.
Cada fila de fuente ofrece un interruptor de activación y controles para ver variables, exportar y eliminar. Antes de deshabilitar o eliminar una fuente, compruebe qué reglas la usan para evitar interrumpir sus tareas.
Importar y exportar paquetes de configuración de uso. Obtenga una vista previa de los ID, tipos y reemplazos antes de importarlos y siga la Guía de seguridad para conocer los requisitos de origen y confianza.
Seleccione el icono con forma de ojo "Ver variables" en una fila de origen. La ventana muestra nombres, tipos, valores y tiempos de actualización. Las variables de comando remoto también se pueden ver desde el control de variables del comando.
Confirme los nombres y la fuente, y verifique que los valores y tipos se ajusten a las comparaciones de la regla.
Compruebe si los tiempos de actualización coinciden con la frecuencia de datos esperada.
Si no hay datos disponibles, verifique que la fuente esté habilitada y luego pruebe la conexión y los campos. Para las variables de comando, verifique también el resultado de la ejecución del comando.
Seleccione "Agregar" en "Plantillas de acción" y elija un tipo de tarea:
Tipo
Función
“Comando CLI”
Ejecuta un comando de consola de dispositivo local.
“Comando SSH”
Ejecuta un comando remoto guardado en la página Comandos.
“Control LED”
Controla los colores, efectos o contenido de la matriz del LED.
“Registro”
Escribe un mensaje en el nivel seleccionado.
“Establecer variable”
Asigna un valor a una variable de automatización.
“Webhook”
La opción permanece visible, pero no se implementa la ejecución de la acción. Actualmente no puede enviar una solicitud.
Introduzca un ID único, un nombre y los parámetros específicos del tipo. Establezca un retraso o "Ejecución asíncrona" si es necesario. Una acción asincrónica continúa en segundo plano; verifique su resultado final a través de registros, variables o el dispositivo de destino.
CLI: introduzca el comando. Puede añadir una variable de resultado y un tiempo de espera.
SSH: elija un host y un comando configurados y verifique la vista previa.
LED: seleccione el dispositivo y una operación compatible de color, efecto, brillo, texto, imagen, código QR o filtro.
Registro: seleccione el nivel y el mensaje. El mensaje puede hacer referencia a variables.
Establecer variable: ingrese el nombre y el valor de la variable.
Webhook: Actualmente no disponible. Elija una acción admitida en su lugar. Los paquetes de reglas que contienen acciones Webhook tampoco se pueden importar.
“Test” ejecuta la acción. Verifique el efecto de las operaciones de encendido, reinicio, comando remoto o solicitud externa antes de realizar la prueba. Un mensaje en cola significa que la tarea fue aceptada, no que se realizó correctamente. Verifique los registros del sistema y también el dispositivo de destino.
Después de editar, guarde y verifique los parámetros. Si no se puede guardar, conserve el borrador y corrija el problema informado. Las importaciones pueden reemplazar las plantillas; revise el impacto de la eliminación antes de eliminar uno. Si falta una imagen o fuente, inserte la tarjeta SD original o seleccione un recurso disponible. La copia de seguridad de emergencia no guarda estos archivos.
Eliminar una regla, plantilla, comando SSH o host puede afectar otras configuraciones. Guarde primero una copia de seguridad de emergencia si la necesita. La eliminación no se puede deshacer de la página.
Seleccione eliminar en la lista correspondiente. Revise el nombre del objetivo y los elementos afectados.
Confirme la eliminación si no hay enlaces. De lo contrario, elija un reemplazo disponible o “Unlink and disable affected rules”.
Actualiza la lista después. Confirme la eliminación y verifique las plantillas, reglas y estados de habilitación vinculados.
Al desvincular una plantilla eliminada se elimina su acción de las reglas afectadas y se desactivan esas reglas. Al eliminar un comando SSH, las plantillas vinculadas quedan como borradores deshabilitados con la referencia del comando borrada; las reglas afectadas están desvinculadas y deshabilitadas. Antes de elegir un reemplazo, verifique su objetivo y acción, no solo un nombre similar.
Al eliminar un host, revise también los comandos y fuentes afectados. Un comando sin un host no se puede ejecutar. Vuelva a crear los comandos necesarios en un host válido y actualice sus enlaces, luego verifíquelos antes de usarlos. Eliminar la configuración del host local es independiente de revocar una clave pública remota; consulte la Guía de seguridad.
Si no se puede completar la eliminación normal, seleccione “Force delete”, lea la explicación y confirme. Se elimina el elemento, se desvinculan las referencias que se puedan identificar y se desactivan las reglas afectadas. Los servicios remotos en segundo plano no se detienen.
Si no se puede determinar todo el alcance, la página le pedirá marcar “I agree to pause automation and continue deleting”. La automatización permanecerá en pausa después de la eliminación. Revise y repare la configuración restante y, después, seleccione “Enable automation” en “Configuration & backup”. Reiniciar el dispositivo no reanuda la automatización.
Si la configuración cambia durante la confirmación, seleccione “Review deletion impact”, revise la nueva lista y confirme de nuevo. La eliminación forzada no garantiza que se complete si falla la escritura en el almacenamiento. Vuelva a consultar la lista: que una tarjeta desaparezca no demuestra que la eliminación se haya guardado.
Seleccione "Agregar" en "Reglas" e ingrese una identificación, nombre e ícono únicos.
Seleccione “Logic”: AND requiere que se cumplan todas las condiciones; OR requiere que se cumpla al menos una.
Establece el tiempo de reutilización para activadores automáticos. Los valores están en ms; 1000 ms equivale a 1 segundo.
Agregue condiciones y elija una variable, comparación y valor. Las comparaciones incluyen igual, no igual, mayor que, mayor o igual, menor que, menor o igual, valor cambiado y contiene. Haga coincidir el tipo de valor con la variable.
Agregue plantillas y establezca retrasos de acción, repeticiones y condiciones a nivel de acción.
Configure "Mostrar en panel" y "Permitir activación manual". El primero controla la visibilidad de la tarjeta en el Sistema; el segundo controla la ejecución manual.
Revise, guarde y luego habilite la regla. Deje desactivado "Habilitar inmediatamente" mientras lo configura por primera vez.
Guardar, habilitar o deshabilitar una regla actualiza la configuración actual sin reiniciar. Si la automatización está en pausa, el guardado no la reanuda. Actualiza la lista y comprueba el resultado. Actualice la copia de seguridad de emergencia después de cambios importantes, como se describe en el Capítulo 13.
Se repite mientras se mantiene la condición de la acción, hasta 100 veces por ejecución.
“Recuento fijo”
Se repite para el conteo e intervalo configurados, verificando la condición de la acción antes de cada ejecución.
Las condiciones de acción son independientes de las condiciones de activación de reglas. Sin una condición de acción, "Repetir mientras sea verdadero" continúa hasta el límite por ejecución. La regla puede desencadenar otra ejecución más adelante.
Deshabilitar una regla evita nuevos desencadenantes; una ejecución ya iniciada puede continuar. Para dejar de programar acciones posteriores, seleccione el control “Parar” del motor y espere la confirmación. Verifique las acciones ya enviadas y los procesos remotos por separado. Las operaciones completadas no se deshacen.
“Solo activación manual”, “Mostrar en panel” y “Permitir activación manual” controlan si una regla se ejecuta solo manualmente, si su tarjeta está visible y si los usuarios pueden ejecutarla.
Ingrese el ID, el nombre y el ícono, luego habilite "Solo disparo manual". Una regla de este tipo no necesita condiciones de activación automática.
Agregue plantillas y revise retrasos, repeticiones y condiciones de acción.
Habilite “Mostrar en panel” y “Permitir activación manual”, luego guarde y habilite la regla.
Regrese al Panel de dispositivos del sistema. Verifique el nombre y el estado de la tarjeta, ejecútela una vez y revise el resultado.
Las reglas automáticas también pueden aparecer en el panel. Mostrar una tarjeta no hace que su regla sea solo manual. Una regla deshabilitada puede permanecer visible pero no puede iniciarse. Proporcione nombres a las acciones orientadas a admin que expliquen su efecto e indique a los usuarios a quién contactar para verificar o detener las tareas en segundo plano. Los usuarios de Root ven registros, verifican y detienen servicios desde “Background runs”.
Importe paquetes de reglas en Automatización, no a través del “Verify Only” de Seguridad o la carga de archivos. Este control verifica el firmante, el dispositivo de destino y la configuración requerida. Verificar cada paquete a través de su propio control de importación; el resultado de otro paquete no se aplica.
Antes de importar, prepare:
Confirme si la tarjeta SD o la configuración de emergencia interna está en uso y si se puede guardar. Consulte el Capítulo 13.
El dispositivo tiene un certificado válido, su clave privada correspondiente y una cadena de CA; su tiempo está verificado. Una cadena de CA verifica los orígenes de los certificados. Consulte la Guía de seguridad para conocer los pasos de instalación.
El administrador de la implementación ha seleccionado un firmante de confianza. Root iniciar sesión o instalar certificados HTTPS no completa esta configuración. Pídale al administrador de implementación que lo configure si falta.
Las plantillas, los comandos y los hosts de la regla están listos. Importar no los instala por usted. Agregue primero cualquier configuración que falte. Si la regla está habilitada, verifique también el estado de habilitación de la configuración que utiliza.
Guardar una importación actualiza la configuración actual sin reiniciar. Antes de confirmar, verifique el estado de habilitación, las condiciones, las acciones y los objetivos, y confirme que la ejecución sea segura. Se mantiene una pausa de configuración existente. Para evitar la ejecución, deshabilite primero la automatización o solicite al proveedor una versión deshabilitada.
Seleccione el icono de importación en “Rules” para abrir “Import Rule Configuration” y luego elija el archivo .tscfg. La verificación comienza y la página muestra una vista previa.
Espere a que “Signing trust, target device and rule content verified”. verifique el nombre, el ID de la regla y “Rule summary”. Expanda “View rule content” para revisar las condiciones, las acciones, los objetivos y el estado de habilitación; no confíe en el nombre del archivo.
Si existe la misma identificación, revise qué se reemplazará. Seleccione “Overwrite existing configuration” solo si desea reemplazarlo. Si el archivo, las credenciales o la configuración cambian después de la vista previa, seleccione “Check package again”. Cierre y vuelva a abrir el editor si la página se lo solicita; después, vuelva a comprobarlo.
Seleccione “Confirm Import” y espere el resultado de guardar. Consulte la lista de reglas, el estado de habilitación y las variables requeridas. Un guardado exitoso no demuestra una ejecución exitosa de la tarea.
Si la regla permite una verificación manual segura, ejecútela una vez y verifique el dispositivo o host. Para conocer otras reglas, observe los registros y los resultados después de una activación normal. Para borrar una pausa de configuración, revise la configuración antes de seleccionar “Enable automation”.
Las reglas importadas se pueden editar, habilitar, deshabilitar y eliminar. Verifique la configuración actual después de las ediciones y actualice la copia de seguridad de emergencia si es necesario. Una importación posterior aún requiere verificación de firma; el permiso para editar localmente no lo omite.
Es posible que un certificado destinado únicamente a HTTPS no autorice la firma de la configuración. Una exportación local exitosa aún puede ser rechazada en el momento de la importación. Solicite al proveedor que resuelva el problema del propósito del certificado; no desactive la verificación ni repita la importación.
Las importaciones y ediciones no deshacen acciones completadas ni detienen procesos remotos en segundo plano. Finalice esas tareas por separado de “Background runs” y confirme el resultado.
Firma root no seleccionada, firmante no confiable o firmante no autorizado
Solicite al administrador de implementación o al proveedor de configuración que verifique el origen de la firma y los permisos del certificado. No sustituya el “Verify Only” de Security ni desactive la verificación.
El paquete apunta a otro dispositivo
Pídale al proveedor que lo exporte utilizando el certificado de este dispositivo; no cambie el nombre dentro del paquete. Organice paquetes de reemplazo coincidentes antes de cambiar también el certificado de este dispositivo.
La hora del dispositivo no está verificada
Verifique y sincronice la hora en “Network & Time” en Sistema, luego verifique el archivo nuevamente.
Carga de configuración
Espere a que termine y luego verifique el paquete nuevamente.
La configuración no se pudo cargar
Verifique los registros del sistema, resuelva la causa y restaure la configuración antes de volver a verificar.
Falta la configuración requerida
Agregue la plantilla, el comando o el host nombrado por la página y luego verifique nuevamente.
Configuración requerida deshabilitada
Compruebe si debería estar habilitado. Una vez que sea seguro ejecutarlo, habilítelo y verifique nuevamente.
Acción no admitida
Pídale al proveedor que revise el paquete. La importación de paquetes de reglas actualmente rechaza las acciones de Webhook; su presencia en el selector de plantillas no significa que el paquete pueda importarse.
Archivo, credenciales o configuración cambiados después de la vista previa
Seleccione “Check package again”. Vuelva a abrir el editor o seleccione el archivo según las instrucciones, luego revise y confirme.
Verifique la ubicación en “Configuration & backup”. Resuelva el problema de almacenamiento o reduzca el contenido innecesario, luego verifique nuevamente.
La configuración actual o la ubicación de guardado cambiaron
Guarde y copie el borrador. Vuelva a abrir el editor, revise la configuración más reciente y envíela nuevamente. No pulse guardar repetidamente.
Guardar resultado sin confirmar
Actualice y verifique el contenido de la regla y habilite el estado. Si aún no está claro, inspeccione los registros del sistema. Conserve el paquete original y no repita la importación.
A una variable de condición sin una muestra no necesariamente le falta configuración; compruebe cuándo se actualizará. Si no se puede leer la configuración, conserve los archivos originales y verifique los registros del sistema. No sobrescriba el contenido dañado como si estuviera vacío.
La ejecución manual requiere una regla habilitada que permita activadores manuales, sin que ninguna ejecución de la misma regla esté en curso. Omite las condiciones de activación automática y el tiempo de reutilización, pero aún aplica condiciones de acción, retrasos y repeticiones.
La desactivación no deshace las acciones completadas. La eliminación no se puede deshacer de la página.
Antes de editar fuentes, plantillas o comandos, verifique qué reglas los utilizan. Las ediciones de configuración no detienen las tareas remotas existentes. Verifique y detenga esas tareas por separado si es necesario.
Importe cada paquete a través de su lista relevante y revise la vista previa. Consulte la Guía de seguridad para conocer todos los procedimientos de firma y cuenta.
Si no se puede guardar, lea el mensaje y conserve el borrador. Si el guardado se realizó correctamente pero la actualización falló, actualice y verifique la lista antes de crear otro elemento.
Configuraciones del sistema como redes, ventiladores, temperatura e iluminación.
Guardado dentro del dispositivo. Una restauración de copia de seguridad de Automatización no los cambia.
Configuración de automatización actual
Las adiciones, ediciones y eliminaciones van a la tarjeta SD durante el uso normal de SD, o al almacenamiento interno en modo de emergencia.
Respaldo de emergencia interno
Mientras usa la tarjeta SD, se actualiza solo cuando selecciona “Save emergency backup”. Las ediciones en modo de emergencia actualizan esta configuración interna directamente.
La copia de seguridad de emergencia guarda juntas reglas, plantillas de acción, comandos SSH, hosts asociados, fuentes y definiciones iniciales de variables de usuario. No guarda claves privadas, imágenes, fuentes, registros ni estados de ejecución remota. La configuración del host sólo recuerda qué clave usar; la clave en sí no se copia.
Esta no es una copia de seguridad completa del dispositivo. Mantenga archivos y claves importantes a través de sus propios métodos de copia de seguridad. Una restauración no significa que los servicios remotos se hayan detenido o que todos los archivos necesarios para una regla estén disponibles.
Confirme que “Currently using” muestre “SD card configuration” y luego revise las reglas y tareas actuales.
Seleccione “Save emergency backup” y espere a que finalice.
Verifique “Last internal save” y “Backup status”. “Includes the current changes” significa que la copia interna coincide con la configuración actual.
Guardar reemplaza la copia de seguridad de emergencia anterior. Las ediciones posteriores de la tarjeta SD no la actualizan. Si no incluye los últimos cambios, revise el contenido actual antes de decidir si desea guardarlo nuevamente.
Mientras se utiliza “Internal emergency configuration”, las ediciones se guardan internamente. No es necesario que vuelva a seleccionar “Save emergency backup”.
Una restauración reemplaza la configuración actual de la tarjeta SD con la copia interna, que puede ser más antigua. Exporte primero cualquier configuración y archivos actuales que necesite. No guarde primero una copia de seguridad de emergencia; eso sobrescribiría la copia anterior que desea restaurar.
Mientras usa la configuración de la tarjeta SD, seleccione “Restore emergency backup”.
Revise los elementos agregados, modificados y eliminados, y si la automatización permanecerá en pausa.
Confirme y espere a que finalice. Las listas se actualizan sin reiniciar el dispositivo.
Verifique reglas, hosts, variables, estados de habilitación y resultados de tareas. Si aún está en pausa, revise la configuración antes de seleccionar “Enable automation”.
Una restauración no cambia las redes, los ventiladores ni las claves. No termina de ejecutar servicios remotos. Adminístrelos desde “Background runs” si es necesario.
Si existe una configuración interna utilizable, el dispositivo cambia a ella. Las reglas automáticas habilitadas siguen sus condiciones; Las reglas manuales todavía necesitan un clic. La copia interna puede ser más antigua, así que verifique qué tareas pueden ejecutarse antes de un cambio planificado.
El modo de emergencia permite adiciones, ediciones y eliminaciones. Los guardados van directamente al almacenamiento interno. Si no existe ninguna configuración interna utilizable, lea primero el motivo. Puede comenzar con una nueva configuración válida, pero no sobrescriba los archivos dañados como si estuvieran vacíos.
Las redes, los ventiladores y otras configuraciones del sistema aún se cargan desde el almacenamiento interno. La configuración de emergencia no restaura las imágenes, fuentes o registros de la tarjeta SD. Inserte la tarjeta original o seleccione los archivos disponibles si faltan recursos. La falta de una tarjeta no significa que todas las funciones se detengan o que todas las tareas puedan continuar.
Inserte una tarjeta SD utilizable y seleccione “Check SD card”, luego revise las dos opciones siguientes. La inserción no cambia ni fusiona configuraciones. Cierre el panel para seguir usando la configuración interna. Reiniciar no toma la decisión por usted.
Botón
que pasa
“Use SD card configuration”
Lee y cambia a la configuración de la tarjeta. La configuración interna se conserva, no se copia en la tarjeta.
“Save current configuration to SD card and use it”
Reemplaza la configuración de la tarjeta con la configuración interna actual y luego cambia a la tarjeta. Se sobrescribe la configuración anterior de la tarjeta.
Verifique la ubicación actual y decida qué configuración conservar.
Seleccione el botón correspondiente y revise el aviso de reemplazo y estado de habilitación. Antes de escribir en la tarjeta, verifique los elementos agregados, modificados y eliminados.
Confirme y espere. Verifique que “Currently using” muestre “SD card configuration” y luego revise las listas y los resultados de las tareas.
La configuración de tarjeta faltante o vacía no se completa automáticamente desde el almacenamiento interno. Confirme que lo que desea es una configuración vacía antes de elegirla. Si la tarjeta o la configuración cambian después de la vista previa, verifique nuevamente según las instrucciones; no reutilice la confirmación anterior.
La configuración interna todavía está en uso. Seleccione “Use SD card configuration” para finalizar el cambio. No sobrescriba la tarjeta nuevamente.
Configuración guardada, automatización aún en pausa
Revise la configuración y seleccione “Enable automation”. No vuelva a guardar ni confíe en un reinicio para quitar la pausa.
Eliminación no guardada, automatización en pausa
Compruebe si el objetivo todavía está presente y si hay almacenamiento disponible. Repare y revise la configuración antes de decidir si habilitarla.
Guardar resultado sin confirmar
Lea la ubicación y el contenido nuevamente. Verifique los registros del sistema si es necesario. No vuelva a enviar el mismo cambio sin comprobarlo.
La entrada actual difiere de la última configuración
Copie cualquier borrador que necesite antes de cerrar y volver a abrir el editor. Revise el contenido más reciente e ingrese sus ediciones. La página no fusiona borradores por usted.
Después de un cambio, restauración o guardado exitosos, verifique si las tareas pueden ejecutarse y si finalizan. Se mantiene una pausa de configuración; revise y seleccione “Enable automation” para continuar. Una pausa causada por “Disable automation” o una eliminación forzada no se borra reiniciando o cambiando las configuraciones.
Ce guide est basé sur TianshanOS 0.6.3. Pour les autres versions, consultez les instructions spécifiques à la version correspondante.
Ce guide couvre les fonctions de routine dans la partie I et l'accès au terminal, les commandes à distance, l'automatisation et la sauvegarde de la configuration dans la partie II. Les opérations Root peuvent affecter le périphérique et les hôtes distants ; vérifiez les tâches cibles et actives avant de continuer. Consultez le Guide de sécurité séparé pour la gestion de la sécurité.
Utilisez les commandes affichées sur votre appareil. Certains nécessitent un matériel ou une configuration spécifique. Sur un ordinateur, passez la souris sur un bouton icône pour voir son nom. Sur un téléphone, faites glisser votre doigt dans un large tableau pour afficher ses autres colonnes.
Ouvrez l'interface Web de l'appareil (WebUI) à l'aide de l'adresse fournie par votre administrateur.
Sélectionnez « Connexion » dans le coin supérieur droit.
Saisissez root et le mot de passe root fourni avec l'appareil.
Sélectionnez « Connexion ». Après une connexion réussie, le nom d'utilisateur actuel apparaît dans le coin supérieur droit.
La connexion avec le mot de passe par défaut ouvre un « rappel de sécurité ». Saisissez le mot de passe actuel, puis saisissez le nouveau mot de passe deux fois et sélectionnez « Modifier maintenant ». Les deux entrées de nouveau mot de passe doivent correspondre. Sélectionnez « Plus tard » pour fermer le rappel.
Lorsque vous avez terminé, sélectionnez « Déconnexion » dans le coin supérieur droit. Vous devrez vous reconnecter pour utiliser l'appareil.
Sélectionnez le bouton de langue en haut de la page, puis choisissez chinois ou anglais. Le contenu de la page et les étiquettes de contrôle changent immédiatement.
« Ressources de la puce de gestion » affiche l’utilisation du CPU, de la DRAM et de la PSRAM de cette puce. Ces valeurs ne concernent ni AGX ni LPMU.
Sélectionnez « Détails » pour afficher la mémoire totale, utilisée et libre ainsi que d'autres informations sur la mémoire.
« Services » affiche le nombre de services en cours d'exécution et le total. Sélectionnez-le pour afficher l’état et l’étape de démarrage de chaque service.
Si un service signale un problème, actualisez son état. Pour le redémarrer, suivez « Redémarrer un service » ci-dessous.
« Vue d’ensemble du système » affiche la puce, la version du micrologiciel, celle d’ESP-IDF et la durée de fonctionnement. Pour l’usage courant, vérifiez la version du micrologiciel. ESP-IDF est le cadre logiciel utilisé par l’appareil.
Le côté droit de la carte affiche la tension d'entrée, la tension interne, le courant, la puissance et l'état de protection.
Les paramètres système tels que la mise en réseau, les ventilateurs, la température et l'éclairage sont enregistrés dans l'appareil. L'insertion d'une ancienne carte SD ne les restaure pas. La configuration de l'automatisation est gérée séparément ; sa sauvegarde d'urgence n'est pas une sauvegarde complète de l'appareil.
L'interrupteur à côté de l'état de protection active ou désactive la protection basse tension. Lorsqu'il est activé, l'appareil utilise les tensions et les délais enregistrés pour s'arrêter à basse tension et redémarrer une fois l'alimentation rétablie.
Un redémarrage interrompt temporairement la WebUI et la gestion des appareils. Terminez les opérations actives, puis sélectionnez « Redémarrer » et confirmez. Attendez que l'appareil soit récupéré, puis rouvrez WebUI.
Le redémarrage d'un service interrompt temporairement la fonction qu'il fournit. Ouvrez « État du service », recherchez le service concerné et sélectionnez « Redémarrer » sur cette ligne. Vérifiez à nouveau son état une fois l'opération terminée.
Ces paramètres contrôlent le moment où l'appareil s'éteint après une chute de tension et le moment où il redémarre après le rétablissement de l'alimentation. Utilisez des valeurs qui correspondent aux besoins en énergie de votre appareil.
Sélectionnez « Paramètres d'arrêt » pour modifier :
« Seuil de basse tension » : démarre le compte à rebours d'arrêt en dessous de cette tension.
« Seuil de tension de récupération » : démarre la récupération au-dessus de cette tension.
« Compte à rebours d'arrêt » : définit le délai avant l'arrêt après la détection d'une basse tension.
« Temps de maintien de la récupération » : définit le temps d'attente utilisé pour confirmer une récupération de puissance stable.
« Fan Stop Delay » : définit le délai avant l'arrêt des ventilateurs après l'arrêt.
Enregistrez le formulaire pour appliquer les paramètres de protection mis à jour.
Le changement de cible USB peut déconnecter temporairement un périphérique connecté. Confirmez l'objectif et terminez le travail actif avant de continuer.
Les appareils prenant en charge la commutation USB affichent un bouton « USB ». Chaque clic fait basculer le port USB supérieur vers la cible suivante : ESP, AGX, puis LPMU. Vérifiez la cible affichée sur le bouton et le message de la page pour confirmer le résultat.
Le « Panneau des périphériques » se trouve sur la page « Système ». Il contient des commandes d'alimentation de module, des actions rapides et des widgets de données.
Enregistrez le travail sur le module et terminez son processus d'arrêt normal avant de couper l'alimentation. Une mise hors tension forcée peut entraîner la perte de données non enregistrées.
« AGX Power » affiche l'état de contrôle de l'alimentation. Sélectionnez-le pour allumer ou éteindre l'appareil, puis attendez la confirmation.
« LPMU Power » affiche « En ligne », « Hors ligne » ou « Inconnu ». Ces états proviennent d'une vérification du réseau. En ligne signifie que le module est accessible ; hors ligne signifie que ce n'est pas le cas. Aucun des deux états ne confirme à lui seul si le module est allumé ou éteint.
La sélection du bouton LPMU déclenche la même action que l'appui sur son bouton d'alimentation physique. Attendez le contrôle et le résultat affiché. Si le résultat est inconnu, vérifiez le module et le réseau avant d'appuyer à nouveau sur le bouton.
Un utilisateur root configure les cartes d’actions rapides. Leur affichage et l’autorisation de lancer une tâche sont deux réglages distincts. Une carte visible ne permet pas toujours de lancer sa tâche.
Lisez le nom et la description de la carte pour identifier la tâche.
Sélectionnez la carte et lisez le résultat. Ne le redémarrez pas pendant le traitement.
Un message exécuté ou mis en file d'attente nécessite toujours une vérification réelle des résultats sur le périphérique ou la tâche cible. Utilisez “Background runs” pour vérifier, afficher les journaux ou arrêter un service en arrière-plan (Chapitre 11).
Si la tâche ne peut pas démarrer, suivez le motif affiché. N’appuyez pas plusieurs fois sur Démarrer :
Règle désactivée ou déclenchement manuel non autorisé : vérifiez les paramètres de la règle sur “Automation” (Chapitre 12). Une carte visible ne constitue pas une autorisation de l'exécuter.
Une tâche ou une opération en arrière-plan est en cours : Attendez son résultat. Ne le redémarrez pas.
Un enregistrement d'exécution en arrière-plan existe déjà pour la tâche : vérifiez la tâche d'origine dans “Background runs” et confirmez qu'elle est terminée avant de recommencer.
Configuration non chargée, élément requis manquant ou automatisation en pause : vérifiez la configuration et son état d’activation sur “Automation” (chapitres 12 et 13).
Appuyez et maintenez une carte jusqu'à ce que l'indicateur de réorganisation apparaisse, puis faites-la glisser pour modifier l'ordre d'affichage.
Si aucune carte n’apparaît, lisez l’explication. Attendez si la configuration est en cours de chargement. Si le chargement échoue, conservez la raison et vérifiez “System Logs” sur le terminal. Si aucune action rapide n'est configurée, sélectionnez “Open Automation” et vérifiez le paramètre “Show on panel” des règles.
Ne redémarrez pas un appareil fournissant des services actifs uniquement pour restaurer une carte.
Les widgets de données affichent et actualisent les données de l’appareil dans le « Panneau des appareils ».
Sélectionnez « Gestionnaire de widgets ».
Choisissez un intervalle d'actualisation ou désactivez l'actualisation automatique.
Ajoutez un widget prédéfini ou choisissez un style de composant et une source de données proposés par la page.
Modifiez son étiquette, son style d'affichage et son unité selon vos besoins, puis enregistrez.
Les widgets existants peuvent être modifiés, supprimés et réorganisés. Vous pouvez également sélectionner une carte de widget pour la modifier. Appuyez longuement sur un widget, puis faites-le glisser vers une nouvelle position.
La barre d’état affiche « Température effective » et « Sortie actuelle ». Le grand pourcentage indique le réglage de régulation confirmé par l’appareil, pas la vitesse mesurée. RPM indique le nombre de tours par minute mesuré et reste masqué sans mesure valide. Si le grand affichage indique --, la sortie actuelle n’est pas confirmée.
Lorsque vous déplacez le curseur manuel, la valeur à côté indique le réglage que vous allez demander. Le grand pourcentage indique toujours la sortie actuelle. Relâchez le curseur, puis vérifiez le message et la valeur actualisée. Si la demande et la sortie actuelle diffèrent, ne considérez pas le réglage comme appliqué.
Le mode intelligent affiche son état : « Mode intelligent », « Suivi de la courbe », protection ou température non valide. Il affiche aussi la température de référence de sécurité, la température prévue dans 45 secondes et la vitesse de variation de la température.
Si la température devient invalide, vérifier que sa source est toujours à jour. L'appareil passe en contrôle de protection contre la perte de température. Sélectionnez « TTI » pour une explication du contrôle thermique intelligent.
Utilisez le bouton d'actualisation dans l'en-tête de section pour récupérer l'état actuel. Si le réglage échoue ou si la sortie n'est pas confirmée, vérifiez l'appareil avant de décider de réessayer.
Utilise un pourcentage de contrôle fixe défini avec le curseur 0-100%.
« Courbe »
Suit la courbe configurée entre la température et le pourcentage de contrôle.
« Intelligent »
Utilise la courbe de base, les tendances de température et les ajustements passés pour contrôler le refroidissement. Utilise un contrôle de protection en cas de besoin.
L'arrêt d'un ventilateur ou le réglage d'une valeur manuelle basse réduit le refroidissement. Vérifiez d’abord la charge et la température et continuez à les surveiller. Le curseur est disponible uniquement en mode manuel lorsque la sortie actuelle est confirmée.
Sélectionnez « Courbe » dans l'en-tête de la section Contrôle du ventilateur pour ouvrir « Gestion des courbes de ventilateur ». Le bouton « Courbe » à l’intérieur d’une carte change uniquement le mode de fonctionnement.
Sous « Ventilateur », choisissez le nombre à ajuster et vérifiez-le par rapport à la page Système.
Sous « Liaison des variables de température », ajoutez des variables de température et attribuez des poids.
Sélectionnez « Relier ». La source de température est partagée par les ventilateurs en modes Courbe et Intelligent, donc sa modification affecte les ventilateurs utilisant cette source.
Ajoutez ou modifiez des « nœuds de courbe ». Chaque courbe nécessite au moins des nœuds 2 et prend en charge jusqu'à 10.
Définissez la « Vitesse minimale » et la « Vitesse maximale » comme pourcentages de contrôle. Le minimum ne doit pas dépasser le maximum.
Réglez « Hystérésis de température » et « Intervalle minimum ». L’hystérésis accepte 0-20°C et limite les réglages fréquents dus à de petites variations de température. L’intervalle accepte 500-30000 ms. 1000 ms correspondent à 1 seconde.
Sélectionnez « Enregistrer la courbe ». Après une sauvegarde réussie, le ventilateur sélectionné passe en mode Courbe. Pour utiliser le contrôle thermique intelligent, revenez à la carte et sélectionnez « Smart ».
Si l'enregistrement échoue, lisez le message et vérifiez l'état actuel avant de réessayer. Après avoir dissocié les variables de température, vérifiez également la température effective et l’état du ventilateur.
Sélectionnez « Importer Config » et choisissez un fichier de courbe JSON. JSON est le format de fichier utilisé pour stocker les données de courbe. Passez en revue les nœuds, les limites et le numéro de ventilateur, puis sélectionnez « Enregistrer la courbe » pour les appliquer.
Sélectionnez « Exporter la configuration » pour télécharger la courbe actuelle. La page tente également d'enregistrer une copie sous /sdcard/config sur la carte SD. Vérifiez séparément le téléchargement du navigateur et le résultat de la carte SD rapporté.
Une température de test remplace temporairement la source normale et affecte le contrôle Curve ou Smart. Surveillez le ventilateur et l’appareil tout au long du test.
Entrez 0-100°C sous « Test Temp ».
Sélectionnez « Test » et observez la sortie actuelle, l'état et la réponse du ventilateur.
À la fin du test, sélectionnez « Effacer le test ». Vérifiez que la température effective provient à nouveau de sa source habituelle.
Utilisez le bouton ampoule situé en bas d'une carte pour allumer ou éteindre la LED.
Déplacez le curseur « Luminosité » ou choisissez une couleur ou un préréglage.
Utilisez le bouton d'animation pour ouvrir les « Paramètres LED ». Sélectionnez une animation sous « Animation programmatique », puis utilisez son contrôle de lecture ou d'arrêt.
Sélectionnez l'icône de sauvegarde en bas à droite de la carte pour enregistrer la configuration actuelle des LED.
Sélectionnez « All Off » pour éteindre toutes les LED et vérifier le résultat rapporté. Si certains échouent, vérifiez ces appareils.
Les cartes de la matrice proposent des icônes pour les fonctions disponibles. Ouvrez une fonction, puis changez de groupe dans « Paramètres LED » :
« Animation programmatique » : sélectionnez et exécutez une animation.
« Image/QR Code » : choisissez une image de la carte SD ou saisissez le contenu d'un code QR.
« Affichage du texte » : définissez le texte, la police, l'alignement, le défilement, le premier plan et l'arrière-plan.
« Filtre de post-traitement » : Choisissez un filtre et des paramètres, puis appliquez-le ou arrêtez-le.
« Correction des couleurs » : ajustez l'affichage et utilisez les commandes de réinitialisation, d'importation ou d'exportation disponibles.
Vérifiez la lumière réelle ou l'affichage matriciel après avoir appliqué une modification. Utilisez uniquement les fonctionnalités affichées. Si un paramètre échoue, suivez le message pour vérifier l’état du fichier, de l’entrée ou du périphérique.
Le haut de la page affiche l'état d'Ethernet, du client WiFi et du point d'accès WiFi. Ouvrez le panneau associé pour afficher l'adresse IP, le masque de sous-réseau, la passerelle, DNS, l'adresse MAC, SSID, le signal et le nombre d'appareils connectés lorsqu'ils sont disponibles.
Le panneau Ethernet affiche les informations actuelles sur la liaison et l'adresse. Il ne fournit pas de contrôles d'édition d'adresse.
Entrez un nouveau nom dans la section « Nom d'hôte » sous « Services réseau », puis sélectionnez « Définir ». La page affiche le nom d'hôte actuel après sa mise à jour.
DHCP attribue automatiquement des adresses réseau aux appareils connectés. Sélectionnez « Clients », choisissez « WiFi AP » ou « Ethernet » et affichez les baux en cours. Utilisez le bouton Actualiser pour recharger la liste.
NAT transmet le trafic réseau entre les interfaces réseau de l'appareil. Activez ou désactivez NAT, puis sélectionnez « Enregistrer » pour conserver le paramètre. Vérifiez ensuite l'état du WiFi et d'Ethernet.
Sous « Accès au réseau en amont », sélectionnez « Accès via LPMU ».
Entrez le mot de passe sudo LPMU et sélectionnez le bouton d'accès. Le mot de passe est utilisé uniquement pour cette exécution et n'est pas enregistré ; saisissez-le à nouveau pour une exécution ultérieure.
Attendez la fin de l'opération. Ne le redémarrez pas pendant le traitement.
L'accès est confirmé uniquement lorsque le résultat indique à la fois une connexion Internet et une configuration réseau terminée.
En cas d'échec ou si le résultat n'est pas confirmé, lisez d'abord la raison. Développez « Journal d'exécution » pour plus de détails. Vérifiez le mot de passe pour une erreur de mot de passe, ou le câblage et le réseau en amont si aucune connexion Internet n'est trouvée.
Un échec de demande d'état ne signifie pas que le script s'est arrêté. Utilisez le contrôle « Actualiser l'état » disponible pour vérifier l'exécution en cours avant de décider de réessayer.
Sélectionnez « Fichiers » dans la navigation supérieure pour ouvrir le « Gestionnaire de fichiers ».
La carte SD est un stockage amovible et SPIFFS est un stockage de fichiers interne à l'appareil. Sélectionnez « Carte SD » ou « SPIFFS » pour changer d'emplacement. Le chemin en haut montre votre dossier actuel. Sélectionnez un nom de dossier dans le chemin pour y revenir.
Les fichiers peuvent être envoyés uniquement sur la carte SD, pas dans SPIFFS. Vérifiez d’abord que la carte SD est montée.
Sélectionnez « Carte SD » et ouvrez le dossier où vous souhaitez envoyer les fichiers.
Sélectionnez « Envoyer des fichiers ».
Sélectionnez un ou plusieurs fichiers, ou faites-les glisser dans la zone d’envoi.
Vérifiez la liste des fichiers à envoyer et retirez ceux dont vous n’avez pas besoin.
Sélectionnez « Envoyer » et attendez la confirmation pour chaque fichier.
L’envoi d’un paquet .tscfg ouvre les étapes de vérification et d’application. Cette page de fichiers n’applique pas encore les réglages du paquet. Un envoi ou une vérification réussi ne signifie pas que les réglages sont actifs.
Importez les paquets de règles depuis « Automatisation », selon le chapitre 12. Un simple envoi de fichiers ne remplace pas l’importation de règles. Pour l’origine et la signature des autres paquets, consultez le Guide de sécurité.
La suppression ne peut pas être annulée dans l’interface Web. Supprimer un dossier supprime aussi son contenu. Vérifiez le nom et le chemin avant de choisir « Supprimer » ou « Suppression par lots » et de confirmer.
Les fichiers gérés par Automation sont protégés. Le téléchargement ou l'écrasement de fichiers dans /sdcard/config/automation, ou la suppression ou le renommage de ce dossier ou d'un parent le contenant, peuvent être refusés. Si le message indique que Automation gère le fichier, utilisez “Configuration & backup” sur Automation ou la liste appropriée. N'utilisez pas Terminal pour contourner la restriction.
Le démontage de la carte SD rend ses fichiers indisponibles jusqu’au prochain montage. Terminez les envois, les téléchargements et les autres opérations sur les fichiers avant de sélectionner « Démonter SD ».
Le démontage ou le remplacement de la carte peut faire basculer Automation vers sa configuration d'urgence interne. Cette copie est peut-être plus ancienne et les règles automatiques activées peuvent toujours s'exécuter. Sans copie utilisable, Automation peut être indisponible. Passez en revue la configuration et les tâches d'urgence avant le démontage (Chapitre 13). Les images, polices et journaux basés sur des cartes deviennent indisponibles.
Lorsque la carte SD n'est pas montée, la page affiche « Mount SD ». Sélectionnez-le, attendez que l'état passe à « Monté », puis ouvrez à nouveau le répertoire de la carte SD.
Le montage de la carte ne signifie pas que l'Automatisme a basculé dans sa configuration. Après avoir réinséré une carte, choisissez la configuration à utiliser comme décrit au chapitre 13. Rien n'est écrasé ou fusionné automatiquement.
La première mise à niveau à partir d'une ancienne configuration de stockage, telle que la version 0.6.2, nécessite un package USB/série correspondant approuvé par le fournisseur. L’envoi du micrologiciel ou de WebUI seul ne suffit pas pour effectuer cette mise à niveau. Demandez à l'administrateur de l'appareil ou au fournisseur de suivre les instructions du package. N'effacez pas l'intégralité du flash et n'utilisez pas une ancienne table de partition.
Enregistrez les fichiers importants et conservez la carte SD d'origine installée. Le premier démarrage migre la configuration existante ; garder l'alimentation connectée. Ensuite, vérifiez la connexion, la mise en réseau, les ventilateurs, l'éclairage, les hôtes SSH et les règles d'automatisation. Passez en revue les règles avant de tester une tâche qui contrôle l’alimentation, redémarre un appareil ou exécute des commandes à distance.
Le package correspondant met à jour les deux emplacements d’application. Ne présumez pas que l’autre emplacement contient toujours l’ancienne version. Si le mot de passe root est perdu, utilisez uniquement une méthode de récupération confirmée par le fournisseur pour correspondre à la mise en page 0.6.3. Ne flashez pas une ancienne image de réinitialisation de mot de passe.
Les méthodes de mise à jour Web ci-dessous s'appliquent uniquement aux versions que l'éditeur a approuvées pour OTA. Ils ne remplacent pas la première mise à niveau de la mise en page.
Saisissez l'adresse du serveur OTA fournie par un administrateur ou un éditeur.
Sélectionnez “Save” puis sélectionnez “Check Update”.
La page signale “Update Available” “Already up to date” une ancienne version du serveur ou une erreur.
Confirmez la version cible, puis sélectionnez “Upgrade Now” ou le contrôle de mise à niveau affiché sur la page.
Attendez la fin du téléchargement, de l'installation et du redémarrage. Pour annuler, utilisez le bouton “Abort” lorsqu'il est disponible. Toutes les étapes ne prennent pas en charge l'annulation.
Attendez la page pour confirmer le firmware après la mise à niveau. Reconnectez-vous au WebUI et vérifiez le “Current Version” et l'état de l'appareil.
“Upgrade Progress” affiche l'étape actuelle dans sa propre section. Une lecture à 100 % ou un message indiquant que les fichiers ont été écrits ne confirme pas un redémarrage et une vérification de version terminés. Si le résultat n'est pas confirmé ou si le micrologiciel en cours d'exécution diffère de la cible, conservez le message et vérifiez la version actuelle. Ne répétez pas la mise à niveau sans vérifier. Vérifiez les journaux système et contactez le fournisseur si nécessaire.
Lorsque “Also upgrade www” est activé, le micrologiciel et WebUI sont mis à jour en séquence. Utilisez le micrologiciel correspondant et les ressources WebUI de la même version. Si l'ancienne interface reste après la mise à niveau, actualisez de force le navigateur et vérifiez à nouveau la version et la page.
Développez « Mise à niveau manuelle » et choisissez l'une de ces méthodes :
« Mise à niveau à partir de l'URL » : saisissez l'URL du micrologiciel, définissez « Mise à niveau également www » conformément aux instructions de publication, puis sélectionnez « Mise à niveau ». Ici, www fait référence aux ressources de l’interface Web de l’appareil.
« Mise à niveau depuis la carte SD » : saisissez un chemin de micrologiciel tel que /sdcard/firmware.bin. Si « Mettre également à niveau www » est activé, assurez-vous que www.bin de la même version se trouve dans ce répertoire.
Pour une mise à niveau à partir d'une URL, « Ignorer la vérification du certificat » ignore la vérification du certificat du serveur HTTPS. Cela supprime la vérification du certificat utilisée pour confirmer l’identité du serveur de téléchargement. Laissez-le décoché pour les mises à jour de routine. Si vous voyez une erreur de certificat, demandez à votre administrateur de vérifier l'adresse du serveur et le certificat.
« Gestion des partitions » affiche la partition en cours d'exécution et les autres partitions disponibles.
« Mark Valid » confirme la version en cours d'exécution et désactive la protection automatique contre la restauration pour cette version. Utilisez-le après avoir confirmé que la version actuelle fonctionne correctement.
« Revenir à cette version » sélectionne une autre version amorçable et passe par un redémarrage. La restauration interrompt les services actuels. Confirmez d'abord la version cible et la compatibilité des données.
Une fois l'opération et le redémarrage terminés, rouvrez l'interface utilisateur Web et vérifiez la version actuelle et l'état de l'appareil.
La version 0.6.3 modifie le stockage de la configuration et la disposition des partitions de périphérique. Ne revenez pas directement à un ancien firmware incompatible. Si une rétrogradation est nécessaire, demandez au fournisseur de l'appareil de confirmer une procédure complète de récupération du micrologiciel, de la configuration et de la configuration.
La restauration ne restaure pas l'ancien format de configuration et ne garantit pas que les anciennes règles fonctionneront.
Sélectionnez « Sécurité » dans la navigation supérieure pour ouvrir la gestion de la sécurité. Utilisez le Guide de sécurité TianshanOS pour les clés SSH, les hôtes distants, les empreintes d'hôte connu, les certificats HTTPS, les packages de configuration et la gestion des comptes. Ces procédures ne sont pas répétées ici.
Un champ d'erreur rouge vous indique ce qu'il faut corriger. Corrigez-le, puis enregistrez. Une marque d'erreur effacée ne confirme pas une sauvegarde réussie ; vérifiez le message et la liste.
Identifiez l’opération qui a échoué, puis lisez le motif et l’étape suivante. Si le message ne donne aucun motif, ne le devinez pas.
Sélectionnez “Details” lorsque disponible. Sélectionnez “Hide” pour masquer les détails. Si un bouton × s'affiche, sélectionnez-le pour ignorer le message. Pour des vérifications plus approfondies, conservez une trace du message et des détails, puis ouvrez “System Logs” sur le terminal pour enquêter.
Si le résultat n’est pas confirmé, actualisez et vérifiez l’état de l’appareil, du fichier ou de la tâche. Un délai expiré ou une déconnexion ne signifie pas que l’opération n’a pas été exécutée. Ne répétez pas aussitôt une opération d’alimentation, de suppression, de lancement de tâche ou de mise à jour. Si le résultat reste inconnu, ouvrez « Journaux système » dans Terminal pour vérifier la cause.
Vérifiez séparément les résultats de lots réussis, échoués et non confirmés. Confirmez les fichiers enregistrés dans la liste de téléchargement du navigateur.
« Terminal » s'affiche uniquement pour root. Il peut exécuter directement les commandes de la console de l'appareil et afficher les journaux de l'appareil. Une commande peut changer l'état de l'appareil immédiatement. Confirmez sa source, ses paramètres et son impact avant de le saisir.
Sélectionnez « Terminal » dans la navigation supérieure.
Attendez « Connecté à l'appareil » et l'invite tianshan>.
Entrez help pour afficher les commandes fournies par le micrologiciel actuel.
Entrez une commande et appuyez sur Entrée. Attendez la fin de sa sortie et l'invite de retour.
Les commandes ne sont pas exécutées tant que la page affiche « Non connecté à l’appareil ». Après une coupure, attendez le message de reconnexion avant de renvoyer une commande pour éviter de l’exécuter deux fois.
Le terminal propose ces commandes au clavier :
Commande
Objectif
Ctrl+C
Efface l'entrée actuelle et demande une interruption. La commande doit prendre en charge l'interruption pour qu'elle s'arrête.
Ctrl+L
Effacer l'écran.
↑ / ↓
Parcourir l'historique des commandes à partir de la session de page en cours.
← / →
Déplace le curseur dans l'entrée actuelle.
« Effacer » en haut de la page efface uniquement l'affichage. Il n'annule pas les commandes déjà exécutées. « Déconnecter » met fin à la connexion actuelle du terminal.
Un shell SSH envoie les entrées clavier ultérieures à un hôte distant. Confirmez l'adresse cible, l'utilisateur et la méthode d'authentification, et effectuez la préparation SSH décrite dans le Guide de sécurité avant de vous connecter.
Entrez ssh --help pour afficher les options de la commande SSH.
Entrez ssh --host <host> --user <user> --shell, en remplaçant chaque espace réservé, y compris ses crochets angulaires, par la valeur réelle. Pour spécifier un port, ajoutez --port <port> avant --shell.
Attendez la confirmation de la connexion à distance avant de saisir des commandes à distance.
Appuyez sur Ctrl+\ pour quitter le shell SSH et revenir à l'invite tianshan>.
Ne saisissez pas d'informations d'identification en texte clair lorsque le terminal est partagé, enregistré ou consulté par une autre personne.
Sélectionnez « Journaux système » en haut du terminal pour ouvrir la fenêtre du journal.
« Niveau » définit le niveau minimum affiché. Utilisez ERROR, WARN+, INFO+ ou DEBUG+ pour affiner la sortie.
« TAG » filtre par source de journal.
« Recherche » filtre les journaux actuels par mot-clé.
« Défilement automatique » suit les nouvelles entrées du journal lorsqu'il est activé.
Le bouton Actualiser recharge les journaux historiques.
Le bouton Effacer efface uniquement les journaux actuellement affichés dans la fenêtre.
Si le filtrage ne produit aucune sortie, effacez d'abord TAG et Search, puis modifiez le niveau. La fermeture de la fenêtre du journal n'arrête pas les services de l'appareil.
Pour une vérification de ligne de commande, entrez auto --config status pour afficher l'emplacement de configuration actuel et l'état de la sauvegarde. Utilisez auto --help pour les options disponibles. L'ancienne option config --sync a été supprimée. Utilisez les étapes Web du chapitre 13 pour la sauvegarde et la récupération de routine.
« Commandes » enregistre des commandes SSH réutilisables et les exécute sur l’hôte distant choisi. Les hôtes et leurs données d’authentification se gèrent dans « Sécurité ». Consultez le guide de sécurité pour ces étapes.
L’empreinte aide à identifier l’hôte auquel vous vous connectez. Ces étapes concernent les tests d’hôtes SSH dans la page Web « Sécurité », pas la confirmation de SSH Shell dans Terminal. Si le message indique une empreinte non enregistrée ou modifiée, ne répétez pas la commande. Ouvrez « Sécurité », trouvez l’hôte SSH et sélectionnez « Tester ».
Lors de la première connexion, la boîte de dialogue affiche l’adresse et l’empreinte de l’hôte. Comparez-les avec l’administrateur par un canal fiable. Sélectionnez « Faire confiance et se connecter » uniquement après avoir confirmé leur correspondance.
Si l’empreinte a changé, la boîte de dialogue affiche l’ancienne et l’actuelle, avec « Annuler » sélectionné par défaut. Une réinstallation peut modifier l’empreinte, mais le changement peut aussi signaler un autre hôte ou une usurpation.
Vérifiez l’adresse et confirmez la cause du changement par un canal fiable. Si vous ne pouvez pas la confirmer, sélectionnez « Annuler ». Ne supprimez pas l’ancienne empreinte pour contourner la vérification. Sélectionnez « Mettre à jour la clé de l’hôte » seulement après avoir confirmé la fiabilité de la nouvelle empreinte.
Sélectionnez « Commandes » dans la navigation supérieure.
Choisissez un hôte actuellement affiché sous « Sélectionner un hôte ».
Consultez ses éléments enregistrés sous « Liste de commandes ».
“Orphan Commands” référence des hôtes qui n’existent plus et ne peuvent pas s’exécuter. Vérifiez la configuration de l'hôte. Pour conserver la tâche, recréez la commande sous un hôte valide, mettez à jour les modèles et les règles qui l'utilisent et vérifiez le résultat avant de supprimer l'orphelin.
Sélectionnez un hôte, puis sélectionnez « Nouvelle commande ». Utilisez le bouton Modifier sur une commande existante pour la modifier.
Entrez un « ID de commande » unique. Il peut contenir des lettres, des chiffres, des traits de soulignement et des traits d'union, et ne peut ni commencer ni se terminer par un trait de soulignement ou un trait d'union.
Saisissez « Nom de la commande » et « Commande ». Placez chaque commande sur une ligne distincte lorsque vous utilisez plusieurs lignes.
Ajoutez une description et choisissez une icône ou une image sur la carte SD si nécessaire.
Vérifiez le mode d'exécution et les options de correspondance de sortie, puis sélectionnez « Enregistrer ».
Le nom vous aide à reconnaître une commande ; L'automatisation utilise son identifiant pour le trouver. Vous ne pouvez pas modifier l'ID d'une commande existante. Pour utiliser un nouvel ID, créez une commande et mettez à jour les modèles et les sources qui l'utilisent.
Sélectionnez le contrôle d'exécution sur une carte de commande.
Regardez la sortie et l'état sous « Résultat de l'exécution ».
Lorsque « Annuler » s'affiche, utilisez-le pour demander l'interruption de la session en cours. Vérifiez l'état et la sortie pour confirmer s'ils se sont arrêtés. Les opérations à distance terminées ne sont pas annulées.
Sélectionnez « Effacer » pour supprimer l'affichage du résultat actuel.
« Effacer » n’annule pas ce qui a déjà été exécuté sur l’hôte distant. Le classement en réussite ou en échec, le contenu extrait et l’état final dépendent des critères configurés pour la commande.
La correspondance des résultats convertit la sortie distante en un état plus facile à utiliser.
« Correspondance attendue » : marque le résultat comme réussi lorsque la sortie contient le texte configuré.
« Fail Match » : marque l'échec du résultat lorsque la sortie contient le texte configuré.
« Extraire l'expression régulière » : utilise un groupe de capture (.*) pour enregistrer la sortie sélectionnée.
« Stop on match » : termine une commande continue après une correspondance réussie.
« Timeout (s) » : définit le temps d'attente pour une correspondance, en secondes. Cela s'applique uniquement lorsqu'un modèle de réussite ou d'échec est défini ou que « Arrêt en cas de correspondance » est activé.
« Nom de la variable » : enregistre l'état et la sortie extraite pour une utilisation sur la page Automatisation.
Choisissez un texte de réussite et d'échec stable et spécifique. Un texte large peut produire des correspondances incorrectes. Exécutez la commande une fois et examinez les « Résultats de correspondance » avant d'utiliser ses variables dans une règle.
nohup signifie qu'une commande continue de s'exécuter en arrière-plan de l'hôte distant après la fermeture de la connexion SSH. La fermeture de WebUI n'arrête pas une tâche en arrière-plan.
Les exécutions en arrière-plan nécessitent une authentification par clé SSH. Déployez la clé publique sur “Security” puis sélectionnez l'hôte associé. N'enregistrez pas les mots de passe en texte brut dans les commandes en arrière-plan. La même clé doit rester disponible pour arrêter ou vérifier la tâche d'origine.
Après avoir activé “Run in background (nohup)” et exécuté la commande, sélectionnez “Background runs” dans Commandes. Le contrôle root uniquement sur Système et le contrôle sur Automatisation ouvrent la même liste.
Recherchez la tâche d'origine par son nom, son utilisateur, son adresse hôte et son port.
Sélectionnez “Verify remote state” pour vérifier cette exécution sur l'hôte d'origine.“Refresh” lit uniquement les enregistrements connus ; cela ne remplace pas la vérification.
Sélectionnez “View Log” pour lire les 100 dernières lignes de l'hôte d'origine. Sélectionnez “Follow log” pour les mises à jour.“Stop following” arrête uniquement les mises à jour des pages.
Pour terminer la tâche, sélectionnez “Stop” sur sa fiche et validez. Attendez le résultat, puis vérifiez qu'il s'est arrêté. Ne le redémarrez pas sans vérifier.
Après le redémarrage de l’appareil, les anciens enregistrements affichent “Not checked”. “Remote state unconfirmed” signifie que l’état de la tâche, arrêtée ou en cours d’exécution, n’a pas été confirmé. “Last result” indique le dernier résultat confirmé et ne garantit pas l’état actuel.
Un échec de lecture ne signifie pas que le journal est vide ou que le processus est terminé. Vérifiez la connexion hôte d'origine, le chemin du journal et la clé SSH. Vérifiez à nouveau après avoir résolu le problème ; ne redémarrez pas une tâche simplement parce que sa vérification d'état a échoué.
La suppression d'une commande, la modification de sa configuration d'hôte ou le changement de configuration d'automatisation ne met pas fin à un processus distant. Gérer la tâche d'origine à partir de “Background runs”. La recréation d'une commande avec le même nom ou ID ne reprend pas la tâche d'origine. Conservez toute clé encore nécessaire pour le contrôler.
« Mode service » surveille une tâche en arrière-plan jusqu’à sa disponibilité. Renseignez « Critère de disponibilité » et « Nom de variable ». Ajustez si nécessaire le critère d’échec et les délais :
« Ready match » : marque le service prêt lorsque le texte configuré apparaît. Utilisez | pour séparer plusieurs modèles.
« Fail Match » : marque l'échec du service lorsque le texte configuré apparaît.
« Délai d'expiration (s) prêt » : définit l'attente la plus longue pour l'état prêt, en secondes.
« Intervalle de vérification (ms) » : définit la fréquence à laquelle le journal est vérifié, en millisecondes ; 1000 ms correspond à une seconde.
« Nom de la variable » : stocke les états tels que la vérification, la préparation et le délai d'attente.
Utilisez le bouton d'exportation d'une commande pour l'exporter et, une fois sélectionné, inclure sa configuration d'hôte dépendante.
Sélectionnez “Import Command”, choisissez un package de configuration .tscfg, prévisualisez son contenu et décidez s'il faut écraser la configuration existante.
L'importation peut inclure un hôte distant et remplacer la configuration par le même ID. Vérifiez la commande, l'hôte et les remplacements dans l'aperçu avant de confirmer. L'enregistrement met à jour la configuration actuelle sans redémarrage. Les processus distants existants ne s'arrêtent pas et ne sont pas déplacés vers le nouvel hôte.
Les nouvelles importations vérifient la source, la signature, l'autorisation de signature et le périphérique cible. Une exportation réussie ne garantit pas une importation ultérieure. Un certificat d'appareil destiné uniquement à HTTPS peut ne pas avoir l'autorisation de signer des packages de configuration. Demandez au fournisseur de configuration de résoudre ce problème ; ne désactivez pas la vérification.
Après avoir sélectionné Supprimer, examinez les modèles et règles liés. Choisissez une commande de remplacement disponible ou dissociez la configuration concernée et désactivez ses règles. Voir le chapitre 12 pour les étapes. La suppression modifie uniquement la configuration utilisée ; il ne met pas à jour l'autre copie d'urgence.
La suppression de la configuration et l'arrêt d'un service distant sont des opérations distinctes. La suppression n’arrête pas le service et n’annule pas les opérations terminées. Pour terminer une tâche distante, arrêtez-la depuis “Background runs” et confirmez le résultat.
« Automation » connecte les données et les opérations dans des flux de travail reproductibles. Créez des sources de données et des modèles d'action, puis utilisez des règles pour décider quand les exécuter.
Automatique : source de données → variable → évaluation des règles → actions
Manuel : action rapide de la page Système → actions
Les sources lisent les données, les variables contiennent des valeurs, les règles évaluent les conditions et les modèles définissent les tâches. Afficher une règle sur le panneau et autoriser l'exécution manuelle sont des paramètres distincts. Des règles automatiques peuvent également apparaître sur le panneau.
Le haut de la page affiche l'état du moteur, le nombre de règles, de variables et de sources, le nombre de déclencheurs et le temps d'exécution.
Contrôle
Effet
“Start”
Démarre un moteur arrêté. Les règles activées s'exécutent uniquement si la configuration actuelle permet l'exécution.
“Pause”
Suspend toute évaluation automatique ultérieure. Les actions existantes peuvent se poursuivre. Pour reprendre la page, arrêtez le moteur, puis démarrez-le.
“Stop”
Tente d'arrêter les vérifications des règles, la lecture des données et la planification d'actions ultérieures, tout en conservant la configuration. Attendez la confirmation ; un timeout ne signifie pas que le moteur s'est arrêté.
“Reload”
Lit à nouveau la configuration à partir de l'emplacement utilisé. Enregistrez les modifications et vérifiez le résultat. Une pause de configuration existante reste en place.
Vérifiez si le refroidissement, les alertes ou d'autres tâches en cours dépendent de l'automatisation. L'arrêt du moteur n'arrête pas un processus en arrière-plan distant. Arrêtez les tâches distantes de “Background runs” et confirmez le résultat.
“Disable automation” sous “Configuration & backup” est distinct de la commande “Pause” du moteur. Si la configuration est en pause, vérifiez-la avant de sélectionner “Enable automation”. Le redémarrage de l'appareil, le rechargement ou l'arrêt et le démarrage du moteur n'effacent pas cette pause de configuration. Voir le chapitre 13.
Créez une source et utilisez son test pour vérifier la connexion et les champs sélectionnés.
Activez-le, puis utilisez l'icône « Afficher les variables » de la ligne pour vérifier les valeurs et mettre à jour les heures.
Créez un modèle, vérifiez ses paramètres et sélectionnez « Test ». Les tests exécutent l’action immédiatement ; confirmez que l'appareil et l'hôte peuvent l'accepter.
Créez une règle avec « Activer immédiatement » désactivé. Définissez les conditions, le temps de recharge, l'ordre d'action, les délais et la répétition.
Réglez « Afficher sur le panneau » et « Autoriser le déclenchement manuel » selon vos besoins.
Enregistrez, puis activez la règle. Vérifiez les variables, le nombre de déclencheurs et les résultats réels.
Sélectionnez « Ajouter » sous « Sources de données » et choisissez un type : Type
Type
Objectif
«API REST»
Lit périodiquement les données d'une adresse HTTP.
« WebSocket »
Reçoit les données transmises via une connexion persistante.
« Socket. IO »
Reçoit les événements d'un service Socket. IO.
« Variable de commande »
Lit les résultats d'une commande à distance configurée.
Saisissez un identifiant unique, une étiquette d'affichage et les informations de connexion requises.
Utilisez le test pour vérifier la connexion. Obtenez les adresses, les détails d'authentification et les informations de champ auprès du fournisseur de données.
Pour les trois premiers types, sélectionnez les champs de la réponse au test. Laisser un nom d’événement Socket. IO vide permet au test de tenter la découverte d’événements.
Pour une variable de commande, sélectionnez l'hôte et une commande avec un nom de variable configuré, puis définissez l'intervalle d'interrogation.
Vérifiez le commutateur d'activation dans le formulaire, enregistrez et utilisez “View Variables” sur sa ligne pour vérifier le résultat.
Chaque ligne de source propose un interrupteur d’activation et des commandes pour voir les variables, exporter ou supprimer. Avant de désactiver ou de supprimer une source, vérifiez les règles qui l’utilisent pour ne pas interrompre leurs tâches.
Importer et exporter des packages de configuration. Prévisualisez les ID, les types et les remplacements avant l’importation, et suivez le Guide de sécurité pour connaître les exigences en matière de source et de confiance.
Sélectionnez l'icône « Afficher les variables » en forme d'œil sur une ligne source. La fenêtre affiche les noms, les types, les valeurs et les heures de mise à jour. Les variables de la commande à distance peuvent également être visualisées à partir du contrôle des variables de la commande.
Confirmez les noms et la source, et vérifiez que les valeurs et les types correspondent aux comparaisons de la règle.
Vérifiez si les heures de mise à jour correspondent à la fréquence de données attendue.
Si aucune donnée n'est disponible, vérifiez que la source est activée, puis testez la connexion et les champs. Pour les variables de commande, vérifiez également le résultat de l’exécution de la commande.
Sélectionnez « Ajouter » sous « Modèles d'action » et choisissez un type de tâche :
Type
Objectif
« Commande CLI »
Exécute une commande de console de périphérique locale.
« Commande SSH »
Exécute une commande à distance enregistrée sur la page Commandes.
« Contrôle LED »
Contrôle les couleurs, les effets ou le contenu des LED.
« Journal »
Écrit un message au niveau sélectionné.
« Définir la variable »
Attribue une valeur à une variable d'automatisation.
« Webhook »
L'option reste visible, mais l'exécution de l'action n'est pas implémentée. Il ne peut actuellement pas envoyer de demande.
Entrez un ID unique, un nom et les paramètres spécifiques au type. Définissez un délai ou une « exécution asynchrone » si nécessaire. Une action asynchrone se poursuit en arrière-plan ; vérifiez son résultat final via les journaux, les variables ou le périphérique cible.
CLI : saisissez la commande. Vous pouvez ajouter une variable de résultat et un délai d’expiration.
SSH : choisissez un hôte et une commande configurés, puis vérifiez l'aperçu.
LED : choisissez l’appareil et une opération prise en charge pour la couleur, l’effet, la luminosité, le texte, l’image, le code QR ou le filtre.
Journal : choisissez le niveau et le message. Le message peut faire référence à des variables.
Définir la variable : saisissez le nom et la valeur de la variable.
Webhook : actuellement indisponible. Choisissez plutôt une action prise en charge. Les packages de règles contenant des actions Webhook ne peuvent pas non plus être importés.
“Test” exécute l'action. Vérifiez l'effet des opérations d'alimentation, de redémarrage, de commande à distance ou de demande externe avant de procéder au test. Un message en file d'attente signifie que la tâche a été acceptée et non qu'elle a réussi. Vérifiez également les journaux système et le périphérique cible.
Après l'édition, enregistrez et vérifiez les paramètres. Si l’enregistrement échoue, conservez le brouillon et corrigez le problème signalé. Les importations peuvent remplacer les modèles ; examinez l’impact de la suppression avant d’en supprimer un. Si une image ou une police est manquante, insérez la carte SD originale ou sélectionnez une ressource disponible. La sauvegarde d'urgence ne sauvegarde pas ces fichiers.
La suppression d'une règle, d'un modèle, d'une commande SSH ou d'un hôte peut affecter d'autres configurations. Enregistrez d'abord une sauvegarde d'urgence si vous en avez besoin. La suppression ne peut pas être annulée à partir de la page.
Sélectionnez Supprimer dans la liste correspondante. Vérifiez le nom de la cible et les éléments concernés.
Confirmez la suppression s'il n'y a aucun lien. Sinon, choisissez un remplacement disponible ou “Unlink and disable affected rules”.
Actualisez ensuite la liste. Confirmez la suppression et vérifiez les modèles liés, les règles et les états d'activation.
La dissociation d'un modèle supprimé supprime son action des règles concernées et désactive ces règles. La suppression d'une commande SSH laisse les modèles liés comme brouillons désactivés avec la référence de commande effacée ; les règles concernées sont dissociées et désactivées. Avant de choisir un remplaçant, vérifiez sa cible et son action, pas seulement un nom similaire.
Lors de la suppression d'un hôte, examinez également les commandes et les sources concernées. Une commande sans hôte ne peut pas s'exécuter. Recréez les commandes nécessaires sous un hôte valide et mettez à jour leurs liens, puis vérifiez-les avant utilisation. La suppression de la configuration de l'hôte local est différente de la révocation d'une clé publique distante ; consultez le Guide de sécurité.
Si la suppression normale ne peut pas aboutir, sélectionnez “Force delete”, lisez les explications, puis confirmez. L’élément est supprimé, les liens identifiables sont retirés et les règles concernées sont désactivées. Les services distants en arrière-plan ne sont pas arrêtés.
Si toute l’étendue des conséquences ne peut pas être déterminée, la page vous demande de cocher “I agree to pause automation and continue deleting”. L’automatisation reste en pause après la suppression. Vérifiez et corrigez la configuration restante, puis sélectionnez “Enable automation” dans “Configuration & backup”. Un redémarrage ne réactive pas l’automatisation.
Si la configuration change pendant la confirmation, sélectionnez “Review deletion impact”, examinez la nouvelle liste et confirmez à nouveau. La suppression forcée ne peut pas garantir son exécution si l’écriture dans le stockage échoue. Vérifiez à nouveau la liste : la disparition d’une carte ne prouve pas que la suppression a été enregistrée.
Sélectionnez « Ajouter » sous « Règles » et entrez un identifiant, un nom et une icône uniques.
Sélectionnez “Logic” : AND exige que toutes les conditions soient remplies ; OR exige qu’au moins une condition soit remplie.
Définit le temps de recharge pour les déclencheurs automatiques. Les valeurs sont en ms ; 1000 ms correspond à une seconde.
Ajoutez des conditions et choisissez une variable, une comparaison et une valeur. Les comparaisons incluent égal, différent, supérieur à, supérieur ou égal, inférieur à, inférieur ou égal, valeur modifiée et contient. Faites correspondre le type de valeur à la variable.
Ajoutez des modèles et définissez les délais d'action, la répétition et les conditions au niveau de l'action.
Définissez « Afficher sur le panneau » et « Autoriser le déclenchement manuel ». Le premier contrôle la visibilité de la carte sur le système ; le second contrôle l’exécution manuelle.
Vérifiez, enregistrez, puis activez la règle. Laissez « Activer immédiatement » désactivé lors de la configuration pour la première fois.
L'enregistrement, l'activation ou la désactivation d'une règle met à jour la configuration actuelle sans redémarrage. Si l'automatisation est suspendue, l'enregistrement ne la reprend pas. Actualisez la liste et vérifiez le résultat. Mettez à jour la sauvegarde d'urgence après des modifications importantes, comme décrit au chapitre 13.
Se répète tant que la condition de l'action est respectée, jusqu'à 100 fois par exécution.
« Nombre fixe »
Se répète pour le nombre et l'intervalle configurés, en vérifiant la condition d'action avant chaque exécution.
Les conditions d'action sont distinctes des conditions de déclenchement de règle. Sans condition d'action, « Répéter tant que vrai » continue jusqu'à la limite par exécution. La règle peut déclencher une autre exécution ultérieurement.
La désactivation d'une règle empêche de nouveaux déclencheurs ; une course déjà commencée peut continuer. Pour arrêter de programmer des actions ultérieures, sélectionnez la commande « Stop » du moteur et attendez la confirmation. Vérifiez séparément les actions déjà envoyées et les processus distants. Les opérations terminées ne sont pas annulées.
« Déclenchement manuel uniquement », « Afficher sur le panneau » et « Autoriser le déclenchement manuel » contrôlent si une règle s'exécute uniquement manuellement, si sa carte est visible et si les utilisateurs peuvent l'exécuter.
Saisissez l'ID, le nom et l'icône, puis activez « Déclenchement manuel uniquement ». Une telle règle ne nécessite aucune condition de déclenchement automatique.
Ajoutez des modèles et examinez les retards, les répétitions et les conditions d'action.
Activez « Afficher sur le panneau » et « Autoriser le déclenchement manuel », puis enregistrez et activez la règle.
Revenez au panneau des périphériques système. Vérifiez le nom et l'état de la carte, exécutez-la une fois et examinez le résultat.
Des règles automatiques peuvent également apparaître sur le panneau. Montrer une carte ne rend pas sa règle uniquement manuelle. Une règle désactivée peut rester visible mais ne peut pas démarrer. Donnez des noms aux actions liées à admin qui expliquent leur effet et indiquez aux utilisateurs qui contacter pour vérifier ou arrêter les tâches en arrière-plan. Les utilisateurs de Root affichent les journaux, vérifient et arrêtent les services de “Background runs”.
Importez des packages de règles sur Automation, et non via le “Verify Only” de Security ou le téléchargement de fichiers. Ce contrôle vérifie le signataire, le périphérique cible et la configuration requise. Vérifiez chaque package via son propre contrôle d'importation ; le résultat d'un autre package ne s'applique pas.
Avant d'importer, préparez :
Confirmez si la carte SD ou la configuration d'urgence interne est utilisée et qu'elle peut être enregistrée. Voir le chapitre 13.
L'appareil dispose d'un certificat valide, de sa clé privée correspondante et d'une chaîne d'autorité de certification ; son heure est vérifiée. Une chaîne d'autorité de certification vérifie l'origine des certificats. Consultez le Guide de sécurité pour connaître les étapes d'installation.
L'administrateur de déploiement a sélectionné un signataire de confiance. La connexion Root ou l'installation de certificats HTTPS ne complète pas ce paramètre. Demandez à l'administrateur de déploiement de le configurer s'il est manquant.
Les modèles, commandes et hôtes de la règle sont prêts. Import ne les installe pas pour vous. Ajoutez d'abord toute configuration manquante. Si la règle est activée, vérifiez également l'état d'activation de la configuration qu'elle utilise.
L'enregistrement d'une importation met à jour la configuration actuelle sans redémarrage. Avant de confirmer, vérifiez l'état d'activation, les conditions, les actions et les cibles, et confirmez que l'exécution est sûre. Une pause de configuration existante reste en place. Pour empêcher l'exécution, désactivez d'abord Automation ou demandez au fournisseur une version désactivée.
Sélectionnez l'icône d'importation sous “Rules” pour ouvrir “Import Rule Configuration” puis choisissez le fichier .tscfg. La vérification démarre et la page affiche un aperçu.
Attendez “Signing trust, target device and rule content verified”. Vérifiez le nom, l'ID de la règle et “Rule summary”. Développez “View rule content” pour examiner les conditions, les actions, les cibles et l'état d'activation ; ne vous fiez pas au nom du fichier.
Si le même identifiant existe, vérifiez ce qui sera remplacé. Sélectionnez “Overwrite existing configuration” uniquement si vous avez l'intention de le remplacer. Si le fichier, les informations d'identification ou la configuration changent après l'aperçu, sélectionnez “Check package again”. Fermer et rouvrez l'éditeur si la page vous le demande, puis vérifiez à nouveau.
Sélectionnez “Confirm Import” et attendez le résultat de l'enregistrement. Vérifiez la liste des règles, l'état d'activation et les variables requises. Une sauvegarde réussie ne prouve pas une exécution réussie de la tâche.
Si la règle permet une vérification manuelle sécurisée, exécutez-la une fois et vérifiez le périphérique ou l'hôte. Pour les autres règles, surveillez les journaux et les résultats après un déclenchement normal. Pour effacer une pause de configuration, examinez la configuration avant de sélectionner “Enable automation”.
Les règles importées peuvent être modifiées, activées, désactivées et supprimées. Vérifiez la configuration actuelle après les modifications et mettez à jour la sauvegarde d'urgence si nécessaire. Une importation ultérieure nécessite toujours une vérification de signature ; l'autorisation de modifier localement ne la contourne pas.
Un certificat destiné uniquement au HTTPS peut ne pas autoriser la signature de configuration. Une exportation locale réussie peut toujours être rejetée à l'importation. Demandez au fournisseur de résoudre le problème lié à l'objectif du certificat ; ne désactivez pas la vérification et ne répétez pas l’importation.
Les importations et les modifications n'annulent pas les actions terminées et n'arrêtent pas les processus en arrière-plan distants. Terminez ces tâches séparément de “Background runs” et confirmez le résultat.
Signature root non sélectionnée, signataire non fiable ou signataire non autorisé
Demandez à l'administrateur de déploiement ou au fournisseur de configuration de vérifier la source de signature et les autorisations du certificat. Ne remplacez pas le “Verify Only” de Security et ne désactivez pas la vérification.
Le package cible un autre appareil
Demandez au fournisseur de l'exporter à l'aide du certificat de cet appareil ; ne changez pas le nom à l’intérieur du package. Organisez des packages de remplacement correspondants avant de modifier également le certificat de cet appareil.
L'heure de l'appareil n'est pas vérifiée
Vérifiez et synchronisez l'heure sous “Network & Time” sur le système, puis vérifiez à nouveau le fichier.
Chargement de la configuration
Attendez la fin, puis vérifiez à nouveau le package.
La configuration n'a pas pu être chargée
Vérifiez les journaux système, résolvez la cause et restaurez la configuration avant de vérifier à nouveau.
Configuration requise manquante
Ajoutez le modèle, la commande ou l'hôte nommé par la page, puis vérifiez à nouveau.
Configuration requise désactivée
Vérifiez s'il doit être activé. Une fois que l'exécution est sûre, activez-la et vérifiez à nouveau.
Action non prise en charge
Demandez au fournisseur de modifier le paquet. L’importation de packages de règles rejette actuellement les actions Webhook ; leur présence dans le sélecteur de modèle ne signifie pas que le package peut être importé.
Fichier, informations d'identification ou configuration modifiés après l'aperçu
Sélectionnez “Check package again”. Rouvrez l'éditeur ou sélectionnez le fichier comme indiqué, puis vérifiez et confirmez.
Vérifiez l'emplacement dans “Configuration & backup”. Résolvez le problème de stockage ou réduisez le contenu inutile, puis vérifiez à nouveau.
La configuration actuelle ou l'emplacement de sauvegarde ont été modifiés
Conservez et copiez le brouillon. Rouvrez l'éditeur, vérifiez la dernière configuration et soumettez-la à nouveau. Ne continuez pas à sélectionner Enregistrer.
Résultat de sauvegarde non confirmé
Actualisez et vérifiez le contenu de la règle et activez l'état. Si ce n’est toujours pas clair, inspectez les journaux système. Conservez l’emballage d’origine et ne répétez pas l’importation.
Une variable de condition sans échantillon ne signifie pas nécessairement une configuration manquante ; vérifiez quand il sera mis à jour. Si la configuration ne peut pas être lue, conservez les fichiers d'origine et vérifiez les journaux système. N'écrasez pas le contenu endommagé comme s'il était vide.
L'exécution manuelle nécessite une règle activée qui autorise les déclencheurs manuels, sans qu'aucune exécution de la même règle ne soit déjà en cours. Il contourne les conditions de déclenchement automatique et le temps de recharge, mais applique toujours les conditions d'action, les délais et la répétition.
La désactivation n'annule pas les actions terminées. La suppression ne peut pas être annulée à partir de la page.
Avant de modifier des sources, des modèles ou des commandes, vérifiez quelles règles les utilisent. Les modifications de configuration n'arrêtent pas les tâches distantes existantes. Vérifiez et arrêtez ces tâches séparément si nécessaire.
Importez chaque package via sa liste appropriée et examinez l'aperçu. Consultez le Guide de sécurité pour connaître les procédures complètes de signature et de compte.
Si l’enregistrement échoue, lisez le message et conservez le brouillon. Si l'enregistrement a réussi mais que l'actualisation a échoué, actualisez et vérifiez la liste avant de créer un autre élément.
Paramètres du système tels que la mise en réseau, les ventilateurs, la température et l'éclairage
Enregistré à l'intérieur de l'appareil. Une restauration de sauvegarde Automation ne les modifie pas.
Configuration actuelle de l'automatisation
Les ajouts, modifications et suppressions sont transférés sur la carte SD lors d'une utilisation normale du SD, ou vers le stockage interne en mode d'urgence.
Sauvegarde d'urgence interne
Lors de l'utilisation de la carte SD, elle se met à jour uniquement lorsque vous sélectionnez “Save emergency backup”. Les modifications en mode d'urgence mettent directement à jour cette configuration interne.
La sauvegarde d'urgence enregistre ensemble les règles, les modèles d'action, les commandes SSH, les hôtes associés, les sources et les définitions initiales des variables utilisateur. Il n'enregistre pas les clés privées, les images, les polices, les journaux ou les états d'exécution à distance. Les paramètres de l'hôte mémorisent uniquement la clé à utiliser ; la clé elle-même n'est pas copiée.
Il ne s'agit pas d'une sauvegarde complète de l'appareil. Conservez les fichiers et les clés importants grâce à leurs propres méthodes de sauvegarde. Une restauration ne signifie pas que les services distants se sont arrêtés ou que tous les fichiers nécessaires à une règle sont disponibles.
Confirmez que “Currently using” affiche “SD card configuration”, puis examinez les règles et tâches actuelles.
Sélectionnez “Save emergency backup” et attendez la fin.
Vérifiez “Last internal save” et “Backup status”. “Includes the current changes” signifie que la copie interne correspond à la configuration actuelle.
La sauvegarde remplace la sauvegarde d'urgence précédente. Les modifications ultérieures de la carte SD ne la mettent pas à jour. S'il n'inclut pas les dernières modifications, examinez le contenu actuel avant de décider de l'enregistrer à nouveau.
Lors de l'utilisation de “Internal emergency configuration”, les modifications sont enregistrées en interne. Vous n'avez pas besoin de sélectionner à nouveau “Save emergency backup”.
Une restauration remplace la configuration actuelle de la carte SD par la copie interne, qui peut être plus ancienne. Exportez d’abord toute configuration actuelle et tous les fichiers dont vous avez besoin. N'enregistrez pas d'abord une sauvegarde d'urgence ; cela écraserait l'ancienne copie que vous avez l'intention de restaurer.
Lors de l'utilisation de la configuration de la carte SD, sélectionnez “Restore emergency backup”.
Vérifiez les éléments ajoutés, modifiés et supprimés et vérifiez si l'automatisation restera en pause.
Confirmez et attendez la fin. Les listes sont mises à jour sans redémarrage de l'appareil.
Vérifiez les règles, les hôtes, les variables, les états d'activation et les résultats des tâches. S'il est toujours en pause, examinez la configuration avant de sélectionner “Enable automation”.
Une restauration ne modifie pas le réseau, les ventilateurs ou les clés. Cela ne met pas fin à l’exécution de services à distance. Gérez-les depuis “Background runs” si nécessaire.
S'il existe une configuration interne utilisable, l'appareil y bascule. Les règles automatiques activées suivent toujours leurs conditions ; les règles manuelles nécessitent toujours un clic. La copie interne est peut-être plus ancienne, alors vérifiez quelles tâches peuvent être exécutées avant un changement planifié.
Le mode d'urgence permet les ajouts, les modifications et les suppressions. Les sauvegardes vont directement dans le stockage interne. S’il n’existe aucune configuration interne utilisable, lisez d’abord la raison. Vous pouvez commencer avec une nouvelle configuration valide, mais n'écrasez pas les fichiers endommagés comme s'ils étaient vides.
La mise en réseau, les ventilateurs et autres paramètres système se chargent toujours à partir du stockage interne. La configuration d'urgence ne restaure pas les images, les polices ou les journaux de la carte SD. Insérez la carte originale ou sélectionnez les fichiers disponibles s'il manque des ressources. Une carte manquante ne signifie pas que toutes les fonctions s'arrêtent ou que chaque tâche peut continuer.
Insérez une carte SD utilisable et sélectionnez “Check SD card”, puis examinez les deux choix ci-dessous. L'insertion ne change ni ne fusionne les configurations. Fermez le panneau pour continuer à utiliser la configuration interne. Le redémarrage ne fait pas le choix à votre place.
Bouton
Que se passe-t-il
“Use SD card configuration”
Lit et passe à la configuration de la carte. La configuration interne est conservée et non copiée sur la carte.
“Save current configuration to SD card and use it”
Remplace la configuration de la carte par la configuration interne actuelle, puis passe à la carte. L'ancienne configuration de la carte est écrasée.
Vérifiez l'emplacement actuel et décidez quelle configuration conserver.
Sélectionnez le bouton approprié et consultez l'avis de remplacement et d'état d'activation. Avant d'écrire sur la carte, vérifiez les éléments ajoutés, modifiés et supprimés.
Confirmez et attendez. Vérifiez que “Currently using” affiche “SD card configuration”, puis examinez les listes et les résultats des tâches.
La configuration de la carte manquante ou vide n'est pas automatiquement remplie à partir de la mémoire interne. Confirmez qu'une configuration vide correspond à ce que vous souhaitez avant de la choisir. Si la carte ou la configuration change après l'aperçu, vérifiez à nouveau comme indiqué ; ne réutilisez pas l’ancienne confirmation.
La configuration interne est toujours utilisée. Sélectionnez “Use SD card configuration” pour terminer la commutation. N'écrasez plus la carte.
Configuration enregistrée, automatisation toujours en pause
Vérifiez la configuration, puis sélectionnez “Enable automation”. Ne l’enregistrez pas à nouveau et ne comptez pas sur un redémarrage pour lever la pause.
Suppression non enregistrée, Automatisation en pause
Vérifiez si la cible est toujours présente et si le stockage est disponible. Réparez et examinez la configuration avant de décider de l'activer ou non.
Résultat de sauvegarde non confirmé
Relisez l'emplacement et le contenu. Vérifiez les journaux système si nécessaire. Ne soumettez pas à nouveau la même modification sans vérifier.
L'entrée actuelle diffère de la dernière configuration
Copiez tout brouillon dont vous avez besoin avant de fermer et de rouvrir l'éditeur. Consultez le dernier contenu et saisissez vos modifications. La page ne fusionne pas les brouillons pour vous.
Après un changement, une restauration ou un enregistrement réussi, vérifiez si les tâches sont autorisées à s'exécuter et si elles se terminent. Une pause de configuration reste en place ; vérifiez et sélectionnez “Enable automation” pour reprendre. Une pause provoquée par “Disable automation” ou une suppression forcée n'est pas effacée par le redémarrage ou le changement de configuration.