/*
 * libthor - Tizen Thor communication protocol
 *
 * Licensed under the Apache License, Version 2.0 (the License);
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#ifndef THOR_H__
#define THOR_H__

#include <sys/types.h>
#include <stdio.h>
#include <stddef.h>

struct usb_device_id {
	const char *busid;
	int vid;
	int pid;
	const char *serial;
};

#define THOR_NET_PORT (23456)

struct net_device_id {
	const char *ip_addr;
	int port;
};

struct thor_device_id {
	struct usb_device_id usb_dev;
	struct net_device_id net_dev;
};

struct thor_device_handle;
typedef struct thor_device_handle thor_device_handle;

enum thor_data_type {
	THOR_NORMAL_DATA = 0,
	THOR_PIT_DATA,
};

struct thor_data_src_entry {
	char *name;
	off_t size;
};

struct thor_data_src {
	off_t (*get_file_length)(struct thor_data_src *src);
	off_t (*get_size)(struct thor_data_src *src);
	off_t (*get_block)(struct thor_data_src *src, void *data, off_t len);
	const char* (*get_name)(struct thor_data_src *src);
	int (*next_file)(struct thor_data_src *src);
	struct thor_data_src_entry **(*get_entries)(struct thor_data_src *src);
	void (*release)(struct thor_data_src *src);
};

enum thor_data_src_format {
	THOR_FORMAT_RAW = 0,
	THOR_FORMAT_TAR,
};

typedef void (*thor_progress_cb)(thor_device_handle *th,
				 struct thor_data_src *data,
				 off_t sent, off_t left,
				 int chunk_nmb, void *user_data);

typedef void (*thor_next_entry_cb)(thor_device_handle *th,
				 struct thor_data_src *data,
				 void *user_data);

enum thor_transport_type {
	THOR_TRANSPORT_USB = 0,
	THOR_TRANSPORT_NET,
	THOR_TRANSPORT_MAX,
};

/* Init the Thor library */
thor_device_handle *thor_init(enum thor_transport_type type);

/* Cleanup the thor library */
void thor_cleanup(thor_device_handle *th);

/* Open the device and prepare it for thor communication */
int thor_open(thor_device_handle *th, struct thor_device_id *dev_id, int wait);

/* Close the device */
void thor_close(thor_device_handle *th);

/* Get protocol version of the device */
int thor_get_proto_ver(thor_device_handle *th);

/* Start thor "session" */
int thor_start_session(thor_device_handle *th, off_t total);

/* Send a butch of data to the target */
int thor_send_data(thor_device_handle *th, struct thor_data_src *data,
		   enum thor_data_type type, thor_progress_cb report_progress,
		   void *user_data, thor_next_entry_cb report_next_entry,
		   void *ne_cb_data);

/* End the session */
int thor_end_session(thor_device_handle *th);

/* Open a standard file or archive as data source for thor */
int thor_get_data_src(const char *path, enum thor_data_src_format format,
		      struct thor_data_src **data);

/* Release data source */
void thor_release_data_src(struct thor_data_src *data);

/* Request target reboot */
int thor_reboot(thor_device_handle *th);

#endif /* THOR_H__ */