1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
|
// Copyright 2015 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef EXTENSIONS_BROWSER_API_WEBCAM_PRIVATE_VISCA_WEBCAM_H_
#define EXTENSIONS_BROWSER_API_WEBCAM_PRIVATE_VISCA_WEBCAM_H_
#include <memory>
#include <string>
#include <utility>
#include <vector>
#include "base/containers/circular_deque.h"
#include "base/functional/callback.h"
#include "base/memory/weak_ptr.h"
#include "extensions/browser/api/serial/serial_connection.h"
#include "extensions/browser/api/webcam_private/webcam.h"
#include "extensions/common/api/serial.h"
#include "extensions/common/extension_id.h"
#include "mojo/public/cpp/bindings/pending_remote.h"
namespace extensions {
class ViscaWebcam : public Webcam {
public:
ViscaWebcam();
ViscaWebcam(const ViscaWebcam&) = delete;
ViscaWebcam& operator=(const ViscaWebcam&) = delete;
using OpenCompleteCallback = base::RepeatingCallback<void(bool)>;
// Open and initialize the web camera. This is done by the following three
// steps (in order): 1. Open the serial port; 2. Request address; 3. Clear the
// command buffer. After these three steps completes, `open_callback` will be
// called.
void Open(const ExtensionId& extension_id,
api::SerialPortManager* port_manager,
const std::string& path,
const OpenCompleteCallback& open_callback);
private:
friend class ViscaWebcamTest;
enum InquiryType {
INQUIRY_PAN,
INQUIRY_TILT,
INQUIRY_ZOOM,
INQUIRY_FOCUS,
};
using CommandCompleteCallback =
base::RepeatingCallback<void(bool, const std::vector<char>&)>;
// Private because WebCam is base::RefCounted.
~ViscaWebcam() override;
// Callback function that will be called after the serial connection has been
// opened successfully.
void OnConnected(const OpenCompleteCallback& open_callback, bool success);
// Callback function that will be called after the address has been set
// successfully.
void OnAddressSetCompleted(const OpenCompleteCallback& open_callback,
bool success,
const std::vector<char>& response);
// Callback function that will be called after the command buffer has been
// cleared successfully.
void OnClearAllCompleted(const OpenCompleteCallback& open_callback,
bool success,
const std::vector<char>& response);
// Send or queue a command and wait for the camera's response.
void Send(const std::vector<char>& command,
const CommandCompleteCallback& callback);
void OnSendCompleted(const CommandCompleteCallback& callback,
uint32_t bytes_sent,
api::serial::SendError error);
void OnReceiveEvent(const CommandCompleteCallback& callback,
std::vector<uint8_t> data,
api::serial::ReceiveError error);
// Callback function that will be called after the send and reply of a command
// are both completed.
void OnCommandCompleted(const SetPTZCompleteCallback& callback,
bool success,
const std::vector<char>& response);
// Callback function that will be called after the send and reply of an
// inquiry are both completed.
void OnInquiryCompleted(InquiryType type,
const GetPTZCompleteCallback& callback,
bool success,
const std::vector<char>& response);
void ProcessNextCommand();
// Webcam Overrides:
void GetPan(const GetPTZCompleteCallback& callback) override;
void GetTilt(const GetPTZCompleteCallback& callback) override;
void GetZoom(const GetPTZCompleteCallback& callback) override;
void GetFocus(const GetPTZCompleteCallback& callback) override;
void SetPan(int value,
int pan_speed,
const SetPTZCompleteCallback& callback) override;
void SetTilt(int value,
int tilt_speed,
const SetPTZCompleteCallback& callback) override;
void SetZoom(int value, const SetPTZCompleteCallback& callback) override;
void SetPanDirection(PanDirection direction,
int pan_speed,
const SetPTZCompleteCallback& callback) override;
void SetTiltDirection(TiltDirection direction,
int tilt_speed,
const SetPTZCompleteCallback& callback) override;
void Reset(bool pan,
bool tilt,
bool zoom,
const SetPTZCompleteCallback& callback) override;
void SetHome(const SetPTZCompleteCallback& callback) override;
void SetFocus(int value, const SetPTZCompleteCallback& callback) override;
void SetAutofocusState(AutofocusState state,
const SetPTZCompleteCallback& callback) override;
void RestoreCameraPreset(int preset_number,
const SetPTZCompleteCallback& callback) override;
void SetCameraPreset(int preset_number,
const SetPTZCompleteCallback& callback) override;
// Used only in unit tests in place of Open().
void OpenForTesting(std::unique_ptr<SerialConnection> serial_connection);
// Used only in unit tests to retrieve `serial_connection_` since this class
// owns it.
SerialConnection* GetSerialConnectionForTesting();
std::unique_ptr<SerialConnection> serial_connection_;
// Stores the response for the current command.
std::vector<char> data_buffer_;
// Queues commands till the current command completes.
base::circular_deque<std::pair<std::vector<char>, CommandCompleteCallback>>
commands_;
// Visca webcam always get/set pan-tilt together. `pan` and `tilt` are used to
// store the current value of pan and tilt positions.
int pan_ = 0;
int tilt_ = 0;
};
} // namespace extensions
#endif // EXTENSIONS_BROWSER_API_WEBCAM_PRIVATE_VISCA_WEBCAM_H_
|
