* Added support for running applications from SD card (FAPs - Flipper Application Packages) * Added plugin_dist target for fbt to build FAPs * All apps of type FlipperAppType.EXTERNAL and FlipperAppType.PLUGIN are built as FAPs by default * Updated VSCode configuration for new fbt features - re-deploy stock configuration to use them * Added debugging support for FAPs with fbt debug & VSCode * Added public firmware API with automated versioning Co-authored-by: hedger <hedger@users.noreply.github.com> Co-authored-by: SG <who.just.the.doctor@gmail.com> Co-authored-by: あく <alleteam@gmail.com>
		
			
				
	
	
		
			100 lines
		
	
	
		
			3.4 KiB
		
	
	
	
		
			Python
		
	
	
	
	
	
			
		
		
	
	
			100 lines
		
	
	
		
			3.4 KiB
		
	
	
	
		
			Python
		
	
	
	
	
	
| #!/usr/bin/env python3
 | |
| 
 | |
| import posixpath
 | |
| from typing import final
 | |
| from flipper.app import App
 | |
| from flipper.storage import FlipperStorage
 | |
| from flipper.utils.cdc import resolve_port
 | |
| 
 | |
| import logging
 | |
| import os
 | |
| import pathlib
 | |
| import serial.tools.list_ports as list_ports
 | |
| 
 | |
| 
 | |
| class Main(App):
 | |
|     def init(self):
 | |
|         self.parser.add_argument("-p", "--port", help="CDC Port", default="auto")
 | |
| 
 | |
|         self.parser.add_argument("fap_src_path", help="App file to upload")
 | |
|         self.parser.add_argument(
 | |
|             "--fap_dst_dir", help="Upload path", default="/ext/apps", required=False
 | |
|         )
 | |
|         self.parser.set_defaults(func=self.install)
 | |
| 
 | |
|         # logging
 | |
|         self.logger = logging.getLogger()
 | |
| 
 | |
|     # make directory with exist check
 | |
|     def mkdir_on_storage(self, storage, flipper_dir_path):
 | |
|         if not storage.exist_dir(flipper_dir_path):
 | |
|             self.logger.debug(f'"{flipper_dir_path}" does not exist, creating')
 | |
|             if not storage.mkdir(flipper_dir_path):
 | |
|                 self.logger.error(f"Error: {storage.last_error}")
 | |
|                 return False
 | |
|         else:
 | |
|             self.logger.debug(f'"{flipper_dir_path}" already exists')
 | |
|         return True
 | |
| 
 | |
|     # send file with exist check and hash check
 | |
|     def send_file_to_storage(self, storage, flipper_file_path, local_file_path, force):
 | |
|         exists = storage.exist_file(flipper_file_path)
 | |
|         do_upload = not exists
 | |
|         if exists:
 | |
|             hash_local = storage.hash_local(local_file_path)
 | |
|             hash_flipper = storage.hash_flipper(flipper_file_path)
 | |
|             self.logger.debug(f"hash check: local {hash_local}, flipper {hash_flipper}")
 | |
|             do_upload = force or (hash_local != hash_flipper)
 | |
| 
 | |
|         if do_upload:
 | |
|             self.logger.info(f'Sending "{local_file_path}" to "{flipper_file_path}"')
 | |
|             if not storage.send_file(local_file_path, flipper_file_path):
 | |
|                 self.logger.error(f"Error: {storage.last_error}")
 | |
|                 return False
 | |
|         return True
 | |
| 
 | |
|     def install(self):
 | |
|         if not (port := resolve_port(self.logger, self.args.port)):
 | |
|             return 1
 | |
| 
 | |
|         storage = FlipperStorage(port)
 | |
|         storage.start()
 | |
| 
 | |
|         try:
 | |
|             fap_local_path = self.args.fap_src_path
 | |
|             self.args.fap_dst_dir = self.args.fap_dst_dir.rstrip("/\\")
 | |
| 
 | |
|             if not os.path.isfile(fap_local_path):
 | |
|                 self.logger.error(f"Error: source .fap ({fap_local_path}) not found")
 | |
|                 return -1
 | |
| 
 | |
|             fap_dst_path = posixpath.join(
 | |
|                 self.args.fap_dst_dir, os.path.basename(fap_local_path)
 | |
|             )
 | |
| 
 | |
|             self.logger.info(f'Installing "{fap_local_path}" to {fap_dst_path}')
 | |
| 
 | |
|             if not self.mkdir_on_storage(storage, self.args.fap_dst_dir):
 | |
|                 self.logger.error(f"Error: cannot create dir: {storage.last_error}")
 | |
|                 return -2
 | |
| 
 | |
|             if not self.send_file_to_storage(
 | |
|                 storage, fap_dst_path, fap_local_path, False
 | |
|             ):
 | |
|                 self.logger.error(f"Error: upload failed: {storage.last_error}")
 | |
|                 return -3
 | |
| 
 | |
|             storage.send_and_wait_eol(f'loader open "Applications" {fap_dst_path}\r')
 | |
|             result = storage.read.until(storage.CLI_EOL)
 | |
|             if len(result):
 | |
|                 self.logger.error(f"Unexpected response: {result.decode('ascii')}")
 | |
|                 return -4
 | |
| 
 | |
|             return 0
 | |
|         finally:
 | |
|             storage.stop()
 | |
| 
 | |
| 
 | |
| if __name__ == "__main__":
 | |
|     Main()()
 |