1 /*
2  * Copyright (C) 2011 The Android Open Source Project
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  *      http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
17 #include "recovery_ui/screen_ui.h"
18 
19 #include <dirent.h>
20 #include <errno.h>
21 #include <fcntl.h>
22 #include <stdarg.h>
23 #include <stdio.h>
24 #include <stdlib.h>
25 #include <string.h>
26 #include <sys/stat.h>
27 #include <sys/time.h>
28 #include <sys/types.h>
29 #include <time.h>
30 #include <unistd.h>
31 
32 #include <algorithm>
33 #include <chrono>
34 #include <memory>
35 #include <string>
36 #include <thread>
37 #include <unordered_map>
38 #include <vector>
39 
40 #include <android-base/chrono_utils.h>
41 #include <android-base/logging.h>
42 #include <android-base/properties.h>
43 #include <android-base/stringprintf.h>
44 #include <android-base/strings.h>
45 
46 #include "minui/minui.h"
47 #include "otautil/paths.h"
48 #include "recovery_ui/device.h"
49 #include "recovery_ui/ui.h"
50 
51 // Return the current time as a double (including fractions of a second).
now()52 static double now() {
53   struct timeval tv;
54   gettimeofday(&tv, nullptr);
55   return tv.tv_sec + tv.tv_usec / 1000000.0;
56 }
57 
Menu(size_t initial_selection,const DrawInterface & draw_func)58 Menu::Menu(size_t initial_selection, const DrawInterface& draw_func)
59     : selection_(initial_selection), draw_funcs_(draw_func) {}
60 
selection() const61 size_t Menu::selection() const {
62   return selection_;
63 }
64 
TextMenu(bool scrollable,size_t max_items,size_t max_length,const std::vector<std::string> & headers,const std::vector<std::string> & items,size_t initial_selection,int char_height,const DrawInterface & draw_funcs)65 TextMenu::TextMenu(bool scrollable, size_t max_items, size_t max_length,
66                    const std::vector<std::string>& headers, const std::vector<std::string>& items,
67                    size_t initial_selection, int char_height, const DrawInterface& draw_funcs)
68     : Menu(initial_selection, draw_funcs),
69       scrollable_(scrollable),
70       max_display_items_(max_items),
71       max_item_length_(max_length),
72       text_headers_(headers),
73       menu_start_(0),
74       char_height_(char_height) {
75   CHECK_LE(max_items, static_cast<size_t>(std::numeric_limits<int>::max()));
76 
77   // It's fine to have more entries than text_rows_ if scrollable menu is supported.
78   size_t items_count = scrollable_ ? items.size() : std::min(items.size(), max_display_items_);
79   for (size_t i = 0; i < items_count; ++i) {
80     text_items_.emplace_back(items[i].substr(0, max_item_length_));
81   }
82 
83   CHECK(!text_items_.empty());
84 }
85 
text_headers() const86 const std::vector<std::string>& TextMenu::text_headers() const {
87   return text_headers_;
88 }
89 
TextItem(size_t index) const90 std::string TextMenu::TextItem(size_t index) const {
91   CHECK_LT(index, text_items_.size());
92 
93   return text_items_[index];
94 }
95 
MenuStart() const96 size_t TextMenu::MenuStart() const {
97   return menu_start_;
98 }
99 
MenuEnd() const100 size_t TextMenu::MenuEnd() const {
101   return std::min(ItemsCount(), menu_start_ + max_display_items_);
102 }
103 
ItemsCount() const104 size_t TextMenu::ItemsCount() const {
105   return text_items_.size();
106 }
107 
ItemsOverflow(std::string * cur_selection_str) const108 bool TextMenu::ItemsOverflow(std::string* cur_selection_str) const {
109   if (!scrollable_ || ItemsCount() <= max_display_items_) {
110     return false;
111   }
112 
113   *cur_selection_str =
114       android::base::StringPrintf("Current item: %zu/%zu", selection_ + 1, ItemsCount());
115   return true;
116 }
117 
118 // TODO(xunchang) modify the function parameters to button up & down.
Select(int sel)119 int TextMenu::Select(int sel) {
120   CHECK_LE(ItemsCount(), static_cast<size_t>(std::numeric_limits<int>::max()));
121   int count = ItemsCount();
122 
123   // Wraps the selection at boundary if the menu is not scrollable.
124   if (!scrollable_) {
125     if (sel < 0) {
126       selection_ = count - 1;
127     } else if (sel >= count) {
128       selection_ = 0;
129     } else {
130       selection_ = sel;
131     }
132 
133     return selection_;
134   }
135 
136   if (sel < 0) {
137     selection_ = 0;
138   } else if (sel >= count) {
139     selection_ = count - 1;
140   } else {
141     if (static_cast<size_t>(sel) < menu_start_) {
142       menu_start_--;
143     } else if (static_cast<size_t>(sel) >= MenuEnd()) {
144       menu_start_++;
145     }
146     selection_ = sel;
147   }
148 
149   return selection_;
150 }
151 
DrawHeader(int x,int y) const152 int TextMenu::DrawHeader(int x, int y) const {
153   int offset = 0;
154 
155   draw_funcs_.SetColor(UIElement::HEADER);
156   if (!scrollable()) {
157     offset += draw_funcs_.DrawWrappedTextLines(x, y + offset, text_headers());
158   } else {
159     offset += draw_funcs_.DrawTextLines(x, y + offset, text_headers());
160     // Show the current menu item number in relation to total number if items don't fit on the
161     // screen.
162     std::string cur_selection_str;
163     if (ItemsOverflow(&cur_selection_str)) {
164       offset += draw_funcs_.DrawTextLine(x, y + offset, cur_selection_str, true);
165     }
166   }
167 
168   return offset;
169 }
170 
DrawItems(int x,int y,int screen_width,bool long_press) const171 int TextMenu::DrawItems(int x, int y, int screen_width, bool long_press) const {
172   int offset = 0;
173 
174   draw_funcs_.SetColor(UIElement::MENU);
175   // Do not draw the horizontal rule for wear devices.
176   if (!scrollable()) {
177     offset += draw_funcs_.DrawHorizontalRule(y + offset) + 4;
178   }
179   for (size_t i = MenuStart(); i < MenuEnd(); ++i) {
180     bool bold = false;
181     if (i == selection()) {
182       // Draw the highlight bar.
183       draw_funcs_.SetColor(long_press ? UIElement::MENU_SEL_BG_ACTIVE : UIElement::MENU_SEL_BG);
184 
185       int bar_height = char_height_ + 4;
186       draw_funcs_.DrawHighlightBar(0, y + offset - 2, screen_width, bar_height);
187 
188       // Bold white text for the selected item.
189       draw_funcs_.SetColor(UIElement::MENU_SEL_FG);
190       bold = true;
191     }
192     offset += draw_funcs_.DrawTextLine(x, y + offset, TextItem(i), bold);
193 
194     draw_funcs_.SetColor(UIElement::MENU);
195   }
196   offset += draw_funcs_.DrawHorizontalRule(y + offset);
197 
198   return offset;
199 }
200 
GraphicMenu(const GRSurface * graphic_headers,const std::vector<const GRSurface * > & graphic_items,size_t initial_selection,const DrawInterface & draw_funcs)201 GraphicMenu::GraphicMenu(const GRSurface* graphic_headers,
202                          const std::vector<const GRSurface*>& graphic_items,
203                          size_t initial_selection, const DrawInterface& draw_funcs)
204     : Menu(initial_selection, draw_funcs) {
205   graphic_headers_ = graphic_headers->Clone();
206   graphic_items_.reserve(graphic_items.size());
207   for (const auto& item : graphic_items) {
208     graphic_items_.emplace_back(item->Clone());
209   }
210 }
211 
Select(int sel)212 int GraphicMenu::Select(int sel) {
213   CHECK_LE(graphic_items_.size(), static_cast<size_t>(std::numeric_limits<int>::max()));
214   int count = graphic_items_.size();
215 
216   // Wraps the selection at boundary if the menu is not scrollable.
217   if (sel < 0) {
218     selection_ = count - 1;
219   } else if (sel >= count) {
220     selection_ = 0;
221   } else {
222     selection_ = sel;
223   }
224 
225   return selection_;
226 }
227 
DrawHeader(int x,int y) const228 int GraphicMenu::DrawHeader(int x, int y) const {
229   draw_funcs_.SetColor(UIElement::HEADER);
230   draw_funcs_.DrawTextIcon(x, y, graphic_headers_.get());
231   return graphic_headers_->height;
232 }
233 
DrawItems(int x,int y,int screen_width,bool long_press) const234 int GraphicMenu::DrawItems(int x, int y, int screen_width, bool long_press) const {
235   int offset = 0;
236 
237   draw_funcs_.SetColor(UIElement::MENU);
238   offset += draw_funcs_.DrawHorizontalRule(y + offset) + 4;
239 
240   for (size_t i = 0; i < graphic_items_.size(); i++) {
241     auto& item = graphic_items_[i];
242     if (i == selection_) {
243       draw_funcs_.SetColor(long_press ? UIElement::MENU_SEL_BG_ACTIVE : UIElement::MENU_SEL_BG);
244 
245       int bar_height = item->height + 4;
246       draw_funcs_.DrawHighlightBar(0, y + offset - 2, screen_width, bar_height);
247 
248       // Bold white text for the selected item.
249       draw_funcs_.SetColor(UIElement::MENU_SEL_FG);
250     }
251     draw_funcs_.DrawTextIcon(x, y + offset, item.get());
252     offset += item->height;
253 
254     draw_funcs_.SetColor(UIElement::MENU);
255   }
256   offset += draw_funcs_.DrawHorizontalRule(y + offset);
257 
258   return offset;
259 }
260 
Validate(size_t max_width,size_t max_height,const GRSurface * graphic_headers,const std::vector<const GRSurface * > & graphic_items)261 bool GraphicMenu::Validate(size_t max_width, size_t max_height, const GRSurface* graphic_headers,
262                            const std::vector<const GRSurface*>& graphic_items) {
263   int offset = 0;
264   if (!ValidateGraphicSurface(max_width, max_height, offset, graphic_headers)) {
265     return false;
266   }
267   offset += graphic_headers->height;
268 
269   for (const auto& item : graphic_items) {
270     if (!ValidateGraphicSurface(max_width, max_height, offset, item)) {
271       return false;
272     }
273     offset += item->height;
274   }
275 
276   return true;
277 }
278 
ValidateGraphicSurface(size_t max_width,size_t max_height,int y,const GRSurface * surface)279 bool GraphicMenu::ValidateGraphicSurface(size_t max_width, size_t max_height, int y,
280                                          const GRSurface* surface) {
281   if (!surface) {
282     fprintf(stderr, "Graphic surface can not be null\n");
283     return false;
284   }
285 
286   if (surface->pixel_bytes != 1 || surface->width != surface->row_bytes) {
287     fprintf(stderr, "Invalid graphic surface, pixel bytes: %zu, width: %zu row_bytes: %zu\n",
288             surface->pixel_bytes, surface->width, surface->row_bytes);
289     return false;
290   }
291 
292   if (surface->width > max_width || surface->height > max_height - y) {
293     fprintf(stderr,
294             "Graphic surface doesn't fit into the screen. width: %zu, height: %zu, max_width: %zu,"
295             " max_height: %zu, vertical offset: %d\n",
296             surface->width, surface->height, max_width, max_height, y);
297     return false;
298   }
299 
300   return true;
301 }
302 
ScreenRecoveryUI()303 ScreenRecoveryUI::ScreenRecoveryUI() : ScreenRecoveryUI(false) {}
304 
305 constexpr int kDefaultMarginHeight = 0;
306 constexpr int kDefaultMarginWidth = 0;
307 constexpr int kDefaultAnimationFps = 30;
308 
ScreenRecoveryUI(bool scrollable_menu)309 ScreenRecoveryUI::ScreenRecoveryUI(bool scrollable_menu)
310     : margin_width_(
311           android::base::GetIntProperty("ro.recovery.ui.margin_width", kDefaultMarginWidth)),
312       margin_height_(
313           android::base::GetIntProperty("ro.recovery.ui.margin_height", kDefaultMarginHeight)),
314       animation_fps_(
315           android::base::GetIntProperty("ro.recovery.ui.animation_fps", kDefaultAnimationFps)),
316       density_(static_cast<float>(android::base::GetIntProperty("ro.sf.lcd_density", 160)) / 160.f),
317       current_icon_(NONE),
318       current_frame_(0),
319       intro_done_(false),
320       progressBarType(EMPTY),
321       progressScopeStart(0),
322       progressScopeSize(0),
323       progress(0),
324       pagesIdentical(false),
325       text_cols_(0),
326       text_rows_(0),
327       text_(nullptr),
328       text_col_(0),
329       text_row_(0),
330       show_text(false),
331       show_text_ever(false),
332       scrollable_menu_(scrollable_menu),
333       file_viewer_text_(nullptr),
334       stage(-1),
335       max_stage(-1),
336       locale_(""),
337       rtl_locale_(false) {}
338 
~ScreenRecoveryUI()339 ScreenRecoveryUI::~ScreenRecoveryUI() {
340   progress_thread_stopped_ = true;
341   if (progress_thread_.joinable()) {
342     progress_thread_.join();
343   }
344   // No-op if gr_init() (via Init()) was not called or had failed.
345   gr_exit();
346 }
347 
GetCurrentFrame() const348 const GRSurface* ScreenRecoveryUI::GetCurrentFrame() const {
349   if (current_icon_ == INSTALLING_UPDATE || current_icon_ == ERASING) {
350     return intro_done_ ? loop_frames_[current_frame_].get() : intro_frames_[current_frame_].get();
351   }
352   return error_icon_.get();
353 }
354 
GetCurrentText() const355 const GRSurface* ScreenRecoveryUI::GetCurrentText() const {
356   switch (current_icon_) {
357     case ERASING:
358       return erasing_text_.get();
359     case ERROR:
360       return error_text_.get();
361     case INSTALLING_UPDATE:
362       return installing_text_.get();
363     case NO_COMMAND:
364       return no_command_text_.get();
365     case NONE:
366       abort();
367   }
368 }
369 
PixelsFromDp(int dp) const370 int ScreenRecoveryUI::PixelsFromDp(int dp) const {
371   return dp * density_;
372 }
373 
374 // Here's the intended layout:
375 
376 //          | portrait    large        landscape      large
377 // ---------+-------------------------------------------------
378 //      gap |
379 // icon     |                   (200dp)
380 //      gap |    68dp      68dp             56dp      112dp
381 // text     |                    (14sp)
382 //      gap |    32dp      32dp             26dp       52dp
383 // progress |                     (2dp)
384 //      gap |
385 
386 // Note that "baseline" is actually the *top* of each icon (because that's how our drawing routines
387 // work), so that's the more useful measurement for calling code. We use even top and bottom gaps.
388 
389 enum Layout { PORTRAIT = 0, PORTRAIT_LARGE = 1, LANDSCAPE = 2, LANDSCAPE_LARGE = 3, LAYOUT_MAX };
390 enum Dimension { TEXT = 0, ICON = 1, DIMENSION_MAX };
391 static constexpr int kLayouts[LAYOUT_MAX][DIMENSION_MAX] = {
392   { 32, 68 },   // PORTRAIT
393   { 32, 68 },   // PORTRAIT_LARGE
394   { 26, 56 },   // LANDSCAPE
395   { 52, 112 },  // LANDSCAPE_LARGE
396 };
397 
GetAnimationBaseline() const398 int ScreenRecoveryUI::GetAnimationBaseline() const {
399   return GetTextBaseline() - PixelsFromDp(kLayouts[layout_][ICON]) -
400          gr_get_height(loop_frames_[0].get());
401 }
402 
GetTextBaseline() const403 int ScreenRecoveryUI::GetTextBaseline() const {
404   return GetProgressBaseline() - PixelsFromDp(kLayouts[layout_][TEXT]) -
405          gr_get_height(installing_text_.get());
406 }
407 
GetProgressBaseline() const408 int ScreenRecoveryUI::GetProgressBaseline() const {
409   int elements_sum = gr_get_height(loop_frames_[0].get()) + PixelsFromDp(kLayouts[layout_][ICON]) +
410                      gr_get_height(installing_text_.get()) + PixelsFromDp(kLayouts[layout_][TEXT]) +
411                      gr_get_height(progress_bar_fill_.get());
412   int bottom_gap = (ScreenHeight() - elements_sum) / 2;
413   return ScreenHeight() - bottom_gap - gr_get_height(progress_bar_fill_.get());
414 }
415 
416 // Clear the screen and draw the currently selected background icon (if any).
417 // Should only be called with updateMutex locked.
draw_background_locked()418 void ScreenRecoveryUI::draw_background_locked() {
419   pagesIdentical = false;
420   gr_color(0, 0, 0, 255);
421   gr_clear();
422   if (current_icon_ != NONE) {
423     if (max_stage != -1) {
424       int stage_height = gr_get_height(stage_marker_empty_.get());
425       int stage_width = gr_get_width(stage_marker_empty_.get());
426       int x = (ScreenWidth() - max_stage * gr_get_width(stage_marker_empty_.get())) / 2;
427       int y = ScreenHeight() - stage_height - margin_height_;
428       for (int i = 0; i < max_stage; ++i) {
429         const auto& stage_surface = (i < stage) ? stage_marker_fill_ : stage_marker_empty_;
430         DrawSurface(stage_surface.get(), 0, 0, stage_width, stage_height, x, y);
431         x += stage_width;
432       }
433     }
434 
435     const auto& text_surface = GetCurrentText();
436     int text_x = (ScreenWidth() - gr_get_width(text_surface)) / 2;
437     int text_y = GetTextBaseline();
438     gr_color(255, 255, 255, 255);
439     DrawTextIcon(text_x, text_y, text_surface);
440   }
441 }
442 
443 // Draws the animation and progress bar (if any) on the screen. Does not flip pages. Should only be
444 // called with updateMutex locked.
draw_foreground_locked()445 void ScreenRecoveryUI::draw_foreground_locked() {
446   if (current_icon_ != NONE) {
447     const auto& frame = GetCurrentFrame();
448     int frame_width = gr_get_width(frame);
449     int frame_height = gr_get_height(frame);
450     int frame_x = (ScreenWidth() - frame_width) / 2;
451     int frame_y = GetAnimationBaseline();
452     if (frame_x >= 0 && frame_y >= 0 && (frame_x + frame_width) < ScreenWidth() &&
453         (frame_y + frame_height) < ScreenHeight())
454       DrawSurface(frame, 0, 0, frame_width, frame_height, frame_x, frame_y);
455   }
456 
457   if (progressBarType != EMPTY) {
458     int width = gr_get_width(progress_bar_empty_.get());
459     int height = gr_get_height(progress_bar_empty_.get());
460 
461     int progress_x = (ScreenWidth() - width) / 2;
462     int progress_y = GetProgressBaseline();
463 
464     // Erase behind the progress bar (in case this was a progress-only update)
465     gr_color(0, 0, 0, 255);
466     DrawFill(progress_x, progress_y, width, height);
467 
468     if (progressBarType == DETERMINATE) {
469       float p = progressScopeStart + progress * progressScopeSize;
470       int pos = static_cast<int>(p * width);
471 
472       if (rtl_locale_) {
473         // Fill the progress bar from right to left.
474         if (pos > 0) {
475           DrawSurface(progress_bar_fill_.get(), width - pos, 0, pos, height,
476                       progress_x + width - pos, progress_y);
477         }
478         if (pos < width - 1) {
479           DrawSurface(progress_bar_empty_.get(), 0, 0, width - pos, height, progress_x, progress_y);
480         }
481       } else {
482         // Fill the progress bar from left to right.
483         if (pos > 0) {
484           DrawSurface(progress_bar_fill_.get(), 0, 0, pos, height, progress_x, progress_y);
485         }
486         if (pos < width - 1) {
487           DrawSurface(progress_bar_empty_.get(), pos, 0, width - pos, height, progress_x + pos,
488                       progress_y);
489         }
490       }
491     }
492   }
493 }
494 
SetColor(UIElement e) const495 void ScreenRecoveryUI::SetColor(UIElement e) const {
496   switch (e) {
497     case UIElement::INFO:
498       gr_color(249, 194, 0, 255);
499       break;
500     case UIElement::HEADER:
501       gr_color(247, 0, 6, 255);
502       break;
503     case UIElement::MENU:
504     case UIElement::MENU_SEL_BG:
505       gr_color(0, 106, 157, 255);
506       break;
507     case UIElement::MENU_SEL_BG_ACTIVE:
508       gr_color(0, 156, 100, 255);
509       break;
510     case UIElement::MENU_SEL_FG:
511       gr_color(255, 255, 255, 255);
512       break;
513     case UIElement::LOG:
514       gr_color(196, 196, 196, 255);
515       break;
516     case UIElement::TEXT_FILL:
517       gr_color(0, 0, 0, 160);
518       break;
519     default:
520       gr_color(255, 255, 255, 255);
521       break;
522   }
523 }
524 
SelectAndShowBackgroundText(const std::vector<std::string> & locales_entries,size_t sel)525 void ScreenRecoveryUI::SelectAndShowBackgroundText(const std::vector<std::string>& locales_entries,
526                                                    size_t sel) {
527   SetLocale(locales_entries[sel]);
528   std::vector<std::string> text_name = { "erasing_text", "error_text", "installing_text",
529                                          "installing_security_text", "no_command_text" };
530   std::unordered_map<std::string, std::unique_ptr<GRSurface>> surfaces;
531   for (const auto& name : text_name) {
532     auto text_image = LoadLocalizedBitmap(name);
533     if (!text_image) {
534       Print("Failed to load %s\n", name.c_str());
535       return;
536     }
537     surfaces.emplace(name, std::move(text_image));
538   }
539 
540   std::lock_guard<std::mutex> lg(updateMutex);
541   gr_color(0, 0, 0, 255);
542   gr_clear();
543 
544   int text_y = margin_height_;
545   int text_x = margin_width_;
546   int line_spacing = gr_sys_font()->char_height;  // Put some extra space between images.
547   // Write the header and descriptive texts.
548   SetColor(UIElement::INFO);
549   std::string header = "Show background text image";
550   text_y += DrawTextLine(text_x, text_y, header, true);
551   std::string locale_selection = android::base::StringPrintf(
552       "Current locale: %s, %zu/%zu", locales_entries[sel].c_str(), sel + 1, locales_entries.size());
553   // clang-format off
554   std::vector<std::string> instruction = {
555     locale_selection,
556     "Use volume up/down to switch locales and power to exit."
557   };
558   // clang-format on
559   text_y += DrawWrappedTextLines(text_x, text_y, instruction);
560 
561   // Iterate through the text images and display them in order for the current locale.
562   for (const auto& p : surfaces) {
563     text_y += line_spacing;
564     SetColor(UIElement::LOG);
565     text_y += DrawTextLine(text_x, text_y, p.first, false);
566     gr_color(255, 255, 255, 255);
567     gr_texticon(text_x, text_y, p.second.get());
568     text_y += gr_get_height(p.second.get());
569   }
570   // Update the whole screen.
571   gr_flip();
572 }
573 
CheckBackgroundTextImages()574 void ScreenRecoveryUI::CheckBackgroundTextImages() {
575   // Load a list of locales embedded in one of the resource files.
576   std::vector<std::string> locales_entries = get_locales_in_png("installing_text");
577   if (locales_entries.empty()) {
578     Print("Failed to load locales from the resource files\n");
579     return;
580   }
581   std::string saved_locale = locale_;
582   size_t selected = 0;
583   SelectAndShowBackgroundText(locales_entries, selected);
584 
585   FlushKeys();
586   while (true) {
587     int key = WaitKey();
588     if (key == static_cast<int>(KeyError::INTERRUPTED)) break;
589     if (key == KEY_POWER || key == KEY_ENTER) {
590       break;
591     } else if (key == KEY_UP || key == KEY_VOLUMEUP) {
592       selected = (selected == 0) ? locales_entries.size() - 1 : selected - 1;
593       SelectAndShowBackgroundText(locales_entries, selected);
594     } else if (key == KEY_DOWN || key == KEY_VOLUMEDOWN) {
595       selected = (selected == locales_entries.size() - 1) ? 0 : selected + 1;
596       SelectAndShowBackgroundText(locales_entries, selected);
597     }
598   }
599 
600   SetLocale(saved_locale);
601 }
602 
ScreenWidth() const603 int ScreenRecoveryUI::ScreenWidth() const {
604   return gr_fb_width();
605 }
606 
ScreenHeight() const607 int ScreenRecoveryUI::ScreenHeight() const {
608   return gr_fb_height();
609 }
610 
DrawSurface(const GRSurface * surface,int sx,int sy,int w,int h,int dx,int dy) const611 void ScreenRecoveryUI::DrawSurface(const GRSurface* surface, int sx, int sy, int w, int h, int dx,
612                                    int dy) const {
613   gr_blit(surface, sx, sy, w, h, dx, dy);
614 }
615 
DrawHorizontalRule(int y) const616 int ScreenRecoveryUI::DrawHorizontalRule(int y) const {
617   gr_fill(0, y + 4, ScreenWidth(), y + 6);
618   return 8;
619 }
620 
DrawHighlightBar(int x,int y,int width,int height) const621 void ScreenRecoveryUI::DrawHighlightBar(int x, int y, int width, int height) const {
622   gr_fill(x, y, x + width, y + height);
623 }
624 
DrawFill(int x,int y,int w,int h) const625 void ScreenRecoveryUI::DrawFill(int x, int y, int w, int h) const {
626   gr_fill(x, y, w, h);
627 }
628 
DrawTextIcon(int x,int y,const GRSurface * surface) const629 void ScreenRecoveryUI::DrawTextIcon(int x, int y, const GRSurface* surface) const {
630   gr_texticon(x, y, surface);
631 }
632 
DrawTextLine(int x,int y,const std::string & line,bool bold) const633 int ScreenRecoveryUI::DrawTextLine(int x, int y, const std::string& line, bool bold) const {
634   gr_text(gr_sys_font(), x, y, line.c_str(), bold);
635   return char_height_ + 4;
636 }
637 
DrawTextLines(int x,int y,const std::vector<std::string> & lines) const638 int ScreenRecoveryUI::DrawTextLines(int x, int y, const std::vector<std::string>& lines) const {
639   int offset = 0;
640   for (const auto& line : lines) {
641     offset += DrawTextLine(x, y + offset, line, false);
642   }
643   return offset;
644 }
645 
DrawWrappedTextLines(int x,int y,const std::vector<std::string> & lines) const646 int ScreenRecoveryUI::DrawWrappedTextLines(int x, int y,
647                                            const std::vector<std::string>& lines) const {
648   // Keep symmetrical margins based on the given offset (i.e. x).
649   size_t text_cols = (ScreenWidth() - x * 2) / char_width_;
650   int offset = 0;
651   for (const auto& line : lines) {
652     size_t next_start = 0;
653     while (next_start < line.size()) {
654       std::string sub = line.substr(next_start, text_cols + 1);
655       if (sub.size() <= text_cols) {
656         next_start += sub.size();
657       } else {
658         // Line too long and must be wrapped to text_cols columns.
659         size_t last_space = sub.find_last_of(" \t\n");
660         if (last_space == std::string::npos) {
661           // No space found, just draw as much as we can.
662           sub.resize(text_cols);
663           next_start += text_cols;
664         } else {
665           sub.resize(last_space);
666           next_start += last_space + 1;
667         }
668       }
669       offset += DrawTextLine(x, y + offset, sub, false);
670     }
671   }
672   return offset;
673 }
674 
SetTitle(const std::vector<std::string> & lines)675 void ScreenRecoveryUI::SetTitle(const std::vector<std::string>& lines) {
676   title_lines_ = lines;
677 }
678 
GetMenuHelpMessage() const679 std::vector<std::string> ScreenRecoveryUI::GetMenuHelpMessage() const {
680   // clang-format off
681   static std::vector<std::string> REGULAR_HELP{
682     "Use volume up/down and power.",
683   };
684   static std::vector<std::string> LONG_PRESS_HELP{
685     "Any button cycles highlight.",
686     "Long-press activates.",
687   };
688   // clang-format on
689   return HasThreeButtons() ? REGULAR_HELP : LONG_PRESS_HELP;
690 }
691 
692 // Redraws everything on the screen. Does not flip pages. Should only be called with updateMutex
693 // locked.
draw_screen_locked()694 void ScreenRecoveryUI::draw_screen_locked() {
695   if (!show_text) {
696     draw_background_locked();
697     draw_foreground_locked();
698     return;
699   }
700 
701   gr_color(0, 0, 0, 255);
702   gr_clear();
703 
704   draw_menu_and_text_buffer_locked(GetMenuHelpMessage());
705 }
706 
707 // Draws the menu and text buffer on the screen. Should only be called with updateMutex locked.
draw_menu_and_text_buffer_locked(const std::vector<std::string> & help_message)708 void ScreenRecoveryUI::draw_menu_and_text_buffer_locked(
709     const std::vector<std::string>& help_message) {
710   int y = margin_height_;
711 
712   if (fastbootd_logo_ && fastbootd_logo_enabled_) {
713     // Try to get this centered on screen.
714     auto width = gr_get_width(fastbootd_logo_.get());
715     auto height = gr_get_height(fastbootd_logo_.get());
716     auto centered_x = ScreenWidth() / 2 - width / 2;
717     DrawSurface(fastbootd_logo_.get(), 0, 0, width, height, centered_x, y);
718     y += height;
719   }
720 
721   if (menu_) {
722     int x = margin_width_ + kMenuIndent;
723 
724     SetColor(UIElement::INFO);
725 
726     for (size_t i = 0; i < title_lines_.size(); i++) {
727       y += DrawTextLine(x, y, title_lines_[i], i == 0);
728     }
729 
730     y += DrawTextLines(x, y, help_message);
731 
732     y += menu_->DrawHeader(x, y);
733     y += menu_->DrawItems(x, y, ScreenWidth(), IsLongPress());
734   }
735 
736   // Display from the bottom up, until we hit the top of the screen, the bottom of the menu, or
737   // we've displayed the entire text buffer.
738   SetColor(UIElement::LOG);
739   int row = text_row_;
740   size_t count = 0;
741   for (int ty = ScreenHeight() - margin_height_ - char_height_; ty >= y && count < text_rows_;
742        ty -= char_height_, ++count) {
743     DrawTextLine(margin_width_, ty, text_[row], false);
744     --row;
745     if (row < 0) row = text_rows_ - 1;
746   }
747 }
748 
749 // Redraw everything on the screen and flip the screen (make it visible).
750 // Should only be called with updateMutex locked.
update_screen_locked()751 void ScreenRecoveryUI::update_screen_locked() {
752   draw_screen_locked();
753   gr_flip();
754 }
755 
756 // Updates only the progress bar, if possible, otherwise redraws the screen.
757 // Should only be called with updateMutex locked.
update_progress_locked()758 void ScreenRecoveryUI::update_progress_locked() {
759   if (show_text || !pagesIdentical) {
760     draw_screen_locked();  // Must redraw the whole screen
761     pagesIdentical = true;
762   } else {
763     draw_foreground_locked();  // Draw only the progress bar and overlays
764   }
765   gr_flip();
766 }
767 
ProgressThreadLoop()768 void ScreenRecoveryUI::ProgressThreadLoop() {
769   double interval = 1.0 / animation_fps_;
770   while (!progress_thread_stopped_) {
771     double start = now();
772     bool redraw = false;
773     {
774       std::lock_guard<std::mutex> lg(updateMutex);
775 
776       // update the installation animation, if active
777       // skip this if we have a text overlay (too expensive to update)
778       if ((current_icon_ == INSTALLING_UPDATE || current_icon_ == ERASING) && !show_text) {
779         if (!intro_done_) {
780           if (current_frame_ == intro_frames_.size() - 1) {
781             intro_done_ = true;
782             current_frame_ = 0;
783           } else {
784             ++current_frame_;
785           }
786         } else {
787           current_frame_ = (current_frame_ + 1) % loop_frames_.size();
788         }
789 
790         redraw = true;
791       }
792 
793       // move the progress bar forward on timed intervals, if configured
794       int duration = progressScopeDuration;
795       if (progressBarType == DETERMINATE && duration > 0) {
796         double elapsed = now() - progressScopeTime;
797         float p = 1.0 * elapsed / duration;
798         if (p > 1.0) p = 1.0;
799         if (p > progress) {
800           progress = p;
801           redraw = true;
802         }
803       }
804 
805       if (redraw) update_progress_locked();
806     }
807 
808     double end = now();
809     // minimum of 20ms delay between frames
810     double delay = interval - (end - start);
811     if (delay < 0.02) delay = 0.02;
812     usleep(static_cast<useconds_t>(delay * 1000000));
813   }
814 }
815 
LoadBitmap(const std::string & filename)816 std::unique_ptr<GRSurface> ScreenRecoveryUI::LoadBitmap(const std::string& filename) {
817   GRSurface* surface;
818   if (auto result = res_create_display_surface(filename.c_str(), &surface); result < 0) {
819     LOG(ERROR) << "Failed to load bitmap " << filename << " (error " << result << ")";
820     return nullptr;
821   }
822   return std::unique_ptr<GRSurface>(surface);
823 }
824 
LoadLocalizedBitmap(const std::string & filename)825 std::unique_ptr<GRSurface> ScreenRecoveryUI::LoadLocalizedBitmap(const std::string& filename) {
826   GRSurface* surface;
827   auto result = res_create_localized_alpha_surface(filename.c_str(), locale_.c_str(), &surface);
828   if (result == 0) {
829     return std::unique_ptr<GRSurface>(surface);
830   }
831   // TODO(xunchang) create a error code enum to refine the retry condition.
832   LOG(WARNING) << "Failed to load bitmap " << filename << " for locale " << locale_ << " (error "
833                << result << "). Falling back to use default locale.";
834 
835   result = res_create_localized_alpha_surface(filename.c_str(), DEFAULT_LOCALE, &surface);
836   if (result == 0) {
837     return std::unique_ptr<GRSurface>(surface);
838   }
839 
840   LOG(ERROR) << "Failed to load bitmap " << filename << " for locale " << DEFAULT_LOCALE
841              << " (error " << result << ")";
842   return nullptr;
843 }
844 
Alloc2d(size_t rows,size_t cols)845 static char** Alloc2d(size_t rows, size_t cols) {
846   char** result = new char*[rows];
847   for (size_t i = 0; i < rows; ++i) {
848     result[i] = new char[cols];
849     memset(result[i], 0, cols);
850   }
851   return result;
852 }
853 
854 // Choose the right background string to display during update.
SetSystemUpdateText(bool security_update)855 void ScreenRecoveryUI::SetSystemUpdateText(bool security_update) {
856   if (security_update) {
857     installing_text_ = LoadLocalizedBitmap("installing_security_text");
858   } else {
859     installing_text_ = LoadLocalizedBitmap("installing_text");
860   }
861   Redraw();
862 }
863 
InitTextParams()864 bool ScreenRecoveryUI::InitTextParams() {
865   // gr_init() would return successfully on font initialization failure.
866   if (gr_sys_font() == nullptr) {
867     return false;
868   }
869   gr_font_size(gr_sys_font(), &char_width_, &char_height_);
870   text_rows_ = (ScreenHeight() - margin_height_ * 2) / char_height_;
871   text_cols_ = (ScreenWidth() - margin_width_ * 2) / char_width_;
872   return true;
873 }
874 
LoadWipeDataMenuText()875 bool ScreenRecoveryUI::LoadWipeDataMenuText() {
876   // Ignores the errors since the member variables will stay as nullptr.
877   cancel_wipe_data_text_ = LoadLocalizedBitmap("cancel_wipe_data_text");
878   factory_data_reset_text_ = LoadLocalizedBitmap("factory_data_reset_text");
879   try_again_text_ = LoadLocalizedBitmap("try_again_text");
880   wipe_data_confirmation_text_ = LoadLocalizedBitmap("wipe_data_confirmation_text");
881   wipe_data_menu_header_text_ = LoadLocalizedBitmap("wipe_data_menu_header_text");
882   return true;
883 }
884 
InitGraphics()885 static bool InitGraphics() {
886   // Timeout is same as init wait for file default of 5 seconds and is arbitrary
887   const unsigned timeout = 500;  // 10ms increments
888   for (auto retry = timeout; retry > 0; --retry) {
889     if (gr_init() == 0) {
890       if (retry < timeout) {
891         // Log message like init wait for file completion log for consistency.
892         LOG(WARNING) << "wait for 'graphics' took " << ((timeout - retry) * 10) << "ms";
893       }
894       return true;
895     }
896     std::this_thread::sleep_for(10ms);
897   }
898   // Log message like init wait for file timeout log for consistency.
899   LOG(ERROR) << "timeout wait for 'graphics' took " << (timeout * 10) << "ms";
900   return false;
901 }
902 
Init(const std::string & locale)903 bool ScreenRecoveryUI::Init(const std::string& locale) {
904   RecoveryUI::Init(locale);
905 
906   if (!InitGraphics()) {
907     return false;
908   }
909 
910   if (!InitTextParams()) {
911     return false;
912   }
913 
914   // Are we portrait or landscape?
915   layout_ = (gr_fb_width() > gr_fb_height()) ? LANDSCAPE : PORTRAIT;
916   // Are we the large variant of our base layout?
917   if (gr_fb_height() > PixelsFromDp(800)) ++layout_;
918 
919   text_ = Alloc2d(text_rows_, text_cols_ + 1);
920   file_viewer_text_ = Alloc2d(text_rows_, text_cols_ + 1);
921 
922   text_col_ = text_row_ = 0;
923 
924   // Set up the locale info.
925   SetLocale(locale);
926 
927   error_icon_ = LoadBitmap("icon_error");
928 
929   progress_bar_empty_ = LoadBitmap("progress_empty");
930   progress_bar_fill_ = LoadBitmap("progress_fill");
931   stage_marker_empty_ = LoadBitmap("stage_empty");
932   stage_marker_fill_ = LoadBitmap("stage_fill");
933 
934   erasing_text_ = LoadLocalizedBitmap("erasing_text");
935   no_command_text_ = LoadLocalizedBitmap("no_command_text");
936   error_text_ = LoadLocalizedBitmap("error_text");
937 
938   if (android::base::GetBoolProperty("ro.boot.dynamic_partitions", false)) {
939     fastbootd_logo_ = LoadBitmap("fastbootd");
940   }
941 
942   // Background text for "installing_update" could be "installing update" or
943   // "installing security update". It will be set after Init() according to the commands in BCB.
944   installing_text_.reset();
945 
946   LoadWipeDataMenuText();
947 
948   LoadAnimation();
949 
950   // Keep the progress bar updated, even when the process is otherwise busy.
951   progress_thread_ = std::thread(&ScreenRecoveryUI::ProgressThreadLoop, this);
952 
953   return true;
954 }
955 
GetLocale() const956 std::string ScreenRecoveryUI::GetLocale() const {
957   return locale_;
958 }
959 
LoadAnimation()960 void ScreenRecoveryUI::LoadAnimation() {
961   std::unique_ptr<DIR, decltype(&closedir)> dir(opendir(Paths::Get().resource_dir().c_str()),
962                                                 closedir);
963   dirent* de;
964   std::vector<std::string> intro_frame_names;
965   std::vector<std::string> loop_frame_names;
966 
967   while ((de = readdir(dir.get())) != nullptr) {
968     int value, num_chars;
969     if (sscanf(de->d_name, "intro%d%n.png", &value, &num_chars) == 1) {
970       intro_frame_names.emplace_back(de->d_name, num_chars);
971     } else if (sscanf(de->d_name, "loop%d%n.png", &value, &num_chars) == 1) {
972       loop_frame_names.emplace_back(de->d_name, num_chars);
973     }
974   }
975 
976   size_t intro_frames = intro_frame_names.size();
977   size_t loop_frames = loop_frame_names.size();
978 
979   // It's okay to not have an intro.
980   if (intro_frames == 0) intro_done_ = true;
981   // But you must have an animation.
982   if (loop_frames == 0) abort();
983 
984   std::sort(intro_frame_names.begin(), intro_frame_names.end());
985   std::sort(loop_frame_names.begin(), loop_frame_names.end());
986 
987   intro_frames_.clear();
988   intro_frames_.reserve(intro_frames);
989   for (const auto& frame_name : intro_frame_names) {
990     intro_frames_.emplace_back(LoadBitmap(frame_name));
991   }
992 
993   loop_frames_.clear();
994   loop_frames_.reserve(loop_frames);
995   for (const auto& frame_name : loop_frame_names) {
996     loop_frames_.emplace_back(LoadBitmap(frame_name));
997   }
998 }
999 
SetBackground(Icon icon)1000 void ScreenRecoveryUI::SetBackground(Icon icon) {
1001   std::lock_guard<std::mutex> lg(updateMutex);
1002 
1003   current_icon_ = icon;
1004   update_screen_locked();
1005 }
1006 
SetProgressType(ProgressType type)1007 void ScreenRecoveryUI::SetProgressType(ProgressType type) {
1008   std::lock_guard<std::mutex> lg(updateMutex);
1009   if (progressBarType != type) {
1010     progressBarType = type;
1011   }
1012   progressScopeStart = 0;
1013   progressScopeSize = 0;
1014   progress = 0;
1015   update_progress_locked();
1016 }
1017 
ShowProgress(float portion,float seconds)1018 void ScreenRecoveryUI::ShowProgress(float portion, float seconds) {
1019   std::lock_guard<std::mutex> lg(updateMutex);
1020   progressBarType = DETERMINATE;
1021   progressScopeStart += progressScopeSize;
1022   progressScopeSize = portion;
1023   progressScopeTime = now();
1024   progressScopeDuration = seconds;
1025   progress = 0;
1026   update_progress_locked();
1027 }
1028 
SetProgress(float fraction)1029 void ScreenRecoveryUI::SetProgress(float fraction) {
1030   std::lock_guard<std::mutex> lg(updateMutex);
1031   if (fraction < 0.0) fraction = 0.0;
1032   if (fraction > 1.0) fraction = 1.0;
1033   if (progressBarType == DETERMINATE && fraction > progress) {
1034     // Skip updates that aren't visibly different.
1035     int width = gr_get_width(progress_bar_empty_.get());
1036     float scale = width * progressScopeSize;
1037     if ((int)(progress * scale) != (int)(fraction * scale)) {
1038       progress = fraction;
1039       update_progress_locked();
1040     }
1041   }
1042 }
1043 
SetStage(int current,int max)1044 void ScreenRecoveryUI::SetStage(int current, int max) {
1045   std::lock_guard<std::mutex> lg(updateMutex);
1046   stage = current;
1047   max_stage = max;
1048 }
1049 
PrintV(const char * fmt,bool copy_to_stdout,va_list ap)1050 void ScreenRecoveryUI::PrintV(const char* fmt, bool copy_to_stdout, va_list ap) {
1051   std::string str;
1052   android::base::StringAppendV(&str, fmt, ap);
1053 
1054   if (copy_to_stdout) {
1055     fputs(str.c_str(), stdout);
1056   }
1057 
1058   std::lock_guard<std::mutex> lg(updateMutex);
1059   if (text_rows_ > 0 && text_cols_ > 0) {
1060     for (const char* ptr = str.c_str(); *ptr != '\0'; ++ptr) {
1061       if (*ptr == '\n' || text_col_ >= text_cols_) {
1062         text_[text_row_][text_col_] = '\0';
1063         text_col_ = 0;
1064         text_row_ = (text_row_ + 1) % text_rows_;
1065       }
1066       if (*ptr != '\n') text_[text_row_][text_col_++] = *ptr;
1067     }
1068     text_[text_row_][text_col_] = '\0';
1069     update_screen_locked();
1070   }
1071 }
1072 
Print(const char * fmt,...)1073 void ScreenRecoveryUI::Print(const char* fmt, ...) {
1074   va_list ap;
1075   va_start(ap, fmt);
1076   PrintV(fmt, true, ap);
1077   va_end(ap);
1078 }
1079 
PrintOnScreenOnly(const char * fmt,...)1080 void ScreenRecoveryUI::PrintOnScreenOnly(const char* fmt, ...) {
1081   va_list ap;
1082   va_start(ap, fmt);
1083   PrintV(fmt, false, ap);
1084   va_end(ap);
1085 }
1086 
PutChar(char ch)1087 void ScreenRecoveryUI::PutChar(char ch) {
1088   std::lock_guard<std::mutex> lg(updateMutex);
1089   if (ch != '\n') text_[text_row_][text_col_++] = ch;
1090   if (ch == '\n' || text_col_ >= text_cols_) {
1091     text_col_ = 0;
1092     ++text_row_;
1093   }
1094 }
1095 
ClearText()1096 void ScreenRecoveryUI::ClearText() {
1097   std::lock_guard<std::mutex> lg(updateMutex);
1098   text_col_ = 0;
1099   text_row_ = 0;
1100   for (size_t i = 0; i < text_rows_; ++i) {
1101     memset(text_[i], 0, text_cols_ + 1);
1102   }
1103 }
1104 
ShowFile(FILE * fp)1105 void ScreenRecoveryUI::ShowFile(FILE* fp) {
1106   std::vector<off_t> offsets;
1107   offsets.push_back(ftello(fp));
1108   ClearText();
1109 
1110   struct stat sb;
1111   fstat(fileno(fp), &sb);
1112 
1113   bool show_prompt = false;
1114   while (true) {
1115     if (show_prompt) {
1116       PrintOnScreenOnly("--(%d%% of %d bytes)--",
1117                         static_cast<int>(100 * (double(ftello(fp)) / double(sb.st_size))),
1118                         static_cast<int>(sb.st_size));
1119       Redraw();
1120       while (show_prompt) {
1121         show_prompt = false;
1122         int key = WaitKey();
1123         if (key == static_cast<int>(KeyError::INTERRUPTED)) return;
1124         if (key == KEY_POWER || key == KEY_ENTER) {
1125           return;
1126         } else if (key == KEY_UP || key == KEY_VOLUMEUP) {
1127           if (offsets.size() <= 1) {
1128             show_prompt = true;
1129           } else {
1130             offsets.pop_back();
1131             fseek(fp, offsets.back(), SEEK_SET);
1132           }
1133         } else {
1134           if (feof(fp)) {
1135             return;
1136           }
1137           offsets.push_back(ftello(fp));
1138         }
1139       }
1140       ClearText();
1141     }
1142 
1143     int ch = getc(fp);
1144     if (ch == EOF) {
1145       while (text_row_ < text_rows_ - 1) PutChar('\n');
1146       show_prompt = true;
1147     } else {
1148       PutChar(ch);
1149       if (text_col_ == 0 && text_row_ >= text_rows_ - 1) {
1150         show_prompt = true;
1151       }
1152     }
1153   }
1154 }
1155 
ShowFile(const std::string & filename)1156 void ScreenRecoveryUI::ShowFile(const std::string& filename) {
1157   std::unique_ptr<FILE, decltype(&fclose)> fp(fopen(filename.c_str(), "re"), fclose);
1158   if (!fp) {
1159     Print("  Unable to open %s: %s\n", filename.c_str(), strerror(errno));
1160     return;
1161   }
1162 
1163   char** old_text = text_;
1164   size_t old_text_col = text_col_;
1165   size_t old_text_row = text_row_;
1166 
1167   // Swap in the alternate screen and clear it.
1168   text_ = file_viewer_text_;
1169   ClearText();
1170 
1171   ShowFile(fp.get());
1172 
1173   text_ = old_text;
1174   text_col_ = old_text_col;
1175   text_row_ = old_text_row;
1176 }
1177 
CreateMenu(const GRSurface * graphic_header,const std::vector<const GRSurface * > & graphic_items,const std::vector<std::string> & text_headers,const std::vector<std::string> & text_items,size_t initial_selection) const1178 std::unique_ptr<Menu> ScreenRecoveryUI::CreateMenu(
1179     const GRSurface* graphic_header, const std::vector<const GRSurface*>& graphic_items,
1180     const std::vector<std::string>& text_headers, const std::vector<std::string>& text_items,
1181     size_t initial_selection) const {
1182   // horizontal unusable area: margin width + menu indent
1183   size_t max_width = ScreenWidth() - margin_width_ - kMenuIndent;
1184   // vertical unusable area: margin height + title lines + helper message + high light bar.
1185   // It is safe to reserve more space.
1186   size_t max_height = ScreenHeight() - margin_height_ - char_height_ * (title_lines_.size() + 3);
1187   if (GraphicMenu::Validate(max_width, max_height, graphic_header, graphic_items)) {
1188     return std::make_unique<GraphicMenu>(graphic_header, graphic_items, initial_selection, *this);
1189   }
1190 
1191   fprintf(stderr, "Failed to initialize graphic menu, falling back to use the text menu.\n");
1192 
1193   return CreateMenu(text_headers, text_items, initial_selection);
1194 }
1195 
CreateMenu(const std::vector<std::string> & text_headers,const std::vector<std::string> & text_items,size_t initial_selection) const1196 std::unique_ptr<Menu> ScreenRecoveryUI::CreateMenu(const std::vector<std::string>& text_headers,
1197                                                    const std::vector<std::string>& text_items,
1198                                                    size_t initial_selection) const {
1199   if (text_rows_ > 0 && text_cols_ > 1) {
1200     return std::make_unique<TextMenu>(scrollable_menu_, text_rows_, text_cols_ - 1, text_headers,
1201                                       text_items, initial_selection, char_height_, *this);
1202   }
1203 
1204   fprintf(stderr, "Failed to create text menu, text_rows %zu, text_cols %zu.\n", text_rows_,
1205           text_cols_);
1206   return nullptr;
1207 }
1208 
SelectMenu(int sel)1209 int ScreenRecoveryUI::SelectMenu(int sel) {
1210   std::lock_guard<std::mutex> lg(updateMutex);
1211   if (menu_) {
1212     int old_sel = menu_->selection();
1213     sel = menu_->Select(sel);
1214 
1215     if (sel != old_sel) {
1216       update_screen_locked();
1217     }
1218   }
1219   return sel;
1220 }
1221 
ShowMenu(std::unique_ptr<Menu> && menu,bool menu_only,const std::function<int (int,bool)> & key_handler)1222 size_t ScreenRecoveryUI::ShowMenu(std::unique_ptr<Menu>&& menu, bool menu_only,
1223                                   const std::function<int(int, bool)>& key_handler) {
1224   // Throw away keys pressed previously, so user doesn't accidentally trigger menu items.
1225   FlushKeys();
1226 
1227   // If there is a key interrupt in progress, return KeyError::INTERRUPTED without starting the
1228   // menu.
1229   if (IsKeyInterrupted()) return static_cast<size_t>(KeyError::INTERRUPTED);
1230 
1231   CHECK(menu != nullptr);
1232 
1233   // Starts and displays the menu
1234   menu_ = std::move(menu);
1235   Redraw();
1236 
1237   int selected = menu_->selection();
1238   int chosen_item = -1;
1239   while (chosen_item < 0) {
1240     int key = WaitKey();
1241     if (key == static_cast<int>(KeyError::INTERRUPTED)) {  // WaitKey() was interrupted.
1242       return static_cast<size_t>(KeyError::INTERRUPTED);
1243     }
1244     if (key == static_cast<int>(KeyError::TIMED_OUT)) {  // WaitKey() timed out.
1245       if (WasTextEverVisible()) {
1246         continue;
1247       } else {
1248         LOG(INFO) << "Timed out waiting for key input; rebooting.";
1249         menu_.reset();
1250         Redraw();
1251         return static_cast<size_t>(KeyError::TIMED_OUT);
1252       }
1253     }
1254 
1255     bool visible = IsTextVisible();
1256     int action = key_handler(key, visible);
1257     if (action < 0) {
1258       switch (action) {
1259         case Device::kHighlightUp:
1260           selected = SelectMenu(--selected);
1261           break;
1262         case Device::kHighlightDown:
1263           selected = SelectMenu(++selected);
1264           break;
1265         case Device::kInvokeItem:
1266           chosen_item = selected;
1267           break;
1268         case Device::kNoAction:
1269           break;
1270       }
1271     } else if (!menu_only) {
1272       chosen_item = action;
1273     }
1274   }
1275 
1276   menu_.reset();
1277   Redraw();
1278 
1279   return chosen_item;
1280 }
1281 
ShowMenu(const std::vector<std::string> & headers,const std::vector<std::string> & items,size_t initial_selection,bool menu_only,const std::function<int (int,bool)> & key_handler)1282 size_t ScreenRecoveryUI::ShowMenu(const std::vector<std::string>& headers,
1283                                   const std::vector<std::string>& items, size_t initial_selection,
1284                                   bool menu_only,
1285                                   const std::function<int(int, bool)>& key_handler) {
1286   auto menu = CreateMenu(headers, items, initial_selection);
1287   if (menu == nullptr) {
1288     return initial_selection;
1289   }
1290 
1291   return ShowMenu(std::move(menu), menu_only, key_handler);
1292 }
1293 
ShowPromptWipeDataMenu(const std::vector<std::string> & backup_headers,const std::vector<std::string> & backup_items,const std::function<int (int,bool)> & key_handler)1294 size_t ScreenRecoveryUI::ShowPromptWipeDataMenu(const std::vector<std::string>& backup_headers,
1295                                                 const std::vector<std::string>& backup_items,
1296                                                 const std::function<int(int, bool)>& key_handler) {
1297   auto wipe_data_menu = CreateMenu(wipe_data_menu_header_text_.get(),
1298                                    { try_again_text_.get(), factory_data_reset_text_.get() },
1299                                    backup_headers, backup_items, 0);
1300   if (wipe_data_menu == nullptr) {
1301     return 0;
1302   }
1303 
1304   return ShowMenu(std::move(wipe_data_menu), true, key_handler);
1305 }
1306 
ShowPromptWipeDataConfirmationMenu(const std::vector<std::string> & backup_headers,const std::vector<std::string> & backup_items,const std::function<int (int,bool)> & key_handler)1307 size_t ScreenRecoveryUI::ShowPromptWipeDataConfirmationMenu(
1308     const std::vector<std::string>& backup_headers, const std::vector<std::string>& backup_items,
1309     const std::function<int(int, bool)>& key_handler) {
1310   auto confirmation_menu =
1311       CreateMenu(wipe_data_confirmation_text_.get(),
1312                  { cancel_wipe_data_text_.get(), factory_data_reset_text_.get() }, backup_headers,
1313                  backup_items, 0);
1314   if (confirmation_menu == nullptr) {
1315     return 0;
1316   }
1317 
1318   return ShowMenu(std::move(confirmation_menu), true, key_handler);
1319 }
1320 
IsTextVisible()1321 bool ScreenRecoveryUI::IsTextVisible() {
1322   std::lock_guard<std::mutex> lg(updateMutex);
1323   int visible = show_text;
1324   return visible;
1325 }
1326 
WasTextEverVisible()1327 bool ScreenRecoveryUI::WasTextEverVisible() {
1328   std::lock_guard<std::mutex> lg(updateMutex);
1329   int ever_visible = show_text_ever;
1330   return ever_visible;
1331 }
1332 
ShowText(bool visible)1333 void ScreenRecoveryUI::ShowText(bool visible) {
1334   std::lock_guard<std::mutex> lg(updateMutex);
1335   show_text = visible;
1336   if (show_text) show_text_ever = true;
1337   update_screen_locked();
1338 }
1339 
Redraw()1340 void ScreenRecoveryUI::Redraw() {
1341   std::lock_guard<std::mutex> lg(updateMutex);
1342   update_screen_locked();
1343 }
1344 
KeyLongPress(int)1345 void ScreenRecoveryUI::KeyLongPress(int) {
1346   // Redraw so that if we're in the menu, the highlight
1347   // will change color to indicate a successful long press.
1348   Redraw();
1349 }
1350 
SetLocale(const std::string & new_locale)1351 void ScreenRecoveryUI::SetLocale(const std::string& new_locale) {
1352   locale_ = new_locale;
1353   rtl_locale_ = false;
1354 
1355   if (!new_locale.empty()) {
1356     size_t separator = new_locale.find('-');
1357     // lang has the language prefix prior to the separator, or full string if none exists.
1358     std::string lang = new_locale.substr(0, separator);
1359 
1360     // A bit cheesy: keep an explicit list of supported RTL languages.
1361     if (lang == "ar" ||  // Arabic
1362         lang == "fa" ||  // Persian (Farsi)
1363         lang == "he" ||  // Hebrew (new language code)
1364         lang == "iw" ||  // Hebrew (old language code)
1365         lang == "ur") {  // Urdu
1366       rtl_locale_ = true;
1367     }
1368   }
1369 }
1370